muse-agent-example/docs/系统架构/新版设计/文件设计/后端-装配与接入.md

后端-装配与接入：文件合同

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

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

本部分文件树

agent-example/
└── src/
    └── muse/
        ├── __init__.py  # 应用包身份
        ├── __main__.py  # Python 命令入口
        ├── 共享/
        │   ├── __init__.py  # Python 包身份
        │   ├── 时间.py  # 时钟和期限类型
        │   ├── 标识.py  # 少量稳定身份与不可变引用
        │   ├── 版本.py  # revision、内容哈希与版本引用
        │   ├── 调用身份.py  # 作者、任务、用途和授权上下文
        │   └── 错误.py  # 共用错误结构
        ├── 启动.py  # 选择并注入数据库、宿主、模块和流程实现
        ├── 接入/
        │   ├── __init__.py  # Python 包身份
        │   ├── cli/
        │   │   ├── __init__.py  # Python 包身份
        │   │   ├── 交付命令.py  # 完整定稿、实际导出与版本发布反馈
        │   │   ├── 任务命令.py  # 查看、取消、暂停和恢复
        │   │   ├── 作品命令.py  # 作品和规划动作
        │   │   ├── 入口.py  # 命令登记与统一结果输出
        │   │   ├── 创作命令.py  # 写作与修订动作
        │   │   ├── 审校命令.py  # 明确作者声音决定、完整审校与显式离线诊断
        │   │   ├── 审阅命令.py  # 按目标类型执行作者决定
        │   │   ├── 研究命令.py  # 资料、拆书与方法动作
        │   │   ├── 管理命令.py  # 配置、归档、备份和恢复
        │   │   ├── 经验命令.py  # 具体改进、实际owner回执与分版本作者观察
        │   │   ├── 结构命令.py  # 结构版本、作品扩展和兼容检查
        │   │   ├── 维护命令.py  # 维护计划与点名推进的薄CLI适配
        │   │   ├── 角色行为命令.py  # 角色行为CLI准备、点名执行和实际报告查询
        │   │   └── 评测命令.py  # 隔离实验入口
        │   ├── http/
        │   │   ├── __init__.py  # Python 包身份
        │   │   ├── 事件订阅.py  # 从持久化事件游标订阅和续接
        │   │   ├── 作者会话.py  # 单作者身份与写入请求来源
        │   │   ├── 依赖.py  # 注入作者身份、任务用途和业务接口
        │   │   ├── 健康检查.py  # 进程与依赖就绪状态
        │   │   ├── 应用.py  # HTTP 应用及生命周期
        │   │   ├── 路由/
        │   │   │   ├── __init__.py  # Python 包身份
        │   │   │   ├── 上下文.py  # 上下文的类型化查询与动作
        │   │   │   ├── 交付连载.py  # 交付连载的类型化查询与动作
        │   │   │   ├── 任务运行.py  # 任务运行的类型化查询与动作
        │   │   │   ├── 作品规划.py  # 作品规划的类型化查询与动作
        │   │   │   ├── 作者审阅.py  # 作者审阅的类型化查询与动作
        │   │   │   ├── 作者经验.py  # 作者经验的类型化查询与动作
        │   │   │   ├── 元数据.py  # 元数据的类型化查询与动作
        │   │   │   ├── 创作生成.py  # 通用生成的类型化发起与审校报告查询
        │   │   │   ├── 审校修订.py  # 审校修订的类型化查询与动作
        │   │   │   ├── 故事世界.py  # 故事世界的类型化查询与动作
        │   │   │   ├── 效果评测.py  # 效果评测的类型化查询与动作
        │   │   │   ├── 正文写作.py  # 正文写作的类型化查询与动作
        │   │   │   ├── 知识方法.py  # 知识方法的类型化查询与动作
        │   │   │   ├── 系统管理.py  # 系统管理的类型化查询与动作
        │   │   │   └── 资料研究.py  # 资料研究的类型化查询与动作
        │   │   ├── 错误响应.py  # 错误码、中文说明、冲突与可重试性
        │   │   └── 静态资源.py  # 发布工作台与静态资源
        │   ├── 主会话.py  # 中文意图和已授权作者动作接入，关联对话及任务
        │   ├── 创作操作.py  # 人工创作具名请求外壳及作者身份构造
        │   ├── 只读工具.py  # 模型可见工具和任务范围绑定
        │   ├── 审校操作.py  # 声音、完整审校与诊断的HTTP和CLI共同请求
        │   ├── 执行器.py  # 后台进程入口、用途装配和优雅停机
        │   ├── 经验操作.py  # 按服务端真实任务用途核对来源及保存运行观察
        │   ├── 结构操作.py  # 结构候选、发布与兼容检查的跨接入类型合同
        │   └── 评测操作.py  # 评测命令外壳及操作者用途；不自报作者或运行证明
        ├── 资源加载.py  # 安装包资源、发布身份与哈希核对
        └── 配置.py  # 配置解析、校验与连接引用

逐文件合同

src/muse/__init__.py

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

src/muse/__main__.py

• 归属与种类：装配；源码。
• 意图：提供安装后的统一 Python 命令入口。
• 职责：Python 命令入口。
• 边界：只把命令转交接入与启动装配，不创建第二套业务或连接逻辑。
• 目标：安装后 python -m muse 使用与 CLI 一致的参数、退出码和业务结果。
• 合同依据：专属接口与副作用。

src/muse/启动.py

• 归属与种类：装配；源码。
• 意图：让环境实现的选择集中在唯一装配位置。
• 职责：选择并注入数据库、宿主、模块和流程实现。
• 边界：只配置和注入模块、宿主、连接、资源与流程；不承载创作规则。
• 目标：更换宿主或连接实现无需修改业务规则，包可在任意 cwd 启动。
• 合同依据：专属接口与副作用。

src/muse/配置.py

• 归属与种类：装配；源码。
• 意图：在启动前明确配置缺失与冲突。
• 职责：配置解析、校验与连接引用。
• 边界：解析、校验与引用解析；不连接数据库、不输出凭据值。
• 目标：缺配置或不合法策略在启动边界可定位，不回退到隐式正式库。
• 合同依据：专属接口与副作用。

src/muse/资源加载.py

• 归属与种类：装配；源码。
• 意图：让运行不依赖 Git 工作树、tests 或目录层数。
• 职责：安装包资源、发布身份与哈希核对。
• 边界：只读安装包中有发布身份的资源；不加载任意用户路径。
• 目标：资源哈希和版本可核对，缺资源明确失败。
• 合同依据：专属接口与副作用。

src/muse/接入/http/应用.py

• 归属与种类：接入；源码。
• 意图：组织服务生命周期与路由。
• 职责：HTTP 应用及生命周期。
• 边界：应用装配由启动注入；不执行领域逻辑。
• 目标：依赖就绪与停机行为明确，失败不伪装正常启动。
• 合同依据：HTTP 基础。

src/muse/接入/http/依赖.py

• 归属与种类：接入；源码。
• 意图：把请求绑定到真实身份和用途。
• 职责：注入作者身份、任务用途和业务接口。
• 边界：不接受客户端自报更高身份；不创建隐式正式库连接。
• 目标：每条业务调用有可核查作者、任务和用途。
• 合同依据：HTTP 基础。

src/muse/接入/http/作者会话.py

• 归属与种类：接入；源码。
• 意图：让作者动作和模型任务具备不同权限。
• 职责：单作者身份与写入请求来源。
• 边界：仅处理单作者认证与写入来源；不做多租户平台或授予模型确认权。
• 目标：未认证或错误来源写入被拒绝，合法作者会话可恢复。
• 合同依据：HTTP 基础。

src/muse/接入/http/错误响应.py

• 归属与种类：接入；源码。
• 意图：让失败可以被作者和客户端正确处理。
• 职责：错误码、中文说明、冲突与可重试性。
• 边界：转换已有错误；不吞异常、不伪造成功或直接覆盖冲突。
• 目标：错误码、中文原因和后续动作一致，凭据不出现在详情。
• 合同依据：HTTP 基础。

src/muse/接入/http/事件订阅.py

• 归属与种类：接入；源码。
• 意图：支持页面断线后的状态续接。
• 职责：从持久化事件游标订阅和续接。
• 边界：只消费已持久化事件；不以内存替代任务状态。
• 目标：游标重连不漏有效终态，重复事件可去重。
• 合同依据：HTTP 基础。

src/muse/接入/http/健康检查.py

• 归属与种类：接入；源码。
• 意图：区分进程存活与依赖可用。
• 职责：进程与依赖就绪状态。
• 边界：只报告自身和必要依赖；不把健康标志当业务通过。
• 目标：连接或关键资源失效时就绪状态如实反映。
• 合同依据：HTTP 基础。

src/muse/接入/http/静态资源.py

• 归属与种类：接入；源码。
• 意图：提供与后端发布版本配套的工作台。
• 职责：发布工作台与静态资源。
• 边界：只服务构建产物；不暴露私人草稿、raw 或任意文件路径。
• 目标：非 Git 工作树部署可加载页面，受控资源之外不可读。
• 合同依据：HTTP 基础。

src/muse/接入/http/路由/作品规划.py

• 归属与种类：接入；源码。
• 意图：把 作品规划 的业务接口映射为稳定 HTTP 动作。
• 职责：作品规划的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/故事世界.py

• 归属与种类：接入；源码。
• 意图：把 故事世界 的业务接口映射为稳定 HTTP 动作。
• 职责：故事世界的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/资料研究.py

• 归属与种类：接入；源码。
• 意图：把 资料研究 的业务接口映射为稳定 HTTP 动作。
• 职责：资料研究的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/知识方法.py

• 归属与种类：接入；源码。
• 意图：把 知识方法 的业务接口映射为稳定 HTTP 动作。
• 职责：知识方法的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/正文写作.py

• 归属与种类：接入；源码。
• 意图：把 正文写作 的业务接口映射为稳定 HTTP 动作。
• 职责：正文写作的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/审校修订.py

• 归属与种类：接入；源码。
• 意图：把 审校修订 的业务接口映射为稳定 HTTP 动作。
• 职责：审校修订的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/作者经验.py

• 归属与种类：接入；源码。
• 意图：把 作者经验 的业务接口映射为稳定 HTTP 动作。
• 职责：作者经验的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/交付连载.py

• 归属与种类：接入；源码。
• 意图：把 交付连载 的业务接口映射为稳定 HTTP 动作。
• 职责：交付连载的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/上下文.py

• 归属与种类：接入；源码。
• 意图：把 上下文 的业务接口映射为稳定 HTTP 动作。
• 职责：上下文的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/效果评测.py

• 归属与种类：接入；源码。
• 意图：把 效果评测 的业务接口映射为稳定 HTTP 动作。
• 职责：效果评测的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/作者审阅.py

• 归属与种类：接入；源码。
• 意图：把作者决定绑定到实际看到的版本和差异。
• 职责：作者审阅的类型化查询与动作。
• 边界：记录展示与具体批准；创建审阅记录不等于已经批准。
• 目标：决定与候选、目标、结构和批准范围可核对。
• 合同依据：专属业务职责。

src/muse/接入/http/路由/任务运行.py

• 归属与种类：接入；源码。
• 意图：把 任务运行 的业务接口映射为稳定 HTTP 动作。
• 职责：任务运行的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/系统管理.py

• 归属与种类：接入；源码。
• 意图：把 系统管理 的业务接口映射为稳定 HTTP 动作。
• 职责：系统管理的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/http/路由/元数据.py

• 归属与种类：接入；源码。
• 意图：把 元数据 的业务接口映射为稳定 HTTP 动作。
• 职责：元数据的类型化查询与动作。
• 边界：只做协议、身份和序列化；不直写表、不执行任意脚本、不替作者批准。
• 目标：成功响应能回查真实业务回执，错误保留版本、范围及可重试信息。
• 合同依据：HTTP 路由。

src/muse/接入/cli/入口.py

• 归属与种类：接入；源码。
• 意图：让命令行使用同一 命令登记与统一结果输出 能力。
• 职责：命令登记与统一结果输出。
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机。
• 目标：命令与 HTTP 用例保持相同结果与拒绝条件，退出码可解释。
• 合同依据：CLI 接入。

src/muse/接入/cli/作品命令.py

• 归属与种类：接入；源码。
• 意图：让命令行使用同一 作品和规划动作 能力。
• 职责：作品和规划动作。
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机。
• 目标：命令与 HTTP 用例保持相同结果与拒绝条件，退出码可解释。
• 合同依据：CLI 接入。

src/muse/接入/cli/创作命令.py

• 归属与种类：接入；源码。
• 意图：让命令行使用同一 写作与修订动作 能力。
• 职责：写作与修订动作。
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机。
• 目标：命令与 HTTP 用例保持相同结果与拒绝条件，退出码可解释。
• 合同依据：CLI 接入。

src/muse/接入/cli/研究命令.py

• 归属与种类：接入；源码。
• 意图：让命令行使用同一 资料、拆书与方法动作 能力。
• 职责：资料、拆书与方法动作。
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机。
• 目标：命令与 HTTP 用例保持相同结果与拒绝条件，退出码可解释。
• 合同依据：CLI 接入。

src/muse/接入/cli/审阅命令.py

• 归属与种类：接入；源码。
• 意图：让命令行使用同一 按目标类型执行作者决定 能力。
• 职责：按目标类型执行作者决定。
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机。
• 目标：命令与 HTTP 用例保持相同结果与拒绝条件，退出码可解释。
• 合同依据：CLI 接入。

src/muse/接入/cli/任务命令.py

• 归属与种类：接入；源码。
• 意图：让命令行使用同一 查看、取消、暂停和恢复 能力。
• 职责：查看、取消、暂停和恢复。
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机。
• 目标：命令与 HTTP 用例保持相同结果与拒绝条件，退出码可解释。
• 合同依据：CLI 接入。

src/muse/接入/cli/评测命令.py

• 归属与种类：接入；源码。
• 意图：让命令行使用同一 隔离实验入口 能力。
• 职责：隔离实验入口。
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机。
• 目标：命令与 HTTP 用例保持相同结果与拒绝条件，退出码可解释。
• 合同依据：CLI 接入。

src/muse/接入/cli/结构命令.py

• 归属与种类：接入；源码。
• 意图：让命令行使用同一 结构版本、作品扩展和兼容检查 能力。
• 职责：结构版本、作品扩展和兼容检查。
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机。
• 目标：命令与 HTTP 用例保持相同结果与拒绝条件，退出码可解释。
• 合同依据：CLI 接入。

src/muse/接入/cli/管理命令.py

• 归属与种类：接入；源码。
• 意图：让命令行使用同一 配置、归档、备份和恢复 能力。
• 职责：配置、归档、备份和恢复。
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机。
• 目标：命令与 HTTP 用例保持相同结果与拒绝条件，退出码可解释。
• 合同依据：CLI 接入。

src/muse/接入/主会话.py

• 归属与种类：接入；源码。
• 意图：把作者意图转为已有业务动作而不依赖会话记账。
• 职责：中文意图和已授权作者动作接入，关联对话及任务。
• 边界：关联对话和任务；不由模型代替作者批准，不保留第二份正式内容。
• 目标：会话退出后任务和候选可回查，具体作者动作有命令身份。
• 合同依据：专属接口与副作用。

src/muse/接入/只读工具.py

• 归属与种类：接入；源码。
• 意图：提供模型可用的窄读取接口。
• 职责：模型可见工具和任务范围绑定。
• 边界：从服务端任务取得身份和范围；不信任模型自报作品、章号或用途。
• 目标：预组装、探索与回放均不能越界，拒绝有明确错误。
• 合同依据：专属接口与副作用。

src/muse/接入/执行器.py

• 归属与种类：接入；源码。
• 意图：给同一业务包提供后台进程入口。
• 职责：后台进程入口、用途装配和优雅停机。
• 边界：启动、领取循环和停机；不定义业务步骤和文学判断。
• 目标：停止领取后能释放或完成租约，重启按持久状态恢复。
• 合同依据：专属接口与副作用。

src/muse/共享/标识.py

• 归属与种类：共享；源码。
• 意图：使 少量稳定身份与不可变引用 在模块间保持同一种解释。
• 职责：少量稳定身份与不可变引用。
• 边界：仅少量不可变基础类型；不导入业务模块或新增通用业务框架。
• 目标：模块可共享身份和错误而不产生反向依赖或副作用。
• 合同依据：共享基础。

src/muse/共享/调用身份.py

• 归属与种类：共享；源码。
• 意图：使 作者、任务、用途和授权上下文 在模块间保持同一种解释。
• 职责：作者、任务、用途和授权上下文。
• 边界：仅少量不可变基础类型；不导入业务模块或新增通用业务框架。
• 目标：模块可共享身份和错误而不产生反向依赖或副作用。
• 合同依据：共享基础。

src/muse/共享/版本.py

• 归属与种类：共享；源码。
• 意图：使 revision、内容哈希与版本引用 在模块间保持同一种解释。
• 职责：revision、内容哈希与版本引用。
• 边界：仅少量不可变基础类型；不导入业务模块或新增通用业务框架。
• 目标：模块可共享身份和错误而不产生反向依赖或副作用。
• 合同依据：共享基础。

src/muse/共享/时间.py

• 归属与种类：共享；源码。
• 意图：使 时钟和期限类型 在模块间保持同一种解释。
• 职责：时钟和期限类型。
• 边界：仅少量不可变基础类型；不导入业务模块或新增通用业务框架。
• 目标：模块可共享身份和错误而不产生反向依赖或副作用。
• 合同依据：共享基础。

src/muse/共享/错误.py

• 归属与种类：共享；源码。
• 意图：使 共用错误结构 在模块间保持同一种解释。
• 职责：共用错误结构。
• 边界：仅少量不可变基础类型；不导入业务模块或新增通用业务框架。
• 目标：模块可共享身份和错误而不产生反向依赖或副作用。
• 合同依据：共享基础。

src/muse/接入/http/__init__.py

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

src/muse/接入/__init__.py

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

src/muse/接入/http/路由/__init__.py

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

src/muse/接入/cli/__init__.py

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

src/muse/共享/__init__.py

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

src/muse/接入/结构操作.py

• 意图与职责：结构候选、发布与兼容检查的跨接入类型合同。
• 边界：只调用所属公开接口；测试使用隔离数据。
• 目标：返回值和失败语义可复验。

src/muse/接入/创作操作.py

• 归属与种类：接入；源码。
• 意图：人工创作具名请求外壳及作者身份构造。
• 职责：人工创作具名请求外壳及作者身份构造。
• 边界：只走已登记的真实owner，不接SQL或作者自报身份。
• 目标：命令、版本、中文内容和错误能实际核对。
• 合同依据：命令与作者决策。

src/muse/接入/http/路由/创作生成.py

• 归属与种类：接入；HTTP 路由。
• 意图：作者经工作台发起通用生成并读取候选审校报告。
• 职责：发起生成任务（运行配置由作者明确选择）；按候选版本查询独立检查报告。
• 边界：只做协议、身份和序列化；不直写表、不替作者批准候选、不替作者选择配置。
• 目标：发起返回可追踪任务；报告与候选版本一一对应；错误保留错误码与可重试信息。
• 合同依据：S02 任务运行、B06 审校修订。

src/muse/接入/评测操作.py

• 归属与种类：接入；源码。
• 意图：评测命令外壳及操作者用途；不自报作者或运行证明。
• 职责：评测命令外壳及操作者用途；不自报作者或运行证明。
• 边界：只走已登记的真实owner，不接SQL或作者自报身份。
• 目标：命令、版本、中文内容和错误能实际核对。
• 合同依据：接口契约/命令与作者决策.md。

src/muse/接入/cli/角色行为命令.py

角色行为CLI准备、点名执行和实际报告查询。合同见效果评测。只通过所属模块公开接口；合成角色循环不作为真实模型效果或启用证明。

src/muse/接入/cli/经验命令.py

• 归属与种类：接入；源码。
• 职责：具体改进、真实回执与长期观察。
• 边界：只通过owner改变目标，保留版本和未知值，不据此声明因果。
• 合同依据：B07作者经验。

src/muse/接入/cli/交付命令.py

• 职责：完整定稿、实际导出与版本发布反馈。
• 边界：不覆盖工作正文、旧定稿或发布历史；不推断反馈因果。
• 目标：从真实作者入口读回固定版本与产物，失败可恢复。

src/muse/接入/cli/维护命令.py

• 归属：接入。
• 职责：维护计划与点名推进的薄CLI适配。
• 合同：备份与恢复入口。

src/muse/接入/审校操作.py

• 维护者：接入
• 职责：声音、完整审校与诊断的HTTP和CLI共同请求
• 设计意图：声音、完整审校与诊断的HTTP和CLI共同请求
• 边界：只走已登记的真实owner，不接SQL或作者自报身份
• 合同依据：接口契约/命令与作者决策.md

src/muse/接入/cli/审校命令.py

• 维护者：接入
• 职责：明确作者声音决定、完整审校与显式离线诊断
• 设计意图：明确作者声音决定、完整审校与显式离线诊断
• 边界：参数与结果适配；不另写 SQL、模型治理或候选状态机
• 合同依据：CLI 接入

src/muse/接入/经验操作.py

• 维护者：接入。
• 职责：按服务端真实任务用途核对来源及保存运行观察。
• 合同：模块合同。