# 产品与能力 Wiki · 变更记录

## 2026-10-19：记忆与摘要修复、Sumi 图文控制和运行监控

**更新升级**

1. **记忆服务故障时怎样回复**：新增入口配置，允许读取记忆失败后继续生成；默认仍停止本轮。Hinos 只放行连接、读取超时、429 和 5xx 等规定故障，身份或返回格式错误仍报错。没有取得本轮读取凭证时不写回 Hinos；普通日记来源的回复后写入仍按原规则执行。
2. **日记更新后保留有效的历史摘要**：程序用作者的原始角色资料判断旧摘要是否仍适用，日记更新不再单独导致摘要失效；回复和压缩模型仍使用本次取回的新日记。作者真正改了角色、历史或相关配置时，继续检查摘要能否使用。
3. **Sumi 选择模型与纯文字模式**：正文可以使用聊天后端指定的模型；新增图片开关，关闭后不发图片 loading、不生成或重放图片。纯文字模式仍可能调用视觉模型读取参考图，不能理解为所有图片相关模型调用都取消。
4. **Sumi 图片编译失败兜底**：新的图片任务在描述编译超时、服务报错或输出不合格时，可以使用完整原始图片标签继续生图。图片任务收到取消信号或后台任务超时时，不再走该兜底；前台断开并不必然取消已受理的后台生图。已有任务仍按记录复用或等待，避免重复付费生成。图片审核和最终成功判定保留。
5. **运行监控与初始化追踪**：#296、#289 已合入主干。补齐请求结果、首段正文等待、Sumi 历史和图片状态，以及从参考图读取到初始状态保存的追踪；正文追踪仍受配置和采样限制。#297 的按实际模型请求尝试统计仍是未合入方案，未混入当前说明。

**开发分支**

- **DIO 跨轮更新 #303**：完整回复结束后判断长期要求，提交 DIO；后续请求取这段聊天的新角色提示词。仍为草稿、默认关闭，只有构建与镜像推送记录，没有实际部署证据。
- **摘要质量检查 #305**：检查已有摘要的增量更新，可只记录问题，或在明确发现问题后重做一次再检查。仍未合入，评审要求修改；现有作者离线结果没有明确通过案例，不能当成质量提升已验证。

**发布状态**：Sumi 在 10 月 19 日 13:26 成功部署 `f9b26a9`，包含本轮主线改动以及前轮 #295／#298；这份记录仅覆盖 Sumi 工作负载，不能证明 Emochi 等其他应用已采用，实际开关、监控采集和业务结果仍须分别核验。SDK 最新发布仍为 0.6.0，Core Tools 沿用此前已核的 0.2.3 记录。Worldbook 本轮没有新主线或部署变化，保留 10 月 9 日成功部署记录，007 迁移和业务联调状态不作推断。

两份 Wiki 已将变化写回对应原章节，保留目录和视觉样式；本地预览高亮相对 10 月 13 日版本的变化。依据截至 10 月 19 日 14:51 的已完成增量巡检及固定源码，未重新进行全仓审查、生产业务验收或 Wiki 部署。

[记忆故障策略 #301](https://github.com/FlowGPT/roleplay-harness/pull/301) · [日记与摘要 #302](https://github.com/FlowGPT/roleplay-harness/pull/302) · [Sumi 模型与图片开关 #300](https://github.com/FlowGPT/roleplay-harness/pull/300) · [图片兜底 #304](https://github.com/FlowGPT/roleplay-harness/pull/304) · [Sumi 10/19 生产部署](https://github.com/FlowGPT/roleplay-harness/actions/runs/39204401613/job/117903983124)

## 2026-10-13：Sumi 历史恢复、角色精简修复与开发分支进展

**更新升级**

1. **Sumi 历史恢复**：聊天后端保存的正文与旧快照不一致，或旧快照缺失时，先核实实际消息，再重建场景状态。补齐失效消息、服务报错、旧图片与保存规则；关闭普通历史导入仍允许这类重建。该修复已包含在 10 月 11 日部署的 Sumi 版本中。
2. **角色设定过长时的精简**：修复合格计数来源变化导致的误拦；角色精简模型的输入预检可以有限使用估算，精简结果放回完整回复输入后仍须严格检查长度。需要原有开关，原角色卡不改写；修复已合主线，未核到部署。
3. **模型连接故障排查**：日志新增 TLS、域名解析、连接和超时等具体原因，方便研发定位失败。HTTP 错误分类与重试规则不变；已合主线，未核到部署。
4. **世界书部署记录**：补齐 Entity 关联版本在 10 月 9 日的成功生产部署证据。世界书本轮没有新增代码，数据库 007 迁移与业务联调仍需单独确认。

**开发分支**

1. **Fusion 编排**：更新为 Actor 写完一段后再次决策，正常结束明确选择 `over`；补充已保存图片槽重绘与可选 JWT 接法。仍未合入，镜像构建成功的运行跳过了实际部署。
2. **图片 Hook 与 Rian**：补入有条件移除重复生图指令，以及确定人物、准备分镜、编译图片描述后生成一张图的工具。两份都是未合入的草稿分支；Rian 尚未发现业务服务调用入口。
3. **运行监控**：分别记录 #296 的 HTTP／RPC 与 Sumi 全流程指标、#297 的应用操作与实际模型请求尝试统计。两份候选有重叠，均未合入，不能合称一套已上线监控。

SDK 仍为 **0.6.0**，Core Tools 仍为 **0.2.3**。更新写回原章节，保留目录、接口细节与章节样式；预览标注本次相对 10 月 9 日本地版本的变化。两份 Wiki 均只更新本地文件，未部署。

依据 10 月 12 日和 10 月 13 日已完成的增量巡检，主线／PR 核对截至 16:34，发布记录截至 16:38。固定主干为 Harness `6a108dd`、Worldbook `ad38dce`；未重新进行全仓审查或生产业务验收。

[Sumi 修复 #294](https://github.com/FlowGPT/roleplay-harness/pull/294) · [角色精简 #295](https://github.com/FlowGPT/roleplay-harness/pull/295) · [连接诊断 #298](https://github.com/FlowGPT/roleplay-harness/pull/298) · [Sumi 10/11 部署](https://github.com/FlowGPT/roleplay-harness/actions/runs/38142426606/job/114478844749) · [Worldbook 10/9 部署](https://github.com/FlowGPT/worldbook-service/actions/runs/37876956192)

## 2026-10-13：区分章节开头与上一章页脚

- 15 个章节统一使用独立标题区域；连续阅读时，章节之间增加留白。
- 页脚改为浅灰资料区，写明“本章结束”及章节名称，源码说明和 Markdown 下载入口保留在所属章节内。
- 保留正文、448 个已有定位 ID、202 处 10/9 更新标注及单章切换逻辑。同步修改生成模板，后续构建沿用此样式。

## 2026-10-09：后台压缩、Sumi 图文、世界书接入与发布状态

**新增**

1. **后台历史压缩**：提前整理旧对话，本轮使用现有材料回复，后续请求读取保存好的摘要。需显式开启；输入仍放得下但任务没排上时直接继续，硬超限则按同步或临时裁历史规则处理。
2. **世界书独立 SDK 客户端**：SDK `0.6.0` 已发布。其他业务可以直接创建、导入、关联、选择世界书，再把返回原文加入自己的模型输入。
3. **Sumi 图片 loading**：正文流中读到完整图片指令后可提前通知等待位置；实际付费生图仍须等状态保存成功。
4. **群聊实验记录**：补入 `group-chat-spike` 的发言安排、正文、状态记录与正式消息确认流程，仍未进入 main。

**更新升级**

1. **压缩超限恢复**：先为记忆留空间；角色设定过长时，可在显式配置下临时压缩本次请求中的角色内容，原角色卡不改写。补齐阶段收益判断、预算和取消诊断。
2. **Sumi 历史恢复**：按 token 装载历史，预留 1,200 输出 token；八次额度只统计新的模型抽取。仅用户人设参考图变化且其余材料、历史前缀和父链一致时，可调整视觉锚点并复用状态。
3. **世界书 Entity 关联**：新接口使用业务对象编号，旧 Prompt 接口继续兼容；现有 RP 仍从角色资源 ID 取值。数据库需要执行保留原数据的 007 迁移，生产迁移未核。
4. **运行观测**：已插桩的模型／工具正文不再只限 staging，仍受开启、配置、采样、遮罩和大小限制；Sumi 补图文事件和调用来源。前缀相似度是排查线索，不代表模型缓存命中。
5. **发布与部署**：Pi 已合入并随 SDK `0.5.0` 发包，Omen 已合入并随 Core Tools `0.2.3` 发包。Sumi `a119b8b` 在 10 月 5 日有成功生产部署记录，不能覆盖 10 月 8–9 日之后新增的图片占位等改动。
6. **开发进展**：Fusion #255 的继续／结束决策和 DIO 调用约束、Sumi #289 初始化追踪分别记录，均未合入目标分支；DIO 限次是模型指令，未新增硬计数拦截。

内容依据 10 月 9 日两周差异巡检及相关固定源码；元数据截至 14:27，开放分支补核完成于 14:36。Harness main `82e0169`、Worldbook main `ad38dce`。本次更新正文、接入示例和状态记录，保留原三个大模块与章节链接；不是全仓逐行重审，也没有把包发布或部署流水线成功当作业务验收。

[Harness 固定主干](https://github.com/FlowGPT/roleplay-harness/tree/82e0169ab2f59f38a11cbdc7e874deec720b0620) · [Worldbook 固定主干](https://github.com/FlowGPT/worldbook-service/tree/ad38dce1de7ccd291d702a67b92c06a966fddf85) · [SDK 0.6.0](https://github.com/FlowGPT/roleplay-harness/releases/tag/sdk-v0.6.0) · [Sumi 指定版本生产部署](https://github.com/FlowGPT/roleplay-harness/actions/runs/37277637931/job/111658130396)

## 2026-09-24 14:27：世界书运行监控合入，补充面板缺陷与 Story 分支进展

本次回填 14:16–14:27 已完成巡检。Harness main 仍为 `3b6ba5f3f22e11baceb1c6857560a97140f41a85`；Worldbook main 更新为 `005e19c664900e999fb7efca7b1dbe2da3629437`。内容来自该轮报告及固定源码，不代表重新审完整个仓库或查询了生产服务。

**已合并**

- **世界书 #18 运行监控**：增加 HTTP 请求、Prompt 绑定、搜索／条目选择、向量降级、索引、数据库连接池与进程等指标，提供 `/metrics` 和 36 个 Grafana 面板、34 条查询。保存、版本、召回排序与本轮选择规则没有因此变化。
- **已发现的问题**：“空选择比例”查询使用 `le="0"`，实际指标导出 `le="0.0"`，巡检已复现分子没有序列。面板无数据不能理解成空选择为 0%；需修正查询并验证实际序列。本次记录缺陷，没有替产品代码修复它。

**部署记录**

- PR 作者记录已将世界书看板导入生产 Grafana，并明确说明指标镜像与抓取注解未部署；截至 14:26 的记录未出现 `005e19c` 对应 GitHub deployment。最近直接成功 rollout 仍是 9 月 22 日 `fca57b8` 的历史事件，当前实例未读回。
- 生产 CD 只更新镜像，不会自动应用新加入的抓取注解。指标镜像、Pod 注解、Prometheus target 与真实查询结果要分别确认；导入看板不等于指标已经到达。

**开发分支**

- **Story Omen #250 仍未合入 main**。14:21 是 main → `story-event-omen` 的分支同步，头从 `8bf877f` 前进到 `21021d6`。本轮只记录新头的 3 commits／8-file 清单；原有功能说明和关闭／替换牌组失败复现仍对应 `8bf877f`，没有把它写成新头已经重新验证。
- Harness #252／#254、Worldbook #15 没有新头；没有新增 SDK／Core Tools 发布。

巡检记录 Worldbook 固定归档本地 `132 passed, 35 skipped`，Ruff 与看板生成一致性通过；35 项缺少本地数据库配置而跳过。main CI 的数据库、Ruff、pytest 步骤成功已确认，PR 自述的 167 项未取得独立日志，不作为本次复验数字。正文已回填世界书能力、监控入口、Story 产品和工具说明，两份 Wiki 分别打包。

[世界书监控固定源码](https://github.com/FlowGPT/worldbook-service/blob/005e19c664900e999fb7efca7b1dbe2da3629437/src/worldbook/metrics.py#L17) · [空选择查询](https://github.com/FlowGPT/worldbook-service/blob/005e19c664900e999fb7efca7b1dbe2da3629437/deploy/grafana/build_dashboard.py#L305) · [部署说明](https://github.com/FlowGPT/worldbook-service/blob/005e19c664900e999fb7efca7b1dbe2da3629437/docs/metrics.zh-CN.md#L3) · [Story #250](https://github.com/FlowGPT/roleplay-harness/pull/250)


## 2026-09-24 08:29：Sumi 状态重建、输入预算与 Fusion 分支更新

本次回填 9 月 23 日 14:17、20:17，以及 9 月 24 日 02:16、08:17 开始的四轮已完成巡检。Harness 主干更新为 `3b6ba5f3f22e11baceb1c6857560a97140f41a85`；Worldbook 主干仍为 `fca57b8af8ae74a44a033ea061043ecbf9a38373`，本轮没有新增世界书功能。依据已有报告及保留的固定源码更新正文，没有另跑远端巡检、真实模型或生产请求。

**更新升级**

1. **Sumi 参考图与图片描述编译已进入主干**：#237 已合入，关闭上一版“开放 PR”的状态。初始化视觉状态时可以同时使用角色图和用户参考图；生图时按配置将完整图片标签交给 compiler，取得描述与参考图顺序后生成图片。#239 随后移除了程序额外添加的角色／图片规则，改由外部 Prompt Manager 提供。测试环境已部署过相关代码，但只换镜像的流程没有同步应用 compiler 的 YAML 设置，实际启用情况仍需核对。
2. **Sumi 遇到资料变化或聊天分叉时重建状态**：角色卡、开场白、用户人设、参考图变化，或用户切到另一条历史路径后，程序不再沿用不匹配的旧状态，而是从当前资料和可见历史重新提取；保存恢复检查点和本轮新状态，旧消息和旧图片不改写。它能恢复对话过程，不能保证精确还原旧镜头。
3. **Sumi 输入预算调整**：主回复与历史提取统一把 `context_limit` 作为输入额度，保留 353 tokens 余量，不再先减输出额度。仓内示例的输入上限由 2,952 调整为 4,647，仍允许最多 2,048 输出；接入模型的真实总窗口需要容得下约 6,695 tokens，定向测试尚未证明真实后端边界请求能通过。
4. **Fusion 图片失败后通知客户端结束等待**：#241 已合入 Fusion。保留原失败通知，再发送同一请求、同一段落且不含图片 URL 的 `chatImageGeneratedV2`，用于 Android 2.2.8 收起加载状态；这条事件不表示生图成功，其他客户端对双事件的处理仍需验证。
5. **Fusion 已部署监控指标与 DIO 免计费请求标记**：#249 的进程指标随 `a5e6fb` 在 9 月 23 日生产 rollout；#253 随 `c8fc61c` 在 9 月 24 日 03:16–03:19 生产 rollout。后者每次提交 DIO 都带 `x-dio-skip-billing:true`，没有真实 DIO 账单或钱包证据，不能写成已验证不扣费。包含 #209 的后续 Fusion 版本已有部署证据，原先“合入后尚无部署”的说明同步更新。

**新增开发分支记录**

- **Story 事件抽牌 #250**：为当前事件保存一张氛围／角度／节奏提示牌，事件内跨轮使用；默认牌组 142 张。仍未合入、未部署。已有聊天切成空牌组或替换牌组会因状态不匹配而报错，不能把它当作可安全随时关闭的功能。
- **原生 Pi 慢任务 #244**：提供共享模型用量统计、预算和取消收尾；仍在 PR，没有发包或正式业务接线。它不替业务保存剧情状态。
- **监控方案分别记录**：Fusion #249 是已部署代码里的 Prometheus 指标与 21 面板；主 Agent Router #252 是尚未合入的 Prometheus 指标与 17 面板；#254 是读取已有 Loki 日志的 10 面板。#254 作者称已导入生产 Grafana，本轮没有直接读取看板或查询结果；三者不混写成“生产监控全部可用”。
- **Sumi 失败模拟 #251**：曾部署测试环境，随后关闭且未合入主干。开关默认关闭；模拟失败一旦保存，同一图片再次进入也会复用失败结果，关闭开关不会自动重试旧图片。最新可见 Sumi 测试部署事件指向这个分支，不能把主干 SHA 当作当前测试实例版本。
- **Sumi 根追踪 #240**：把前台输入和最终回复放进根 trace 的改动仍与主干区分；它曾部署测试环境。主干 #237 的模型／图片／保存追踪不代表 #240 也已合入。

**原有说明修正**

- 图片页补明 compiler 的超时、网络故障和 5xx 同样会保存为 `prompt_compilation_failed`；当前没有自动重试，同一图片重进仍读到失败结果。
- Agent V2 的输入表改为“此前保存的剧情笔记（Director 整理）及专家分析记录”，明确 Director 生成、程序校验保存、后续请求读回的顺序。
- 三大模块、原章节地址和五张页首流程图保持不变；变更写回相应正文。本次先提供更新后的页面，没有重新制作部署包。

[Harness 固定主干](https://github.com/FlowGPT/roleplay-harness/tree/3b6ba5f3f22e11baceb1c6857560a97140f41a85) · [Fusion 最新部署记录](https://github.com/FlowGPT/roleplay-harness/actions/runs/35908208557) · [Sumi 最近测试部署记录](https://github.com/FlowGPT/roleplay-harness/actions/runs/35868869411)

## 2026-09-23 08:31：长聊压缩、正文续写、世界书检索与保存状态

本次接入 9 月 22 日 20:13、9 月 23 日 02:15 和 08:18 三轮已完成报告，覆盖上一版之后的增量。最新固定主干为 Harness `43332d8616b4e24874915a69cdea7bdaa0429aba`、Worldbook `fca57b8af8ae74a44a033ea061043ecbf9a38373`。本次 Wiki 维护读取这些报告和保留的源码，没有另跑远端巡检、真实模型或生产验收。

**主干中的变化**

- **正文中断后继续写**：配置了恢复模型的 Gemini Actor，在已经生成部分可见正文后遇到不完整上游流，可用原正文作为前缀，让 DeepSeek 续写一次；保留剩余输出预算、取消和旧式 DONE 兼容。Gemini 可恢复的上游错误范围也扩大了，但本地错误和用户取消不因此重试。真实模型之间的语气衔接、重复和延迟尚未验收。
- **长聊天分别用初始化、增量和备用摘要模型**：Hybrid Compact 已合入；首次总结／确认需要重建时可用 bootstrap，后续用主模型，符合预算的超时或规划失败再交给 fallback。成功的中间阶段可以保留，全部完成后只提交一次检查点。字段放在 Scenario 顶层 `compact.bootstrap/fallback`，没有自动为全部聊天开启。
- **摘要放到指定提示词位置**：Actor 模板可以用唯一的 `compactMemory` 区块决定摘要出现的位置。格式或实际渲染不符合要求时终止、不保存新检查点；没有声明位置的旧模板继续使用原注入方式。
- **历史筛选与配置加载**：#205 本地估算及段落 V2 已合入主干，纠正上一版“仍为候选”的状态；V2 仍需显式选择。新增 `incremental_only` 筛选范围、实验配置目录、入口名前缀匹配和 production 覆盖文件说明；文档按实际源码使用 `HARNESS_ENABLED_SCENARIOS`。
- **世界书更好地处理短句指代**：hybrid 排序把当前输入和最近两条非空用户／助手历史组合查询；Harness 先排除当前消息重复，state 仍单独用于条件判断。新增排名、命中原因和预算诊断。另在单次选择中复用原文构造与精确 token 计数，选取规则不变。包含上述变化的 `fca57b8` 于 9 月 22 日 21:15 完成生产部署；真实流量的检索质量、延迟与 CPU 改善仍未验证。
- **Story 工具可以接收用户人设**：公共工具新增 `userPersona`，Core Tools `0.2.2` 已发布；现成 StoryV1 调用仍未传入，普通 Agent V2 则已有用户人设输入。分别更新工具接入页和完整产品页，避免把包发布写成业务已经接通。
- **新增执行日志及实际限制**：请求、模型、工具和记忆事件可按请求关联。main 同时会始终向 stdout 写最多 16,000 字符用户原文及最多 300 字符错误消息，关闭 Langfuse 不会关闭；staging 的 Langfuse 还允许普通模型与工具正文。记忆表已保存、后续提炼失败时可能仍记 `memory_write_failed`，因此要读回版本确认，不能凭失败日志重复写入。这些限制尚未修复，也未确认该 main 已部署到实际 Agent Router 实例。

**分支与发布状态**

- **Fusion**：新增无正文超时控制、文字与图片准备分开完成、生图失败保留已完成正文，以及慢响应时并发备用模型。`6dac2cbe` 有 9 月 22 日 23:56 的 Narrative Fusion 部署记录；败方请求取消前的真实费用和 20 秒阈值效果仍待核。#209 随后合入分支 `c75dabb`，不属于普通 main，也没有这次后续合入的部署证据；编辑／重新生成必须换消息 ID 的条件保留。
- **Sumi #237**：新增用户人设参考图、图片描述编译及主模型到保存／通知的追踪，仍为开放 PR。编译失败不继续付费生图；图片业务失败时，stdout 与 Langfuse 的状态可能不同，需读 `ready` 等实际结果。不能把它依赖的主干日志合入，写成整组 Sumi 能力已合入。
- **包版本**：Core Tools `0.2.2` 已发布；SDK `0.4.0` 只是源码准备，发布失败，最近已发布 SDK 仍为 `0.3.0`。

对应内容已回填到产品、正文生成、Story 工具、世界书、记忆、压缩、图片、业务接入和 SDK 章节。保留三大模块、原有章节地址、同章展开和五张置顶流程图；没有把历史报告直接堆成新的主阅读章节。

[Harness 固定主干](https://github.com/FlowGPT/roleplay-harness/tree/43332d8616b4e24874915a69cdea7bdaa0429aba) · [Worldbook 固定主干](https://github.com/FlowGPT/worldbook-service/tree/fca57b8af8ae74a44a033ea061043ecbf9a38373) · [Worldbook 当次生产部署](https://github.com/FlowGPT/worldbook-service/actions/runs/35732023874) · [Core Tools 0.2.2](https://github.com/FlowGPT/roleplay-harness/releases/tag/core-tools-v0.2.2)

## 2026-09-22：原子能力的输入、接入位置与返回结果

本次调整原子能力全部 10 个能力页及能力目录，依据现有固定源码细化使用合同，没有新增远端巡检或产品功能。

- 能力目录增加“接在 Agent 的哪个环节”，区分回复前准备、模型调用、后台分析、生成后保存与后续读取。
- 各页把输入拆成准确字段、业务含义、来源、例值与必要条件；分别说明真人账号 ID、聊天 ID、角色资源 ID、实际提示词文本、历史消息和持久状态。
- 世界书页前置现成应用的配置与选书接线，补直接 HTTP 输入释义、返回原文到模型消息的对照及可执行装配片段；它属于回复前上下文准备。
- DIO 及其他能力补齐请求／返回样例、结果使用者、保存动作和生效轮次；现成业务接线与自建 Agent 的工作分开说明。
- 三大模块逐页补齐接入前提与实际操作：现成聊天服务修改哪份 JSON、服务怎样加载、请求怎样选中；保留自有后端时，在哪一步调用哪个包／服务／源码模块，返回值怎样接回正文或保存流程。完整产品补充业务方与仓库应用各自负责的工作，SDK 示例补充依赖对象、真实资料来源和状态所属聊天。
- 调整三大模块的正文表达，按用户发消息、程序处理、结果使用的过程叙述；合并重复解释，保留字段表、调用示例、限制条件和源码依据。
- 补充 Agent V2、Story、世界书、后台笔记和历史压缩的流程图，放在各章标题下方、正文之前，区分同时执行、按条件跳过和下一轮才使用的结果；正文参数与异常说明保留。
- 世界书明确 `tenantId` 是保存和读取同一批书时使用的分组编号，由接入研发提供；其他章节继续补明账号、角色、聊天记录等数据的实际来源，以及配置值由谁填写。
- 保留三个大模块、原章节地址与已有源码依据；技术接口仍可展开，关键输入和结果在正文直接阅读。

## 2026-09-22 14:40：累计计数、空响应恢复与世界书部署

本次回填 14:13 开始、14:40 标记完成的巡检。Harness 固定范围为 `a4f5bb83..ccaaa46e`；Worldbook main 仍为 `fafdb8d`，新增的是部署证据与开放候选记录。本次维护复核保存的源码与报告，未另跑远端巡检或调用真实模型。

19:30 复核同一份已完成报告，未找到更晚的完成记录，补齐以下正文遗漏。这次补充沿用 14:40 的证据，不表示又完成了一次巡检。

- **记忆与状态**：补入 PR #209 的同一条回复追加段落后怎样读回笔记、编辑／重新生成为何需要新的消息 ID，以及沿用旧 ID 可能误读旧笔记的例子；Agent V2 保存说明增加对应入口。该项此前只在本变更记录出现，旧项目 Wiki 已有详细说明。
- **历史压缩**：补入 PR #205 本地估算分类请求长度与段落 V2 试验，说明低估后的请求失败、原文回退和有限实验结果。旧项目 Wiki 同步补充失败后实际怎样处理。
- **世界书**：两份 Wiki 补充滚动发布候选中的实例缓存条件：新实例不会继承旧实例的临时缓存，服务就绪仍需结合真实检索验证。

这些均保留候选版本、默认状态和验证范围，没有改写为主干新增或已经上线。

| 项目更新 | 已有行为与启用状态 | 对应内容 |
| --- | --- | --- |
| **Compact 累计计数** · main #207 | 新增 `boundarySearch:"cumulative"`，只用于 `bounded_recent`；借片段累计计数减少边界探测，最终仍检查完整模型请求并通过原保存规则。默认 binary；已有场景未配置 cumulative | 长历史压缩：算法、配置、降级、实际计数与质量取舍 |
| **Actor 空响应恢复** · main #208 | 配置了恢复模型且满足已有条件时，`router.empty_response` 可切一次允许的 DeepSeek 模型；备用仍为空则失败。已有 POV 场景含 recovery 配置，但未核当前线上采用 | 前台回复、Agent V2 产品、失败与恢复 |
| **Worldbook 生产部署成功** | `fafdb8d` 于 10:59–11:02 完成数据库测试、镜像构建、部署、rollout 与镜像一致性检查；run `35681509122`、deployment `6582461066` 成功。纠正 08:42 时“未见对应部署”的旧记录 | 世界书部署现状与业务接入边界 |
| **候选 #205／#209／Worldbook #15** | 本地估算及段落 V2、同助手消息追加的状态关联、滚动发布策略仍分别属于开放 PR。#209 目标是 fusion-harness，不能作为 main 的保证；#15 的 readiness 不保证向量重建已完成 | 对应能力的候选说明与旧 Wiki 候选章节 |
| **文档 #210 与待查 #211／#212** | #210 只有文档改动。#211／#212 及 #205 后续 head 仅登记为待复核，不从标题推导产品功能 | 本条巡检范围与后续记录 |

**部署与测试的准确范围。**Worldbook 当次部署成功已经成立；14:xx 当前 workload 未独立读回，job log GET 失败未取得具体 digest，不能补写不存在的集群读回结果。真实 Harness 流量、迁移 006、权限与向量／混合检索业务效果仍未验收。Harness `ccaaa46e` 的 CI 和 staging 镜像构建成功，后者只有 build/push，不能算工作负载已经部署。

巡检记录 Compact 定向 22＋10＋12 项、新增 Actor 空响应恢复 3 项通过；Actor 全文件 111/112，唯一失败涉及既有 Node 24 stdout mock；类型检查遇到既有环境相关 TS2742。这里引用巡检记录，没有在文档维护中重跑这些产品测试。离线累计计数实验走了 legacy fragment fallback，其耗时降幅不能写成生产延迟或摘要质量提升。

**Wiki 结构调整。**产品与能力 Wiki 现在分成三个并列模块：**01 完整产品、02 原子能力、03 业务接入**。第三模块依次收录“业务如何接入能力”和“Agent 编排与扩展”：先看接入步骤与完整案例，再看 SDK、工具注册、Hook 和固定流程的接法。原章节与段落地址保留；这项调整不改变产品代码。

[Harness 固定主干](https://github.com/FlowGPT/roleplay-harness/tree/ccaaa46e6fd16544481284bb1388fc78cc177009) · [Worldbook 生产部署工作流](https://github.com/FlowGPT/worldbook-service/actions/runs/35681509122) · [Harness staging 镜像构建](https://github.com/FlowGPT/roleplay-harness/actions/runs/35689577715) · [PR #209](https://github.com/FlowGPT/roleplay-harness/pull/209) · [Worldbook PR #15](https://github.com/FlowGPT/worldbook-service/pull/15)


## 2026-09-22：新增业务接入模块，补充原子能力运行细节

本次为文档补充，依据已保留的 Harness `a4f5bb83` 和 Worldbook `fafdb8d` 源码核对，没有新增一次远端巡检，也没有变更产品运行代码。

**新增**

- **业务如何接入原子能力**：现有产品开配置、自有后端直接调用、注册给主 Agent 选择三种接法；逐步说明接入点、输入、返回、采用、保存和下一轮使用。
- **业务接入案例**：已有聊天业务加世界书；新人物出现后接入人物分析。包含配置与调用片段、现成能力和业务自建部分、失败处理及联调检查。

**更新升级（原有章节）**

1. **角色正文与前台工具**：分别列出控制模型与 Actor 收到的材料，补充真实工具回执、固定菜单的扩展位置、执行后检查及记忆写入顺序。
2. **记忆与视觉连续性**：增加默认 Personalization Hook 的完整读取和写入通知；展开视觉人物记录的新增、按历史恢复、消息内保存及下次配图使用。
3. **SDK 编排**：补充并行工具的依赖、批次失败、流程完成与保存成功的区别、工具名单固定时机、上下文窗口与费用预算边界。
4. **Story 与分析工具**：补充模型判定和程序校验的分工、结算证据保留范围、结果返回与异常、超时作用范围和事件去重窗口。
5. **目录与定位**：接入模块放在原子能力目录之后，保留完整产品／原子能力两大部分；保留原章节标题定位，新增段落不挤占已有链接。

## 2026-09-22：两仓主干增量与接入边界

本次合并 **02:14 和 08:13 开始的两次已完成巡检，最新完成时间 08:42 CST**。Harness 从 `fa41d220` 经 `c2264753` 更新至 `a4f5bb83`；Worldbook 从 `9fd897e` 经 `a2dad786` 更新至 `fafdb8d`。使用报告及保存的源码定向复核受影响调用链；本次文档维护没有另跑远端巡检、真实模型或生产调用。

| 项目变化 | 实际结果和启用条件 | 对应说明 |
| --- | --- | --- |
| **Worldbook 接入扩展**：Harness #197／#199 | 显式配置后，普通 RP、Agent V2、Compact、Story、Sumi、前台工具循环均可使用世界书。每轮校验会话、解析绑定，同轮复用固定版本快照；返回空书单时不建立选择任务，不占条目位置预算，下一轮仍会重新解析 | 世界书上下文与接入章节；Agent V2、Story 产品及世界书原子能力 |
| **每次 Actor 调用重新放置世界书** | 本轮重试／分段 Actor 调用分别渲染、计数并只裁旧历史，固定提示、当前输入、条目和续写材料受保护。放不下的重试目标跳过，不污染下一个目标；本轮条目仍不自动进入 Planner、长期状态或聊天原文 | 模型输入、窗口、异常与世界书注入 |
| **Prompt 绑定修复**：服务 #13 | 移除两条绑定外键限制，通过应用层验证整个批次后替换；读取遇到失效书籍／版本返回 409，不悄悄丢一部分绑定。生产需执行 migration 006；`AUTO_MIGRATE=false`，镜像更新不代替表结构升级 | 导入与 Prompt 绑定、接入条件 |
| **Selection v3**：服务 #14 | 每一轮先通过预算／冲突录取条目，再用真正录取的正文及依赖递归；被拒条目不再额外触发其他设定。中文多字 query 用连续双字匹配，避免常见单字反复加分；单字 query 仍支持 | 条目选择、动态召回、世界书能力 |
| **Compact 过滤进入 main**：#196／#198 | 完整对话组过滤、助手自然段过滤和实测边界搜索已合入，默认关闭；自然段策略只筛 ≥40 字的 assistant 段落，drop 概率 ≥0.8，用户消息不删。超限回退恢复完整原输入与原摘要；语义误省略仍需质量验证 | 长历史压缩、记忆保存、配置参数；原候选链接保留并标已合入 |
| **Worldbook 调用观测**：#200＋后续修整 | 总观测仍默认关闭；启用后 query、历史、state、binding、选中 lore 可进入 Langfuse。只放行宿主 Worldbook envelope，每项最多 16,000 JSON 字符，超出保留结构化 preview；没有单独正文开关 | 观测与成本、世界书接入与 SDK 接线 |
| **Actor 早期失败恢复缓冲**：#206 | 配好恢复模型且符合即时流式条件时，主模型首次尝试在生成正常完成或首个正文片段后 4 秒释放缓存；未发可见正文且符合恢复条件时可切一次备用模型，已发可见正文后不能无痕切换。并非所有请求固定多等 4 秒 | 当前回复、失败处理、延迟及 Agent V2 产品 |
| **SDK／应用文档整理**：#159 | 新增／整理 46 份 SDK 与 Emochi 文档，帮助定位公开接口与接线；这次文档提交本身不代表新增运行能力、发包或部署 | 工程参考与接入源码索引 |

### 测试、部署与尚未证明的结果

巡检已记录 Harness 与 tools 类型检查通过；最新 Worldbook 放置／观测 47 项、Langfuse 导出 19 项、Actor 拒答恢复 6 项、Compact 定向 109 项通过；世界书词法／选择 29 项和 Ruff 通过。这些是**既有巡检结果**，不冒充此次 Wiki 更新重跑。另一次旧 Compact 测试受 Node 24 与 stdout mock 限制，在 36 项后停止，保留该限制。真实模型的事实召回、费用、TTFT／P95、用户放弃率未验收。

Worldbook 曾有 `c67852c` 的成功 rollout／readiness／镜像一致性记录，其文件树与合入的 `a2dad786` 一致；08:42 当时尚未取得 `fafdb8d` 的新部署证据；14:40 巡检已确认其 10:59–11:02 生产部署成功，见本页最新记录。Harness `a4f5bb83` 的成功工作流只有镜像构建／推送，没有 apply、rollout 或 readiness，不能据此写成已接管生产流量。生产当前 digest、schema 和有效配置未直接核实；没有新部署证据也不抹去此前成功部署。

另须分开核实：Worldbook migration 006 是否执行；Staging 更换镜像的工作流是否同时落实新增 tenant／观测环境变量；Demo 所信任的 `X-User-ID` 是否由真实网关注入并受 ACL 保护。Origin／CORS 不是身份认证。上述是接入与发布证据缺口，未被本次巡检证明为线上故障。

[Harness 当前固定版本](https://github.com/FlowGPT/roleplay-harness/tree/a4f5bb83cdab7aed6113ffe4b6859378887c5d91) · [Worldbook 当前固定版本](https://github.com/FlowGPT/worldbook-service/tree/fafdb8d866a8956927d4b6142683221e7cb89a96)。此前章节和历史条目各保留自己的固定源码，不将本次增量同步称为全仓重新审完。

## 2026-09-21：首次交付

建立独立 Wiki，分为完整产品（Agent V2、Story）和原子能力两大部分。原始固定源码为 Harness `fa41d220`、Worldbook `9fd897e`，未验证生产有效配置。
