33aad93bef
基于产品/架构/流程/前端/后端五维度并行review，澄清并落地22项关键决策： 架构层：Governance按消费者归属拆散、MetaSchema独立模块、 Source传播改为事件驱动自治、去掉Candidate Decision Envelope 和needs_recheck中间状态、Neo4j决策为依赖RAGFlow GraphRAG 后端层：Entitlement统一为可变表+审计日志、API版本策略采用 X-API-Version Header、知识实体唯一键加scope字段 前端层：SSE实时通信（AI stream独立+事件统一）、正文持久化 IndexedDB安全网、Block粒度为场景/小节级 产品层：范围不变UX解决复杂度、知识确认默认自动+冲突时人工
61 lines
4.8 KiB
Markdown
61 lines
4.8 KiB
Markdown
# 整体文档一致性修复
|
||
|
||
- 日期：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. 原型用户可见技术词扫描。
|