VitePress 集成

背景

项目原为纯 Markdown 文档仓库，需要搭建为响应式网站，支持桌面端和手机端访问。

实现方式

• 使用 VitePress 1.6.4 作为静态站点生成器
• srcDir: '.' 配置直接指向项目根目录，保持原有文件结构不变
• srcExclude 排除 CLAUDE.md、node_modules 等非内容文件
• 根目录 index.md 作为首页（hero 布局 + features 卡片）
• README.md 保留给 GitHub 查看，从 VitePress 中排除

配置要点

配置项	值	说明
语言	zh-CN	中文界面（搜索、导航文字）
搜索	local	本地全文搜索
侧边栏	按板块分区	01/02/03 各自独立侧栏
移动端	自动适配	汉堡菜单 + 折叠侧栏

关联文件

• .vitepress/config.mts — 核心配置
• index.md — 首页
• package.json — 构建脚本