muse-agent-example/docs/系统架构/新版设计/文件设计/后端-B08-交付连载.md

后端-B08-交付连载：文件合同

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

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

本部分文件树

agent-example/
└── src/
    └── muse/
        └── 交付连载/
            ├── __init__.py  # Python 包身份
            ├── 交付材料.py  # 书名、简介、梗概和人物表
            ├── 全书整理.py  # 全书回看和跨章修订任务
            ├── 发布登记.py  # 真实发布版本及修订影响
            ├── 存储.py  # 交付连载所属记录的 SQL 与版本读写
            ├── 定稿版本.py  # 冻结章节与交付材料清单
            ├── 导出格式/
            │   ├── EPUB.py  # EPUB 目录、内容与打包
            │   ├── Markdown.py  # Markdown 正文导出
            │   ├── Word.py  # DOCX 结构与排版导出
            │   ├── __init__.py  # Python 包身份
            │   └── 纯文本.py  # TXT 正文导出
            ├── 接口.py  # 交付连载公开用例和可导入合同
            ├── 提示词/
            │   ├── 全书审阅.md  # 跨章审阅任务模板
            │   └── 整理交付材料.md  # 固定正文版本的材料生成
            ├── 文字校对.py  # 专名、称谓、标点、格式与例外
            ├── 文稿导出.py  # 导出任务、目录及完整性核对
            ├── 模型.py  # 交付连载稳定对象、外壳及内部状态
            ├── 登记事务.py  # 完整定稿、实际导出与版本发布反馈
            ├── 读者反馈.py  # 归集、辨析与调整任务
            └── 连载计划.py  # 存稿、时间和章节依赖

逐文件合同

src/muse/交付连载/接口.py

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

src/muse/交付连载/模型.py

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

src/muse/交付连载/存储.py

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

src/muse/交付连载/全书整理.py

• 归属与种类：B08；源码。
• 意图：跨章发现问题而不失去逐章写入保护。
• 职责：全书回看和跨章修订任务。
• 边界：组织检查和修订任务；不直接更新正文表。
• 目标：每项跨章修改能回到具体章节版本及确认。
• 合同依据：专属业务职责。

src/muse/交付连载/文字校对.py

• 归属与种类：B08；源码。
• 意图：统一交付稿中的文字与格式并保留例外。
• 职责：专名、称谓、标点、格式与例外。
• 边界：提出校对变化；不改故事事实或自动批准。
• 目标：专名、标点、数字与格式异常有定位和保留选择。
• 合同依据：专属业务职责。

src/muse/交付连载/定稿版本.py

• 归属与种类：B08；源码。
• 意图：区分工作稿、定稿与实际发布内容。
• 职责：冻结章节与交付材料清单。
• 边界：冻结明确章节版本清单；不查询 latest 代替定稿。
• 目标：后续编辑不改变已经冻结的交付内容。
• 合同依据：专属业务职责。

src/muse/交付连载/文稿导出.py

• 归属与种类：B08；源码。
• 意图：生成可核对的交付文件。
• 职责：导出任务、目录及完整性核对。
• 边界：只消费固定定稿清单；格式实现不改正文，缺章不得跳过。
• 目标：目录、章节和可见文本与清单一致，失败可独立重试。
• 合同依据：专属业务职责。

src/muse/交付连载/交付材料.py

• 归属与种类：B08；源码。
• 意图：为交付准备有来源的配套内容。
• 职责：书名、简介、梗概和人物表。
• 边界：形成书名、简介和梗概候选；不自动发布或改已确认正文。
• 目标：材料引用正确版本并经作者定版。
• 合同依据：专属业务职责。

src/muse/交付连载/连载计划.py

• 归属与种类：B08；源码。
• 意图：安排存稿和更新时间而不混淆执行状态。
• 职责：存稿、时间和章节依赖。
• 边界：维护计划与依赖；不把计划日期等同真实发布。
• 目标：待写、待审、存稿、待发布和已发布可区分。
• 合同依据：专属业务职责。

src/muse/交付连载/发布登记.py

• 归属与种类：B08；源码。
• 意图：记录外部实际使用的稿件版本。
• 职责：真实发布版本及修订影响。
• 边界：登记实际发布及影响；不自动向外部平台发文。
• 目标：每次发布能定位具体交付稿和后续改动。
• 合同依据：专属业务职责。

src/muse/交付连载/读者反馈.py

• 归属与种类：B08；源码。
• 意图：把读者和编辑意见关联到真实稿件。
• 职责：归集、辨析与调整任务。
• 边界：记录、辨析和提出调整；不按时间猜测最近 run。
• 目标：反馈可以定位版本，作者选择后才进入修订或经验。
• 合同依据：专属业务职责。

src/muse/交付连载/导出格式/纯文本.py

• 归属与种类：B08；源码。
• 意图：按 纯文本 格式交付同一份已冻结正文。
• 职责：TXT 正文导出。
• 边界：格式适配不改写内容、不选择最新版本、不跳过缺章。
• 目标：实际导出文本、章节顺序和结构与交付清单一致。
• 合同依据：文稿格式。

src/muse/交付连载/导出格式/Markdown.py

• 归属与种类：B08；源码。
• 意图：按 Markdown 格式交付同一份已冻结正文。
• 职责：Markdown 正文导出。
• 边界：格式适配不改写内容、不选择最新版本、不跳过缺章。
• 目标：实际导出文本、章节顺序和结构与交付清单一致。
• 合同依据：文稿格式。

src/muse/交付连载/导出格式/Word.py

• 归属与种类：B08；源码。
• 意图：按 Word 格式交付同一份已冻结正文。
• 职责：DOCX 结构与排版导出。
• 边界：格式适配不改写内容、不选择最新版本、不跳过缺章。
• 目标：实际导出文本、章节顺序和结构与交付清单一致。
• 合同依据：文稿格式。

src/muse/交付连载/导出格式/EPUB.py

• 归属与种类：B08；源码。
• 意图：按 EPUB 格式交付同一份已冻结正文。
• 职责：EPUB 目录、内容与打包。
• 边界：格式适配不改写内容、不选择最新版本、不跳过缺章。
• 目标：实际导出文本、章节顺序和结构与交付清单一致。
• 合同依据：文稿格式。

src/muse/交付连载/提示词/全书审阅.md

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

src/muse/交付连载/提示词/整理交付材料.md

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

src/muse/交付连载/__init__.py

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

src/muse/交付连载/导出格式/__init__.py

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

src/muse/交付连载/登记事务.py

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