# 24 章业务理解验收记录

2026-09-17：全篇重审与修订完成。主阅读层直接解释业务过程，完整参数、历史分支和代码依据保留在同章展开项。章节编号与原链接保持不变；工具、更新记录、七步演示及部署包同步。

## 怎样验收

先记录原文的理解断点，再修订正文。三名独立 AI 审查者交叉阅读非本人撰写的章节；提供给他们的材料已移除技术展开和源码内容。他们必须用正文原句回答关键业务问题，不允许靠源码或既有知识补答案。这是文档审查，不是邀请真实 PM 参与的可用性测试。

初审有 3 章未通过；修正后定向复验，24 章最终均通过。初始问题和修后原句保留在工作区审查记录中。

## 实际发现并修正的问题

- 第 14 章：后台示例误用了 Actor 同轮新创作的信件。改为只分析用户已经提供的使者信息，明确该轮后台还不知道信件。
- 第 14、15 章：长期指令示例没有明确修改哪个角色。统一为当前主角色艾琳，并说明修改她后续使用的角色指令。
- 第 6 章：“调用失败”范围过宽。限定为 Director 调用失败；某位专家失败仍可能继续整理和提交。
- 第 8、16 章：移走没有配置名称的数字，并当场解释按语义检索与按词匹配。
- 第 24 章：修正内容分类数，并明确不同章节展示的是可能回复分支，避免把教学例子误认成同一段连续聊天。

## 各章检查的问题

| 章节 | 只看正文应能回答 | 最终结果 |
| --- | --- | --- |
| [01](rp-business-guide.html#section-1) | 两个仓库各负责什么，正文、设定和状态分别在哪里？ | 通过 |
| [02](rp-business-guide.html#section-2) | 一句话进入后，用户正文、后台状态、执行记录分别怎样产生？ | 通过 |
| [03](rp-business-guide.html#section-3) | 谁选择本次方案，谁在方案内部选择工具？ | 通过 |
| [04](rp-business-guide.html#section-4) | 单模型、Workflow、前台工具循环各怎样交付回复？ | 通过 |
| [05](rp-business-guide.html#section-5) | 后台何时开始，专家和 Director 各拿什么、交出什么？ | 通过 |
| [06](rp-business-guide.html#section-6) | 新状态怎样保存、重新读回并影响以后回复？ | 通过 |
| [07](rp-business-guide.html#section-7) | Actor 和后台各看见什么，为什么并不共享全部材料？ | 通过 |
| [08](rp-business-guide.html#section-8) | 日记、表格、用户资料、压缩历史各解决什么问题？ | 通过 |
| [09](rp-business-guide.html#section-9) | Story 的准备、正文采用和后续结算怎样衔接？ | 通过 |
| [10](rp-business-guide.html#section-10) | 世界书文件怎样导入、保存版本、建索引并绑定会话？ | 通过 |
| [11](rp-business-guide.html#section-11) | 常驻、动态、必需怎样经过资格、召回和预算？ | 通过 |
| [12](rp-business-guide.html#section-12) | 入选原文怎样真正放入 Actor，后台什么时候才可能知道？ | 通过 |
| [13](rp-business-guide.html#section-13) | 作者、管理接入与聊天用户各能控制什么？ | 通过 |
| [14](rp-business-guide.html#section-14) | Agent 实际接了哪些能力，每份结果落到哪里，缺口是什么？ | 通过 |
| [15](rp-business-guide.html#section-15) | 图片、长期角色指令和 Sumi 分别影响哪一次交付？ | 通过 |
| [16](rp-business-guide.html#section-16) | 停止、专家失败、保存冲突、重生成分别有什么后果？ | 通过 |
| [17](rp-business-guide.html#section-17) | 一轮有哪些调用，生成成功、保存成功和后续使用怎样区分？ | 通过 |
| [18](rp-business-guide.html#section-18) | 已有业务怎样选工具、SDK 或应用接法，还须承担什么？ | 通过 |
| [19](rp-business-guide.html#section-19) | 第二轮读到哪些新证据，如何接上上一轮的回复与后台状态？ | 通过 |
| [20](rp-business-guide.html#section-20) | 已有巡检带来哪些业务变化，本轮有没有重新巡检或验证生产？ | 通过 |
| [21](rp-business-guide.html#section-21) | 模型任务单怎样变成执行，结果由谁消费，之后是否复核？ | 通过 |
| [22](rp-business-guide.html#section-22) | 新人怎样先出场再维护连续性，与独立 NPC 卡差在哪里？ | 通过 |
| [23](rp-business-guide.html#section-23) | 未合并候选解决什么，为什么构建成功不等于线上已启用？ | 通过 |
| [24](rp-business-guide.html#section-24) | 七步中程序与模型怎样分工，保存前有哪种复核、没有哪种？ | 通过 |

## 证据与检查范围

主要固定基线：Harness 13c481bf8be04560940d4362f9ceced12ab57011；Worldbook Service b0af622b3af6bbc9c59c7201501f768955151efd。本轮对关键接线定向核对 Harness 本地源码；世界书服务沿用此前固定版本证据，同时复查 Harness 的选择请求与装配。历史基线与候选分支在各章单独标注，没有重新宣称仓库当前最新状态。

静态检查覆盖 24 章、章节锚点与本地链接、内联脚本语法、JSON 示例、原引用保留和当前主线引用文件/行号范围。原稿 340 个不同外部引用均保留；231 处当前主线引用完成文件与行号检查。引用存在性检查不能代替逐项语义审查；关键因果按上述源码阅读及正文问答核对。

本轮没有修改业务代码、执行付费模型、运行生产验证或重新发起巡检。浏览器此前拒绝本地文件访问，本轮没有绕过限制；未声称完成浏览器视觉验收。原技术图保留各自核验版本，最新业务解释以主导读为准。部署 ZIP 的文件完整性、校验清单、首页一致性和相对链接由打包程序另行检查，结果见 rp-guide-package-receipt.json。

## 第 10 章追加：运营数据准备

在第10章开头新增完整外部世界书JSON样例、可下载模板、字段填写说明、增加条目和保存检查、管理接入交接及已有书修订底稿要求。独立读者按文件类型、填写、增条目、导入位置、修订五个问题检查；“修改旧书先取得完整底稿”的建议已落实。其余23章正文未改动。

页面样例与 [下载模板](worldbook-import-template.json) 的JSON内容一致，语法及页面静态检查通过；未向真实服务执行导入，也未进行浏览器视觉测试。固定字段核对仍以世界书 b0af622 为准。

## 第 14 章追加：能力表与 Story 过程

根据实际阅读反馈，能力总表由抽象的四列改成“具体需求／系统动作／结果与使用时机”三列，按当前回复、后续资料、其他玩法与接入分组。同一位置直接给出 Story 定义、模型与程序分工、输入和四步执行，以及生成后待核对、下一次请求采用正文、提交成功才持久保存的区别。

独立正文检查发现 Sumi 的“状态”仍抽象，已补外观／场景例子及下一轮 Sumi 主模型读取的路径，并完成定点复查。Story 关键流程与 Sumi 状态读写复核固定 13c481b 代码；仅第14章正文改变。关联工具文档和部署包同步；浏览器视觉测试未执行。

## 全篇代码补查：先检查展开项，再修实际缺口
本次完整阅读了24章正文和56个已有展开项。原接口表、默认值、导入规则、状态结构和候选分支证据继续保留；没有因为内容在折叠里就将它判为缺失。实际修订涉及第2、4、7–18、21、22、24章，其中第3、5、6等已经覆盖的内容没有重复扩写。

第7章新增模型调用位置图，以及“图上编号→源文件→函数→输入和产物”的对应说明。图画的是普通Agentic加世界书的咨询路径；直接整理、未选专家、无更新等分支在图下说明。Actor、第一次协调、并行专家、第二次协调、Director与程序保存分别解释，保留原材料差异和参数证据。

工具第14、21章保留能力全景和完整接口。第21章把世界书查询、JSON字段更新、Story推进、配图、长期角色指令分别展开为实际调用例子，列出调用方、关键参数、结果接收方和生效时点，并链接到本章已有参数区。链接现可直接打开目标展开项；对应阅读器函数用隔离DOM测试核对，未运行浏览器导航。

源码修正还包括：关闭专家菜单仍需准备整套配置；流式结果可能缓冲；记忆来源按配置选取、日记摘要不等于日记卡、召回与写入失败策略不同；世界书hybrid的30项是相关性名单而非全部候选上限；快照在模型请求前产生；普通后台菜单不等于执行层权限保证；SDK Slow与普通后台的参数验证不同；后台用量汇总不等于供应商总请求数。Story的叙事待处理事件与世界结算pending分别说明；配图的下一步自动调度受循环剩余步数约束，scheduled不等于生成或交付成功。

独立交叉复核发现并修正了新例子中的世界书JSON条件边界、Story结算pending阻断准备、图片交付及步数条件。完整条件、字段、失败分支与依据均放回相应章节，不以本记录替代正文。

固定基线为Harness 13c481b、Worldbook b0af622。Harness复核实际应用/SDK/工具路径；世界书重新读取selection.py、service.py及models.py相关字段，其余导入和存储材料沿用先前固定证据。本次没有重新遍历两仓全部分支、执行巡检、调用付费模型或确认生产配置。

静态检查：24章标题和56个展开项保留，JSON样例全部可解析，正文引用和本地锚点检查通过；旧稿401个不同GitHub引用中400个原样保留，另1个从整文件精确到同文件行号。当前主线引用完成本地文件/行号范围检查。节点图showcase检查9/9、0错误、0警告，交付HTML和源定义哈希一致；SVG文字与节点布局通过原生栅格预览检查。浏览器此前拒绝本地HTML访问，本轮没有绕过；页面视口、主题与交互的浏览器视觉验收未执行。部署包另核文件哈希、ZIP完整性、首页与相对链接。

## Agent 总览展开：按执行职责阅读

第1章改为“Agent 全貌：一句输入怎样变成回复和后续状态”，直接展示程序、模型岗位、工具与服务接口、可重读资料的职责，以及铜钥匙输入到当前回复、后台检查、分别保存、下一次读取的完整过程。第1、2章和首页采用同一张10节点业务执行图；节点按工作命名，应用目录名称只在源码对应处解释。

原有技术展开和引用保留；补入两种入口接法由谁准备材料、请求版本不等于快慢分流、模型网关与数据服务的输入/返回、正文保存与后台提交的责任边界。该图明确限定普通Agentic加世界书的具体组合，并说明直接整理、没有更新和未开启后台等分支，不把全部能力画成每轮必经。

独立核对固定13c入口、准备、生成、后台和保存代码后，未发现阻断问题。24章编号/锚点与56个展开项保留，450个原GitHub引用全部保留；新增本地主线链接检查文件及行号范围。导读和项目地图脚本语法、本地链接检查通过；图的showcase交付为9/9、0错误、0警告。

静态SVG已用原生栅格查看文字与节点布局；该方式不完整复现浏览器箭头标记。此前浏览器拒绝本地HTML访问，本轮没有绕过，未做浏览器视口、主题和交互视觉验收。没有改变业务实现、调用付费模型或确认生产启用。
