webnovel-writer/.trellis/tasks/archive/2026-07/07-02-v7-boundary-doc-backfill/prd.md

v7 边界回顾文档回填：格式裁决与里程碑认领

来源：2026-07-02 设计边界回顾（对话裁决，作者已逐项确认）。13 项发现中的文档类修订全部归本任务；代码类修订归后续「边界收口」任务，以本任务落定的文本为依据。

Goal

把边界回顾中拍板的裁决写进四份法律/规划文本（story-repo-spec、v7-prd、multi-agent-spec、实施计划）与 backend 规范，消除"法律文本 ↔ 参考实现"漂移中该改文档的一侧，并给无主事项（体检、F1 CLI 缝）指定宿主里程碑。

Requirements

A. docs/architecture/story-repo-spec-2026-06-10.md（0.8 → 0.9）

• A1 §3 book.yaml 增字段 体检周期: 50（注释口径：手动模式每 N 章体检；连写时体检随批次）。现状代码已读此字段（state-machine/index.js），属规范缺位。
• A2 收卷声明制（消解"卷末章如何判定"的规范真空，替代代码现行的 章号 % 卷规模 整除启发式）：
  • §4.1 章 front matter 增可选字段 收卷: 是（仅卷末章写；由定稿步骤写出）。
  • §7 细纲"本章提案"段说明：AI 可依据卷纲进度与卷规模参考值提议收卷，作者确认细纲即生效。
  • §10 序 4 判定改为"最新定稿章声明了收卷 → 卷复盘"；明确 卷规模 仅用于全书近况提示与 AI 提议参考，不参与状态机判定。
• A3 §10 序 0 钉死"源文件"清单：定稿/正文、三类条目、角色卡、信息差 的 front matter + book.yaml + 文风铁律 front matter + 名册表 + 时间线表。超出清单的文件不属序 0 扫描范围。
• A4 §10 序 3：细纲.md 计入"未完成流程"；补续跑映射表——仅细纲 → 出示细纲请作者过目后备料；+写作材料 → 写稿；+草稿 → 机检/两审；+审稿 → 等作者裁决。
• A5 §11 表清单五张 → 六张（补 entity_aliases），与 cache-design-2026-06-26.md、backend database-guidelines.md §2.4 对齐。
• A6 §2.2 依赖口径改为：运行时直接依赖仅 js-yaml（YAML 解析；序列化手写防呆；决策记录：M1 任务 design §8.1），其余零依赖，缓存用内置 node:sqlite。
• A7 §14 决策记录补 0.8 → 0.9 表（来源：2026-07-02 边界回顾），每条注明落点小节。
• A8 版本头与变更摘要更新为 0.9。

B. docs/architecture/v7-prd.md（1.0 → 1.1）

• B1 §5 非功能需求"零第三方依赖（node:sqlite）"改为与 A6 同口径。
• B2 文档头标注 1.1 修订（日期 + 一句修订说明），其余内容不动。

C. docs/architecture/multi-agent-adaptation-spec-2026-06-05.md（v3.4 → v3.5）

• C1 §6.1 目录图 roles/ 由三审（读者审/编辑审/设定校对）改为两审（事实审查/编辑审），与 §5.4 及 v7/roles/ 实态一致。
• C2 版本头更新 v3.5。

D. .trellis/spec/backend/

• D1 quality-guidelines.md §1.1 补"现行唯一例外：js-yaml（解析用；序列化手写），已经 PRD 1.1 修订确认"。
• D2 directory-structure.md §3.2 同步同一口径。

E. docs/architecture/v7-implementation-plan.md

• E1 新增体检里程碑（编号 M5.5，位于 M5 与 M6 之间，可与 M5 并行）：跨章高频意象统计、句式体检（句长方差/段落分布/高频开头）、文体指纹提取与基线对比（激活 report-style-drift）、状态机序 5 接通、备料"反复读清单"接通（吃高频意象 top-N）。出口判据：PRD §4 #9/#11 的验收方式可跑。注明硬依赖：M6 停止条件"体检不过线"依赖本里程碑。
• E2 M5 范围补 F1 CLI 缝清单：next --json（输出完整 DTO；人读 message 保留）、review-input <章号>、save-review <章号> --file=、persist-outline / persist-book / persist-volume-review / persist-repair、finalize <章号> --payload=。JSON 一律走 --file 不走 stdin（Windows 中文管道编码雷区）。注明"next 不输出 DTO"属 F1 范围。
• E3 §0 现状盘点补一行：2026-07-02 边界回顾 13 项——文档侧本任务收口，代码侧另立「边界收口」任务（M5 前置）。

Constraints

• 全中文；作者界面词汇遵守 PRD §8 命名四原则，不引入新机器味。
• 每处修订标注决策出处（2026-07-02 边界回顾）。
• 收卷声明制是补未定义机制（spec §10 原文"刚定稿的章是卷末章"未定义判定方式），不推翻 RFC 公示结论。
• 不动任何代码与测试（v7/ 目录零改动）；不动 README。

Acceptance Criteria

• AC1 五组文件（A–E）逐项修订到位，版本号与变更记录同步更新。
• AC2 收卷声明制在 spec 内自洽：§4.1 字段、§7 细纲、§10 序 4 三处口径一致、互相引用。
• AC3 js-yaml 口径三处（story-spec §2.2 / PRD §5 / backend §1.1+§3.2）同口径："运行时直接依赖仅 js-yaml"。
• AC4 spec §11 表清单与 cache-design、database-guidelines 一致（六表）。
• AC5 git diff --stat 确认改动仅落在 docs/architecture/ 与 .trellis/spec/backend/。

Out of Scope

• 全部代码改动（格式对齐、状态机判定、机检/备料/ReviewInput 补料）→ 后续「边界收口」任务。
• 体检本身与 F1 CLI 命令的实现（分别归 M5.5 / M5）。