# webnovel-writer v7 实施计划（里程碑路线图）

> 状态：草案 0.1（2026-06-13，待作者确认）
> 上游：`v7-prd.md` 1.0（产品法律文本）、`story-repo-spec-2026-06-10.md` 0.6（格式法律文本）、`multi-agent-adaptation-spec-2026-06-05.md` v3.2（宿主适配）、`.trellis/spec/backend/` 基线 1.0（开发规范）
> 地位：本文档管**实施排程**——把 PRD §6 的 v7.0 范围切成有依赖顺序、有出口判据的里程碑。范围与行为以 PRD/spec 为准，两者冲突时改本文档。

---

## 0. 现状盘点（2026-06-13）

| 事项 | 状态 |
|---|---|
| PRD 1.0 | ✅ 定稿（06-12，作者逐项确认） |
| story-repo-spec 0.6 / multi-agent-spec v3.2 | ✅ 按 PRD §10 修订指令完成 |
| RFC | ✅ 已发 Discussions（06-12），开放至少 1 周 → **~06-19 收口** |
| 后端开发规范基线 1.0 | ✅ `.trellis/spec/backend/` |
| v7 代码 | ❌ 0 行（`webnovel-writer/` 目录是 v6 遗产，冻结） |
| PRD 开放问题 | O2（开关定名）、O3（灵感池落点）已被 spec 0.6 消解；**O4（精准读取接口完整清单 + `.cache` 表设计）归 M1 第一步** |

## 1. 排程原则

1. **RFC 开放期只做格式不敏感的地基**。RFC 意见可能改格式层（目录、front matter、条目格式），开放期内（至 ~06-19）不写依赖具体格式的代码；收口后格式层全速开工。
2. **依赖顺序**：格式库（读写+缓存重建）→ 写章流程脚本 → 状态机单入口 → AI 角色层 → 安装器 → 自动模式 → 迁移/导出。每层只依赖其左侧。
3. **验收前置**：beta 判据里的两条 CI（Windows 中文路径全链路、删 `.cache` 全量重建）分别在 M0、M1 就建起来，全程绿着往前走，不留到发布前补。
4. **每个里程碑出口判据可验证**——对应 PRD §4 验收方式或 §7 发布判据的具体条目，不接受"做完了"。
5. 里程碑是依赖序不是严格串行：M4 的知识层平移（纯搬运 v6 资产）、M5 安装器骨架可与 M2/M3 并行。

## 2. 里程碑

### M0 仓库骨架（RFC 开放期内，立即可开）

格式无关，RFC 怎么改都不浪费。

- npm 包骨架：包名、`bin` 入口、`src/` 模块划分（安装器/状态机/机检/备料/定稿/缓存）——定稿后回填 `.trellis/spec/backend/directory-structure.md` §4 待补项
- 测试骨架：`node:test`，零第三方依赖纪律从第一行代码生效；测试目录与命名约定回填规范
- CI：Linux + Windows 双矩阵，Windows 跑**中文路径**用例（先空壳，用例随里程碑长）
- **出口**：CI 双平台绿；`node --version` 门槛检查（≥22）与人话提示可跑

### M1 格式层核心库 + 派生缓存（RFC 收口后第一批）

- **第一步消解 O4（设计文档，可在 RFC 开放期内先行起草）**：`.cache/index.db` 五表（chapters/threads/secrets/entities/fingerprints）DDL + 精准读取接口完整清单（spec 0.6 §11.1 初版清单的补全），成稿后补进 spec §11
- 容错读写库：front matter / 平铺 YAML / 三类条目文件 / book.yaml；未知字段保留原样写回（不变量 9）；写出防呆（平铺、块列表、危险值加引号）
- 重建器：只读 定稿/大纲/文风 全量重建缓存——**重建器即格式的参考实现**
- 精准读取接口 CLI 全套（条目/大纲/正文/时间线/设定/全文检索/报表）
- **出口**：「删光 `.cache` 全量重建」CI 绿（beta 判据之一提前达成）；精准读取清单逐条有测试

### M2 写章流程脚本面（零 AI 全通）

八阶段里"执行体=脚本"的部分（spec 0.6 §8 第 1/3/5/8 步）：

- 全书近况组装、备料（本章写作材料，默认精准片段）
- 机检全套可计数项：字数、禁词/禁句式、复读、高频意象统计、句式体检、新专名比对名册、front matter 格式、账本变动形式检查、信息差关键词候选（只出清单不拦截）
- 定稿原子 commit：正文入定稿、设定/时间线/名册更新、条目履历写入、章摘要落盘、工作区清空——要么完成要么原样保留
- **出口**：用手工伪造的草稿与细纲，一章从细纲走到定稿全程脚本可跑、零 AI 调用；定稿中断注入测试（断电模拟）后工作区原样保留

### M3 状态机单入口 + git 隐身全套

- git 健康检查（半提交/冲突/锁文件/损坏/网盘副本，各配自动修复或人话指引）
- 状态机 7 个态（spec 0.6 §10）：修复确认、建书引导、手改检测补登、断点续跑、卷复盘入口、体检入口、起草细纲
- "回到第 N 章"、影响分析脚本、吃书流程
- **出口**：7 个态各有端到端测试；构造 git 异常样本库逐个演练，作者可见输出零英文堆栈

### M4 AI 角色层 + 一级宿主壳（可与 M2/M3 部分并行）

- SKILL.md 入口、角色单源生成三平台壳 + drift check（multi-agent-spec v3.2）
- 三审任务书单源（读者审/编辑审/设定校对）、写评分离的上下文编排、降级模式（无 subagent 顺序执行，如实声明）
- SessionStart 注入（读 `books.jsonl`）；无 hook 宿主状态机入口等价路径
- 知识层平移：37 题材模板、追读力分类、爽点节奏库（纯搬运，可提前并行做)
- **出口**：Claude Code 与 Codex 各跑一次真模型 smoke——建书 → 写 1 章 → 三审 → 定稿

### M5 安装器与多本书

- `npx webnovel-writer init` / `update`：工作目录布局、平台壳按检测生成、模板哈希追踪、Node 版本人话提示
- `books.jsonl` 登记 + 换书对话 + 书单重建自愈；工作目录 `AGENTS.md` 公约数层（标记块管理）；书仓库指路 `AGENTS.md`
- **出口**：干净 Windows 中文用户名环境一条命令装出工作目录并建第一本书（CI + 手测各一）

### M6 自动模式（按批次定稿）

- `工作区/待定稿/` 批次结构、"定稿+待定稿批次"叠加组装视图
- 停止条件四件套（写满/体检不过线/卷纲耗尽/连续 3 章无账本变动）
- 批量审稿、作者敲定后逐章按序定稿、整批回滚（"回到第 N 章"复用 M3）
- **出口**：PRD §4 #15 验收——自动模式端到端 + 注入错误的恢复演练（批内污染不出批次）

### M7 导出 + /migrate + beta 入口

- 干净导出（单章/范围/全书，去 front matter，落 `工作区/导出/`）
- `/migrate` 一次性脚本（PRD §10.3 映射表）+ 迁移报告 + 整体回退
- **出口**：进入 beta——用 v7 真实写一本书到 50 章（建书→日更→吃书→卷复盘全覆盖）；`/migrate` 在 ≥3 个真实 v6 项目跑通是 7.0.0 判据，beta 期内完成

## 3. RFC 收口（~06-19，硬节点）

1. 汇总 Discussions 意见，逐条给处置（接受/改造接受/说明理由不接受）——回复全程大白话。
2. 接受的意见：先修 PRD/spec（0.6 → 0.7，走任务流程），再动代码——文档先行是铁律。
3. 收口前 issue 区与 Discussions 的提问保持及时回复。
4. 收口后 M1 格式层代码开闸。

## 4. 与发布判据的对应

| PRD §7 判据 | 路线图归属 |
|---|---|
| 发 RFC | ✅ 已达成（06-12） |
| beta：真写一本书到 50 章 | M7 出口后启动 |
| beta：Windows 中文路径全链路 CI 绿 | M0 建、M5 补全链路 |
| beta：删 `.cache` 全量重建 CI 绿 | M1 出口 |
| 7.0.0：`/migrate` ≥3 真实项目 + 无数据丢失级 bug | M7 + beta 期 |

## 5. 下一个可立即开工的任务

1. **M0 仓库骨架**（今天可起）：格式无关，不等 RFC。
2. **O4 设计文档**（与 M0 并行）：表 DDL + 精准读取接口清单，纸面工作，RFC 改格式时修订成本低。
3. RFC 意见跟进（持续，到 06-19 收口）。