muse-agent-example/docs/系统架构/新版设计/文件设计/后端-B05-正文写作.md

后端-B05-正文写作：文件合同

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

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

本部分文件树

agent-example/
└── src/
    └── muse/
        └── 正文写作/
            ├── __init__.py  # Python 包身份
            ├── 人工保存.py  # 人工编辑、版本、历史和修改影响
            ├── 候选版本.py  # 候选保存、编辑、部分采纳和重检
            ├── 写作任务.py  # 不同粒度和修改目的的任务合同
            ├── 存储.py  # 正文写作所属记录的 SQL 与版本读写
            ├── 接口.py  # 正文写作公开用例和可导入合同
            ├── 提示词/
            │   ├── 修改选段.md  # 按授权范围修改模板
            │   └── 生成正文.md  # 无工具写作模板
            ├── 模型.py  # 正文写作稳定对象、外壳及内部状态
            ├── 正式提交.py  # 正文类型化确认与已批准关联变更
            ├── 正文格式.py  # 稳定段落、受限结构、可见文本与哈希
            ├── 版本分支.py  # 分支、快照、差异、合并及回退
            ├── 选段任务.py  # 确切作者圈选、保护范围与四类写作目的
            └── 选段编辑.py  # 字符位置、保护区及确定性修改应用

逐文件合同

src/muse/正文写作/接口.py

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

src/muse/正文写作/模型.py

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

src/muse/正文写作/存储.py

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

src/muse/正文写作/正文格式.py

• 归属与种类：B05；源码。
• 意图：给编辑器、模型、选区和导出提供共同正文表示。
• 职责：稳定段落、受限结构、可见文本与哈希。
• 边界：纯结构、文本和哈希处理；不读数据库、不调用模型、不裁决采纳。
• 目标：段落 ID、空行、可见文本及哈希往返一致。
• 合同依据：专属业务职责。

src/muse/正文写作/人工保存.py

• 归属与种类：B05；源码。
• 意图：让作者编辑可靠保存而不受模型评分支配。
• 职责：人工编辑、版本、历史和修改影响。
• 边界：接收人工正文和基线；经 S01 保护版本，不自动确认抽取事实。
• 目标：重复保存幂等、并发冲突拒绝，失败保留未提交内容。
• 合同依据：专属业务职责。

src/muse/正文写作/写作任务.py

• 归属与种类：B05；源码。
• 意图：把多粒度写作和不同修改目的变为明确任务。
• 职责：不同粒度和修改目的的任务合同。
• 边界：形成目标、范围、前置和预算；不在此直接调用模型或采纳。
• 目标：新作品和新章通过数据运行，选段任务包含明确保护范围。
• 合同依据：专属业务职责。

src/muse/正文写作/选段编辑.py

• 归属与种类：B05；源码。
• 意图：把自动修改限定到作者允许的真实位置。
• 职责：字符位置、保护区及确定性修改应用。
• 边界：确定性应用文本操作；不扩大范围，不以第一次字符串命中代替定位。
• 目标：位置、原文和哈希不一致时拒绝，范围外内容不变。
• 合同依据：专属业务职责。

src/muse/正文写作/候选版本.py

• 归属与种类：B05；源码。
• 意图：让修改和部分采纳有自己的检查身份。
• 职责：候选保存、编辑、部分采纳和重检。
• 边界：维护候选值和版本；不把旧检查或旧批准套用到新内容。
• 目标：每次候选变化产生新哈希，旧报告与决定可辨识。
• 合同依据：专属业务职责。

src/muse/正文写作/版本分支.py

• 归属与种类：B05；源码。
• 意图：允许比较和回退同时保留作者修改历史。
• 职责：分支、快照、差异、合并及回退。
• 边界：维护本分支和基线；合并走目标确认，支线不推进主分支事实。
• 目标：合并重验当前版本，回退创建新版本而不删除中间记录。
• 合同依据：专属业务职责。

src/muse/正文写作/正式提交.py

• 归属与种类：B05；源码。
• 意图：把正文采纳的全部保护集中在一个业务用例。
• 职责：正文类型化确认与已批准关联变更。
• 边界：只解释正文和明确批准清单；事务由 S01，事实写入由 B02。
• 目标：审阅、正文、候选、结构或来源不匹配时不写入，关联失败整包回滚。
• 合同依据：专属业务职责。

src/muse/正文写作/提示词/生成正文.md

• 归属与种类：B05；源码。
• 意图：为正文写作的“生成正文”任务提供可版本化表达。
• 职责：无工具写作模板。
• 边界：仅定义本任务提示；角色身份、字段结构、权限和预算从各自权威装配。
• 目标：模板可随发布包加载且记录哈希，不含固定作品内容或测试答案。
• 合同依据：业务提示资源。

src/muse/正文写作/提示词/修改选段.md

• 归属与种类：B05；源码。
• 意图：为正文写作的“修改选段”任务提供可版本化表达。
• 职责：按授权范围修改模板。
• 边界：仅定义本任务提示；角色身份、字段结构、权限和预算从各自权威装配。
• 目标：模板可随发布包加载且记录哈希，不含固定作品内容或测试答案。
• 合同依据：业务提示资源。

src/muse/正文写作/__init__.py

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

src/muse/正文写作/选段任务.py

• 维护者：B05
• 职责：确切作者圈选、保护范围与四类写作目的
• 设计意图：确切作者圈选、保护范围与四类写作目的
• 边界：确定性应用文本操作；不扩大范围，不以第一次字符串命中代替定位
• 合同依据：专属业务职责