oh-my-muse/design-docs/专题-03-AI编排上下文与质量评测实现规范.md
zizi 2124a79312 docs(design): 补知识效用缺环——新增专题-07 消费契约与质量闭环 + 七册配套拍板
第一性原理结论:知识的价值只在被选中并改善产出的那一刻兑现;此前 SoT 钉死了治理
(谁能读什么),缺消费选择(该读哪几条)与输入侧质量(什么算好知识、怎么测)。

- 新增 专题-07 v1(唯一 owner):术语桥(卡↔SoT 载体)、按用途默认消费合同与注入
  视图两档、知识质量三性(可命中/可行动/可持续+口径)、回放评测(参考书=标准答案,
  三评测线+两道合规闸+知识策略对象与上线门禁)、长线进度三期消费、实验台实证附录、
  验收清单 8 条
- 专题-06 v4:拍板双层型判定(craft 1326 条实测无损→不拆,判据不变);新增 §6.4
  参照作品面(参考书实体演变=系统侧证据资产,蒸馏成叙事域成长曲线范式才入 Global);
  世界域六型登记演变历程元素;读取器 purpose 枚举 parse→extraction
- 架构-02 v11:aiContext 值域升级为布尔或用途集(实验台字段级用途裁剪实证反哺)
- 专题-03 v3 / 专题-04 v2(补 .md 改名+离线评估允许样本第 5 类)/ 后端-05 v11 /
  前端-03 v7 / 产品-01·02、前端-02、后端-03 断链修复 / 大纲 v10 / 映射表 v8
- prototypes/ 新增四页签开发者总览

依据:设计文档全库横切取证 + 实验台 9 批实拆实证(活卡 8587、消费端 0 实现、升格
卡向量 0%、p50 实例数 1)。经 codex 与 opus 双独立评审,必修项全部落实。
2026-07-18 00:02:51 +08:00

28 KiB
Raw Blame History

专题-03AI 编排、上下文与质量评测实现规范

  • 版本v3
  • 更新日期2026-07-17
  • 目标读者:产品 / 架构 / 后端 / 前端 / 测试
  • 阅读时间30-45 分钟
  • 变更记录v32026-07-17§4.2 登记「分区内该选哪几条知识」的选择契约归属 专题-07-知识消费契约与质量闭环;关联阅读补专题-07。
  • 边界说明:本文件承接阶段 1~5定义 AI 编排、上下文组装、检索、运行权限、来源追踪、风险路由和质量评测的产品架构合同。它不定义精确数据库表、后端 endpoint、前端组件和运维门禁这些由后续前端/后端阶段承接。

1. 归属范围

本文件回答 AI 链路“谁能读什么、怎么组上下文、哪些节点不可替换、结果如何进入 Shadow、风险和质量如何解释”。

主题 本文件负责 不负责
AI 任务编排 系统功能链路、保护节点、开放替换槽位、失败边界 具体服务类、队列实现、接口路径
运行时权限 Agent Runtime Permission Envelope 的语义和校验点 权限表结构、鉴权框架实现
上下文组装 Layer、授权快照、来源状态、Token 预算和用户可解释摘要 Prompt 具体全文、前端调试面板
检索和图查询 RAG / Graph Provider 的事实边界、降级和来源要求 向量库或图数据库选型细节
风险路由 合规、来源、权限、质量风险对候选状态的影响 安全模型供应商实现
质量评测 质量结果如何绑定候选、上下文和配置快照 质量门控 UI 与策略细则,见 专题-04
外部 Agent Adapter 外部运行时必须遵守的权限、上下文、输出和审计边界 Dify / AgentScope / New-API 具体 HTTP 映射,见 专题-05

核心 owner

对象 Owner BC 本专题中的使用方式
AI Task / Context Snapshot / Quality Result AI Orchestration BC 创建、运行、归档和解释 AI 任务
Agent / Agent Version / Agent Runtime Permission Envelope Agent BC 提供可运行能力和权限包
Work / Chapter / Block / Block Source Attribution Work/Content BC 提供正文事实、写入锚点和来源归因
Local KB / Knowledge Draft / Knowledge Source Binding Knowledge BC 提供正式知识、待确认草稿和知识来源状态
Marketplace Asset / License / Install / Source Status Event Marketplace/Asset BC 提供市场授权、安装和召回事件
New-API Binding / Integration Call Log Integration BC 执行模型网关调用和最小调用摘要
External Agent Runtime / Adapter AI Orchestration BC 按统一协议调用 Dify / AgentScope / New-API 等外部能力,不能持有 Muse 事实写权

2. 系统功能链路

Muse 的 AI 能力不是“前端按钮直接调某个智能体”,而是系统预编排功能链路。用户只能在开放槽位中替换子智能体,不能替换保护节点。

2.1 标准链路

用户意图
-> 输入合规
-> 权限和来源预检
-> Agent Runtime Permission Envelope
-> 上下文组装
-> 开放槽位子智能体运行
-> AI Task Result
-> Provisional AI Suggestion / Shadow Candidate
-> 静态检查和来源状态校验
-> 质量门控与有限重写
-> 输出合规
-> 候选可接受性实时校验
-> 可展示的 Shadow 对象
-> 用户决策

任何链路都必须满足:

  1. 运行前固化 actor、work、chapter/block、agent version、slot、tool grant、context scope、egress policy、budget、authorization snapshot 和 trace。
  2. 任务成功只能先生成 Provisional AI Suggestion、Knowledge Draft、Planning Candidate、Risk Marker、Quality Result 或记录,经静态检查、来源状态校验、质量门控、输出合规和风险路由后,才成为可展示或可接受的 Shadow 对象。
  3. 任务失败不能静默降级为“低质量但可接受候选”。
  4. 用户接受候选只写正文和候选归档,不写 Local KB。

2.2 不可替换保护节点

以下节点属于系统保护节点,用户智能体、市场智能体和工作流智能体都不能替换:

保护节点 作用 失败结果
输入合规 检查用户输入、导入文本和上下文请求是否可处理 阻断任务或要求用户修改
权限过滤 校验作品、知识库、市场资产、智能体、工具和外发权限 阻断读取或剔除来源
来源状态校验 校验 active / stale / revoked / delisted / recalled / blocked / owner_missing / unauthorized 等状态 禁用旧来源的新使用
拆分切块 对导入、解析、入 RAG 的文本做系统级分块 任务失败或等待重试
入 RAG 将已确认内容投影到检索索引 异步失败,不反写 Canonical
语义安全围栏 限制越界、违规、隐私和 prompt 注入风险 阻断或生成风险标记
静态检查 检查输出结构、字段、schema 和必要来源 失败不得进入可接受候选
Shadow -> Canonical 用户确认和正文保存的唯一正式入口 不允许智能体绕过
质量门控 对候选做关键维度评分和有限重写 不合格候选不得伪装为通过
输出合规 检查交付给用户前的文本、来源和安全状态 阻断展示或要求重生成

2.3 开放替换槽位

开放槽位只能替换“能力子智能体”,不能改变系统链路控制权。

槽位 允许替换 不允许替换
Writing Agent 生成、续写、扩写、润色、纠错、去 AI 味的子智能体 输入/输出合规、质量门控、Shadow 写入规则
Analysis Agent 目标分析、实体解析、候选草稿提取的子智能体 拆分切块、入 RAG、来源状态校验
Detection Agent 风险识别、一致性检查、角色声音检查的子智能体 语义安全围栏、静态检查、权限过滤

外部 Agent 平台Dify、AgentScope、New-API 等只能接入开放槽位或系统定义的能力节点。它们不能替换输入合规、权限过滤、来源状态校验、Shadow -> Canonical、质量门控和输出合规等保护节点。外部运行时统一通过 专题-05-AI统一交互协议与外部AgentAdapter设计.md 定义的 adapter 协议接入。

3. Agent Runtime Permission Envelope

每次试用、生成、解析、检测和质量评测都必须有运行时权限包。前端、Prompt、模型输出和智能体自述权限无效。

最小语义:

字段语义 要求
actor 用户、管理员或系统服务身份
work / chapter / block 当前任务作用范围
slot 本次调用使用的能力槽位
agentVersion 实际运行的智能体版本
toolGrantSet 可调用工具授权集合,逐项约束动作、目的、输入、输出和副作用
allowedContextScopes 可读上下文范围包括正文、Local KB、用户知识库、全局知识库、市场资产
egressPolicy 是否允许外发、允许外发到哪些集成、是否需要脱敏
budget Token、重试、时间和费用预算
authorizationSnapshot 本次读取和外发使用的授权快照
sourceSnapshot 本次上下文来源摘要和版本
auditRequirement 是否必须记录、脱敏或进入高危审计

执行要求:

  1. 所有工具调用、上下文读取、检索和外部请求必须经过服务端 tool broker 或等价执行边界校验。
  2. 权限包只能收紧,不能被用户智能体、市场智能体或工作流步骤扩大。
  3. 任务中途来源撤权、召回、owner 缺失或安全阻断时,任务进入 needs_recheckfailed 或候选 invalidated,不得继续消费旧权限包。
  4. 权限包摘要进入任务记录和质量评测输入,便于复盘。

3.1 Tool Grant 语义

工具授权不是简单的工具名 allowlist。每个可调用工具必须绑定

语义 要求
tool / action 允许调用的工具和动作,不能用通配符扩大权限
purpose 本次调用目的,例如检索、切块、入 RAG、评估、导出预检
inputSources 工具可读取的来源范围和来源状态
outputSinks 工具结果允许写入的位置,例如 Shadow、任务记录、投影索引、审计摘要
sideEffectPolicy 是否允许副作用;允许时必须说明幂等键、补偿或回滚方式
egressDestination 是否外发,以及允许的集成目标
budget 单工具 token、次数、时间和费用预算
approval 是否需要管理员、用户或系统预检批准
auditClass 普通审计、敏感审计或高危审计

配置型智能体和工作流型智能体只能消费已授予的 Tool Grant不能在 Prompt、市场描述或工作流节点中自声明新增工具权限。

如果系统 Agent 版本引用 Dify agent / workflow 或未来 AgentScope graph外部平台内已经限制好的工具和知识权限只作为 provider 内部限制Muse runtime 仍必须在调用前生成 Runtime Permission Envelope并按该 envelope 裁剪上下文、外发目标和输出合同。外部平台返回的工具调用结果不能直接写 Canonical只能作为 Muse Shadow / task result 的输入。

4. 上下文组装

上下文组装(Context Assembly)是 AI Orchestration 的核心内部合同。它只能读取 owner BC 暴露的正式数据、授权资料和明确允许的待审对象。

4.1 请求语义

上下文组装输入至少包含:

语义 要求
actor / work / target 当前用户、作品、章节、Block 或任务目标
scenario continuation / rewrite / expansion / polish / extraction / full_parse / planning / validation / consistency_check / quality_gate
userIntent 用户当前意图或系统任务目标
agentSlot 本次使用的能力槽位
runtimePermissionEnvelope 运行时权限包引用
tokenBudget 输入输出预算和截断策略
requiredSources 必须读取的正文、规划、知识或外部资料范围
forbiddenSources 已撤权、下架、召回、blocked、owner_missing 或未授权来源
debugVisibility 是否允许返回调试快照

4.2 四层上下文

Layer 内容 可省略性 约束
Layer 0 当前输入 用户意图、当前文本、目标章节、目标 Block revision 不可省略 必须与 expectedRevision 或任务版本一致
Layer 1 近邻正文 当前章节、相邻 Block、章节目标、近期叙事状态 续写/改写不可省略 来源必须可追溯到 Work/Content
Layer 2 作品事实 Local KB、正式规划、角色关系、事件时间线、Narrative State 一致性/规划不可省略 只能读取 Canonical
Layer 3 授权资料 用户知识库、全局知识库、已安装知识库、允许的市场资产摘要 可按场景省略 必须绑定 Authorization Snapshot 和来源状态

Token 预算顺序:

  1. 保留输出预算。
  2. Layer 0 必须完整保留。
  3. Layer 1 优先于 Layer 2Layer 2 优先于 Layer 3。
  4. 超限时先摘要化低优先级资料,再截断。
  5. 被省略资料进入 omittedSources原因只能是 token_budgetnot_authorizedstale_sourcelow_confidencenot_relevantblocked

分层与预算回答「装多少、先装谁」;分区内「该选哪几条知识、以什么视图注入、按什么排序」的选择契约归 专题-07-知识消费契约与质量闭环,本册不重复定义。

4.3 来源和授权

每个进入上下文的外部或授权来源必须携带 Authorization Snapshot 或等价不可变指纹,最小语义包括:

语义 要求
actor / owner 本次使用者和来源 owner
source object / version 来源对象、版本和类型
license / policy 授权、许可、使用策略和限制
allowedPurpose 允许用途,例如上下文检索、生成参考、绑定、导出、确认知识
forbiddenPurpose 明确禁止用途,例如市场作品资产模板化、受限导出、二次分发
status active / stale / revoked / delisted / recalled / blocked / owner_missing / unauthorized
checkedAt 校验时间
expiresAt / recheckCondition 过期时间或需要重验的条件
displaySummary 可展示给用户的来源摘要

授权校验必须按用途执行。允许“阅读”的授权不等于允许进入 AI 上下文,允许“上下文检索”的授权不等于允许导出,允许“生成参考”的授权也不等于允许确认知识。

以下结果不得进入 Prompt

  1. 缺来源对象。
  2. 缺授权快照。
  3. 来源状态为 revoked、delisted、recalled、blocked、owner_missing 或 unauthorized。
  4. 检索结果只说明“来自某索引”,但无法回到 owner BC。
  5. 市场作品资产在 feature gate 未开启时作为模板、参考来源或 AI 上下文。

4.4 用户可解释响应

普通用户只能看到创作语言摘要,不看到完整 Prompt、密钥、调试层或供应商响应。

AI 结果必须能解释:

  • 使用了哪个智能体或系统链路。
  • 参考了哪些正文、规划、Local KB 或授权知识。
  • 哪些来源因撤权、召回、未授权或预算被排除。
  • 是否触发质量门控、重写、风险标记或输出阻断。
  • 下一步用户可以接受、修改、丢弃、重生成或进入知识确认。

5. 检索和图查询

5.1 RAG 定位

RAG / RAGFlow 是检索基座,不是 Muse 事实源。它只能消费 Work/Content、Knowledge、Marketplace/Asset 等 owner BC 的正式数据或授权资料投影,不能反向决定作品事实。

允许进入正式检索的来源:

来源 是否可进正式检索 约束
当前作品正文 Canonical 需要 revision 和 Block Source Attribution
Local KB Canonical 需要知识版本和来源状态
正式规划项 / Narrative State 需要 Work/Content owner 版本
用户知识库 / 全局知识库 / 已安装知识库 需要 Authorization Snapshot
AI Suggestion / Knowledge Draft / Planning Candidate 默认否 只能用于明确标记的预览、校验或审计
市场作品资产 阶段 6 否 feature gate 关闭,只能阅读、收藏和授权记录

5.2 检索失败边界

场景 系统行为
检索不可用、超时或认证失败 阻断依赖检索的生成、提取、规划和一致性检查
单条结果无权限 丢弃并记录摘要
单条结果缺来源 丢弃,不进入上下文
投影落后 尝试 owner BC overlay仍无法补齐则返回可恢复失败
来源撤权或召回 禁止新使用,相关候选或草稿进入 invalidated / needs_recheck

RAG 不可用不得阻止用户保存正文、查看已确认正文、查看已确认知识或处理本地 UI 状态。

5.3 检索结果合同

阶段 6 不规定具体图数据库、Graph Provider、queryType 或 fallback 实现。后续后端阶段可以选择 RAGFlow GraphRAG、图数据库或混合检索但交给 AI Orchestration 的检索结果合同必须稳定。

每条检索结果至少包含:

语义 要求
sourceOwner 来源 owner BC
sourceObject / sourceVersion 来源对象、版本和类型
evidence 证据摘要、定位和可解释引用
confidence 置信度与计算来源
authorizationSnapshot 本次用途的授权快照
sourceStatus active / stale / revoked / delisted / recalled / blocked / owner_missing / unauthorized
allowedPurpose 当前结果允许参与的用途

缺 source、version、evidence、confidence、authorizationSnapshot 或 sourceStatus 的结果不得进入上下文。检索层不能把“查到了”解释成“可使用”。

6. 生成、解析和检测结果

6.1 生成结果

生成任务只能输出:

  • AI Suggestion。
  • Candidate Quality Result。
  • Risk Marker。
  • Source Summary。
  • 可选 Knowledge Draft。

硬约束:

  1. AI Suggestion 进入 Shadow等待用户接受、修改后合并或丢弃。
  2. 接受 AI Suggestion 只写正文和候选归档,不自动确认 Knowledge Draft。
  3. 如果候选使用外部或授权来源,接受后必须写 Block Source Attribution。
  4. 候选来源撤权、召回、owner 缺失、版本冲突或合规阻断时,候选进入 invalidated不能继续接受。

6.2 解析结果

全书解析(Full Parse)必须按阶段 4 和架构 04 的章节审阅边界处理:

Parse Job -> Chapter Parse Result -> Chapter Review -> Knowledge Draft

约束:

  1. AI Orchestration 拥有 Parse Job 和 Chapter Parse Result。
  2. 用户确认章节审阅只表示“这一章解析结果可进入后续知识草稿处理”。
  3. Knowledge BC 在章节审阅确认后创建或更新 Knowledge Draft。
  4. 章节审阅不写 Canonical 知识,不写 Narrative State。
  5. 拆分切块、静态检查和入 RAG 是保护节点,用户智能体不可替换。

6.3 检测结果

检测类任务可以输出:

  • Consistency Check Result。
  • Risk Marker。
  • Source Conflict。
  • Quality Dimension Result。
  • 修复建议摘要。

检测结果不直接改正文、知识、规划或市场资产。用户必须在对应 owner 空间中决策。

7. Risk Routing

风险路由决定 AI 结果是否可展示、可接受、需重验或阻断。

风险类型 例子 系统行为
source_stale 来源版本变化、source hash 不匹配 禁用确认或要求重新生成
source_revoked 来源主动撤权 禁止新生成、新绑定、新来源型确认和受限导出
authorization_revoked 授权撤销 禁止继续使用该授权快照,相关候选、绑定、导出和下载凭证进入阻断或重验
asset_recalled 市场召回 禁止新生成、新绑定、新来源型确认和受限导出,并传播到已安装、已绑定、运行任务和未确认对象
source_delisted 市场下架 禁止新获取、新安装、新绑定和新导出,已授权阅读按治理策略限制
permission_denied 用户无权读取作品、知识库或智能体 阻断任务
safety_blocked 输入/输出合规失败、语义安全围栏阻断 阻断候选展示或接受
schema_invalid 输出结构不符合合同 重试或失败
quality_critical_failed 叙事质量关键维度不达标 在 Shadow 内有限重写;仍失败则标记高风险、需修改或按策略阻断
low_confidence 证据不足或置信度低 展示风险,由用户判断

风险等级:

等级 展示 是否允许用户接受
info 可解释提示
warning 明确展示风险和来源
high 要求显式确认或修改后合并 视场景
critical 阻断接受、绑定、导出或确认

风险标记属于 Shadow 解释,不是 Canonical 事实。风险、来源证据和用户决策必须进入 Archive 或审计摘要。

7.1 候选可接受性实时校验

候选是否可展示、可接受、需重验或阻断,必须由系统在接受时实时校验来源版本和授权状态来合并判断。校验逻辑不封装为独立对象,而是作为接受链路的内联前置条件执行。

最小校验输入:

  • Source Status / Authorization Snapshot / Work Asset feature gate。
  • 输入合规、输出合规、语义安全围栏和静态检查结果。
  • Candidate Quality Result id、qualityPolicyVersion 和评分时间。
  • Risk Marker。
  • 目标 Block expectedRevision、候选版本和命令幂等上下文。

校验输出:

语义 要求
decisionState displayable / acceptable / requires_explicit_confirm / needs_recheck / blocked / invalidated
acceptability 可接受、只能修改后合并、需重验、不可接受
blockingReasons 阻断原因和来源摘要
userActions 接受、修改后合并、丢弃、重生成、重验来源等可用动作
auditSummary 校验输入版本、质量结果版本、授权快照、来源状态、expectedRevision 和幂等摘要

7.2 决策优先级

候选可接受性实时校验按以下优先级合并,前面的硬阻断不能被后面的质量评分放开:

  1. 合规、安全、语义围栏、静态检查硬阻断。
  2. 来源 revoked、recalled、delisted、blocked、owner_missing、unauthorized 或授权快照无效。
  3. 市场作品资产 feature gate、owner 预检或 workAssetUsePrecheckId 缺失。
  4. Block revision、来源 stale、策略版本变化或授权过期导致的 needs_recheck
  5. 质量门控服务不可用、超时或关键叙事维度无法评估。
  6. 叙事质量 high risk、低置信度和普通 warning。
  7. pass / rewritten_pass。

8. 质量评测合同

质量评测分两层:

  1. 运行时质量门控:对单次候选交付前做关键维度评分和有限重写。
  2. 离线评估对智能体、Prompt、上下文策略和质量策略版本做评估集回归。

本文件只定义输入和追踪合同,质量门控策略、创作健康度展示和有限重写细则由 专题-04 承接。

质量评测输入必须绑定:

  • AI Task id。
  • Candidate id 或评估样本 id。
  • Agent Version。
  • Prompt Template / Prompt Version。
  • Context Assembly Snapshot。
  • Authorization Snapshot。
  • Source Summary。
  • Quality Policy Version。
  • New-API Binding 摘要。
  • Runtime Permission Envelope 摘要。

质量评测输出必须至少包含:

结果 要求
hardBlockDimensions 来源安全、输出合规、静态结构等硬阻断结果
criticalDimensions 叙事关键维度评分、是否触发重写、最终状态
nonCriticalDimensions 非关键维度评分和建议
riskMarkers 风险标记和来源摘要
rewriteCount 已触发重写次数
qualityState pass / rewritten_pass / high_risk / blocked / unavailable / needs_recheck
userExplanation 面向普通用户的创作语言解释

9. New-API 边界

New-API 是外部模型网关 authority。Muse 只保存本地绑定引用、幂等键、调用归属、最小调用摘要和异常状态。

允许保存:

字段语义 说明
newApiBindingRef Muse 侧绑定引用
newApiCredentialRef 指向密钥管理系统的凭据引用,不含明文
requestTrace New-API 返回的请求引用或 trace必须是白名单字段且已脱敏
modelAlias 使用的模型别名或能力标签
tokenSummary 输入/输出 token 摘要
latencyMs 延迟
errorClass 脱敏后的错误分类
taskId / actor / workId 调用归属

禁止保存:

  • New-API token 明文。
  • 供应商密钥。
  • 请求头、完整请求体、完整响应体。
  • 完整模型供应商路由表。
  • New-API 成本账本 authority。
  • 未脱敏 Prompt、候选全文、私有正文或外部知识全文。

用户可见错误只能展示分类、可理解摘要和下一步动作,不展示供应商原始错误、密钥、完整 Prompt、请求体、响应体或外部知识全文。

执行链:

AI Orchestration -> Integration Execution Facade -> New-API -> AI Task Result

归属链:

Integration Call Log -> Account/Usage/Audit -> Usage Record / Entitlement Snapshot / Personal Center Summary

10. Source Status Event

来源状态变化必须通过 Source Status Event 传播到候选、草稿、绑定、安装、运行任务、导出任务、下载凭证、个人中心和市场记录。具体状态机以 架构-04 为准;本专题只规定 AI 编排和质量链路必须消费这些事件,不能继续使用旧来源。

这里必须区分三层语义,不能把 allowedblockedneeds_recheck 这类动作结论简化成无法解释的来源状态。

层级 归属 含义 示例
SourceStatus 来源 owner / Marketplace/Asset BC 来源对象当前可证明的事实状态 active、stale、revoked、delisted、recalled、owner_missing、blocked、unauthorized
SourceEventType 事件发布方 触发状态或策略变化的原因 source_updated、source_revoked、asset_delisted、asset_recalled、asset_blocked、owner_missing、authorization_revoked、authorization_expired、license_changed、processing_failed、recheck_required
Action Policy 消费方按用途计算 本次动作是否允许执行 allowed、read_only、needs_recheck、blocked

同一个 SourceStatus 可以按用途得到不同 Action Policy例如 delisted 可允许用户查看历史授权记录,但阻断新安装、新绑定、新生成、新导出、来源型确认和候选接受。

事件最小语义:

语义 要求
sourceOwner 来源 owner BC
sourceId / sourceVersion 来源对象和版本
sourceStatus 事件后的 SourceStatus
eventType SourceEventType例如 source_updated / source_revoked / authorization_revoked / authorization_expired / asset_delisted / asset_recalled / asset_blocked / owner_missing / license_changed / processing_failed / recheck_required
actionPolicies 按用途计算的 Action Policy例如 read、generate、bind、confirm_source_fact、accept_candidate、export、download
reason 可解释原因
idempotencyKey 幂等键
impactScope 影响对象范围
emittedAt 事件时间

传播目标:

目标对象 Owner 最小状态变化 失败策略
AI Suggestion / Planning Candidate AI Orchestration BC needs_recheck / invalidated / blocked fail-default 禁用接受或确认
Knowledge Draft Knowledge BC needs_recheck / unconfirmable / invalidated 禁用来源型确认
Chapter Parse Result AI Orchestration BC needs_recheck / stale 禁用章节审阅确认
Context Assembly Snapshot AI Orchestration BC stale / blocked / needs_recheck 后续生成不得继续消费旧上下文
Knowledge Source Binding Knowledge BC stale / revoked / blocked 禁用新检索、新绑定或新确认
Agent Slot Binding Agent BC needs_recheck / disabled 禁用运行或要求重新预检
Installed Agent / Installed KB Marketplace/Asset BC disabled / limited / recalled 禁用新使用,保留授权记录
Running Task AI Orchestration BC cancelling / failed / needs_recheck 停止消费旧权限包
Export Task / download credential 下载凭证 Export / Delivery owner disabled / revoked / needs_recheck 禁用下载或要求导出重验;已签发但未使用或未过期凭证必须作废或重验
Personal Center Summary Account read model risk_summary_updated 只展示摘要和跳转,不成为事实 owner
Marketplace / Publisher Record Marketplace/Asset BC delisted / recalled / appealable 进入治理、申诉或下架链路

Source Status Event 必须幂等处理,传播失败时要可重试;在传播完成前,新使用一律 fail-default 禁用,并暴露可重试治理入口。

11. 验收清单

阶段 6 后,本专题必须满足:

  1. 不出现 AI 绕过用户决策写入 Canonical 的链路。
  2. 不出现接受候选同时写入 Local KB 的链路。
  3. 不出现用户智能体替换保护节点的链路。
  4. 任何外部或授权来源进入上下文时,都有 Authorization Snapshot 和 Source Status。
  5. 任何含 AI、市场、外部知识或授权知识来源的正文写入都能落到 Block Source Attribution。
  6. New-API 只作为外部网关,不成为 Muse 本地模型路由和成本 authority。
  7. 质量评测结果能被 专题-04 的质量门控和创作健康度直接消费。
  8. 候选可接受性实时校验能统一合并来源、权限、合规、质量和风险路由结果。

12. 关联阅读

  • 产品-01-产品定位与核心价值.md
  • 产品-02-核心功能与交互边界.md
  • 产品-03-用户旅程与操作流程.md
  • 流程-01B-普通用户操作流程(操作视角).md
  • 流程-02B-普通用户系统处理流程(系统视角).md
  • 架构-01-系统全貌与边界上下文.md
  • 架构-02-核心数据结构与双轨模型.md
  • 架构-04-状态机与约束清单.md
  • 专题-04-生成质量门控与创作健康度设计方案.md
  • 专题-07-知识消费契约与质量闭环.md