muse-agent-example/docs/系统架构/新版设计/文件设计/后端-流程编排.md

后端-流程编排：文件合同

本页从目标文件清单投影，共 20 个目标条目。测试身份与行为合同在现行用例清单；文件和目标合同不代表实现或验收已完成。

返回目录 · 完整项目树 · 现行用例清单

本部分文件树

agent-example/
└── src/
    └── muse/
        └── 编排/
            ├── __init__.py  # Python 包身份
            ├── 作品准备.py  # 探索交接、规划、设定及方法绑定衔接
            ├── 完整审校.py  # 只读完整审校流程装配和逐片judge派发
            ├── 定稿交付.py  # 全书检查、版本清单、导出与核对
            ├── 审校修订.py  # 诊断、受控修改、有界返修及等待作者
            ├── 执行评测.py  # 按隔离用途逐例执行实验
            ├── 接口.py  # 公开流程发起与任务查询
            ├── 数据维护.py  # 归档、备份、隔离恢复及引用安全删除
            ├── 槽位约束.py  # 开放槽位兼容性与保护节点不可绕行检查
            ├── 流程版本.py  # 固定流程定义、步骤版本和配置
            ├── 流程登记.py  # 登记具名步骤与流程类型
            ├── 生成正文.py  # 预组装、受限探索、冻结回放、无工具写作和检查
            ├── 生成规划.py  # 受控规划：冻结材料、固定 planner、保存候选；不替代作者确认
            ├── 研究拆书.py  # 资料处理、分窗分析、恢复与成果交接
            ├── 章后处理.py  # 摘要、事实提案、索引及影响复核
            ├── 经验改进.py  # 具体变更评测、批准及目标模块启用
            ├── 行为评测.py  # 角色请求准备、S02有限会话执行及证据查询
            ├── 规划章节.py  # 前置条件、近期细化与规划候选
            ├── 载入模板.py  # 流程模板 YAML 的受控载入
            └── 运行装配.py  # 包内流程按需发布和作者点名推进一个冻结步骤

逐文件合同

src/muse/编排/接口.py

• 归属与种类：编排；源码。
• 意图：让调用方通过稳定用例操作编排，隐藏模块内部组织。
• 职责：公开流程发起与任务查询。
• 边界：唯一跨模块表面；导出输入输出合同，不暴露私有 SQL 或任意处理器。
• 目标：HTTP、CLI 和编排对相同用例得到一致验证、失败与结果。
• 合同依据：业务公开接口。

src/muse/编排/流程登记.py

• 归属与种类：编排；源码。
• 意图：给步骤实现提供具名、受控的登记。
• 职责：登记具名步骤与流程类型。
• 边界：只登记已实现处理器；不执行模型提供路径或任意代码。
• 目标：未知处理器无法形成可运行任务。
• 合同依据：流程编排。

src/muse/编排/流程版本.py

• 归属与种类：编排；源码。
• 意图：让流程配置与实际执行可追溯。
• 职责：固定流程定义、步骤版本和配置。
• 边界：固定节点、槽位和输入输出版本；不修改历史流程定义。
• 目标：任务能回查确切流程，更新不静默改变运行中步骤。
• 合同依据：流程编排。

src/muse/编排/槽位约束.py

• 归属与种类：编排；源码。
• 意图：保护可替换能力仍经过必需检查。
• 职责：开放槽位兼容性与保护节点不可绕行检查。
• 边界：只核对已登记槽位和保护路径；不让配置删除安全与确认节点。
• 目标：所有合法路径包含适用保护，能力和合同不兼容时拒绝。
• 合同依据：流程编排。

src/muse/编排/作品准备.py

• 归属与种类：编排；源码。
• 意图：把“作品准备”的跨模块交接收在一条可恢复旅程。
• 职责：探索交接、规划、设定及方法绑定衔接。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/规划章节.py

• 归属与种类：编排；源码。
• 意图：把“规划章节”的跨模块交接收在一条可恢复旅程。
• 职责：前置条件、近期细化与规划候选。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/生成正文.py

• 归属与种类：编排；源码。
• 意图：把“生成正文”的跨模块交接收在一条可恢复旅程。
• 职责：预组装、受限探索、冻结回放、无工具写作和检查。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/研究拆书.py

• 归属与种类：编排；源码。
• 意图：把“研究拆书”的跨模块交接收在一条可恢复旅程。
• 职责：资料处理、分窗分析、恢复与成果交接。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/审校修订.py

• 归属与种类：编排；源码。
• 意图：把“审校修订”的跨模块交接收在一条可恢复旅程。
• 职责：诊断、受控修改、有界返修及等待作者。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/章后处理.py

• 归属与种类：编排；源码。
• 意图：把“章后处理”的跨模块交接收在一条可恢复旅程。
• 职责：摘要、事实提案、索引及影响复核。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/经验改进.py

• 归属与种类：编排；源码。
• 意图：把“经验改进”的跨模块交接收在一条可恢复旅程。
• 职责：具体变更评测、批准及目标模块启用。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/定稿交付.py

• 归属与种类：编排；源码。
• 意图：把“定稿交付”的跨模块交接收在一条可恢复旅程。
• 职责：全书检查、版本清单、导出与核对。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/执行评测.py

• 归属与种类：编排；源码。
• 意图：把“执行评测”的跨模块交接收在一条可恢复旅程。
• 职责：按隔离用途逐例执行实验。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/数据维护.py

• 归属与种类：编排；源码。
• 意图：把“数据维护”的跨模块交接收在一条可恢复旅程。
• 职责：归档、备份、隔离恢复及引用安全删除。
• 边界：只调用模块公开用例并按授权安排步骤；不嵌入 SQL、宿主协议或自动创作决定。
• 目标：每步输入、产物、等待和失败有检查点，关闭会话后仍可继续。
• 合同依据：流程编排。

src/muse/编排/__init__.py

• 归属与种类：工程；源码。
• 意图：明确安装包和模块的导入身份。
• 职责：Python 包身份。
• 边界：只声明包及必要公开导出；不读取运行数据、连接网络或启动任务。
• 目标：正常安装后可从任意 cwd 导入，导入无运行副作用。
• 合同依据：Python 包身份。

src/muse/编排/载入模板.py

• 归属与种类：编排；流程模板载入。
• 意图：让可审 YAML 配置成为流程定义的唯一来源。
• 职责：读取流程模板并映射为流程定义；结构不完整或含未登记字段即拒绝。
• 边界：只允许引用已登记处理器与固定版本；不能删除保护节点或运行任意脚本；载入产物交由流程校验冻结。
• 目标：模板损坏、缺字段或引用未知处理器在发布前失败，不静默降级。
• 合同依据：流程编排、配置/流程模板/生成正文.yaml。

src/muse/编排/生成规划.py

职责：受控规划：冻结材料、固定 planner、保存候选；不替代作者确认。

合同依据：流程编排。机械范围与用例绑定见目标文件清单中同路径条目。

src/muse/编排/完整审校.py

职责：只读完整审校流程装配和逐片judge派发。

合同依据：流程编排。机械范围与用例绑定见目标文件清单中同路径条目。

src/muse/编排/行为评测.py

角色请求准备、S02有限会话执行及证据查询。合同见效果评测。只通过所属模块公开接口；合成角色循环不作为真实模型效果或启用证明。

src/muse/编排/运行装配.py

• 归属：编排。
• 职责：包内流程按需发布和作者点名推进一个冻结步骤。
• 合同：公开执行与恢复合同。