开发记录：VitePress专题入口与推荐阅读增强

这篇开发记录用于复盘 M2 的背景、目标、执行过程和最终结果。

为什么在 M2 补专题入口与推荐阅读增强

M1 已经把首页和模块导航做成了更像正式站点入口的样子，但当前信息架构仍然主要依赖“顶层模块目录”。对于资料量比较大的知识库来说，这仍然不够，因为很多用户进入站点时，真正想找的是某个主题，而不是目录树本身。

只要缺少专题层，站点就很容易继续出现这些问题：

• 用户知道想看 Vue、面试或工程化，但首页没有直接主题入口
• 总览页虽然完整，但高价值主题仍然埋在目录结构里
• 首页、模块页和后续推荐阅读之间缺少真正的主题连接层
• 后面如果继续补 SEO、搜索或推荐内容，站点会缺少中间组织层

所以 M2 选择先补专题入口与推荐阅读，是为了让站点从“按目录进入”升级到“既能按目录进入，也能按主题进入”。

这轮做了什么

这轮主要完成了这些事情：

• 新增 M2 任务拆解文档
• 新增 M2 详细设计文档
• 调整 scripts/generate-vitepress.mjs，增加专题配置能力
• 自动生成 专题导航/ 总览页
• 自动生成多个专题详情页
• 在首页补齐专题推荐区
• 在顶栏导航接入专题导航入口与重点专题下拉

这轮最重要的决策

决策一：先做少量高价值专题，而不是做很多标签页

这轮没有尝试一口气做很多专题，也没有引入复杂标签系统，而是优先落地四个更稳定的主题入口：

• Vue / Nuxt
• 面试整理
• 构建与工程化
• AI 学习

这样做的好处是，主题入口先能成立，后面再继续扩充时结构也不会乱。

决策二：继续坚持“脚本生成优先”

这轮没有手工创建一堆专题页面，而是让专题页继续由生成脚本统一产出。

这样做的原因是：

• 后续扩充专题时成本更低
• 首页、专题导航页和详情页可以共享同一套数据来源
• 站点不会形成“部分自动生成、部分手工维护”的双轨状态

决策三：推荐阅读先采用简单稳定的规则

这轮没有引入复杂的人工打标或内容评分系统，而是先基于：

• 模块优先入口
• 模块高价值入口
• 模块高频主题入口

组合成一版稳定可解释的推荐阅读列表。

本轮自测怎么做

这轮主要做了下面这些自测：

• 执行 npm run docs:sync，确认专题导航相关页面生成通过
• 执行 npm run build，确认 VitePress 构建通过
• 启动 vitepress preview，确认预览服务可启动
• 使用 curl 检查首页访问返回 200
• 使用 curl 检查 专题导航/ 页面访问返回 200
• 使用 curl 检查 专题导航/vue-nuxt.html 返回 200

本轮结果

M2 完成后，当前站点已经不再只是“模块目录型知识库”，而开始具备比较明确的主题组织层：

• 首页可以直接进入专题推荐区
• 站点已经有独立的 专题导航/ 层
• 每个专题页都可以承接覆盖模块和推荐阅读链路
• 后续做专题扩充、推荐优化和搜索体验增强时会更顺畅

这意味着下一轮如果继续扩展：

• 更细的 Vue / 面试 / AI 子专题
• 模块页和专题页之间的双向跳转
• 更精细的推荐阅读规则
• 搜索体验与专题权重协同

都已经有了更稳定的挂载点。