6.9 KiB
B05 正文写作
通用选段写作授权
扩写、压缩、润色和重写使用作者明确圈选的正文版本、段落ID、哈希、Unicode码点范围和逐字原文。每次目的分别为expand/compress/polish/rewrite,附作者指示;保护区也绑定确切原文,自动任务不得与其重叠。重复字面片段按身份及码点区分,源文稿、范围或保护依据不符时不创建任务。
B05拥有选段定位和重放,B06复用受控模型修订链、声音保护及保真检查。通用选段没有诊断ID,输出使用selection_id;机器味路径仍要求真实诊断和已批准finding_id。两类任务都只产生候选,范围外不变。压缩/润色机械保真不能代替语义连续性判断;重写目的也不自动改规划或确认故事事实。
原生成正文入口只处理new_chapter。先前声明的expand_scene/edit_selection缺少确切圈选且输出整章,不能用来修改既有正文;现由上述选段授权入口承接,旧入口明确拒绝,不以整章生成冒充选段保护。
选段授权链路可携带参考改写扩展:作者从方法检索中挑选的参考版本作为授权输入进入冻结材料,合同见B06 参考改写。B05 仍拥有选段定位、重放与保真;参考材料不改变选区边界,范围外不变的约束继续成立。
分支与合并来源
分支从作者点名的已保存正文版本创建,固定源文稿/版本/哈希;新分支有独立正文指针,创建、保存及回退均不派发主线章后抽取。主分支保存及采纳仍按既有事务登记章后任务。
合并只回到该分支的直接来源文稿。作者从共同基线到分支当前版本的差异中点名选择;服务器与目标当前版本做三方重放。不相交修改可以组合,相同修改只计一次,重叠或同位插入冲突拒绝并保留两边;不自动推测冲突意图。合并产生基于目标当前版本的新待审候选,不直接覆盖正文。
合并来源绑定与候选版本同事务保存,后续编辑/部分选择版本沿用绑定。候选采纳同时复检目标正文、分支当前来源及目录,任一版本变化需重新合并和审阅;源分支不因合并删除。回退继续产生新正文版本,保留中间历史。V0031__正文分支来源.sql只追加分支来源和合并候选来源,不另建正文权威。
职责与对象
正文工作版本、段落、写作目标、候选、分支和作者保存。
实例归属以总体架构为准;结构、状态和公开外壳分别引用数据模型与接口契约。
公开接口
| 用例 | 输入责任 | 输出与后果 |
|---|---|---|
| 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 | 按授权范围修改模板 |
完整路径及运行模板见目标文件清单。逐文件意图、边界与目标见文件合同。
写作粒度边界
领域合同保留 new_chapter、expand_scene、edit_selection 三种粒度。当前正文生成编排及 HTTP/CLI 新生成请求仅接受 new_chapter;其余粒度不是该生成入口已接通的能力。已发布的 expand_scene 合同允许已有基线且无选区,edit_selection 必须明确选区;不以本次文档修正改变兼容输入。选段修订仍走其独立授权入口。
实现约束
- 正文格式、哈希和码点位置由专门协议定义。允许手写、生成、扩写、压缩、润色和明确结构改写。
- 两阶段写手的业务目标由本模块形成,步骤编排由编排层执行;模型没有正式写入能力。
- 人工保存不依赖模型评分;自动修改必须限制范围,修改候选后重新检查。
- 正文当前指针、作者决定、归因和派生任务与批准事实共同提交。
协作与失败
作者也可以把自行整理的改稿保存为待比较候选。该入口保留基线与版本,经作者认证后写入B05候选记录;不改当前正文。人工候选只执行正文格式与依赖校验,不声称经过模型质量检查。模型产生的候选由写作任务携带实际来源、输出与检查证据接入,不能借用人工入口取得模型执行凭证。
候选全文编辑或按段选取差异都会追加候选版本,重新计算哈希和确定性检查;旧审阅不沿用。差异组由服务端基于固定正文和候选结构生成,部分选择保留未选内容的原段落。审阅返回其绑定版本的正文与候选,提交仍核对当前版本。采纳通过S01与人工保存使用同一个B05正文参与者;拒绝、暂缓只更新作者决定,即使候选基线已陈旧仍允许明确弃用。批准事实与章后任务的联合采纳遵守 S01 原子提交与章后流程合同。
依赖 B01 的可用规划、B09 的固定上下文、B06 的适用检查、S01 的提交保护;B02 参与已批准事实写入。
版本冲突保留输入;源变、缺证据或审阅不匹配阻止采纳;章后失败独立呈现。
验收行为
- 作者审稿期间正文修改后拒绝旧候选。
- 部分采纳产生新版本和重检。
- 相同命令重放同回执。
- 支线不推进主分支事实。
验收入口和替换条件见迁移与验收;这些条目是目标行为,不是已通过测试的声明。