# 整体文档一致性修复

- 日期：2026-05-24
- 适用范围：Muse 设计文档整体 review 后的 P0/P1 跨分册一致性修复。
- 文档性质：项目内 memorys 留痕，用于后续继续设计、review 或进入实现阶段时快速恢复关键边界。

## 1. 本次修复背景

在阶段 7 前后端架构文档完成后，对 `design-docs/` 做了多角度整体 review，发现部分已完成分册之间仍存在 owner、状态、事实写入和产品能力 gate 的 P0 冲突。

本次修复是一次明确的跨阶段一致性修复例外：不是重新设计所有阶段，也不是进入阶段 8 索引整理，而是在用户确认后，按独立 owner 分组修复已经发现的阻断级问题。

## 2. 本次修复方式

修复任务拆为五个互不重叠的子代理任务：

1. 架构与领域边界：修 `架构-01/02/03/04`。
2. 后端 Schema/API/模块契约：修 `后端-01/02/03/04/05`。
3. 产品 02 与市场原型：修 `产品-02/02C/02F` 和 02F 原型。
4. 流程与专题：修 `流程-01A/01B/02A/02B` 与 `专题-01/02/03/04`。
5. 前端文档：修 `前端-01/02/03`。

主代理最后做跨文档整合，补了 `产品-03`、来源状态命名和用户可见技术词残留，并更新阶段计划。

## 3. 已收口的关键口径

后续设计和实现必须继续承接以下结论。

1. MetaSchema 的逻辑 owner 固定为 Admin/Governance；物理表即使暂落 Content，也只能通过治理 facade 写入。Content 只承载或消费投影。
2. Agent、Tool Grant、Agent Runtime Permission Envelope 必须分层。AI runtime 只能消费服务端签发的权限包，不能自授权、扩权或绕过 owner 校验。
3. Market 只负责市场资产、授权、安装记录、来源侧 handoff、授权摘要和跳转审计。目标 owner 自己创建和消费 target precheck/session，Market 不写目标事实。
4. Import task/context 归 Work/Content；Parse Job、Chapter Parse Result、Chapter Review 归 AI Orchestration；Knowledge 只在章节审阅确认后创建或更新 Knowledge Draft。
5. 动态字段没有跨 owner 的通用写接口。`/dynamic-fields/validate` 只做校验和路由建议，正式写入必须回到 Content、Planning、Knowledge、Agent 等 owner action。
6. Accept / Merge 写 Canonical 前必须消费或重算 Candidate Decision Envelope。硬闸门必须覆盖输出合规、静态检查、质量结果版本、来源状态、授权快照、作品资产 feature gate、`expectedRevision` 和幂等结果。（ADR-018 已决策去掉独立 Candidate Decision Envelope 概念封装，改为接受时实时对比来源状态；Agent Runtime Permission Envelope 仍保留，两者是不同概念。专题文档已同步更新。）
7. 作品资产当前只允许阅读、收藏和授权记录。模板化、参考来源写入、AI 上下文绑定必须等待后续 feature gate、作品 owner 入口、使用检查、来源谱系、API/Schema 和失败回退闭合。
8. SourceStatus、SourceEventType、SourceActionPolicy 必须分层表达。SourceStatus 包含 `delisted`；SourceActionPolicy 包含 `read_only`，不能把 `allowed/blocked/needs_recheck` 当成来源事实状态。
9. 来源撤权、召回、下架、阻断、owner 缺失和授权失效会影响候选接受、Local KB 来源型确认、生成上下文、绑定、导出任务和已签发下载凭证，但不能自动回滚已确认 Canonical。
10. 用户可见原型和前端文案不能暴露 `handoff token`、`precheckId`、`Tool Grant`、`Runtime Permission Envelope` 等技术合同名；界面应使用跳转授权、使用检查、工具权限摘要、运行权限摘要等产品语言。

## 4. 后续继续时先检查

继续阶段 8 或进入实现阶段前，先检查：

1. `design-docs/临时-产品形态阶段化重设计计划.md` 中 D-045 和 C-006。
2. `产品-02C/02F/03` 中作品资产是否仍保持只读/收藏/授权记录的默认 gate。
3. `后端-05` 中动态字段是否仍没有跨 owner 泛写接口。
4. `专题-01`、`流程-02B` 和 `前端-02` 是否仍要求 Candidate Decision Envelope 硬闸门。（ADR-018 已决策去掉独立 Candidate Decision Envelope，改为实时对比；Agent Runtime Permission Envelope 仍保留。）
5. `架构-01/02/04`、`后端-03/04/05`、`专题-03` 是否仍统一 SourceStatus / SourceEventType / SourceActionPolicy。
6. 阶段 8 已在 D-046 开始补 `00-文档大纲.md` 和 `内容映射表.md` 的四仓工程架构索引；后续仍需继续复核其他过期引用和 owner 映射。

## 5. 验证方式

本次修复完成后已执行：

1. `git diff --check`
2. 阶段 8 文件未修改检查。
3. 作品资产误开放关键词扫描。
4. 动态字段泛写入口扫描。
5. SourceStatus / SourceEventType / SourceActionPolicy 旧口径扫描。
6. 原型用户可见技术词扫描。