docs(plan): v7 实施计划草案 0.1——七里程碑路线图与 RFC 收口排程

依据 PRD 1.0 §6/§7 与 spec 0.6 切分 M0-M7：RFC 开放期内只做格式
不敏感地基（M0 骨架 + O4 设计），~06-19 收口后格式层开闸；两条
beta 判据 CI 前置到 M0/M1。状态：草案，待作者确认。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

.trellis/tasks/06-13-v7-roadmap/check.jsonl

@@ -0,0 +1,2 @@
+{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}
+{"file": "docs/architecture/story-repo-spec-2026-06-10.md", "reason": "里程碑范围须与格式 spec 对齐"}

.trellis/tasks/06-13-v7-roadmap/implement.jsonl

@@ -0,0 +1,2 @@
+{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}
+{"file": "docs/architecture/v7-prd.md", "reason": "排程范围与发布判据真源"}

.trellis/tasks/06-13-v7-roadmap/prd.md

@@ -0,0 +1,20 @@
+# v7 实施计划：里程碑路线图
+
+> 需求真源：PRD 1.0 §6（范围切分）、§7（发布判据）；story-repo-spec 0.6；multi-agent-adaptation-spec v3.2；后端规范基线 1.0。
+> 背景：四份文档全部定稿，RFC 已于 2026-06-12 发 Discussions（开放至少一周），v7 代码 0 行。需要一份把 PRD 范围变成可执行任务序列的路线图。
+
+## Requirements
+
+- 里程碑切分覆盖 PRD §6 v7.0 全部范围，每个里程碑有明确出口判据（可验证，不是"做完了"）。
+- 排程尊重两个约束：
+  1. RFC 开放期（至 ~06-19）格式层可能被意见改动——开放期内只做格式不敏感的地基。
+  2. 依赖顺序：格式库 → 流程脚本 → 状态机 → AI 角色层 → 安装器 → 自动模式 → 迁移/导出。
+- 消解 PRD 开放问题 O4 的落点要在路线图里有明确归属（O2/O3 已被 spec 0.6 消解）。
+- beta 判据中的两条 CI（Windows 中文路径、删缓存重建）必须前置到最早可建的里程碑，不留到最后。
+- 文档落点：`docs/architecture/v7-implementation-plan.md`，开发侧文档，状态标"草案，待作者确认"。
+
+## Definition of Done
+
+- 路线图文档提交到 v7 分支。
+- 每个里程碑：范围（对应 PRD/spec 小节）、出口判据、与发布判据的对应关系。
+- 列出"下一个可立即开工的任务"。

.trellis/tasks/06-13-v7-roadmap/task.json

@@ -0,0 +1,26 @@
+{
+  "id": "v7-roadmap",
+  "name": "v7-roadmap",
+  "title": "v7 实施计划：里程碑路线图",
+  "description": "PRD 1.0 与 spec 0.6/v3.2 定稿后的实施排程：里程碑切分、依赖顺序、RFC 收口动作",
+  "status": "in_progress",
+  "dev_type": null,
+  "scope": null,
+  "package": null,
+  "priority": "P1",
+  "creator": "claude",
+  "assignee": "claude",
+  "createdAt": "2026-06-13",
+  "completedAt": null,
+  "branch": null,
+  "base_branch": "v7",
+  "worktree_path": null,
+  "commit": null,
+  "pr_url": null,
+  "subtasks": [],
+  "children": [],
+  "parent": null,
+  "relatedFiles": [],
+  "notes": "",
+  "meta": {}
+}

docs/architecture/v7-implementation-plan.md

@@ -0,0 +1,111 @@
+# 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 收口）。