M1详细设计：首页信息架构与模块总览

这份设计文档说明 M1 为什么选择首页与模块导航增强，以及本轮会如何接入当前站点底座。

设计目标

把当前 VitePress 站点从“技术上已经跑通”升级到“对人更容易理解和进入”的状态，也就是：

• 首页能说明站点价值
• 模块总览页能承担真正的目录入口职责
• 重点模块能更快被看到
• 生成逻辑继续保持自动化

为什么在 M1 先做首页与模块导航增强

M0 已经解决了最核心的可运行问题，但它仍然更偏“工程底座”而不是“知识产品入口”。如果直接继续加更多功能，而不先把首页与模块入口做好，后面的站点体验会长期停留在“内容很多，但不好进”的状态。

所以 M1 的重点不是继续补底层兼容，而是先把“站点入口表达”做完整。

本轮复杂度中心

本轮真正的复杂度中心主要有四个：

• 首页应该表达哪些信息，不能只是放几个按钮
• 模块总览如何既保留自动生成，又不显得只是纯列表
• 重点模块如何被推荐，但不破坏全站自动化结构
• 生成脚本如何在增强内容表达时继续保持可维护

设计方案

设计一：首页增强为结构化入口

首页除了 Hero 区之外，还需要补齐：

• 站点规模说明
• 重点模块入口
• 推荐专题入口
• 当前重构策略说明

设计二：模块总览增强为“内容入口页”

内容导航/index.md 不再只是简单列出模块名，而是应该补齐：

• 文档数
• 快速进入入口
• 模块排序逻辑
• 适合一眼理解的信息摘要

设计三：保持自动生成优先

这一轮继续坚持“生成优先”，也就是：

• 尽量通过脚本生成，而不是手工维护大段目录页
• 尽量让后续新增模块能自动接入展示
• 尽量减少重复编辑成本

本轮交付物

本轮预期交付物包括：

• 首页增强版
• 模块总览增强版
• 01-M1任务拆解-首页与模块导航增强.md
• 02-M1详细设计-首页信息架构与模块总览.md
• 03-开发记录-VitePress知识库首页与导航增强.md

风险与约束

本轮主要约束有这些：

• 原始 Markdown 资料不应被大规模手工改写
• 站点内容仍然要以自动接入为主
• 历史资料中的脏 HTML、模板语法和资源错误仍然可能存在
• 构建成功仍然是最优先约束之一

完成后的预期效果

完成后，当前站点应该达到下面这些状态：

• 用户进入首页时能更快理解站点内容
• 用户从总览页进入某个模块时路径更清晰
• 自动生成逻辑依然成立
• 后续 M2 做专题入口时会更顺畅