# M9 / issue-46 开发日志：教程大纲与里程碑收束

- Issue：#80
- 里程碑：M9 体验基线与主题边界：从可用到可继续设计
- 分支：`fys-dev/docs-m9-issue-46-tutorial-outline`
- 日期：2026-03-27

## 背景

`issue-42 ~ issue-45` 已经把 M9 的主线推进完成：

- 主题基线成立
- 后台壳结构更清晰
- 公开页视觉基线升级
- 最小共享展示原语落下

如果这个阶段不及时把设计取舍、边界判断和文章结构收住，后续继续做模板化、视觉升级或更完整后台时，很容易只剩“代码结果”，丢掉教程型仓库最重要的过程感。

## 本次目标

- 为 M9 产出一份可继续扩写的教程大纲
- 串起 `issue-42 ~ issue-45` 的主线与顺序关系
- 写清 M9 做了什么、没做什么、为什么这样做
- 更新文档导航，保证入口明确

## 非目标

- 不补新的业务功能
- 不回头修改 M9 已完成 issue 的实现
- 不把大纲直接扩成完整长文
- 不把后续模板化能力写成当前已完成内容

## TDD / 测试设计

这是文档任务，本轮不做代码测试，验证方式以文档校对为主。

### 1. 结构完整性校对

验证教程大纲至少覆盖：

- 里程碑目标
- issue 拆解顺序
- 关键设计取舍
- 已完成边界
- 后续衔接建议

### 2. 文档入口校对

验证：

- `docs/40-教程与博客/` 中存在 M9 大纲
- `docs/00-文档导航.md` 有对应入口或规划项
- 开发日志与教程大纲之间能互相引用

### 3. 文案边界校对

重点确认：

- 不再出现内部流程专用表述
- 不把后续规划写成“已交付能力”
- 用公开仓库可接受的中性工程语言描述 M9

## 实际改动

### 1. 补出 M9 里程碑教程大纲

新增：

- `docs/40-教程与博客/M9-主题边界到共享-UI-从可用到可继续设计-教程大纲.md`

这份大纲把 M9 收成了一条完整主线：

- 先立主题边界
- 再整理后台信息架构
- 再升级公开页视觉基线
- 最后沉淀最小共享展示原语

同时明确写清：

- M9 为什么这样拆
- 当前刻意不做什么
- 后续文章可以从哪些角度继续展开

### 2. 补本轮开发日志

新增：

- `docs/30-开发日志/M9-issue-46-教程大纲与里程碑收束.md`

这样 `issue-46` 依然符合仓库的标准流程：

- 有 issue
- 有边界
- 有日志
- 有产出

### 3. 更新文档导航

更新：

- `docs/00-文档导航.md`

把 M9 教程大纲补进教程与博客目录规划，避免文档新增后悬空。

## Review 记录

### 是否符合当前 Issue 与里程碑目标

符合。

本次只做：

- M9 教程大纲
- 文档导航补充
- 本轮开发日志

没有越界去做：

- 新功能开发
- UI 回改
- 额外技术方案扩展

### 是否存在可抽离的组件、公共函数、skills 或其他复用能力

本轮是纯文档任务，没有新的代码层抽象。

但从内容组织上，已经沉淀出一个稳定的里程碑写法：

- 先解释阶段问题
- 再解释 issue 顺序
- 再总结取舍与边界
- 最后给出文章拆分建议与后续衔接

后续 `M10+` 可以继续沿用这个结构。

### 本次最重要的边界判断

这轮不是“把 M9 宣布写完”，而是“把 M9 变成可继续写的素材”。

这很重要，因为教程型仓库的目标不是尽快把文档堆满，而是让每个阶段都能留下稳定、可扩展、不会和后续演进冲突的文档骨架。

## 自测结果

已执行：

- 文档结构人工校对
- 目录入口人工校对
- 文案边界人工校对

结果：

- M9 教程大纲已生成
- 文档导航入口已补齐
- 当前文案保持公开仓库可接受的中性工程表述

## 遇到的问题

### 1. 里程碑收束文档很容易写成“重复开发日志”

问题：

如果只是把 `issue-42 ~ issue-45` 各自再复述一遍，大纲会显得冗长，也很难形成后续文章骨架。

处理：

- 不重复细节实现
- 改为强调主线顺序、设计边界和文章拆分角度

### 2. 里程碑总结很容易把“后续规划”写成“当前已完成”

问题：

M9 已经触达模板化和设计系统边界，但这些能力当前并没有真正落地。

处理：

- 明确写出“M9 刻意没做什么”
- 把后续内容放到“衔接建议”而不是“已完成状态”

## 可沉淀为教程/博客的点

- 如何写一份真正服务后续创作的里程碑教程大纲
- 为什么教程型仓库要在每个阶段结束时及时收束文档
- 如何区分“阶段总结”和“开发日志”
- 如何用 issue 顺序反推出教程章节顺序

## 后续待办

- 视 M9 是否需要正式收尾，补一份对外可发布的阶段总结正文
- 开始规划下一个里程碑时，继续沿用当前大纲结构
- 如后续进入模板化或视觉精修阶段，再从 M9 大纲中拆出单独文章继续展开
