zizi-al/muse-agent-example
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

框架: 前期创作流程SSOT——五阶段流程+设定闭环/卷数/范式绑定三决策

Browse Source 
把"前期准备"立成正式流程 SSOT，并填三个架构空白（独立子代理形而上四维审查通过后提交）：
- 05-创作流程领域 §1A 前期创作阶段：定盘→大纲/卷纲→设定拆条→范式文风→细纲五阶段，
  每阶段进入/退出/门禁，区分代码硬门禁与文档纪律；归属收编卷纲/设定拆条/装配assembly/
  范式绑定四个既成事实；现状与待建已对齐代码（取数端+生产接线已建、结构化文风画像等待建）。
- 02-实体领域 §8 决策：设定全书闭环校验+全书设定台账（演变历程从只追加日志升级为闭环义务，
  设定×章消费矩阵从库表机械重算，与 canon_compliance 一致性正交）。
- 01-作品领域 §6 决策：分卷数合同（novel_work.篇幅目标 增分卷数，outline 分卷粗纲卷数须一致机械校验）。
- 03-范式领域 §6 决策：规划期绑定（pattern_bindings 合同；实验仓以已确认 assembly 行承载，
  作品行承载列为主仓方向；消费侧取数端+生产接线已建）。
- _index.md 协作关系登记同步。
This commit is contained in:
zizi 2026-08-02 02:17:30 +08:00
parent 952485a506
commit cfa46e6e7a
5 changed files with 263 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
.agent/docs/architecture/domains/01-作品领域.md
View File

@ -53,12 +53,46 @@
## 5. 规划与状态
- 规划（总纲、卷纲、章级细纲）候选先落库为待审候选，用户确认后才入库成为正式规划。
- 分卷数合同：`novel_work.篇幅目标.分卷数` 是规划承诺，大纲分卷粗纲的卷数须与之一致并经机械校验，见 §6。
- 进度状态在库内记录下一步、伏笔承接和阶段目标，不复制正文可推导的统计。
- 叙事状态在库内只保存作品级状态或对实体状态的引用；人物、地点、事件等详细事实由实体领域拥有。
- 章数、字数、前沿等派生量机械计算，不入库做手工镜像。
- 用户接受正文不自动确认知识或实体变化。正文保存后可以异步生成实体草稿，仍需确认。
## 6. 生命周期
## 6. 设计决策：分卷数合同
### 背景
`novel_work.篇幅目标` 当前只有目标章数与单章字数区间，没有分卷数。`outline`（scope=work）的分卷粗纲按卷承载骨架，其卷数就是「本作计划分几卷」的结构计数，却没有上层承诺可对齐：规划期可以静默增减卷，续写可以提前收线或无限膨胀，机械门也没有依据拦截。卷数本应在定盘阶段拍定、由大纲/卷纲阶段遵守，需要把它挂进篇幅目标，使上层约束下层（篇幅目标 → 大纲分卷派生）。
### 选项
| 选项 | 做法 | 取舍 |
|---|---|---|
| A. 分卷数入篇幅目标 + 卷数一致性机械校验 | 篇幅目标增「分卷数」作为规划承诺；分卷粗纲卷数必须等于篇幅目标.分卷数，规划确认前机械校验 | 卷数成为硬合同，规划期即拦截不一致；代价是改卷须先改篇幅目标 |
| B. 卷数只由大纲自带，篇幅目标不记承诺 | 分卷粗纲卷数即事实，不向篇幅目标回写 | 省一个字段；但卷数无上层承诺，改卷无门禁，续写可静默增减卷 |
| C. 卷数做派生量，从大纲回算进篇幅目标 | 篇幅目标.分卷数 = count(分卷粗纲)，机械镜像 | 违反「派生量不手工镜像」原则（§3）；承诺与回算混淆，规划期无法先于大纲定卷数 |
### 结论
选 A。
**① 篇幅目标.分卷数 字段合同。** 含义：本作计划划分的卷数，定盘阶段由用户拍定的规划承诺。与目标章数、单章字数区间三者共同构成篇幅目标——目标章数定总量、单章字数区间定每章尺度、分卷数定分册骨架；三者须自洽，分卷数不得大于目标章数。aiContext 用途：随篇幅目标走 `aiContext: [planning]`，只在规划期（大纲/卷纲）进生成上下文约束 planner 分卷，写作期不注入。性质：规划承诺，不是回算量。
**② 分卷粗纲卷数一致性机械校验。** 规则：`outline`（scope=work）的分卷粗纲条目数必须等于 `novel_work.篇幅目标.分卷数`。校验时机：规划候选落库为待审（Shadow）之后、用户确认翻 confirmed 之前的机械门，即大纲/卷纲阶段的出门门禁。失败关闭：不一致时该规划候选不得翻 confirmed、不得进生成上下文，明确失败关闭——不静默放行、不自动改数，由用户回到篇幅目标或分卷粗纲修正后重跑；改卷必须先改篇幅目标.分卷数，再让分卷粗纲对齐。归属：校验是确定性机械门、不调模型，门禁编排归 [05-创作流程领域](05-创作流程领域.md)，合同本身（比什么、何时比、失败关什么）归本领域。
**③ 承诺量与回算量边界。** 规划承诺（人定、稳定合同、写进篇幅目标）：目标章数、单章字数区间、分卷数，三者都在规划期拍定，不随正文增长自动变。回算量（机械重算、绝不手工镜像、不进篇幅目标）：已确认章数、总字数，从库内正式正文机械计算（§3）。分卷粗纲卷数既不是独立承诺也不是回算量，而是结构计数，是 ② 校验的对象，本身不由正文派生。一句话：卷数与目标章数是「计划要多少」的承诺，已确认章数与总字数是「实际写了多少」的回算，两类不互相镜像。
### 后果
- 篇幅目标成为三要素合同，定盘阶段「篇幅目标三要素齐全」门禁有了字段支撑。
- 卷数变更受控：任何加减卷都必须先动篇幅目标.分卷数并让分卷粗纲对齐，机械门在规划期拦截，续写不再能静默提前收线或无限加卷。
- 上层约束下层成立：篇幅目标（定盘）派生约束大纲分卷（卷纲），与既有规划派生关系一致。
- 横切总闸不变：分卷粗纲作为规划候选仍先落 Shadow，校验通过且用户确认后才翻 confirmed 进生成上下文。
> 现状标注：`novel_work.篇幅目标` 说明当前为「目标章数与单章字数区间」，分卷数字段及对应库列、outline 卷数一致性机械门为目标合同，schema 与机械门实施由主会话承接，本领域只定合同。
## 7. 生命周期
```text
draft -> writing -> paused -> writing -> completed
@ -68,11 +102,11 @@ draft -> writing -> paused -> writing -> completed
> 注：本生命周期用 `draft/writing/paused/completed`，而部分 schema 用“筹备/连载/完结”，两套状态词待对齐。
## 7. 可恢复性
## 8. 可恢复性
作品的可恢复性（数据库备份、快照、可重建脚本，配合 Git 里的代码与 DDL 从零重建库结构）见 [08-数据权威与可视化领域](08-数据权威与可视化领域.md)。
## 8. 验收条件
## 9. 验收条件
1. 一部作品的身份、规划、正式正文、用户决策都能从 `muse-example` 库查出，不依赖任何文件。
2. 库内正式正文与待审候选隔离：候选不被当作正式正文返回；丢弃候选后，正式正文逐字节不变。
@ -81,8 +115,9 @@ draft -> writing -> paused -> writing -> completed
5. 接受/合并校验（候选版本、正文哈希、正式正文 revision、来源状态）任一失败时，库内正式正文不发生写入。
6. 作品的每个输入产出都已落库，只读看板能据此渲染出作品全貌，不读取任何库外数据。
7. `reviews`、`experiments`、`runs` 不在作品领域重复定义结果 schema 或终态。
8. `outline`（scope=work）的分卷粗纲卷数与 `novel_work.篇幅目标.分卷数` 一致；不一致的规划候选不能翻 confirmed、不进生成上下文。
## 9. 关联 SoT
## 10. 关联 SoT
- 领域总览与横切合同：[领域设计索引](_index.md)
- 实体事实：[02-实体领域](02-实体领域.md)

78
.agent/docs/architecture/domains/02-实体领域.md
View File

@ -85,7 +85,71 @@
> 现状标注：叙事时态目前用“演变历程”的双层模型表达（一条当前态加一条演变记录），与设计里的 `valid_from / valid_to_chapter` 章区间并存。**两套时态表示待对齐**，对齐前两者都承认、以库内实际为准。
## 8. 检索
## 8. 设计决策：设定全书闭环与台账
### 背景
演变历程 `{章, 台阶, 周期}` 的字段合同在 `meta/schemas/` 与 [专题-06](../../../../../design-docs/专题-06-元数据驱动的智能体架构.md) §4.5，三期消费语义（规划/检测/写作）在 [专题-07](../../../../../design-docs/专题-07-知识消费契约与质量闭环.md) §5。现状合同里它是**只追加的已发生日志**：一条一台阶、只追加不覆写。由此留下两个无主缺口：
- **只记已发生、不约束未来**：台阶只记到 登场/成长/高光/退场，“这条设定最终去哪”没有结构义务。角色有没有结局、力量体系如何退场，全靠作者记忆——升级线崩、线索太监、续写提前收线，都没有机械门禁提前拦。
- **没有全书视角**：哪条设定被哪几章消费过、哪些从没被碰、哪些还没收口，只能靠人判断，不能机械计算。
检测维度 `canon_compliance`（[专题-04](../../../../../design-docs/专题-04-生成质量门控与创作健康度设计方案.md)）只查候选是否与已立正式事实矛盾（**一致性**）；它不查设定自身是否有始有终、被消费、被收口（**完整性**）。完整性目前无 owner。
### 选项
| 选项 | 做法 | 为何不选/选 |
|---|---|---|
| A. 维持只追加日志，闭环靠人工 | 演变历程不动，全书闭环靠人记忆与人工审计 | 不选：不可机械验证、不能提前拦；百万字规模人工审计必漏 |
| B. 只在写作/检测期补闭环 | 检测智能体发现未收口线时报警 | 不选：检测是章级、事后；且一致性与完整性是两种义务，塞进同一条检测链难收敛 |
| C. 入库即闭环义务 + 全书台账 | 设定首次确认时门禁“计划弧线有始有终”；台账机械计算设定×章消费矩阵，常设报警未被碰/未收口 | 选：义务落在最早时点（设定拆条确认），机械可验；台账不手工镜像，可从库表随时重算 |
### 结论
采 C。实体领域拥有**闭环义务合同**与**台账数据形状**；不重定义 演变历程/成长弧线 的字段语义（归 `meta/schemas/` 与 专题-06 §4.5），不改其三期消费合同（归 专题-07 §5），不重定义 `canon_compliance`（归 专题-04）。
**① 闭环义务：从只追加日志升级为闭环**
- 义务对象：`meta/schemas/` 登记了 演变历程 的六个型——`character` / `event` / `faction` / `location` / `item` / `power_system`。未登记 演变历程 的型（如 `narrative_state`、`character_relation`）不受此义务约束。
- 闭环定义：一条设定的“已发生台阶（演变历程）”与“未来计划”合起来必须覆盖 登场 → … → 结局。即有明确的 登场 台阶，并有声明的 结局 方向——未来记在该型的未来计划字段，已发生的结局记在 演变历程（周期=结局）。“有终”指计划明写这条设定如何收场（角色的结局、力量体系的退场或湮灭、物品的归属），不是只有成长台阶。
- 机械执行时点：
- **入库硬门禁**：设定草稿首次经 `confirm` 成为正式行时（draft→canonical 确认路径，归 `confirm` skill），校验计划弧线有始有终，缺一则确认失败、不落正式行。机械失败不可被 Agent 主观覆判（与 [06-质量与复利领域](06-质量与复利领域.md) 质量链一致）。弧线的合法变更只走用户确认的正式修订（`revision` 加一）或带审计的 `retired`（§3 三态），这两条不是绕过门禁。
- **完本硬门禁**：作品状态转 完本（`completed` 流转归 [01-作品领域](01-作品领域.md)）前，校验所有义务设定已在 演变历程 落到 结局（实现收口）或经 `retired` 带审计；存在 未收口 则不得转 完本。
- **常设不变量**：台账（②）持续运行，把 未被碰/未收口 项曝为创作健康度项（与 06 长期验证轴一致），违反即报警。
**② 全书设定台账：数据形状与计算来源**
- 性质：派生视图，从库表机械计算，**不建手工镜像存储**（与 01 §3“派生量不手工镜像”、索引 §3“一切输入产出落库”一致）。数据形状合同归实体领域，渲染由 [08-数据权威与可视化领域](08-数据权威与可视化领域.md) 的只读看板承载。
- 形状：设定×章消费矩阵。行 = 本作义务设定（`muse_knowledge_entity` 的 active 行），列 = 章（`muse_content_chapter`）。格状态按“截至该章”的累计口径取三值；未收口 是行级（全书）结论：
| 标记 | 判据 |
|---|---|
| 未被碰 | 截至第 n 章，该设定无已发生台阶、也无正式正文消费 |
| 已消费 | 截至第 n 章有已发生消费，但尚未出现 结局 台阶 |
| 已收口 | 截至第 n 章存在 周期=结局 的台阶（实现收口） |
| 未收口（行级） | 计划弧线声明了 结局 方向，但截至当前最新章（或完本时）尚未实现 结局 台阶 |
- 计算来源（全部库表，可随时重算）：
- 已发生台阶与实现收口：实体行 JSONB 里的 演变历程——每条 `{章, 台阶, 周期}` 直接给出“该设定在哪章推进”，周期=结局 给出收口。
- 正文消费：`muse_content_block_source_attribution`（确认时写入的来源归因）把正文块关联到实体，经 `muse_content_block` / `muse_content_chapter` 给出“实际在哪章被消费”。
- 计划弧线与结局方向：实体行 JSONB 里的未来计划字段（`character` 为 成长弧线）。
- 计划消费：`example_planning_section` 的章级细纲（`fine_outline`）声明的必须出场实体与伏笔动作，只用于计算“计划碰而实际没碰”的偏差信号，不改格的已发生状态。
**③ 与 `canon_compliance` 的边界**
- `canon_compliance`（专题-04）问“是否与已立事实矛盾”，是一致性；闭环与台账问“是否有始有终、被消费、被收口”，是完整性。两者正交：不合并、不互相替代。
- 候选通过一致性检测，不豁免设定的闭环义务；台账报 未收口，也不代表任何候选吃了设定。
> 现状标注：未来计划字段目前只有 `character` 登记（成长弧线）；其余五个义务型只有 演变历程（已发生），无未来计划字段——它们的计划闭环暂不可机械校验。字段合同补齐归 `meta/schemas/`（术语与字段合同见 专题-06 §4.5），本节只定义义务、不定义字段。补齐前，这五型的入库门禁降级为校验已发生部分（须有 登场 台阶），结局方向暂由规划（大纲/细纲）声明、在台账登记为 未收口；字段补齐后升级为完整的计划闭环校验。
### 后果
- `confirm` 路径新增一项入库门禁：设定首次确认必须带 有始有终 的计划弧线，否则不落正式行。
- 作品新增一个全书常设视图（台账），由 08 只读看板渲染；完本新增一项实现收口硬门禁（流转归 01 作品领域，校验归本领域）。
- 演变历程的消费语义不变：续写仍不给 演变历程 全线（专题-07 §5 与其验收条款 6）；台账是全书健康度视图，不改逐章上下文注入。
- 待建：`confirm` 的计划弧线门禁、台账视图、完本收口门禁均未建成；建成前闭环不被机械校验（登记于本文件 附·待建）。
## 9. 检索
实体检索 = 库内查询 + 库内检索加速（向量）。
@ -94,7 +158,7 @@
- **命中后回读库行并校验内容哈希**，确认拿到的是库里当前正式行——不是回读任何文件。
- 检索加速失败只影响速度，不改变实体内容语义、不跳过审核。
## 9. 验收条件
## 10. 验收条件
1. 任一正式实体都能回到库内来源行，并经内容哈希校验一致。
2. 同一事实只有一个 owner 行，不要求同时维护 Markdown 与 JSON 两份人工事实。
@ -103,15 +167,19 @@
5. 参考书导入产生的实体草稿与正文产生的实体草稿走同一条确认链（可机械验证：两类草稿的确认都经 `confirm` 触发、都产生正式表行）。
6. 向量召回命中后回读的是库行而非文件（可机械验证：命中结果带库行 id 与内容哈希，且哈希与库一致）。
7. 作品面入库管线的每一次覆写都有审计记录，可追到来源原文。
8. 可恢复性（库损坏后能否重建）见 [08-数据权威与可视化领域](08-数据权威与可视化领域.md)。
8. 义务型设定草稿首次确认时，计划弧线缺 登场 或 结局 方向则不落正式行（可机械验证：任一义务型正式设定行都能回读出含 登场 台阶与 结局 方向的弧线）。
9. 台账从库表机械重算、无手工镜像：同一设定×同一章的消费状态两次重算一致，库内不存在台账镜像行。
10. 可恢复性（库损坏后能否重建）见 [08-数据权威与可视化领域](08-数据权威与可视化领域.md)。
## 10. 关联 SoT
## 11. 关联 SoT
- 类型结构：[`meta/schemas/`](../../../../meta/schemas/README.md)
- 数据权威与可恢复性：[08-数据权威与可视化领域](08-数据权威与可视化领域.md)
- 作品引用：[01-作品领域](01-作品领域.md)
- 上下文冻结：[04-上下文领域](04-上下文领域.md)
- 经验升格（与作品面实体升格不同）：[06-质量与复利领域](06-质量与复利领域.md)
- 演变历程三期消费语义（owner，本领域 §8 只加完整性义务、不改消费）：[专题-07](../../../../../design-docs/专题-07-知识消费契约与质量闭环.md) §5
- 一致性检测维度 `canon_compliance`（与 §8 闭环完整性正交）：[专题-04](../../../../../design-docs/专题-04-生成质量门控与创作健康度设计方案.md)
- 父仓元数据合同：[专题-06](../../../../../design-docs/专题-06-元数据驱动的智能体架构.md)
---
@ -130,4 +198,6 @@
- 草稿→确认的后半段真正跑通（当前正式表、绑定表基本为空，卡多在 `pending`）。
- 稳定 `id` 不因改名变化的保证。
- `retired` 退役态。
- 设定全书闭环与台账（§8）：`confirm` 计划弧线入库门禁、全书设定台账视图、完本实现收口门禁；建成前闭环不被机械校验。
- 五个义务型（`event`/`faction`/`location`/`item`/`power_system`）的未来计划字段补齐（字段合同归 `meta/schemas/`，见 §8 现状标注）。
- 删库可恢复（见 08）。

54
.agent/docs/architecture/domains/03-范式领域.md
View File

@ -58,11 +58,45 @@ observation -> draft -> evaluating -> active -> retired
- 范式冲突时按作品明确绑定、适用范围、证据等级和版本顺序处理；无法确定时省略，不随机拼接。
- 范式只影响“怎么写”，不能覆盖作品和实体的正式事实。
> **消费方式待对齐**：设计目标是“规划期选定并绑定范式，写作期只消费已绑定范式”；现状是“写作期按本章意图实时有界召回”。两者尚未对齐，规划期绑定待建。
> **消费方式（已决策，见 §6）**：合同态是“规划期选定并绑定范式，写作期只消费已绑定范式”，决策与落库合同见 §6；现状“写作期按本章意图实时有界召回”在绑定合同生效后即为违规路径。范式注入 writer 的尺寸上限与冲突规则仍以本节为准，§6 只补“选哪几张、何时生效、谁来消费”的绑定语义。
实验臂现状：Gate A 用 A/B/C 三臂，A 臂恒空（纯历史原文对照），B/C 臂拿候选范式卡；分臂规则收敛在 writer 合同一处，保证“有无范式卡”这个单变量不被破坏。
## 6. 范式在经验升格中的位置
## 6. 设计决策：规划期绑定
**背景**：范式的正路是“规划期决策、写作期引用”——规划产出显式挂所引范式的引用，写作期只按引用注入、不重新检索范式，上级合同见 [专题-07 §2](../../../../../design-docs/专题-07-知识消费契约与质量闭环.md)。本领域 §5 消费合同的目标态与此一致，但现状是写作期按本章意图实时有界召回，两者未对齐；同时 [01-作品领域 §3](01-作品领域.md) 已在作品行字段合同声明 `pattern_bindings`（绑定的范式范围或明确 ID），真实库表 `muse_content_work` 却无承载列。这两处缺口由本决策一并收口为明确合同。
**选项**：
| 选项 | 做法 | 取舍 |
|---|---|---|
| A 写作期实时召回（现状） | 每章按意图对公共范式库有界召回 | 选择不可追溯、不可复现，无法形成“规划决策→写作引用”链；与专题-07 验收 3 直接冲突 |
| B 规划期绑定 + 写作期只读引用 | `select_patterns` 规划期选定 → Shadow → 用户确认 → 写 `pattern_bindings` → 写作期只消费已绑定 | 选择由用户决策、落库可追溯、注入可复现；代价是绑定须有库表承载位与确认门禁 |
| C 写作期海选 + 事后登记 | 写作期向量海选，选中后再补登记 | 登记滞后于消费，单变量与可复现性同样被破坏，只是 B 的劣化版 |
**结论**：采用 B。合同如下。
1. **绑定对象与形态**：`pattern_bindings` 承载本作已确认绑定的范式引用集合，每条绑定 = 范式卡库内 `sourceId` + 选定时的版本 / 内容哈希快照。绑定可指公共范式卡（`work_id = 0`，已确认 / `active` 态），也可指作品级范式（非零 `work_id`）。哈希快照冻结绑定语义：范式卡后续被修订不静默改变已绑定内容，是否换绑由用户重新决策。
2. **SoT↔库不一致与补齐方向**：`pattern_bindings` 已是作品行 SoT 合同字段（[01-作品领域 §3](01-作品领域.md)），但 `muse_content_work` 尚无承载列——这是 SoT 先于库的债。本领域只定范式侧语义；库表承载位与落库机制归 [01-作品领域](01-作品领域.md) 与 [08-数据权威与可视化领域](08-数据权威与可视化领域.md)，不在此写 DDL。补齐方向：在作品行增结构化承载位，存已确认绑定的范式引用集合；承载位建成前，绑定事实必须有临时落库位，不得只活在内存或文件，否则违反“一切落库”横切合同（[领域索引 §3](_index.md)）。
- **实验仓落地承载**（遵循 `db/ddl` 「主仓表原样不改列、实验扩展进 example_*」口径）：承载位 = 最新一条已确认 assembly 规划行（`example_planning_section`，`section_type=assembly`，`state=confirmed`）的 `patternReferences`；确认 assembly 即激活绑定，不另改 `muse_content_work`。消费侧由 read-context `load_confirmed_pattern_bindings` 只读该已确认绑定（写作期不临场召回）。作品行 `pattern_bindings` 列仍是主仓生产承载方向（归 01/08），届时实验仓承载收敛回作品行。
3. **生效时机（Shadow→confirmed）**：规划期 `select_patterns` 从公共范式卡选定本作范式，选择先落 Shadow（规划候选）；经用户确认翻 confirmed 后才写入 `pattern_bindings`、才可进生成上下文（横切总闸见 [架构-02](../../../../../design-docs/架构-02-核心数据结构与双轨模型.md)）。未经确认的 Shadow 选择不是绑定，不得被写作期消费。
4. **assembly 落点与 knowledgeBindings 填充**：assembly 装配本次写作上下文时，其范式绑定项（`knowledgeBindings` 的范式部分）只从该作品 confirmed 的 `pattern_bindings` 派生——按引用回读冻结范式卡、回读验哈希，再按 §5 尺寸上限裁成注入视图；不从全库临场召回。选择、冻结、裁剪、投影的机制归 [04-上下文领域](04-上下文领域.md)，本领域只约束“范式这一路只认已绑定引用”。
5. **消费合同（写作期只读引用）**：assemble / writer 只消费 `pattern_bindings` 里 confirmed 绑定的范式；写作期对公共范式库做相似度临场海选的链路判违规（对齐 [专题-07 §7 验收 3](../../../../../design-docs/专题-07-知识消费契约与质量闭环.md)）。范式冲突仍按 §5 既有规则（作品明确绑定优先、无法确定则省略，不随机拼接）。
6. **与评测 A/B/C 臂的关系**：生产绑定走作品行 `pattern_bindings`；评测 A/B/C 臂的分臂规则仍收敛在 writer 合同一处（开发评测边界见 [05-创作流程领域 §7](05-创作流程领域.md)），A 臂恒空、B/C 臂注入评测侧独立冻结的同一组范式卡。两条注入路径分立：评测臂不读作品行 `pattern_bindings`，生产绑定也不改写评测臂的冻结卡集——保证“有无范式卡 / 哪组范式卡”这个单变量不被生产绑定污染。
**后果**：
- 范式选择从“写作期黑盒召回”变为“规划期用户决策 + 落库可追溯”，规划产出携带引用链，写作任务可回指该绑定。
- 新增两条机械门禁：①写作期任一注入 writer 的范式必须能回指 `pattern_bindings` 一条 confirmed 绑定，无绑定来源失败关闭；②`select_patterns` 的 Shadow 选择在用户确认前不出现在 `pattern_bindings`、不进生成上下文。
- 产生一项对作品领域的依赖：`muse_content_work` 需补 `pattern_bindings` 承载位（见结论 2）；承载位建成前绑定只能走临时落库位，属过渡通道，不是合同形态。
- 现状写作期实时有界召回在绑定合同生效后即为违规路径，须收敛为“只读已绑定”。
## 7. 范式在经验升格中的位置
范式是经验升格的中转站：作品里反复出现的稳定观察，先进入范式验证，达到可复用标准后，再升格为 Skill、确定性工具或 Agent 规则。**完整升格规则和判据由质量与复利领域独家拥有**，见 [06-质量与复利领域 §6](06-质量与复利领域.md)。本节只说范式这一段：
@ -71,7 +105,7 @@ observation -> draft -> evaluating -> active -> retired
> **两个“升格”不同义**：本节的“经验升格”指写法经验从范式提炼为 Skill / Tool / Agent 规则，对象是**方法**。02 实体领域里的“升格”指参考书或正文产生的实体草稿经用户确认成为作品正式事实，对象是**作品面实体入库**，见 [02-实体领域](02-实体领域.md)。两者对象不同，不要混用。
## 7. 检索与召回
## 8. 检索与召回
范式的选择靠库内检索：按型别、适用范围、场景和意图从库里过滤候选；库内检索加速（pgvector 向量索引）只负责提高召回速度，不是独立权威，可从库重建。任何命中都必须回读库行并校验内容哈希后才能采用。
@ -79,7 +113,7 @@ observation -> draft -> evaluating -> active -> retired
- 只读看板查库渲染范式，绝不写库；接受、丢弃等写操作仍由 `confirm` skill 和主会话走。
- 可恢复性（库备份、快照、可重建脚本）见 [08-数据权威与可视化领域](08-数据权威与可视化领域.md)。
## 8. 验收条件
## 9. 验收条件
1. 每张 `active`（或现状下已确认）范式卡都能从 `draft_payload` 回到来源（拆书书名 + 回目，或作品证据）。
2. 公共范式行的 `work_id = 0`，作品级范式行的 `work_id` 非 0；单作品观察不会被写成 `work_id = 0`。
@ -89,14 +123,15 @@ observation -> draft -> evaluating -> active -> retired
6. 范式卡只影响“怎么写”，上下文里的作品事实和实体事实不被范式覆盖。
7. 范式升格为 Skill/Tool 后，卡里不存在第二份执行步骤，只有链接。
8. 只读看板对范式只查不写。
9. 规划期绑定（§6）可机械校验：写作期任一注入 writer 的范式都能回指作品行 `pattern_bindings` 一条 confirmed 绑定，无绑定来源失败关闭；`select_patterns` 的 Shadow 选择在用户确认前不出现在 `pattern_bindings`、不进生成上下文。
## 9. 待建
## 10. 待建
- 五态生命周期（`evaluating` / `active` / `retired`）的机械判据。
- scope 的 category（品类）层：现状只有公共 / 作品两层，品类层为目标。
- 规划期绑定：现状是写作期实时有界召回，待与设计目标对齐。
- 规划期绑定的合同已定（见 §6）；消费侧取数端（read-context `load_confirmed_pattern_bindings`）与生产编排接线已建（实验仓以已确认 assembly 行承载）。剩余待建只是落地：`muse_content_work` 的 `pattern_bindings` 承载列（库表承载归 [01-作品领域](01-作品领域.md)，届时实验仓承载收敛回作品行）、绑定确认门禁、写作期范式须可回指 confirmed 绑定的机械门禁（尚未强制）。
## 10. 关联 SoT
## 11. 关联 SoT
- 数据权威与落库硬纪律：[领域索引](_index.md)
- 质量与经验升格规则：[06-质量与复利领域](06-质量与复利领域.md)
@ -104,4 +139,7 @@ observation -> draft -> evaluating -> active -> retired
- Skill 边界：[07-Agent与Skill领域](07-Agent与Skill领域.md)
- 数据权威与可恢复性：[08-数据权威与可视化领域](08-数据权威与可视化领域.md)
- 类型结构：[`meta/schemas/`](../../../../meta/schemas/README.md)
- 知识消费上级合同：[专题-07](../../../../../design-docs/专题-07-知识消费契约与质量闭环.md)
- 作品行 `pattern_bindings` 字段合同与库表承载：[01-作品领域](01-作品领域.md)
- 装配的选择 / 冻结 / 裁剪 / 投影机制：[04-上下文领域](04-上下文领域.md)
- 开发评测边界与 A/B/C 臂：[05-创作流程领域](05-创作流程领域.md)
- 知识消费上级合同（规划期决策、写作期引用）：[专题-07](../../../../../design-docs/专题-07-知识消费契约与质量闭环.md)

102
.agent/docs/architecture/domains/05-创作流程领域.md
View File

@ -8,6 +8,101 @@
一切输入产出必须落库可见——横切合同见索引 §3。
## 1A. 前期创作阶段（正向创作链的前段）
本节拥有正文生成**之前**的五阶段串行流程：定盘 → 大纲/卷纲 → 设定拆条 → 范式与文风选定 → 细纲。它回答"一部书在动笔写正文之前，要依次产出哪些规划事实、每步卡在什么门禁上、满足什么条件才允许进入下一步"。§2 的正向流程从本节阶段 4 产出的细纲往后接续。
本领域拥有这五阶段的**顺序、进入/退出条件和门禁**，不拥有各阶段产物的字段合同与存储表结构——字段权威在 [`meta/schemas/`](../../../../meta/schemas/README.md)，存储与确认链分别在 [01-作品领域](01-作品领域.md)、[02-实体领域](02-实体领域.md)、[03-范式领域](03-范式领域.md)，本节只引用、不重复定义。
两条贯穿五阶段的硬合同（均为既有合同，本节只引用）：
- **横切总闸**：一切规划候选先落 Shadow，经用户确认翻 Confirmed 后才进入生成上下文（Shadow/Canonical 双轨，见 [架构-02](../../../../../design-docs/架构-02-核心数据结构与双轨模型.md)）。
- **上层约束下层**：大纲派生卷纲、卷纲派生细纲；下层规划不得与已确认的上层规划相悖，冲突时以下层退回为准。
### 阶段定义
除特别注明外，各阶段规划产出都经 `persist_planning` 落 `example_planning_section`（默认 `state='shadow'`），用户确认后翻 `confirmed`。
**阶段 0 · 定盘**
- 进入条件：作品已创建（作品行存在，见 [01-作品领域](01-作品领域.md)）。
- 产出：`work_core`（题材定位 / 核心卖点 / 主题立意 / 基调 / 禁区 / 核心悬念 / 谜底与真相 / 结局方向 / 目标读者，字段权威见 `meta/schemas/work_core.yaml`）+ `novel_work` 的篇幅目标（目标章数 × 单章字数区间 × 分卷数，见 `meta/schemas/novel_work.yaml`）。落 `section_type='setting'`。
- 机械门禁：**篇幅目标三要素齐全**——当前为文档纪律，待升级为落库校验。
- 退出条件：`work_core` 九字段与篇幅目标三要素齐备且用户确认（`confirmed`）。
**阶段 1 · 大纲 / 卷纲**
- 进入条件：阶段 0 已确认。
- 产出：`outline`（`scope=work`，字段权威见 `meta/schemas/outline.yaml`）——主线一句话、分卷粗纲（每卷：卷名 · 卷目标 · 核心冲突 · 情绪终点）、当前卷细纲、未来卷粗纲（防续写提前收线）、弃案记录（防 AI 复活旧方向）。落 `section_type='outline'`。
- 机械门禁：**主线一句话 ≤ 50 字**、**每卷四要素齐**、**卷粗纲 ≈ 卷正文 0.3–0.5%**、**卷数 = 篇幅目标.分卷数**——当前均为文档纪律，待升级为落库机械校验（卷数合同是本次新增的架构空白之一，见本节"现状与待建"）。
- 退出条件：大纲 `confirmed`，且卷数与篇幅目标.分卷数一致。
**阶段 2 · 设定拆条**
- 进入条件：阶段 1 已确认。
- 产出：把设定拆成结构本体 23 型条目（`world` / `power_system` / `faction` / `character` / `item` / `location` / `event` / `character_relation` 等，型与字段权威见 [`meta/schemas/`](../../../../meta/schemas/README.md)）。主落点是实体入库链：`muse_knowledge_draft` → 用户确认 → `muse_knowledge_entity`（关系另落 `muse_knowledge_relation`），确认链由 [02-实体领域](02-实体领域.md) 拥有。每条实体带「演变历程」（已发生的 `{章, 台阶, 周期}`，周期取 登场/成长/高光/退场/结局）与「成长弧线」（未来计划）。
- 机械门禁：
1. **payload ↔ schema 字段覆盖**（落库机械校验，带「字段存疑：原因」逃生口）——**已建**：`persist_planning` 落库按 `meta/schemas/<型>.yaml` 校验必填字段，缺必填失败关闭；`fine_outline` 型已标「字段覆盖门禁：强制」，其余型字段（中文键）与 payload 对齐后逐步纳入；推荐字段缺失只报告不拦，确无依据的字段可显式标「字段存疑：原因」放行。
2. **设定全书闭环**：每条设定须有 登场 → … → 结局 的计划弧线，有始有终——目标合同，待建（本次新增架构空白之一）。
3. **全书设定台账**：设定 × 章消费矩阵，标记未被碰 / 未收口——目标合同，待建（本次新增架构空白之一）。
- 退出条件：设定条目经用户确认入正式实体表，且字段覆盖、闭环、台账三项校验通过（三项建成前，以用户确认为退出准绳）。
**阶段 3 · 范式与文风选定**
- 进入条件：阶段 2 已确认。
- 产出：
- 规划期 `select_patterns` 从公共范式卡（`work_id=0`）选定本作范式，绑定 `pattern_bindings`；范式内容与消费尺寸合同见 [03-范式领域](03-范式领域.md)。
- 装配 `assembly`：把已选范式与本作事实组织为待装配集合，落 `section_type='assembly'`（装配此前无领域 owner，本节收编，见下"归属收编"）。
- `style` 文风画像八字段（叙事人称视角 / 句式 / 叙述配比 / 用词质感 / AI 味黑名单 / 对话风格 / 章末钩子风格 / 达标样张，字段权威见 `meta/schemas/style.yaml`）。
- 机械门禁：**`assembly` 经用户确认（`confirmed`）才进正文上下文**、**`assemble` 只消费已绑定范式**（对齐 [专题-07](../../../../../design-docs/专题-07-知识消费契约与质量闭环.md)：公共范式只走规划期决策、写作期引用，不作写作期临场海选）、**`style` 真注入 writer**——**取数端与生产接线已建**：read-context 三个一等取数端（`load_confirmed_fine_outline` / `load_confirmed_pattern_bindings` / `load_confirmed_style`）已建并由生产编排（`docs/write-chapter/step2_write_chapter.py`）接线；范式只读已确认 assembly 绑定注入（实验仓承载，见 [03-范式领域 §6](03-范式领域.md)），确认文风投影为 `styleConstraints` 随冻结上下文注入 writer（不再写死为空）。**待建**：当前注入的是设定行的一句话文风（书12 现状），结构化 `style` 八字段画像的书级抽取尚未建；写作期范式须可回指 confirmed 绑定的门禁尚未机械强制。评测 A/B/C 臂走独立冻结注入，不读生产绑定。
- 退出条件：`assembly` 已 `confirmed` 并完成 `pattern_bindings` 绑定，`style` 八字段齐备。
**阶段 4 · 细纲**
- 进入条件：阶段 3 已确认，且当前卷大纲已确认。
- 产出：逐章 `fine_outline`（章细纲 ≈ 章正文 3–5%，是结构骨架不是缩写，超比例退回），落 `section_type='fine_outline'` 且必须带 `target_chapter`。细纲字段合同见 [`meta/schemas/`](../../../../meta/schemas/README.md) 与 [fine-outline 合同](../../../../.claude/skills/fine-outline/SKILL.md)。
- 机械门禁：
- **硬门禁（既有，代码失败关闭）**：`section_type='fine_outline'` 必带 `target_chapter`、`payload` 为非空 JSON、细纲须为结构化对象且数组/字符串字段类型稳定（落库即拒）。
- **内容门禁（文档纪律，待升级）**：硬事件 / 伏笔动作（埋 · 推 · 收）/ 必须出场实体 / 章末钩子齐备；**细纲硬约束覆盖率 100%**（回放评测维度，见 [专题-04](../../../../../design-docs/专题-04-生成质量门控与创作健康度设计方案.md)）；**细纲产出形与 writer 装配消费形统一——已建**：唯一字段权威 [`meta/schemas/fine_outline.yaml`](../../../../meta/schemas/fine_outline.yaml)（必填集满足装配与机械门、推荐集保留规划表达力），planning 技能与 writer 装配同指它，结束此前两套字段不相交的漂移。
- 退出条件：该章细纲 `confirmed`，硬约束覆盖率达标，产出形可被 writer 装配直接消费。
### 五阶段共用的落库机械门禁（既有，代码失败关闭）
这四条由 `persist_planning` / `confirm` 在库侧强制，不靠调用方自觉：
1. `section_type` 只接受 `setting / outline / state / assembly / fine_outline`，非法值拒落。
2. `fine_outline` 缺 `target_chapter` 拒落。
3. `payload` 必须是非空 JSON 对象。
4. 规划确认只走 `shadow → confirmed` 单通道，非 `shadow` 不可确认；未 `confirmed` 的规划不进生成上下文。
### 归属收编登记
以下四个既成事实此前散落在别处或无 owner，本节在流程里给它们一个明确阶段位置；**字段与存储 owner 不变**，本领域只拥有它们所处的阶段、进入/退出与门禁。
| 既成事实 | 本流程位置 | 字段 / 存储 owner（只引用） |
|---|---|---|
| 卷纲 | 阶段 1 产出的一部分 | `outline` schema + [01-作品领域 §5](01-作品领域.md)（规划存储与确认）；此前仅 01 一笔带过 |
| 设定拆条 | 阶段 2 | 23 型 schema + [02-实体领域](02-实体领域.md)（入库与确认链）；此前仅为纪律 |
| 装配 `assembly` | 阶段 3 | `example_planning_section.section_type='assembly'`；此前无领域 owner，由本节收编 |
| 范式规划期绑定 | 阶段 3 | [03-范式领域 §5/§6](03-范式领域.md)（消费合同；规划期绑定消费侧已建、作品行承载列待建）+ `pattern_bindings`（[01-作品领域 §3](01-作品领域.md) 已声明字段） |
### 现状与待建
- **已建成（引用即可）**：五阶段顺序与产出落点、`example_planning_section` 的 `section_type` 白名单与 `fine_outline` 必带章号、`shadow → confirmed` 单通道、公共范式卡与 `select_patterns`；以及本轮落地的——细纲唯一字段合同（`meta/schemas/fine_outline.yaml`，产出形与装配消费形统一）、落库字段覆盖门禁（`fine_outline` 型已强制失败关闭）、read-context 三个一等取数端（`load_confirmed_fine_outline` / `load_confirmed_pattern_bindings` / `load_confirmed_style`）并由生产编排 `step2_write_chapter.py` 接线（细纲统一消费、范式只读已确认 assembly 绑定、文风投影为 `styleConstraints` 注入 writer）。
- **决策已定、机械落地待建（三个架构空白）**：合同见 02/01/03 三域决策记录——
1. 设定全书闭环校验 + 全书设定台账（把「演变历程」从只追加日志升级为闭环义务，新增设定 × 章消费矩阵视图；见 [02-实体领域 §8](02-实体领域.md)）。
2. 卷数合同：`novel_work` 篇幅目标增「分卷数」，`outline` 分卷粗纲卷数须与之一致并机械校验（见 [01-作品领域 §6](01-作品领域.md)）。
3. 范式规划期绑定：消费侧已通；作品行 `pattern_bindings` 承载列为主仓生产方向（实验仓暂以已确认 assembly 行承载，见 [03-范式领域 §6](03-范式领域.md)）。
- **待建（其余门禁升级与取数补全）**：阶段 0–1 的字数 / 比例 / 四要素校验、阶段 2 字段覆盖门禁扩到其余型（中文键 schema 与英文 payload 对齐后纳入）、阶段 4 细纲硬约束覆盖率门禁、结构化 `style` 八字段画像的书级抽取（当前注入设定行一句话文风）、写作期范式须可回指 confirmed 绑定的机械门禁。字段层面的回填（`novel_work` 分卷数、`pattern_bindings` 库列）属各 owner 文档与 `meta/schemas`，不在本节。
### 本节验收条件
1. 五阶段可机械读出先后：任一早阶段的规划未 `confirmed` 时，其直接后续阶段的规划不允许进入生成上下文（查询 `example_planning_section` 的 `state` 与依赖关系可验证）。
2. 每条规划产出都在库内有 `section_type`、`state`、`target_chapter`（细纲）记录，只读看板可据此渲染前期全流程。
3. 任一 `fine_outline` 行必带非空 `target_chapter` 与非空 `payload`（查询可验证，缺者在落库时即被拒）。
4. 未 `confirmed` 的 `assembly` 不出现在正文生成上下文里；正文上下文引用的范式均可回读到 `pattern_bindings` 绑定记录（绑定库列建成后可机械验证）。
5. 阶段门禁失败（字数超限、卷数与分卷数不一致、字段覆盖不足、闭环缺弧线、覆盖率不达标）会阻断进入下一阶段，而不是静默放行（各门禁升级落库后逐项可机械验证）。
## 2. 正向流程
```text
@ -114,8 +209,13 @@ Gate A/B、A/B/C 三臂、参考书标准答案和盲评只属于开发期离线
## 9. 关联 SoT
- 作品与决策存储：[01-作品领域](01-作品领域.md)——正式正文、决策记录的表结构归它。
- 作品与决策存储：[01-作品领域](01-作品领域.md)——正式正文、规划存储、决策记录、`pattern_bindings` 字段声明的表结构归它。
- 设定拆条与实体入库：[02-实体领域](02-实体领域.md)——阶段 2 设定条目的 `draft → entity` 确认链与演变历程归它。
- 范式规划期绑定：[03-范式领域](03-范式领域.md)——阶段 3 范式消费尺寸合同与规划期绑定（消费侧已建、作品行承载列待建）归它。
- 上下文输入：[04-上下文领域](04-上下文领域.md)——冻结上下文的选择与裁剪。
- 质量步骤：[06-质量与复利领域](06-质量与复利领域.md)——机械门、语义检测、评分的合同。
- 数据权威与落库：[08-数据权威与可视化领域](08-数据权威与可视化领域.md)——库权威层级、落库机制、只读看板。
- 结构本体字段权威：[`meta/schemas/`](../../../../meta/schemas/README.md)——前期五阶段各产出（work_core / novel_work / outline / style / 23 型）的字段合同。
- 接受上级合同：[专题-01](../../../../../design-docs/专题-01-正文建议接受%28Accept%20Suggestion%29实现规范.md)——accept preflight 的产品级规范。
- 细纲硬约束覆盖率：[专题-04](../../../../../design-docs/专题-04-生成质量门控与创作健康度设计方案.md)——阶段 4 覆盖率门禁的回放评测维度。
- 范式规划期决策：[专题-07](../../../../../design-docs/专题-07-知识消费契约与质量闭环.md)——公共范式只走规划期决策、写作期引用的上级合同。

4
.agent/docs/architecture/domains/_index.md
View File

@ -55,7 +55,7 @@
| 实体 | 单作品内人物、关系、事件、地点、物品、组织、世界规则、叙事状态事实，以及拆书与作品面实体入库管线 | [02-实体领域](02-实体领域.md) |
| 范式 | 跨作品或限定范围复用的写作方法、适用条件、证据与生命周期 | [03-范式领域](03-范式领域.md) |
| 上下文 | 从作品、实体、范式选择并冻结角色可见输入 | [04-上下文领域](04-上下文领域.md) |
| 创作流程 | 从用户意图到待审候选，再到用户决策和正式正文的正向链路 | [05-创作流程领域](05-创作流程领域.md) |
| 创作流程 | 从用户意图到待审候选，再到用户决策和正式正文的正向链路；含正文生成前的前期创作五阶段（定盘 → 大纲/卷纲 → 设定拆条 → 范式与文风 → 细纲）及其进入/退出与门禁 | [05-创作流程领域](05-创作流程领域.md) |
| 质量与复利 | 机械门、语义审查、审核/实验结果合同、场景评分、验证终态和经验升格规则 | [06-质量与复利领域](06-质量与复利领域.md) |
| Agent 与 Skill | 角色职责、能力合同、确定性工具及复用标准 | [07-Agent与Skill领域](07-Agent与Skill领域.md) |
| 数据权威与可视化 | 数据库权威层级、输入产出落库机制、raw 进库与访问控制、只读看板、可恢复性 | [08-数据权威与可视化领域](08-数据权威与可视化领域.md) |
@ -64,6 +64,8 @@
```text
用户意图
-> 创作流程域前期阶段：定盘 -> 大纲/卷纲 -> 设定拆条 -> 范式与文风 -> 细纲
（各阶段候选先 shadow、用户确认翻 confirmed 才进生成上下文；详见 05 §1A）
-> 作品域提供目标、规划与最新正式正文
-> 实体域提供正式事实和叙事状态
-> 范式域提供经验证的写法参考