muse-agent-example/docs/系统架构/新版设计/文件设计/后端-B07-作者经验.md

后端-B07-作者经验：文件合同

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

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

本部分文件树

agent-example/
└── src/
    └── muse/
        └── 作者经验/
            ├── __init__.py  # Python 包身份
            ├── 作者偏好.py  # 捕获、确认、范围、冲突和撤回
            ├── 反馈对.py  # 原稿、改稿、作者原话及决策
            ├── 启用回执.py  # 目标模块启停请求、批准及回执
            ├── 存储.py  # 作者经验所属记录的 SQL 与版本读写
            ├── 接口.py  # 作者经验公开用例和可导入合同
            ├── 提示词/
            │   └── 整理偏好与改进建议.md  # 保留原话及区分推断的提案模板
            ├── 改进提案.py  # 具体目标变更、版本及内容哈希
            ├── 模型.py  # 作者经验稳定对象、外壳及内部状态
            ├── 观察记录.py  # 运行观察、重复问题及背景
            ├── 运行观察.py  # 真实尝试与具名业务来源的观察和重复问题查询
            ├── 长期观察.py  # 人审时间、返工、误杀与退化
            └── 验证申请.py  # 实验请求与逐例结果关联

逐文件合同

src/muse/作者经验/接口.py

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

src/muse/作者经验/模型.py

• 归属与种类：B07；源码。
• 意图：把作者经验的稳定数据骨架与执行实现分开。
• 职责：作者经验稳定对象、外壳及内部状态。
• 边界：纯模型和状态合同；不联网或写库，不把题材属性写死为类字段。
• 目标：稳定外壳可校验，动态内容携带结构绑定并在所属校验链验证。
• 合同依据：稳定模型。

src/muse/作者经验/存储.py

• 归属与种类：B07；源码。
• 意图：将作者经验的数据访问与版本写入局限在本模块。
• 职责：作者经验所属记录的 SQL 与版本读写。
• 边界：只操作本模块记录并使用调用方事务；不跨 owner 写表或调用模型。
• 目标：版本读写及回滚可验证，不产生第二个独立事务结果。
• 合同依据：模块存储。

src/muse/作者经验/作者偏好.py

• 归属与种类：B07；源码。
• 意图：使长期偏好与临时要求可区分、可撤回。
• 职责：捕获、确认、范围、冲突和撤回。
• 边界：显式要求和推断候选分开；不覆盖小说事实和他域生效状态。
• 目标：推断先确认，作用域冲突可见，撤回后停止新消费。
• 合同依据：专属业务职责。

src/muse/作者经验/反馈对.py

• 归属与种类：B07；源码。
• 意图：保留作者为什么选择一个版本。
• 职责：原稿、改稿、作者原话及决策。
• 边界：维护版本对、原话与决定；不从缺失上下文推断因果。
• 目标：原稿、改稿、理由和任务背景可关联。
• 合同依据：专属业务职责。

src/muse/作者经验/观察记录.py

• 归属与种类：B07；源码。
• 意图：将运行现象保留为证据而非直接当结论。
• 职责：运行观察、重复问题及背景。
• 边界：记录现象及来源；不自动形成长期偏好或规则。
• 目标：重复问题可检索，单次成功与方法有效分开。
• 合同依据：专属业务职责。

src/muse/作者经验/改进提案.py

• 归属与种类：B07；源码。
• 意图：让改进指向可评测的具体变更。
• 职责：具体目标变更、版本及内容哈希。
• 边界：创建目标内容及哈希；不直接修改生效资源或代码。
• 目标：评测前已经存在具体候选，内容变化必须建立新版本。
• 合同依据：专属业务职责。

src/muse/作者经验/验证申请.py

• 归属与种类：B07；源码。
• 意图：将提案与适用实验关联。
• 职责：实验请求与逐例结果关联。
• 边界：提交固定版本和范围；不填造评测结果、不读取 oracle 给生成角色。
• 目标：每份验证对应实际逐例结果和同一目标哈希。
• 合同依据：专属业务职责。

src/muse/作者经验/启用回执.py

• 归属与种类：B07；源码。
• 意图：使批准与实际目标生效可对应。
• 职责：目标模块启停请求、批准及回执。
• 边界：请求目标维护者启停；不复制方法、规则或资源的生效状态。
• 目标：仅有提案状态不能显示已启用，回执能回读目标版本。
• 合同依据：专属业务职责。

src/muse/作者经验/长期观察.py

• 归属与种类：B07；源码。
• 意图：追踪改进是否持续帮助作者。
• 职责：人审时间、返工、误杀与退化。
• 边界：保留成本、返工、人审时间和误杀观察；不宣称未经对照的因果。
• 目标：可按版本和范围回看指标，退化能触发复核。
• 合同依据：专属业务职责。

src/muse/作者经验/提示词/整理偏好与改进建议.md

• 归属与种类：B07；源码。
• 意图：为作者经验的“整理偏好与改进建议”任务提供可版本化表达。
• 职责：保留原话及区分推断的提案模板。
• 边界：仅定义本任务提示；角色身份、字段结构、权限和预算从各自权威装配。
• 目标：模板可随发布包加载且记录哈希，不含固定作品内容或测试答案。
• 合同依据：业务提示资源。

src/muse/作者经验/__init__.py

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

src/muse/作者经验/运行观察.py

• 维护者：B07。
• 职责：真实尝试与具名业务来源的观察和重复问题查询。
• 合同：模块合同。