# 已有巡检与候选分支：业务变化与采用边界

本文件与主导读相应章节同步。教学例子不是生产记录；固定代码版本与接入边界见各章。

## 20. 本次更新：巡检与最新主线改变了什么

**这章说明已核对的更新改变了哪些产品判断。** 范围是 9 月 16 日四次巡检与 9 月 17 日已取得的固定源码：Harness main 13c481b、世界书 b0af622。当前这轮做的是全篇解释修订和定向证据复核，没有重新运行巡检，也不把这里当作实时线上版本公告。

### 哪些新增能力值得产品关注

| 已有更新 | 在具体业务中意味着什么 | 接入时还要确认什么 |
| --- | --- | --- |
| 世界书增加位置装配与管理匹配调试 | 可以先试“递钥匙”会选哪些原文，并支持更多资料放置方式 | 当前模板实际开放哪些位置；新书版本是否已绑定到会话；代码支持八类不等于八类已全开 |
| 普通后台和工具执行观测 | 可以分开追踪正文生成、人物检查、状态整理与保存 | 采集是否开启、记录是否存在；工具跑完不能当状态存好 |
| 十项 Core Tools 可独立调试 | 开发者可用一份测试材料单独检查人物、记忆、剧情或图片能力 | 测试入口不是在线角色每轮的新菜单；图片可能真实调用外部服务 |
| Sumi 图片并发和顺序交付 | 图片可同时生成，用户仍按正文顺序收到相应结果 | 该业务是否走 Sumi；不能套用到所有图片调用或候选链 |
| SDK 发布与调用观测增量 | 接入方有已发布的通用能力可选 | 实际安装版本、主线新增但未包含在包内的改动、业务有没有主动接入 |

这些信息已放回对应正文：世界书在第 10–13 章，工具在第 14/21 章，图文在第 15 章，成本观测在第 17 章，SDK 接入在第 18 章。本章用于对账；理解业务不需要先读巡检时间线。

### 哪些判断没有因此改变

普通后台仍从本轮准备阶段的材料分析，世界书原文仍没有自动复制给同轮后台；“有新观测”不会使后台突然读到当前正在生成的正文。发布了 SDK，也不会让日记、表格、Story、世界书和图片自动组合为一条万能流程。

候选 Pioneer 的消息分支状态、图文消息格式和历史重绘保图修复，需要按各自提交阅读。它们没有统一证明 main 已具备同样行为，也没有新增“自动把每个陌生人物创建为完整可编辑小卡”的闭环。

### 怎样把更新用到产品判断里

以“希望新角色先出场，稍后补全”为例：当前能依据的是回复继续、后台按材料做人物分析并可能更新会话状态。要承诺独立人物小卡，还需人物实体结构、保存和后续读取接线；不能因为日志里出现 NPC 专家就说小卡已建好。

判断一项变更可否对用户承诺，应分别确认：**代码在哪个版本、目标业务是否接线、运行配置是否开启、实际结果是否验证。** 构建镜像成功或测试报告通过，各只能证明各自步骤。下面保留四份报告、对应章节和固定提交，便于逐条核查。

<details>
<summary>逐项变更、原始巡检与固定分支证据</summary>

以下为此前固定版本核查的详细记录；其中“本次”“昨天”指该记录形成时，不代表本轮重新巡检或部署。

**之前只同步了部分结果，确实存在“更新记录提到了，原章节仍没改”的遗漏。** 本次找到 9 月 16 日四次巡检的原任务与报告，逐项回填对应章节；同时用 9 月 17 日已取得的固定源码修正过期说法。下面分开列历史发现与今天采用的结论。

#### 昨天四次巡检，分别更新到了哪里

四个任务的原名都为《KAS 仓库每六小时深度巡检》，是同一巡检计划的四次独立运行。下表均为北京时间，使用报告开始时间，各任务完成时间另列。

| 9 月 16 日报告 | 当时主要发现 | 本次回填的对应章节 |
| --- | --- | --- |
| **01:36**；main `bf934d0` | 候选增加状态/Actor 观测；正文保存、状态 CAS、消息挂接仍是不同步骤。平行候选 `e3b57e6` 修复重绘失败保留旧审核通过图。镜像构建推送不等于服务已替换 | **6、16、17、23**：状态生效、分步保存与观测边界；重绘保旧图按历史分支标明；保留构建与部署区别 |
| **07:39**；main `bf934d0` | 候选修复 Actor 失败时的回复额度与原错误保留；原始上游错误仍可能经后台 runner 写入 stdout。定向 14 项测试与类型检查通过 | **16、17、23**：回复额度与供应商账单分开；补具体日志路径，未把定向测试当作生产验收 |
| **13:42**；main `c4a7b9a` | Core 贡献审批及 MCP 依赖更新；SDK 0.2.2 已发包但发布后校验失败；八组 fake SDK 示例已编译执行，当时尚未合并；候选 AOI 解析/失败隔离改进 | **18**：接入与贡献规则、示例证明范围、发布历程；**14、23**：候选图文工具链。今天版本已另更新 |
| **19:40**；main `77a1537` | #156 示例、#158 消费者校验修复、#161 Emochi 可选观测已合并。独立 registry 校验成功，旧发布任务仍失败。Pi 观测 #160 当时未合并 | **17、18**：保留前台/后台独立记录、默认关闭、用量与提交结果区分；改掉“schema 尚未发布”等过期结论 |

已阅读四份原报告并核对原任务。本次读到报告中的测试通过，不等于重新执行了这些业务测试。[昨日 main](https://github.com/FlowGPT/roleplay-harness/commit/bf934d0d231924b1e70da24a99a498fea88df787) · [中午 main](https://github.com/FlowGPT/roleplay-harness/commit/c4a7b9a824d71d5d728e3e0304b8252247f7d821) · [晚间 main](https://github.com/FlowGPT/roleplay-harness/commit/77a153779c1a3baf5c02af96366b252ec4cc3e22)

<details>
<summary>四份原报告名称，供与巡检任务对账</summary>

1. `KAS-2026-09-16-0136-bf934d0-PR147可观测性与镜像构建分层.md`；任务最后完成 02:01:53。
2. `KAS-2026-09-16-0739-bf934d0-平行分支预算修复与日志泄露.md`；最后完成 07:50:49。
3. `KAS-2026-09-16-1342-c4a7b9a-SDK安全补丁已发但发布闭环失败.md`；最后完成 13:54:52。
4. `KAS-2026-09-16-1940-77a1537-遥测接线与发布复核.md`；最后完成 19:48:10。

已区分巡检执行任务与接收巡检回传的常驻任务，没有把回传入口再当成第五次巡检。

</details>

#### 今天的新信息，已直接补回业务章节

| 新信息或修正 | 读者现在应怎样理解 | 已更新位置 |
| --- | --- | --- |
| 世界书八位置、宿主能力协商、管理匹配调试 | 支持八类，不等于当前模板八类全开；默认场景仍是原三类。旧书须按新 revision 和会话绑定生效 | **10–13**：格式导入、选条目、上下文图、页面控制；**7** 同步输入边界 |
| 新增 Harness 调度说明 | 从业务场景配置、两份上下文、LLM 工具调用，走到工具执行、条件复核与程序保存；区分两阶段调度和通用 ReAct 循环 | **24**：独立业务模块与流程图；**7** 增加直接入口 |
| 快路/慢路的产物与使用 | 快路交正文；专家给建议；Director 给完整候选；有效保存后，未来准备请求才把状态投影装回模型 | **4–6**：同一轮铜钥匙例子，展示步骤、结果、保存与再使用；解释下一轮太快及保存失败 |
| Core Tools 独立调试 | 十项能力可 prepare / execute / cancel；状态、记忆在隔离内存试跑，图片可能真实调用外部服务。不是在线 RP 菜单扩为十项 | **14、21**：工具、入口、输入输出、例子及保存边界 |
| Sumi 图片并发与顺序交付 | 正文不等图；并发生成后仍按正文图序逐张保存通知，每次检查消息及租约 | **15**：生成与交付顺序分开，区别于 AOI 候选 |
| Actor 用量、原生 Pi 观测 | Actor 记上游实际用量，没有就保留 missing；Pi 提供显式包装入口，仍由业务接入 | **17、18**：修旧表、补接法，不当作统一财务账单 |
| SDK 0.3.0 已发布 | schema v1、Pi 观测已随此版发布；之后 main 的 placement 增量不能自动算进已发布包 | **18**：发布版本、源码增量、业务是否升级分开 |
| Pioneer `61039e5`、格式候选 `44ffcf1` | 已有图文与消息分支工具，仍没有自动创建并发布完整 NPC 卡；原生单图重试等未闭合 | **14、23**：分支分别列出；**5、6、16、17** 就地提示影响 |
| Compact 补审精度修正 | 本轮可用临时摘要不等于已确认持久化；历史编辑检测受覆盖边界可见性限制 | **8**：来自 **9 月 17 日 13:34** 额外报告及本次源码复核，不算昨天四次的新功能 |

依据：[Harness 固定 main `13c481b`](https://github.com/FlowGPT/roleplay-harness/commit/13c481bf8be04560940d4362f9ceced12ab57011) · [Worldbook 固定 main `b0af622`](https://github.com/FlowGPT/worldbook-service/commit/b0af622b3af6bbc9c59c7201501f768955151efd) · [位置接入 #168](https://github.com/FlowGPT/roleplay-harness/pull/168) · [Sumi 交付 #162](https://github.com/FlowGPT/roleplay-harness/pull/162) · [SDK 0.3.0 发布](https://github.com/FlowGPT/roleplay-harness/releases/tag/sdk-v0.3.0)。具体代码证据随各业务章节提供。

#### 哪些结论保持不变，哪些不能据此承诺

普通 Agentic 没有全局“累积 X 轮才开慢系统”的开关；Actor 与 Planner 使用轮初材料并行执行。世界书原文进入当前 Actor，不自动复制给同轮 Planner 或知识专家。Story、日记、Compact、Sumi 各有生命周期，新日志和新 SDK 版本没有把它们合成一条万能链路。

已发布 SDK、已合并代码、已部署服务、业务配置已启用、真实聊天已验证，仍是不同事实。旧世界书服务曾有 `267b9ea` 人工恢复 Ready 的巡检证据；后续 `bf934d0` 自动更新在 apply 前受权限阻碍，不能倒推服务从未部署。本次没有独立核实当前运行的服务 SHA。

<details>
<summary>发布历史与覆盖范围，供技术对齐</summary>

SDK 0.2.2 的历史是“包已发布，但发布后消费者校验失败”；#158 随后修正可选 OpenTelemetry peers 的校验矛盾，另一次 registry 验证成功，旧失败任务仍是历史失败。9 月 17 日巡检已核验 SDK 0.3.0 的新发布任务成功，本次沿用该证据并核对 changelog，没有重新发包或重跑 registry 测试。[旧发布任务](https://github.com/FlowGPT/roleplay-harness/actions/runs/35059599529) · [后续独立校验](https://github.com/FlowGPT/roleplay-harness/actions/runs/35063048965) · [0.3.0 成功任务](https://github.com/FlowGPT/roleplay-harness/actions/runs/35118420707)

13:42 提到的 MCP SDK 1.26.0 是依赖安全更新，不是本次确认业务曾触发漏洞。Core 的非作者审批要求是代码贡献治理，不是玩家调工具要人工批准。[SDK 变更记录](https://github.com/FlowGPT/roleplay-harness/blob/13c481bf8be04560940d4362f9ceced12ab57011/packages/sdk/CHANGELOG.md#L13) · [贡献规则](https://github.com/FlowGPT/roleplay-harness/blob/13c481bf8be04560940d4362f9ceced12ab57011/CONTRIBUTING.md#L16)

本轮对账四份历史报告，定向复核相关源码、配置、契约和测试断言，没有把分支全部历史或两个仓库每一行重新审计。正文保留与结论一致的固定链接，未改动处沿用先前基线。没有调用付费模型、生图、导入业务世界书、部署服务或修改生产数据。

</details>

</details>

## 23. 候选分支：正文交付、消息分支与图片失败处理

**这里的“候选分支”是已写出、但在本次核对基线中尚未合入 main 的代码。** PM 可以据此了解方向与接入条件，不能直接把它列为当前线上用户已经享有的功能。本章固定看 Pioneer 61039e5 和图文格式 44ffcf1；更早 071eb766 等记录单独保留为历史证据。

### 这些改动解决哪种用户问题

**第一种：用户重生成了回复，旧剧情状态会不会串进新分支？** 例如旧回复说守卫接住钥匙，新回复改成没有接。Pioneer 候选增加根据可见消息和内容关联去找状态，并在提交前等待相应非空助手正文保存，再把状态引用关联回消息。它要改善的是“这份状态属于哪条回复”。

但这不等于后台重读了新正文后再分析。该候选仍用本轮起始材料；正文保存、状态提交、引用关联也是分开的步骤，仍可能部分失败。不能据此承诺完整事务或语义完全一致。

**第二种：想把一轮的文字和图片交付到聊天产品。** Pioneer 扩展图文宿主和图片资产任务；另一条 44ffcf1 格式候选将文字、段落关联图片等接到原生消息格式。它们是不同接线，不能从一个分支有某工具推导另一个分支也已接好。格式候选的原生单图重试与完整端到端验收仍有未闭合项。

**第三种：一张图重画失败，能否保留旧的好图？** 历史巡检在平行候选 e3b57e6 找到相应修复。这个事实只属于该次固定分支核验，不能推广成今天所有 Sumi、AOI、Pioneer 失败路径的共同保证。

### 有些听起来相近的能力，其实还没完成

这些候选没有因此新增“模型遇见新人→创建完整人物实体卡→发布成世界书→下一轮自动使用”的统一链路。人物专家仍主要给分析建议，普通 Director 仍整理状态；若要可独立编辑的小卡，还需要明确的数据结构与读写连接。

候选中对用户显示通用错误文案，也不能证明所有内部日志都做了同样处理。已核实的一条原始异常转写日志路径仍需单独解决；这是特定代码路径的条件性风险，不是本次观察到线上泄露事件。

### 什么时候可以把候选写进正式产品能力

需要确认目标代码合入或明确选择部署该候选、业务请求走到它、所需配置和依赖已开，再验证实际交付及失败路径。镜像构建推送成功只说明构建阶段完成；它不能单独证明新服务接管线上流量。

因此本章主阅读给业务影响，下面展开给精确分支、输入输出、失败条件和历史构建证据。对用户承诺时，应使用已确认的运行版本，而不是把所有候选优点合在一起。

<details>
<summary>逐项变更、原始巡检与固定分支证据</summary>

以下为此前固定版本核查的详细记录；其中“本次”“昨天”指该记录形成时，不代表本轮重新巡检或部署。

**本次核查两条尚未合入 main `13c481b` 的候选：Pioneer `61039e5`，以及图文消息格式 `44ffcf1`。** 它们扩展图文交付、消息分支与状态归属，没有新增“自动创建并发布完整 NPC 小卡”的闭环。第 14 章列工具能力，本章说明候选实际改变的结果与尚未闭合的部分。

#### 当前候选能解决什么，结果怎么使用

| 候选能力 | 用户场景与结果 | 仍需区分的边界 |
| --- | --- | --- |
| Pioneer：后台状态跟随消息分支 | 重生成或改写后，按可见消息及内容锚点找状态；提交前等指定非空助手正文已保存，CAS 后将快照引用挂回消息 | 等正文存在不等于后台重读正文再分析；正文、CAS、挂接分步进行，仍可能部分失败。第 5、6 章已就地说明 |
| Pioneer：图文宿主链 | 解析 Actor 图文段、准备视觉状态/提示词、执行图片资产任务，再按消息保存与通知时序交付 | 属于候选应用接线；图片钱包虽有类实现，当前图片执行链已不调用，不能画成每轮必经 |
| 格式候选：原生消息交付 | 文字用 chatStream/chat，图片按段落锚定，落入原生图片字段；私有图片状态存 Axon memory | 不是 Pioneer 的同一条必经路径；记录明确原生单图重试未进入 Fusion，端到端验收未完成，那次最终运行也未重验 chat 与 edit-regenerate |

依据：[Pioneer 状态读取、等待与挂接](https://github.com/FlowGPT/roleplay-harness/blob/61039e588e8c786f5fef07b1d35125016b84a678/apps/emochi/planning/runtime.ts#L146) · [Pioneer 图文入口](https://github.com/FlowGPT/roleplay-harness/blob/61039e588e8c786f5fef07b1d35125016b84a678/apps/emochi/narrative-api.ts) · [格式实现与验收记录](https://github.com/FlowGPT/roleplay-harness/blob/44ffcf1dd5ef58503709f5da080ce3590c442063/docs/decisions/2026-09-16-fusion-sumi-format.md)

#### 昨天巡检还发现了什么

**同一张图重画失败，还要看旧图是否保留。** 01:36 报告在平行候选 `e3b57e6` 确认了修复：旧图已审核通过时，新重绘失败仍保留旧 URL、审核结果、主色与任务 ID。这只按该固定候选记录，未据此宣称今天 main 或 `61039e5` 的每条失败路径都有同等保证。[历史重绘修复](https://github.com/FlowGPT/roleplay-harness/commit/e3b57e651c61175ff0aa818c03ee3a20af8a0db5)

**对用户隐藏详细错误，不等于内部日志也隐藏。** 07:39 等报告提出的原错误日志问题，本次在 `61039e5` 定向复核仍有路径：Narrative 重抛原 cause，后台 runner 取 `error.message`，dispatch 写 stdout。如果上游错误含敏感内容，仍可能进入日志；这不是本次已确认的生产泄露事件。第 17 章列完整依据。合并候选前应修正并验证这条路径，不能只看默认不抓正文的遥测配置。[原异常](https://github.com/FlowGPT/roleplay-harness/blob/61039e588e8c786f5fef07b1d35125016b84a678/apps/emochi/narrative-api.ts#L343) · [后台错误记录](https://github.com/FlowGPT/roleplay-harness/blob/61039e588e8c786f5fef07b1d35125016b84a678/packages/sdk/src/tasks.ts#L58) · [日志输出](https://github.com/FlowGPT/roleplay-harness/blob/61039e588e8c786f5fef07b1d35125016b84a678/adapters/agent-router/dispatch.ts#L202)

<details>
<summary>展开 9 月 16 日候选 071eb76 的逐步解释与构建证据（历史版本）</summary>

核查对象是 **`codex/pioneer-actor-progress` 的 `071eb7664a2201824aa5373af2342930aca30910`**，不是主线 `77a1537`，也不是已确认运行中的服务版本。GitHub 提交页记录 2026-09-16 19:55（GMT+8），9 文件、+154/-97；父提交 `719f4e650c9484b3207ce14bb5c170b26a5a195b` 为当天 14:58，3 文件、+89/-4。主线到该分支的 GitHub 三点比较显示 43 commits / 100 files，包含分叉后的历史，不能把这 43 笔都称为“刚刚上线的新改动”。本次只读提交差异和最终版本关键源码，未执行部署或业务调用。[071 提交](https://github.com/FlowGPT/roleplay-harness/commit/071eb7664a2201824aa5373af2342930aca30910)、[719 提交](https://github.com/FlowGPT/roleplay-harness/commit/719f4e650c9484b3207ce14bb5c170b26a5a195b)

#### 对用户“先接剧情、后台补人物”的解释，有一处必须增补

**并行分工没有变，持久状态与已保存正文的绑定变了。** 候选版仍在 Actor `generate()` 开始时调用 `coordinator.schedule()`，慢路仍使用本轮起始材料。因此：用户 query 已点名新人物，本轮后台可审计；Actor 本轮才发明的名字，要等正文进入后续历史，后台才能针对它审计。候选没有增加“先同步生成完整 NPC 卡才让 Actor 回复”的步骤。[并行调度](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/planning/runtime.ts#L751-L803)、[Actor 启动点](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/planning/runtime.ts#L884-L902)

但在候选的普通 Agentic 装配中，`dispatch.ts` 会恢复 assistant lineage，并把 `context` 传给 `AxonAgenticStateRuntime`。它启用以下链路，不能继续沿用主线“后台完全独立于正文是否已保存”的表述：

1. **读哪份状态**：从当前可见历史倒查 assistant 消息，在存储消息中找到 `narrative.agenticState`；核对消息 ID、scenario、assistant 正文 hash、对应 user 消息及其 hash，再按 `snapshotRef` 取这条分支的状态。没有可验证锚点时，使用空快照基线；只有现存 state 的来源消息确实还在当前可见分支中，才允许兼容升级。
2. **什么时候允许发布新状态**：后台可以先计算，但 CAS 前会等本轮 assistant 消息已经保存、角色为 assistant、正文非空。最多等 120 秒，每 200 ms 查一次。不需要等用户点“接受”，这里的门槛是业务存储里已有正文。
3. **保存以后怎样关联**：CAS 带 `baseSnapshotRef`，成功后把 `snapshotRef`、assistant 正文 hash、userAnchor 保存回该 assistant 的 narrative。后续读取按这些锚点识别所属分支；改写/换分支导致 hash 或锚点不匹配时，不能直接拿旧分支状态。

这改进的是“这份后台状态属于哪条已保存回复”，**没有把本轮 Actor 新正文追加给已经启动的 Planner**，也没有宣称整套跨服务事务原子化。保存正文、CAS、挂接快照仍是不同步骤；代码对丢失 CAS 响应有读回确认，并可重试挂接，但仍可能失败。[入口实际传入 lineage](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/adapters/agent-router/dispatch.ts)、[分支选择](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/planning/runtime.ts#L102-L178)、[等待正文与挂接](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/planning/runtime.ts#L196-L245)、[CAS 及恢复](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/planning/runtime.ts#L248-L323)

#### NPC 本体没有新增完整人物卡 schema

最终版本仍使用原六个专家及 `update_director_state`。`judge_npc` 的模型调用参数还是 `reason`（必填）、`focus`（可选），输出仍是 `{ok, tool, result: 文本, usage?}`，失败则带 error；职责描述仍明确 advisory / never writes state。最近 4 条消息加 query 的名字检测、首轮/新名字补审计、Director 合并候选的结构仍在。没有在这个候选中发现“创建 NPC 实体卡”“新增世界书条目”的人物工具。不能把画像示例写成已强制执行的固定性格/身世字段。[最终人物工具契约](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/packages/tools/src/modules/memory/advisory.ts)、[最终触发逻辑](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/planning/agentic-v2.ts#L646-L710)

候选另有一个状态质量变化：Director 候选校验失败后，重试请求会带回具体 validationFeedback，要求完整修正、保留全部必需段落、缩短各段，不要只返回缺失段或编造事实补空。这改善格式修正反馈，不能保证人物事实一定正确。[重试校验反馈](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/planning/agentic-v2.ts#L103-L137)

#### 前台模型菜单仍是四个，新增业务能力主要在宿主工具链

| 位置 | 当前明确有什么 | 业务例子与边界 |
|---|---|---|
| 前台 function loop 的模型菜单 | `actor`、`generate_image`、`schedule_dio`、`over` | 调 Actor 写一段；按这段安排图；用户明确要求长期修改时安排 DIO；结束本轮。没有新增 `create_npc_card` |
| `actor` 参数 | `responseMode: complete / visual_beat`，使用整轮剩余 token 预算 | “先写一幕，再配图”，不是给每一段重新发一份完整预算 |
| 独立 Narrative HTTP 入口 | `/v1/chat`、`/v1/chat/continue`、`/v1/chat/regenerate`、`/v1/chat/edit-regenerate` | 独立处理聊天、续写、重生成、改用户消息后重生成；要求目标 scenario 有 Agentic V2、AOI 输出、modelConfig/preset |
| Narrative 宿主调用 | `conversation.meta.get`、`conversation.history.get`、`conversation.message.get`、`conversation.messages.save`；`history.prepare`/对应操作；`wallet.charge`；`notify.push`；AOI `parse_narrative` | 校验当前分支与消息 → 准备历史 → 预留计费 → 生成 → 解析图文段 → 保存并读回确认 → 提交计费 → 推送完成消息 → 放行图片交付。它们是业务代码调用，不是全部暴露给 LLM 的菜单 |
| 图片资产/执行链 | `AoiImageTool`、`EmochiImageAssetTools`、AOI 状态/提示词工具；本次明确新增兼容操作 `parse_image_prompt` | 从最新 Actor 段落准备图、跟踪图槽位和已生成结果；图片结果在完整消息推送后才交付 |

前台菜单及独立入口见[Actor runtime](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/actor/roleplay-runtime.ts)、[Narrative 入口](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/narrative-api.ts)、[实际装配](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/adapters/agent-router/dispatch.ts)。这些最终候选路径已逐项读取；不能从分支源码单独证明线上 scenario 已启用。

#### 9 月 16 日两笔提交，玩家能感知到的具体变化

**14:58 的 `719f4e6`：生成中能提前看到经过过滤的 Actor 正文预览。** 前提是有 `onProgress`、没有 after-hook Agent，且正则规则为空或能被安全流式过滤；特殊识别现有 Luna 的四条过滤规则。`visual_beat` 等原本缓冲的段落也可以给 Narrative 客户端预览；最终 Axon 过滤结果仍是正式内容，完成时替换预览。不是所有输出配置都无条件逐 token 展示。[预览条件和实现](https://github.com/FlowGPT/roleplay-harness/commit/719f4e650c9484b3207ce14bb5c170b26a5a195b)

**19:55 的 `071eb76`：图片坏一张，尽量保留正文和其他图片；Actor 瞬时失败不再过度扣掉回复额度。**

- Image Prompt Producer 请求明确 `maxTokens: 2000`、`thinking: disabled`。图片块交给 AOI `parse_image_prompt` 统一兼容解析/编译，移除前端额外的严格字段校验；可兼容缺省相机字段、可修补 JSON 等，嵌套 image 分隔符仍拒绝。
- 对特定 AOI 准备失败（`parse_image_prompt`、`apply_state_patch`、`initialize_state`），在 AOI 输出、实际生图及流式图片交付已开启且未取消时，保存一个带 `image_preparation_failed` 的失败槽位和可人工重试的场景提示词。该槽位不会继续实际生图，其他正文/图槽位得以保留。不是所有异常都吞掉。
- Actor 失败且上游没有 usage：若没有收到任何正文，不扣这次回复额度；收到部分正文则数这段实际 token；计数服务也失败时才保守占用本次上限。预算耗尽时保留原上游错误，避免被“重试没预算”错误覆盖。这里是回复额度管理，不是声称供应商未计费。
- Narrative 失败会保留 Harness 原错误和 error_code；不再统一替换为没有原因的 “Narrative turn failed”。

[图片准备失败隔离](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/tools/aoi-image-tool.ts#L149-L188)、[图片提示词兼容解析](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/tools/imagine-skill.ts#L104-L118)、[AOI 新操作](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/compat/aoi-tools/worker.py#L156-L166)、[Actor 失败额度处理](https://github.com/FlowGPT/roleplay-harness/blob/071eb7664a2201824aa5373af2342930aca30910/apps/emochi/actor/roleplay-runtime.ts#L931-L955)、[本次完整提交](https://github.com/FlowGPT/roleplay-harness/commit/071eb7664a2201824aa5373af2342930aca30910)

本章描述候选分支已实现的路径；线上是否启用仍需运行证据。主线的取消/提交说明保留在第 16 章。

#### 构建成功能证明到哪一步

本次实际打开了候选 `071eb766` 对应的 Build Staging Image #235 任务：Build and push 在 19:57 成功，步骤包括源码检出、ECR 登录、镜像构建与推送。没有在这个 job 中看到集群 apply 或 rollout。GitHub 环境页的 “Deployed” 标签因此不能单独证明新服务已替换线上流量；这也不排除存在另一路人工或自动部署。

依据：[核查的构建推送任务](https://github.com/FlowGPT/roleplay-harness/actions/runs/35092974660/job/104783444566)。

核查范围：已读 071/719 两笔提交差异、071 最终 planning/runtime、planning/agentic-v2、advisory、dispatch、Actor runtime、pre-actor-director、Narrative API，以及图片相关改动。未对分叉以来 100 个文件全面审计，未读线上 PromptManager 实际内容，未执行测试、部署或核对集群运行镜像。自建研究标签页已关闭。

</details>

</details>
