صفحهٔ اصلی گشت‌و‌گذار راهنما
ثبت نام ورود
haiany
/
webnovel-writer
mirrorاز https://github.com/lingfengQAQ/webnovel-writer.git
1
0
انشعاب 0
پرونده‌ها مشکلات 0 ویکی
شاخه: v7
شاخه‌ها تگ‌ها
webnovel-writer
/
docs
/
architecture
/
v7-implementation-plan.md

v7-implementation-plan.md 7.7 KB
لینک دائمی تاريخچه خام

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 收口）。