开发记录：SSR 与水合文档化重构

这篇开发记录用于复盘 M5 第一轮工作的背景、目标、执行过程和结果。

为什么在 M5 先补 SSR

前面的案例大多集中在客户端页面和基础组件，已经足够建立 Vue 重构的基本框架，但还缺一个很关键的维度：服务端与客户端之间的数据流边界。

SSR / hydration 正好可以补上这一块。它和之前案例不同的地方在于，复杂度不主要来自某个大组件，而是来自“同一个页面的数据准备要跨两个运行时完成”。

这轮做了什么

这轮主要完成了几件事：

• 新增了 SSR 案例文档
• 新增了 M5 的任务拆解文档
• 新增了 M5 的详细设计文档
• 更新了入口、导航与统一框架
• 更新了里程碑状态

这轮的核心决策

决策一：先从 SSR 数据流入手，而不是先讲 Nuxt API

因为当前方法库的目标是“重构框架”，不是“API 速查表”，所以本轮优先沉淀的是数据预取、水合和运行时边界，而不是某个具体框架指令。

决策二：继续维持案例文档与过程文档分层

案例文档保留在根目录，过程性材料继续进入 docs/，这样新读者看案例不会被过程细节打断，但需要追溯设计的人也能找到上下文。

决策三：同步更新导航与总框架

每新增一篇案例，如果不同时更新导航层和方法层，体系很快又会失衡。所以这轮继续坚持“案例新增 = 入口同步更新”。

这轮的自测方式

因为本轮仍然只修改文档，没有动独立子项目源码，所以自测重点放在文档结构完整性上：

• 检查新增 Markdown 文件是否落盘
• 检查本地链接是否都能正确解析
• 检查入口页是否已经挂上 M5 文档
• 检查统一框架与导航图是否已同步纳入 SSR 案例

当前 M5 的阶段结论

M5 不再是“待开始”，而是已经进入执行阶段。第一轮先把 SSR / hydration 这条线补进方法库，后续就可以继续扩展：

• Nuxt 数据获取
• hydration 边界问题
• SSR 页面缓存
• 服务端错误边界

这意味着整个项目现在已经从“客户端 Vue 重构方法库”，向“Vue / Nuxt 全链路重构方法库”迈进了一步。