zizi 0e3964da2c W00 固定工作树、资料与数据边界：新版设计文档树、改造计划与验证清单基线；工作树资料与数据边界。

按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。

2026-09-10 19:25:40 +08:00

3.9 KiB

Raw Blame History

B05 正文写作

职责与对象

正文工作版本、段落、写作目标、候选、分支和作者保存。

实例归属以总体架构为准；结构、状态和公开外壳分别引用数据模型与接口契约。

公开接口

用例	输入责任	输出与后果
read_document	章节与分支	正文及当前版本
save_manual	目标基线、文档、命令身份	新正文版本及保存回执
create_writing_task	粒度、目的、选区、保护区和来源	冻结写作任务
edit_candidate	候选基线及修改	新候选版本和重检要求
adopt_candidate	被审候选、依赖和批准清单	原子提交回执
merge_or_restore	分支或历史版本及当前基线	待审合并候选或新人工版本

所有接口在本模块的接口.py 暴露。输入输出类型由同一公开表面导出，外部不导入私有模型或 SQL。

内部职责

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

完整路径及运行模板见目标文件清单。逐文件意图、边界与目标见文件合同。

实现约束

正文格式、哈希和码点位置由专门协议定义。允许手写、生成、扩写、压缩、润色和明确结构改写。
两阶段写手的业务目标由本模块形成，步骤编排由编排层执行；模型没有正式写入能力。
人工保存不依赖模型评分；自动修改必须限制范围，修改候选后重新检查。
正文当前指针、作者决定、归因和派生任务与批准事实共同提交。

协作与失败

作者也可以把自行整理的改稿保存为待比较候选。该入口保留基线与版本，经作者认证后写入B05候选记录；不改当前正文。人工候选只执行正文格式与依赖校验，不声称经过模型质量检查。模型产生的候选由写作任务携带实际来源、输出与检查证据接入，不能借用人工入口取得模型执行凭证。

候选全文编辑或按段选取差异都会追加候选版本，重新计算哈希和确定性检查；旧审阅不沿用。差异组由服务端基于固定正文和候选结构生成，部分选择保留未选内容的原段落。审阅返回其绑定版本的正文与候选，提交仍核对当前版本。采纳通过S01与人工保存使用同一个B05正文参与者；拒绝、暂缓只更新作者决定，即使候选基线已陈旧仍允许明确弃用。批准事实与章后任务的联合采纳由W16接入并验收。

依赖 B01 的可用规划、B09 的固定上下文、B06 的适用检查、S01 的提交保护；B02 参与已批准事实写入。

版本冲突保留输入；源变、缺证据或审阅不匹配阻止采纳；章后失败独立呈现。

验收行为

作者审稿期间正文修改后拒绝旧候选。
部分采纳产生新版本和重检。
相同命令重放同回执。
支线不推进主分支事实。

验收入口和替换条件见迁移与验收；这些条目是目标行为，不是已通过测试的声明。

3.9 KiB Raw Blame History Unescape Escape