webnovel-writer v7 产品需求文档（PRD）

状态：1.0（作者逐项确认，2026-06-12 定稿）日期：2026-06-12 读者：①开发实施者（含 AI）；②issue 区用户（RFC 母本，裁剪时换大白话）地位：本 PRD 是 v7 的产品法律文本。spec 0.5 的"冻结"已解除——本 PRD 先行，story-repo-spec 与 multi-agent-adaptation-spec 随本文档修订（修订指令见 §10）。上游：story-repo-spec 0.5、multi-agent-adaptation-spec v3.1、v7-design-discussion-notes、v6 issue 区（#58–#113）决策过程：.trellis/tasks/06-11-v7-prd-webnovel-writer/prd.md（20 条 ADR）

1. 背景与目标

1.1 一句话

为中文网文作者做一个开箱即用、全程中文、200 万字不崩的 AI 长篇创作系统：一本书是一个 git 仓库，AI 负责写和审，脚本负责数和记，作者只做三件事——确认细纲、审稿、拍创作决策。

1.2 为什么推翻 v6 重来

v6 的病根（issue 与代码互证）：

病根	证据
用 prompt 驱动确定性状态机，模型不遵守	#91、#66、#87/#76；385 行写章流程规范
派生状态（SQLite/投影）与作者手改冲突，无解	#100、#77、#63、#67、#70、#71、#89
Token/时间消耗失控（每章 3 subagent + 4 份 JSON + 多道 gate）	#58、#92、#106
安装门槛高（Python 依赖 + .env + RAG key）	#90、#103、#69
禁词表治不了 AI 味	#94
连写缺失/质量漂移	#79、#95、#74

核心教训：v6 信任流程、不信任模型和作者；v7 信任 markdown 和作者，把流程压到最薄。

1.3 继承与归零

继承：仓库/star/用户群/issue 区；37 个题材模板；追读力分类与爽点节奏知识库；审查维度；踩坑记录。
归零：Story System、SQLite 双库、RAG、Python runtime、8 个命令、Dashboard 常驻服务。
v6 留 master 分支只修致命 bug；v7 新 major + /migrate 一次性迁移。

1.4 产品原则（宪法级）

文件即真相：作者面对的一切状态都是中文 Markdown，可手改、可 git diff。系统检测手改并提议入账，永不报错拒绝。
脚本能做的归脚本，做不到的归 AI 语义判断——一定要分清楚。禁止用正则硬凑语义判断（一点用没有）；能数的不让模型估，能模型判的不打扰作者。
git 隐身铁律：作者永远不需要亲手敲 git 命令——真需要 git 操作时由 AI 代为运行；任何 git 异常都有人话修复流程。
可靠性来自自愈，不来自门禁：宁停勿崩；hook 语义是 ask 不是 deny（#113 教训）。
精准读取，非必要不全文读：所有数据文件都有"精准读到所需一段"的脚本命令；AI 默认读片段，不整文件读取（v6 token 失控的根治手段）。
作者界面零机器味：术语全部用网文圈原生词或大白话（§8 术语表）；财务/工程/数据库隐喻和自造精简词禁止出现在作者界面。
品味决策归人：定稿永远由作者敲定（没有"自动定稿"）；金句入库、文风规则入铁律，一律作者审核，不交给阈值或模型。

2. 用户画像与作者旅程

用户是中文网文作者，非工程师，Windows 为主力环境，目标体量 200 万字。三条旅程全部支持，主旅程是新书作者——它是产品定义本身；迁移作者第二；连写党是日常写作的一种模式而非独立门面。

2.1 主旅程：新书作者（从零到稳定日更）

① 安装        npx webnovel-writer init
              （检测 Node ≥22 与已装的 AI 工具，生成工作目录；缺 Node 时人话提示升级）
② 建书        打开 AI 工具说"开始写书"→ 引导式问答生成 book.yaml、总纲、第一卷卷纲
③ 写第一章    确认细纲（AI 拟，作者点头或改）→ AI 写稿 → 机检 → 三审 → 审稿 → 定稿
④ 日常        每次打开，AI 先报全书近况（写到哪、哪些伏笔悬了太久、连续几章钩子弱）
              → 继续写下一章，或说"改第 N 章""把这条感情线收了"
⑤ 卷末        卷复盘：伏笔清账、卷摘要、与作者对谈定下卷卷纲、伏笔机会扫描
⑥ 发布        一键导出干净正文（单章/范围/全书，去 front matter），贴到起点/番茄

体验底线：全程看不到 git、看不到报错堆栈、看不到英文术语；目录里只有定稿/大纲/文风/工作区四个中文文件夹。

2.2 旅程二：v6 迁移作者

① 引导        市场版插件页面与 README 指引：v7 换了安装方式 → 卸载市场版 → npx 安装
② 迁移        在工作目录说"迁移我的书"→ /migrate 一次性脚本（映射表见 §10.3）
③ 校对        迁移报告人话列出：迁了什么、哪些条目标了"迁移待校对"、建议先看哪
④ 继续写作    进入主旅程 ④

体验底线：迁移不丢任何一个字；v6 的伏笔/剧情线/追读账本全部有去处；失败可整体回退。

2.3 旅程三：连写党（自动模式）

① 前提        当前卷卷纲已确认（自动模式的控制边界——全自动 ≠ 无控制，是控制上移到大纲层）
② 开关        自动确认细纲 + 连写批次大小（默认与体检周期一致 8 章；开关中文名 spec 定稿时敲定）
③ 挂机        连写一个批次：草稿与预入账数据攒在工作区，**不定稿**；
              写后续章的材料从"定稿 + 待定稿批次"叠加组装（脚本提供）
④ 停止        批次写满 / 体检不过线 / 卷纲耗尽（绝不让模型裸奔编纲）
              + 连续 3 章（可配）无账本变动也停
⑤ 批量审稿    作者过一遍攒下的审稿单：整批接受 / 改某几章 / 从某章起打回重写
              （批内错误未定稿，直接改，影响最多波及一个批次）
⑥ 批量定稿    作者敲定后逐章按序定稿（原子性按章保留）→ 继续下一批次
              整批不要 → "回到第 N 章"（git 回滚的人话包装）
              已发布后才发现错误 → 影响分析 → 顺势圆（向后兼容；已发布不可改是铁律）

定稿永远需要作者敲定——系统没有任何不经作者确认就写入定稿区的路径（宪法级）。自动模式与手动模式的差异只是确认粒度：逐章 vs 按批次。

3. 系统形态

工作目录/                      ← AI 工具在这里启动；本身不是 git 仓库
├── AGENTS.md                  # 公约数层：没装插件的 AI 也能看懂这里是什么、入口在哪
├── .claude/  .codex/ …        # 各平台壳（按检测到的环境生成）
├── .webnovel/                 # 插件本体：Node 脚本、角色定义、版本与模板哈希清单
│   └── books.jsonl            # ★ 书目录登记：每行一本书（书名/目录/是否当前在写/最后打开）
├── 我的第一本书/               # 书仓库（独立 git 仓库）
└── 我的第二本书/               # 多本书共用一套安装

强制安装到工作目录（项目级），不支持用户级——所有用户目录结构一字不差，可诊断性优先于灵活性（v6 安装类 issue 半数根源是"装哪了/读的哪份"歧义）。
分发只走 npx（npx webnovel-writer init / update）。Claude Code 插件市场渠道放弃，市场版停在 v6 并指引新装法。
update 用模板哈希追踪：用户没改过的文件直接更新，改过的提示（Trellis 模式）。
当前书与书单由登记文件解析（.webnovel/books.jsonl，机器域，每行一本书：书名/目录/是否当前在写/最后打开）：
- SessionStart hook 注入上下文（Claude Code）：会话启动自动注入"当前在写哪本、共几本书、全书近况入口"；无 hook 宿主由状态机入口启动时读同一文件，行为等价——关键能力不得只存在于 hook 中。
- 换书 = 一句话让 AI 改登记（对话即编辑器）；作者不需要手编 jsonl。
- 自愈：登记文件缺失/损坏 → 扫描工作目录下含 book.yaml 的子目录重建书单（书单是可重建派生物），"当前在写"标记请作者选一次。
只支持从工作目录启动：各宿主只在启动目录自动加载 skills/配置（.claude/、.codex/ 都住工作目录），在书目录里启动插件根本不会加载。当前书一律由登记文件决定。脚本启动时校验当前目录含 .webnovel/，不是工作目录 → 人话提示"请从工作目录启动"。
运行时要求 Node ≥ 22（用内置 node:sqlite 实现缓存，零依赖承诺保住）；无 Python、无 pip、无 .env。

3.2 书仓库目录（spec 0.5 §2 修订版）

<书名>/
├── .git/  .gitignore  book.yaml
├── AGENTS.md                   # ★ 指路文件（建书时自动生成）：误在书目录启动 AI 工具 /
│                               #   单独 clone 时，指引回工作目录或 npx 重建
├── 定稿/                       # ── 审稿通过后的一切，只进不改 ──
│   ├── 正文/0152-北境的雪.md    # 正文 + 章信息 front matter（自包含档案）
│   ├── 设定/
│   │   ├── 角色/林晚.md
│   │   ├── 信息差/信息差-021-灭门真凶.md
│   │   ├── 世界观.md
│   │   ├── 时间线/第05卷.md     # ★ 按卷拆分（原单文件）
│   │   └── 名册.md
│   └── 摘要/                   # ★ 原「记忆/」
│       ├── 章摘要/0152.md
│       └── 卷摘要/第05卷.md
├── 大纲/                       # ── 作者意图，随时可改 ──
│   ├── 总纲.md
│   ├── 卷纲/第05卷.md          # 主线支线的推进写在这里，不另记账
│   ├── 伏笔/伏笔-031-灭门真凶.md  # ★ 账本三类（原「承诺/」大一统拆分）
│   ├── 悬念/悬念-008-神秘老者身份.md
│   └── 感情线/感情线-012-林晚主线.md
├── 文风/
│   ├── 文风铁律.md             # ★ 原「风格宪法.md」；含反和解标准段
│   └── 金句库/战斗.md …
├── 工作区/                     # ── 没定稿的一切，默认不进 git ──
│   ├── 细纲.md                 # ★ 原「决策卡.md」：全书近况+本章提案+要写到的事+备选
│   ├── 本章写作材料.md          # ★ 原「上下文包.md」
│   ├── 草稿-A.md
│   ├── 审稿.md                 # ★ 原「验收卡」
│   ├── 评审报告/
│   └── 导出/                   # ★ 新增：干净正文导出落点（不进 git）
└── .cache/index.db             # 唯一派生物，删了能全量重建（CI 验收项）

书仓库里零工程文件——作者打开文件夹只看到书。唯一显式例外是指路 AGENTS.md：误在书目录启动 AI 工具或单独 clone 时，它是唯一会被 AI 自动读到的求生通道。

3.3 账本：三类，统一引擎

有"开启→推进→收尾"生命周期的才进账本；引擎一套共用（每条一个文件、平铺 front matter、履历、"悬了太久"预警、定稿时入账；机器内部状态同构 open/advance/resolve/drop）：

类型	编号	生命周期动词	"悬了太久"默认阈值
伏笔	伏笔-031	埋下 → 推进 → 回收 / 放弃	紧（10 章量级）
悬念	悬念-008	设下 → 推进 → 揭晓 / 放弃	紧（10 章量级）
感情线	感情线-012	开启 → 推进 → 修成正果 / 无疾而终	宽（30 章量级）

条目编号一律用全称（伏笔-031，不是伏-031 或 P-031）——作者天天要念的编号必须是人话，不过度压缩；信息差同理（信息差-021）。

不进账本的（各归各位）：

爽点：不是账本条目，是知识层——v6 的追读力分类（危机钩/悬念钩/渴望钩/情绪钩/选择钩）、爽点与节奏知识库（压抑爆发/微反转补刀/黄金三章等，按题材有偏好和毒点）、37 个题材模板平移继承，喂给细纲（按题材推荐本章钩子类型/情绪定位/爽点节拍）和三审读者审。
钩子、情绪定位：每章属性，住章节 front matter（本章钩子类型与强弱、情绪定位：压抑/铺垫/小爽/大爽/转折）。
剧情线（主线/支线）：推进本来就是总纲/卷纲正文内容，再开一类账=重复记账。
冲突、立旗：不设类（冲突每章都有；立旗是黑话直译，归悬念或爽点知识）。
"装逼打脸蓄积了多少章"：信息差的派生报表（数据源就是"谁还不知道主角的底牌"），不需要独立机制。

账本态度："悬了太久"是提醒不是错误，有些伏笔收不了可以接受——系统不逼作者填所有坑。

注：「账本」是开发侧词汇，仅用于本文档与 spec 内部指代这套机制；作者界面只出现伏笔/悬念/感情线三个具体名字，不出现"账本"二字。

3.4 写章流程（八阶段，spec 0.5 §8 修订版）

#	阶段	执行体	说明
1	起草细纲	脚本读全书近况 + AI 拟	生成 `工作区/细纲.md`；细纲声明本章定位（推进/过渡/日常）——过渡章合法，消除模型撒谎动机（替代 0.5 的"每章必须动一条承诺"硬门检与豁免机制）
2	确认细纲	作者	点头 / 改 / 选备选；自动模式可跳过
3	备料	脚本	组装 `工作区/本章写作材料.md`：全书近况+要写到的事+事实切片+信息差边界+近章结尾+反复读清单+文风锚点+反和解规则；默认用精准片段（当前卷+上一卷时间线、按编号取账本条目）
4	写稿	AI（干净上下文）	`工作区/草稿-*.md`；关键章 best-of-N
5	机检	脚本，零 token	只做可计数项：字数、禁词/禁句式、复读、高频意象统计、句式体检（句长方差/段落分布/高频开头）、新专名比对名册、front matter 格式、账本文件是否变动（只查形式）、信息差关键词命中（只出候选清单，不拦截）。不过关打回第 4 步，不打扰作者
6	三审	AI ×3（各自新鲜上下文）	读者审（爽不爽/哪段想划走，用追读力知识库的标准）、编辑审（结构与商业性）、设定校对（语义判断在这里：①"本章要写到的事"逐条核对正文写没写到；②机检的泄密候选是不是真泄密；③账本履历引用的章内证据是否属实）
7	审稿	作者	`工作区/审稿.md` = 草稿 + 三句话审意见 + 待确认新人名 + 章摘要（扫一眼可改）。动作：接受 / 改完接受 / 打回。手动模式逐章审；自动模式按批次审（§2.3）。定稿永远需要作者敲定，没有"自动定稿"
8	定稿	脚本，原子	一次 git commit：正文进定稿、设定/时间线/名册更新、账本各条目写入履历、章摘要存入 `定稿/摘要/`、工作区清空。要么完成要么原样保留，没有中间态

写评分离：写稿与三审必须在不同上下文中进行；机检先于 AI 审。

3.5 单入口状态机（spec 0.5 §10 修订版）

系统启动按序判定，命中即停。第 0 步之前加 git 健康检查：半提交/冲突/锁文件/.git 损坏/网盘冲突副本（"xxx (1).md"），每种配自动修复或人话指引——作者永远不直面 git 报错。

序	条件	下一步
0	任一源文件解析失败	修复确认（原"修复卡"）：定位到行、AI 提议保留意图的修复、作者确认；全角标点结构性错误直接预修复只报不问。永不带堆栈崩溃
1	定稿/大纲有未入账手改	提议补登（系统适应作者，不报错）
2	工作区有未完成流程	从中断的阶段继续
3	刚定稿的章是卷末章	卷复盘
4	章号到达体检周期	体检
5	其余	起草新章细纲

v6 的 8 个命令全部内化为以上状态；作者只需要一个入口和"继续"。

3.6 精准读取接口（新增，宪法级原则的落地）

每类数据文件的 spec 定义都附带"定位读取"脚本接口，例如：

读伏笔-031 的履历 / 读感情线-012 的当前状态
读第 5 卷卷纲的高潮节点 / 读总纲的结局承诺段
读 0152 章结尾 500 字 / 读第 148–152 章的章摘要
查"玄阶令牌"在全书的出现章（Grep 正文，正文本身就是无损数据库）

.cache/index.db 的表设计必须支撑这些查询；写作材料组装默认用精准片段。

4. 功能需求：问题空间 16 项的产品化映射

#	问题	解法	版本	验收方式
1	客观事实吃书（修为/资产/物品）	角色卡结构化字段增量记账，定稿时脚本更新	7.0	改 100 章前的设定，影响分析能列全受影响章
2	时间线混乱	每章强制时间锚点；时间线按卷拆分，append-only	7.0	从第 1 章起强制；体检报告时间线孤儿为零
3	信息差泄密	登记表（每条一文件：知情人/读者已知/关键词）+ 机检出候选 + 设定校对判真伪；写作材料注入出场人物知识边界	7.0	构造泄密样章，三审能逮住；误报不拦截流程
4	人设语气漂移	角色卡存典型对话原文 few-shot + 周期语气体检 + 遮名盲测	7.x（体检后置）	盲测准确率报告
5	摘要信息损耗	分层摘要（章≤200字/卷≤500字/全书骨架按需拼接、不落盘）+ Grep 正文管细节 + 账本即"人工标注的未来相关性"	7.0	写第 0153 章时，写作材料能召回第 12 章埋下、第 152 章推进的伏笔
6	大纲漂移	偏离是决策点不是 bug：细纲阶段给"拉回/改纲/进灵感池"三选	7.0	细纲模板含偏离报告段
7	改稿三档	未发布：直接改+自动重入账；已发布：只读，生成"顺势圆"方案；设定/大纲：影响分析出已发布/未发布两清单	7.0	三档各有端到端用例
8	AI 和解倾向毒害爽文	反和解规则入文风铁律标准段，随写作材料前置注入，按题材配浓度	7.0	题材模板含反和解预设；样章对比可感
9	桥段循环	高频意象统计（零 token 脚本，7.0）+ 桥段使用史"冷却中"清单（7.x）	7.0/7.x	"空气仿佛凝固"全书 47 次这类能被机检报出
10	情绪节奏失控	每章情绪定位入 front matter（7.0）+ 波形体检与平台预设周期（7.x）	7.0/7.x	体检报告含情绪波形图
11	AI 味	分布问题分层打：禁词表（第一层）+ 句式体检脚本（7.0）+ 文风锚定 few-shot（7.x）。诚实边界：承诺"读者不出戏"，不承诺过 AI 检测器	7.0/7.x	句式体检指标进体检报告
12	对话同质化	口癖卡 + 遮名盲测	7.x	盲测用例
13	诚实边界	README/RFC 明示承诺口径；合规/敏感词不进 v1	全程	文档口径一致
14	控制点滑杆	确认细纲/审稿两个开关；全关=逐章交互，全开=自动模式；一套实现	7.0	开关组合矩阵全测
15	连写质量漂移	按批次定稿（错误最多污染一个批次，且未定稿可直接改）+ 体检与批次对齐（默认 8 章）+ 停止条件（写满/体检不过线/卷纲耗尽/连续 3 章无账本变动）+ 已发布错误走顺势圆	7.0	自动模式端到端 + 注入错误的恢复演练
16	真源唯一	正文+摘要 markdown 即全部状态；`.cache` 删了全量重建	7.0	重建 CI（重建器即格式的参考实现）

5. 非功能需求

维度	要求
运行时	Node ≥ 22，零第三方依赖（`node:sqlite`）；安装器检测版本并人话提示
平台	Windows 中文环境一等公民：全链路 UTF-8 无 BOM、`core.quotepath false`、CI 含 Windows 中文路径全链路测试（建库→写章→定稿→重建缓存）
Token 成本	机检零 token；精准读取默认片段化；分层摘要控制长程上下文；每章 AI 调用次数有预算上限（实现时定数）
健壮性	永不带堆栈崩溃（修复确认兜底）；定稿原子性；git 健康检查；容错读取（未知字段保留原样写回）
可诊断性	强制项目级安装，目录结构全网统一；issue 里贴目录清单即可定位
防呆	系统写出的 YAML 一律平铺、块列表、危险值加引号；多条记录每条一文件
多宿主	格式层平台无关；SKILL.md 开放标准零适配；角色单源生成三平台壳 + drift check；降级诚实（不允许声称调用了不存在的能力）；hook 语义 ask 不 deny
许可证	MIT/Apache-2.0（v7 从零写）

6. 范围切分

切线原则：已设计完且实现成本低的进 7.0；需要新设计或调参的体检类全部 7.x。

v7.0（首发）

骨架：状态机单入口、写章流程八阶段（机检/三审新分工）、三类账本（声明制）、客观事实记账、时间线（按卷）、分层摘要、改稿三档、git 隐身全套（含健康检查与"回到第 N 章"）、精准读取接口
高呼声卖点：自动模式（连写，按批次定稿）、反和解规则、信息差登记（候选制泄密检查）
配套：npx 安装器（工作目录布局）+ update、/migrate、干净导出、AGENTS.md
文风层基础：文风铁律 + 禁词/句式机检 + 高频意象统计（v6 资产平移）；金句库目录与手动放入
宿主：一级（Claude Code + Codex），亲测过 smoke

v7.x（增量）

金句库自动收割（候选制：作者改写且字数相近才候选，净删减不算；对话触发：作者聊天中夸某段也触发；最终一律作者审核入库）
按需静态简报（单文件 HTML，内联样式无外链无服务器；账本全貌、体检统计与情绪波形、时间线浏览——"全书近况"管对话里的决策瞬间，浏览级信息归简报）
文风锚定（对标作者 few-shot）、桥段冷却清单、语气盲测、情绪波形、口癖卡
多宿主二级平台（Gemini CLI / Cursor，社区反馈确认）

不做（封死）

RAG/向量库（语义检索=可选插件，永不做事实召回主路径）、常驻服务、敏感词/合规、AI 检测器承诺
大一统 YAML 数据文件、事件级 witnesses 投影、自建提交链、模型自由评"文笔好坏"、模型裸奔编纲
术语禁用词 CI 检查（术语一致性靠自审与评审把关，不上机器）

7. 发布判据

阶段	过线标准
发 RFC	本 PRD 定稿；术语表/目录图/三条作者旅程齐；RFC 以大白话裁剪发 GitHub Discussions（需先开启 Discussions，issue 区发置顶指引），征求意见至少开放 1 周
beta	用 v7 真实写一本书到 50 章（自用验证，覆盖建书→日更→吃书→卷复盘）；Windows 中文路径全链路 CI 绿；"删光 .cache 全量重建" CI 绿
7.0.0	`/migrate` 在 ≥3 个真实 v6 项目跑通；beta 期无数据丢失级 bug；迁移指引文档齐

8. 术语表（作者界面词汇的法律文本）

命名四原则：①网文圈原生词优先；②圈内没有的用自然大白话；③财务/工程/数据库隐喻禁止出现在作者界面；④不自造两字精简词——宁可用自然的长短语。

spec 0.5 旧词	v7 定名	备注
承诺（P-031）	账本拆三类：伏笔（伏笔-031）/ 悬念（悬念-008）/ 感情线（感情线-012）	各用各的生命周期动词（埋下→回收 / 设下→揭晓 / 开启→修成正果）；编号一律全称
节奏债	"悬了太久"预警	是提醒不是错误
retcon 事务	吃书（吃书-87）	commit 前缀仍 retcon（机器域）
settle / 结转	定稿（动词）	与 `定稿/` 目录一致
章事务	写章流程
盘面	全书近况
上下文包	本章写作材料
合同	本章要写到的事
镜头评审	三审（读者审/编辑审/设定校对）	出版业原生词
棘轮	删除该比喻	直接说"定稿前/定稿后"
风格宪法	文风铁律
决策卡	取消"卡"概念：环节叫"确认细纲"，文件 `工作区/细纲.md`	AI 拟细纲→作者点头或改
验收（卡）	审稿，文件 `工作区/审稿.md`
修复卡	修复确认
定稿/记忆/	定稿/摘要/	"记忆"是 AI 视角词
信息差/时间线/名册/金句库/体检/钩子/强弱钩	保留	原生或大白话

机器协议不动（机器域，作者看不到）：commit 前缀 ch/vol/retcon/fix、book.yaml、spec_version、.cache 表名。条目编号全部中文全称（伏笔-031/悬念-008/感情线-012/信息差-021，原 P-031/S-021 废止）——编号是作者天天要念的，必须是人话且不过度压缩。

9. 风险与开放问题

风险	控制
三审每章 3 次 AI 调用，弱模型宿主上质量参差	三审任务书单源；设定校对给的是核对清单不是开放问题；降级模式（无 subagent 顺序执行）如实声明
自动模式错误连锁	按批次定稿——错误不经作者审稿不入定稿，污染上限一个批次且未定稿可直接改；已发布后的错误走影响分析+顺势圆
中文路径在小众平台/工具链上出幺蛾子	CI 全链路 + 一级宿主 smoke；问题平台降级到二三级，不硬保
Node 22 普及度	安装器人话提示升级；22 已是 LTS，写手装最新版无历史包袱
Codex skill 列表 8k 字符预算	description 精简纪律 + validator 检查
金句库 few-shot 注入旧文加重自我重复	7.x 才做自动收割；候选制+作者审核；按场景分文件轮换

开放问题（不阻塞 RFC，spec 修订时解决）：

[O2] 自动模式开关的中文定名（"自动确认细纲"+"连写批次大小"候选）。
[O3] 灵感池（偏离大纲的素材去向）的文件落点——大纲/灵感池.md 候选。
[O4] 精准读取接口的完整清单与 .cache 表设计（实现 spec 定）。

（已消解，均为作者 2026-06-12 拍板：编号体系→全称中文编号；攒批审稿落点→按批次定稿后问题不复存在；多本书切换→.webnovel/books.jsonl 登记 + hook 注入；启动点→只支持工作目录启动；O1 书仓库自描述→根部指路 AGENTS.md。）---

10. spec 修订指令清单（本 PRD 对两份 spec 的下行要求）

10.1 story-repo-spec 0.5 → 0.6

§0/§1：删"棘轮"比喻；不变量补三条——git 隐身铁律、精准读取、"脚本/AI 语义分界"。
§2：目录按 §3.2 修订（账本三目录、摘要/、时间线按卷、细纲/审稿/导出、工作区文件改名）；条目编号改中文全称（"编号保留 ASCII"条款废止）；新增"工作目录 ⊃ 书目录"安装布局、书目录登记（.webnovel/books.jsonl）、启动点限制（只支持从工作目录启动——宿主只在启动目录加载 skills/配置；脚本校验 cwd 含 .webnovel/，否则人话提示）。
§2.1：Node ≥ 22，node:sqlite。
§3 book.yaml：删除"自动验收"开关（定稿永远归作者），新增"连写批次大小"（默认与体检周期一致）；开关中文名随术语表（O2）；新增分类型"悬了太久"阈值。
§5：大一统"承诺"拆三类账本；"每章必须结转"硬门检改声明制（细纲声明本章定位）；履历行必须引用章内证据；删豁免机制。
§6.1 改名文风铁律；§6.2 金句库 7.0 仅目录+手动，自动收割条款移入 7.x 附录（候选制+对话触发+作者审核）。
§7 决策卡 → 细纲.md，固定段落改为：全书近况 / 本章提案与定位声明 / 本章要写到的事 / 备选。
§8：第 5 步机检删"合同断言比对"（移三审设定校对）、信息差扫描改"只出候选"；第 6 步三审职责按 §3.4 重写。§8.1 整节重写：删除"自动验收过线即 settle"——定稿永远由作者敲定；自动模式改为按批次定稿（批内草稿与预入账数据攒工作区、写作材料组装支持"定稿+待定稿批次"叠加视图、批量审稿、作者敲定后逐章按序定稿）；停止条件增加"连续 3 章无账本变动即停"。
§9：retcon 作者界面叫吃书；新增影响分析脚本、"回到第 N 章"命令、顺势圆主路径。
§10：第 0 步前加 git 健康检查；修复卡→修复确认。
§11：表设计须支撑精准读取接口（O4）。
§4.1 章节 front matter：字段名随术语表与账本三类改写（开启/推进/兑付承诺 → 分类型的埋下/推进/回收等；"合同"→"本章要写到的事"）；新增章属性字段：钩子类型与强弱、情绪定位（压抑/铺垫/小爽/大爽/转折）。
新增"建书"入口：状态机目前假设书已存在，需补"无书/空仓库"态——引导式问答生成 book.yaml、总纲、第一卷卷纲（主旅程 §2.1 ② 的依据）；建书时同步生成书仓库根部指路 AGENTS.md（误启动/单独 clone 的指引）并登记进 books.jsonl。
§12 迁移映射更新：foreshadowing→伏笔、plot_threads→并入卷纲（不进账本）、chase_debt/reading_power→知识层与章属性；新增"市场版插件卸载+npx 重装"引导。
新增章节：干净导出命令、精准读取接口。

10.2 multi-agent-adaptation-spec v3.1 → v3.2

§8 安装器重写：工作目录布局、强制项目级、npx init/update、模板哈希追踪、Node 版本检测、书目录登记初始化（建书时写入 .webnovel/books.jsonl）。
§5.5 hook 条款扩充：SessionStart 注入"当前在写哪本/书单/全书近况入口"（读 books.jsonl）；无 hook 宿主由状态机入口读同一文件，行为等价。
新增 AGENTS.md 公约数层条款（工作目录根部， 标记块管理）。
吸收 Trellis 调研：共享模板 + 平台上下文/条件块编译降级路径（降级在安装时定稿，不靠运行时判断）。
删除 §5.2 中插件市场相关表述（.claude-plugin/ 仅作为 v6 遗留说明）。

10.3 迁移映射（v6 → v7，更新版）

v6	v7
`正文/`	`定稿/正文/`（补 front matter，"要写到的事"标"迁移"）
`设定集/`	`定稿/设定/`
`大纲/`	`大纲/总纲.md`、`大纲/卷纲/`
foreshadowing	`大纲/伏笔/` 逐条成文件
plot_threads	并入卷纲正文（不进账本）
chase_debt / reading_power	知识层与章属性（不进账本）
`.webnovel/state.json`	一次性展开进 `定稿/设定/`
`summaries/`	`定稿/摘要/`
project_memory patterns / scratchpad	`文风/文风铁律.md`（人工过一遍再入）
`.story-system/` 提交链	压成初始 commit，原目录只读归档
index.db / vectors.db / projection_log	删除（缓存重建；向量为可选插件）
references（题材模板/追读力/爽点节奏）	知识层平移继承

11. 验收清单（PRD 自身）

三条作者旅程完整（安装→建书/迁移→日常写作→卷复盘→发布）
问题空间 16 项每项有归属（7.0 / 7.x / 不做）与验收方式
发布判据可执行（每阶段有可验证的过线条件）
RFC 可从本 PRD 直接裁剪产出（§1.1、§2、§3.2、§6、§8 为裁剪主体）
spec 修订指令完整（两份 spec 的每处冲突都有下行指令）

v7-prd.md 32 KB

Historia Czysty

webnovel-writer v7 产品需求文档（PRD）

1. 背景与目标

1.1 一句话

1.2 为什么推翻 v6 重来

1.3 继承与归零

1.4 产品原则（宪法级）

2. 用户画像与作者旅程

2.1 主旅程：新书作者（从零到稳定日更）

2.2 旅程二：v6 迁移作者

2.3 旅程三：连写党（自动模式）

3. 系统形态

3.1 安装布局：工作目录 ⊃ 书目录

3.2 书仓库目录（spec 0.5 §2 修订版）

3.3 账本：三类，统一引擎

3.4 写章流程（八阶段，spec 0.5 §8 修订版）

3.5 单入口状态机（spec 0.5 §10 修订版）

3.6 精准读取接口（新增，宪法级原则的落地）

4. 功能需求：问题空间 16 项的产品化映射

5. 非功能需求

6. 范围切分

v7.0（首发）

v7.x（增量）

不做（封死）

7. 发布判据

8. 术语表（作者界面词汇的法律文本）

9. 风险与开放问题

10. spec 修订指令清单（本 PRD 对两份 spec 的下行要求）

10.1 story-repo-spec 0.5 → 0.6

10.2 multi-agent-adaptation-spec v3.1 → v3.2

10.3 迁移映射（v6 → v7，更新版）

11. 验收清单（PRD 自身）

v7-prd.md 32 KB Historia Czysty

webnovel-writer v7 产品需求文档（PRD）

1. 背景与目标

1.1 一句话

1.2 为什么推翻 v6 重来

1.3 继承与归零

1.4 产品原则（宪法级）

2. 用户画像与作者旅程

2.1 主旅程：新书作者（从零到稳定日更）

2.2 旅程二：v6 迁移作者

2.3 旅程三：连写党（自动模式）

3. 系统形态

3.1 安装布局：工作目录 ⊃ 书目录

3.2 书仓库目录（spec 0.5 §2 修订版）

3.3 账本：三类，统一引擎

3.4 写章流程（八阶段，spec 0.5 §8 修订版）

3.5 单入口状态机（spec 0.5 §10 修订版）

3.6 精准读取接口（新增，宪法级原则的落地）

4. 功能需求：问题空间 16 项的产品化映射

5. 非功能需求

6. 范围切分

v7.0（首发）

v7.x（增量）

不做（封死）

7. 发布判据

8. 术语表（作者界面词汇的法律文本）

9. 风险与开放问题

10. spec 修订指令清单（本 PRD 对两份 spec 的下行要求）

10.1 story-repo-spec 0.5 → 0.6

10.2 multi-agent-adaptation-spec v3.1 → v3.2

10.3 迁移映射（v6 → v7，更新版）

11. 验收清单（PRD 自身）

v7-prd.md 32 KB

Historia Czysty