Roleplay Harness × Worldbook Service项目 Wiki · Roleplay 现状与完整业务链
先看全貌,再按需要读细节

01 · Roleplay 项目全貌

10/19 更新 · 本章 6 处从第一处开始看 →

这个项目把角色资料、模型和工具接成连续聊天:Agent 提供角色回复与剧情玩法,Harness 组织执行,Worldbook 提供世界设定。

  1. 用户输入 → 业务带上角色、聊天历史和已选玩法。
  2. 准备资料 → 读取状态/记忆;已接世界书时,选出本轮适用条目,装入对应模型输入。
  3. 回复与后台 → Actor 写本轮正文;启用普通后台时,模型按需调用专家、整理后续要用的状态。Story、Sumi 各有自己的流程。
  4. 保存到下一句 → 正文和各类状态分别保存;下次请求重新读取,模型才会用到。后台未完成时,可能仍读到旧状态。

能力按玩法和配置启用,并非所有工具默认全开。下面同页查看现状、代码位置和工具;完整案例与条件可按需展开。

放在一张图里,各部分的位置是这样

当前文字Roleplay的整体关系:准备资料后生成本轮回复,启用的后台并行整理状态,正文和状态分别保存后供下一次请求读取

一段聊天怎样跑完:具体输入、回复、保存和下一句

图的中间一行是当前正文,下方是已启用时才运行的普通后台与后续读取。上方“角色与已保存资料”具体包括角色设定、聊天原文,以及所选玩法使用的持续状态/记忆;它们各自读取,再组成这一次模型调用的材料。不是一个包含所有资料、永久留在模型里的公共窗口。世界书在回复前选取。

图上几次交接还包含具体处理:资料进入模型前要选择、展开模板和检查容量;模型写出的文字交给用户前可能要过滤或改写;保存后的记录进入下一句前还要重新读取。例如,屏幕先出现的一段流式文字可能在完成时被最终正文替换;用户随后修改旧消息,也不会让普通后台自动撤销所有已保存后果。下面沿一段聊天把这些交接连起来,具体处理保留在对应章节。

先看完整过程:用户说完这一句,系统到底办了什么

用户选择角色艾琳,发来:“我把铜钥匙递给北塔守卫,请他开门。”用户只需要说这句话;聊天业务还要把用户、会话、角色、已有聊天,以及本次采用的执行方式交给 Harness。例如业务已经为这段聊天选定“世界书+普通 Agentic 后台”,程序才会按这套接法执行。它没有先问模型这句话够不够复杂,再把整条请求二选一送往快通道或慢通道。

第一件事是让回复有依据。程序取到艾琳的角色资料、近期聊天和已保存状态;在这套接法里,还会请世界书服务按本轮问题和相关材料选条目。假设选回的原文写着“铜钥匙能表明旧王室身份,但进塔仍需城主手令”,程序把这段文字放进回复模型的输入。此时模型拿到的是具体资料,不只是“请遵守世界观”一句空要求。

接着,当前回复和后台工作从各自准备好的材料出发,并行运行。写正文的模型叫 Actor,它可以写:“守卫接过钥匙看了一眼,仍挡在门口:‘城主的手令呢?’”这段文字经过本方案启用的过滤与生成后处理,成为交给业务的最终正文。聊天业务展示并保存这一份;若协议启用了预览与最终替换,完成时要用最终整段替换屏幕预览,不能把两份接在一起。正文如何交付。当前回复不需要等后台把新状态存完。后台的协调模型则判断这一轮是否需要人物、知识、剧情等检查,必要时调用专家。专家交回分析建议;需要更新时,再由 Director——负责整理持续状态的模型——写出一份新状态稿,交程序检查和保存。

这两条路径拿到的材料并不完全相同。本轮选给 Actor 的世界书原文没有自动复制给普通后台;后台也没有自动收到 Actor 正在写的“守卫接过钥匙”这段新正文。因此本轮后台不能仅凭用户说“递出”,就把“守卫已经接收、同意开门”都当成已发生。它可以记录用户的动作和仍待确认的事项,也可以判断暂时没有值得保存的变化。

下一句才把这些结果重新接起来。用户再问:“手令该找谁开?”新请求重新准备材料:上一段正文已保存且被带回,模型才能读到“守卫接住了,但还在要手令”;后台新状态已保存且此时读得到,才会替换旧状态进入后续输入;世界书则针对新问题重新选取办手令的资料。于是下一次回复有了继续往下写的依据。若后台尚未完成,下一轮可能先读到旧状态;若某项保存失败,也不能把模型曾经写出的内容当成已经长期记住。

上面的设定与台词是用于说明机制的例子。当前回复、后台分析、资料保存、下次读取,共同构成连续聊天;其中任何一步都不能由“工具已经调用过”代替。

这段聊天继续使用时,产品还会遇到下面这些操作。它们会改变刚才的闭环,不能只看“下一句仍能正常生成”就认为处理完整了。

聊天发生的变化 当前实现对这段故事的实际影响 产品需要明确的行为与完整细节
用户不满意,重新生成;或把“递钥匙”改成“收回钥匙” 普通主线使用请求交入的历史,同时读取已有持续状态;重生成仍可能启动后台。“守卫已拿到钥匙”的旧记录不会因改一句话就自动撤销 业务要定义替换哪条消息、哪些后续消息作废,以及哪些状态需恢复;逐个操作看输入与保存
运营把艾琳的门禁规则改了 Actor 与后台分别读取和组装角色资料;后台可能优先使用另一份非空角色 Prompt。原会话的持续状态也不会自动重建 核对改动实际进入哪份模型输入,以及旧剧情是否保留;改角色后的实际读取
人设、世界书、旧状态对“能否开门”说法不同 这些资料可能同时进入 Actor。条目优先级和版本检查各管自己的规则,没有一个已接好的跨来源语义裁决程序替产品选定哪份设定作准 应定义设定修改与冲突处理方式,再核对模板/接线;具体冲突案例与现有边界
用户想重新玩一次故事 世界书 Demo 点回角色会优先恢复已有会话;新对话才创建新的会话 ID;清浏览器资料不删除远端聊天与状态 界面要区分继续旧局、另开一局、删除记录;当前三个操作分别做什么
接入时选择什么:默认提供、业务责任与可支持场景含 1 处更新

默认给业务的是什么:先确定接入哪个入口

你接入的东西 一开始已经提供什么 一开始没有自动提供什么 要让用户真正用起来,还要交什么
通用 Agent SDK:自己定义 Agent 基于 Pi 的执行循环、工具执行与结果回传、取消与观测等组件;可选快慢协作运行器 没有统一 RP 主提示词,没有自动挂上的世界书/记忆/六专家;一次创建不等于拥有长期记忆库 业务自己的 system prompt、模型、输入、工具名单与具体实现;需要跨轮记忆时提供读取、提交和下次采用逻辑
Core Tools 工具包:只借用能力 六类分析、JSON 读写、图片资产、Story 工具及通用读写包装;可单独调用 安装包不会自动开启对应玩法,也不会自动获得业务用户、数据库或服务授权 给选中的工具传真实材料,注入模型/存储/服务;决定什么时候调用、结果交给谁
仓内角色聊天应用:使用现成请求入口 按 scenario_id 选择已经编写的 Actor、后台、记忆等接线 不能因用户说“加记忆、加图片”就临时安装新能力;没有“所有模块默认全开” 启用合法方案并接通依赖;聊天业务先处理用户登录、会话归属与受理,再交入身份、历史和动作;接收并保存最终正文。入口与业务责任
Worldbook Service:管理和取用作者设定 导入预览/落库、不可变修订、规则选择、可选混合检索、索引与选择诊断 不负责角色聊天、NPC 自动建卡、聊天记忆同步;服务默认不启动向量后端 运营准备书条目;接入方负责租户和权限,绑定版本、选择时机及原文注入位置;用向量检索还要启用并建立对应索引

这里还有一个容易遗漏的代码默认值:若服务启动时没有指定场景文件列表或旧 JSON 配置,server.ts 只提供 cookie-diary 和 clove-diary-table 两个默认场景,分别配置日记、日记+表格来源;两者都没有默认开启普通 Agentic 后台。每个闭环聊天请求仍必须明确带一个有效 scenario_id。这是闭环聊天服务的默认装配;仓内另有使用 scenarioId 的冻结记忆试跑接口,不能因方案同名就套用相同读写行为。这也不是所有环境的线上默认。

目前能支持哪些业务场景,做到哪一步

看 KAS/Roleplay 开发进度,先区分“能做到什么”和“在哪个环境已经跑通”。 下表沿用现有业务能力目录,在最后一列标出实现状态;各章开头还会写这项能力的接线、开启条件和部署证据。全篇使用同一口径:

状态标记 已经确认什么 还需要什么才可用于具体产品
主线已接线 · 按配置启用 固定 main 能追到输入、执行与结果的应用路径 目标环境加载对应方案,模型、模板、服务和存储可用;再验证该产品的真实请求
已有组件 · 业务需装配 SDK 或工具有公开实现,可以被接入方调用 接入方提供材料、工具菜单、依赖,以及采用、保存和回读规则;不是安装后自动全开
候选已读/候选待审 前者读过标明的实现范围;后者仅有提案或文件清单 先确认目标分支与准确版本,再完成缺失核验。是否合入、是否部署、是否业务验收,分别记录
尚无完整接线 已读路径没有形成所描述业务的输入到保存、回用闭环 仍需业务规则和实现;不能用相似工具的存在代替完成

本次更新“代码已合入”“包已发布”“指定版本已部署”“真实业务已验收”分别记录。截至 10/19 14:51,Harness main 为 f9b26a9,Worldbook main 为 ad38dce。本轮新合入六项:记忆召回容错、日记更新后的 Compact 摘要复用、Sumi 模型与图文模式选择、初始化追踪、绘图提示编译失败兜底,以及服务监控。Sumi 的固定版本已于今天 13:26 完成生产镜像更新和就绪步骤;这不证明 Emochi 已采用新记忆策略或实验配置。Worldbook 沿用 10/09 成功部署证据。SDK Latest 仍是 0.6.0,Core Tools 0.2.3 只是前次已核基线。本次变化 · 分支各自状态。

下表的“主线已接线”不是保证模型效果,也不是承诺所有能力可以同时开启。某项外部依赖尚未验证,表示未确认,不表示已经确认它没有部署。

用户希望发生什么 当前怎样实现 当前交付、保存与下一次使用 接入阶段与条件
与已有角色连续文字聊天:“继续刚才的对话。” 角色与历史组装 → Actor 生成 → 业务保存正文 当前回复;下次由聊天业务带回已保存历史 主线已接线 · 按配置启用;具体输入与交付。模型、角色、模板、消息保存服务必须可用
人物、关系、秘密和承诺保持连续:“记着我明天还钥匙。” Actor 写正文时,普通 Agentic 后台按需咨询、整理状态 后台通过检查并保存后,后续轮读取 state+有限 ledger 投影;当前正文不等它 主线已接线 · 按配置启用;后台触发与产物。每次进入生成安排后台,并非全局累计 X 轮才启动
遵循一本已存在的世界书:“进北塔有什么规矩?” 回复前按已绑定版本选条目,原文进入 Actor 当轮看到门禁原文;下轮重新选择,没有自动把同批原文交后台 主线已接线 · 按配置启用;绑定与启用。已支持显式配置的前台工具循环、Story、Sumi;条目不自动进入后台或长期状态
聊天更长,同时保留旧经历或字段:“之前借的东西呢?” 按选择的记忆后端取摘要/表格;必要时 Compact 压缩旧聊天 取回摘要文本、表格文本或压缩摘要;模板实际引用后才进入模型。写入时点各不相同 主线多种接线 · 按来源启用;保存与回读。需选来源和后端,不能把日记、表格、Compact 当成同一机制
当前故事配图:“写见面这一幕,配两张图。” 前台控制模型调用 Actor;按已启用图片策略安排任务 正文先交付,图片稍后关联同一消息;视觉资料另存供后续一致性使用 主线已接线 · 依赖图片服务;调用与保存。需要对应 Skill 配置和图片服务,不是六专家负责生图
以后持续改变角色表现:“以后她说话更简洁。” 前台 schedule_dio 交外部 DIO 编译长期修改 本轮拿到受理回执;后续读取有效的 compiledPrompt 才改变角色提示 主线已接线 · 依赖外部编译;DIO 的输入输出。外部编译与启用必须完成,不承诺本轮立刻改写
按世界事件、情节推进文字剧情:“等到天亮再出城。” Story 处理世界/叙事快照,准备当前可写内容,之后核对实际保存的正文 世界和叙事快照、待核对正文记录;下一次先采用可靠后果,再处理新动作 主线已接线 · 可选玩法;Story 如何启用和保存。替代普通六专家后台,不能叠在它后面当每轮必经模块
连续图文叙事、重生成和分支延续:“接着画刚才那一幕。” Sumi 独立协议、消息快照与图片交付 消息前后状态、可见正文、图片尝试/交付进度;按选定历史消息恢复 主线已接线 · 外部归档发布待核;快照与归档。本次固定 main 还调用图片 History/Gallery 归档,依赖外部接口发布;不直接继承普通 RP 的全套记忆
既有业务只想用一个专家或工具:“帮我检查人物知情范围。” 直接调用 Core Tool,或自行挂入 SDK Agent/已有 Workflow 分析建议、JSON 对象、新快照或图片资产;业务自行采用并保存 已有组件 · 业务需装配;可复用名单。“单工具能运行”与“完整产品已接好”分开
新人物先出场,后面不要写乱:“陌生使者走进来。” 普通 RP 先承接;后台可能调人物分析,再整理持续状态 当前正文+后续人物连续性材料;没有独立 NPC 卡 已有接线的组合案例 · 无独立人物卡闭环;从出场到后续使用。这是上面“文字回复+连续性”的专项案例,不是新模式,也不会动态安装一个 NPC 工具

尚无完整接线:进一步的“统一 Agent 自动找遍所有工具、缺资料自己查世界书、陌生人自动建可编辑卡、所有记忆同步一份真相”,目前还需要业务接线和数据规则。已有基础能力不等于这些跨模块产品已经完成。

角色、历史、状态与记忆:取出什么,下一句怎样用

世界书和记忆,都在支撑这段聊天,但保存的是不同东西

图上的“角色与已保存资料”具体指下面几份资料。先看本页使用的“普通 Agentic+世界书”接法:角色设定说明谁在演,聊天原文保留以前说过的话,持续状态记录后台认为后续要沿用的事实与要求,世界书提供作者设定。日记、记忆表和 Compact 是有对应配置时才加入的其他来源。

你在图里看到的词 实际取回的是什么;给模型看什么 直接查看具体过程
角色资料 按角色 ID 读取名字、描述、角色卡、开场等。例:“艾琳谨慎、少言”;普通 Actor 通过模板使用,后台另外组织角色定义。它不是这个模型以前聊过后永久记住的人格 从哪里读取,怎样装进本轮
聊天历史 这次请求带回或相应入口读取的消息 ID、角色、原文。例:“守卫说:手令呢?”;模板和容量处理后留下的原文才能被本次模型看到 消息从哪来 · 保留条数与容量
普通 Agentic 持续状态(Director 整理、程序保存) Axon 读回 Director 整理且程序成功保存的 state 剧情笔记、版本、来源和部分专家分析记录 ledger。例:“仍在门外;用户递出了钥匙,交接未确认”;程序选取并裁剪状态/记录文字,再给 Actor 和后台,二者长度不同 真实回包、初始状态、保存与下次采用 · 完整状态格式示例
世界书 每轮按 Prompt 关联解析出的具体书籍版本,经本轮选择后返回条目原文;关联改变影响既有会话下一轮。例:“入塔需要手令”;原文按允许位置进入 Actor,不自动复制给同轮后台 怎么选 · 原文放到哪里
日记、表格、用户资料 所选后端可能交回经历摘要、表格文字或用户设定;模板实际引用后才成为输入。这些不是普通 Agentic state 的别名,也不是全仓默认全开 取回对象与模型文字对照 · 各后端接法
历史压缩摘要 启用 Compact 后,把一段旧对话变成已知事实、互动摘要和未完事项,连同保留原文使用。摘要有独立检查点,不会因此重写世界书或持续状态 什么时候压缩、如何保存和复用
换成 Story/Sumi 时的状态 Story 读世界/叙事快照再组织当前场景;Sumi 读对应消息分支的 stateAfter 等资料。它们替换运行方式,各自有保存链路,不是普通后台每轮还必读的两份额外资料 Story 状态 · Sumi 状态

“现在用哪份”,程序按本次业务选择的运行方式、用户/会话和相关记录读取。普通后台成功保存了新版,且下一次准备时已读到,下一次才使用新版;它还没存完,模型本轮就可能继续读到旧版。资料已取回也不等于已入模——模板没引用、容量处理删掉或选书未命中,模型就没有这部分内容。具体保存时点见一轮到下一轮的时间线。

例如“钥匙已归还”先出现在一条消息里;后台状态、记忆表是否也更新,要看各自流程。当前没有一个会自动把所有资料同步为同一份内容的“总记忆”。本文解释固定源码的读取规则;某次线上请求实际用了哪个模型窗口和状态版本,需要该次有效配置及最终输入,不能从总览例子推定。

能力怎样组合:已有接线、组合限制与尚未完成部分

其余能力怎样加入整体:增强当前链路,或者换一套玩法

上面用“世界书+普通后台”说明闭环,它是一套已接线的组合,不是所有 Roleplay 的默认配置。从整个项目看,业务可以先采用普通角色回复;需要连续性分析时启用普通 Agentic 后台;需要作者设定、额外经历或长历史处理时,再选择允许这些资料能力的接法。参数、模板和保存链路必须相互匹配,不是勾选越多就自然组合成功。

要让这一轮主动安排正文、配图或长期角色修改,已有前台工具循环:先由控制模型选择已注册动作,程序执行并交回结果,再决定下一步;后台连续性分析仍可以按配置另行运行。这里“安排图片”返回的是任务已调度,图片还要生成并写回消息;“修改长期角色指令”返回的是任务受理,后续请求读到已启用的新指令才生效。它们不是调用一下就同步完成所有业务结果。

模型收到的工作要求,与程序执行时的硬性检查,也各有作用。例如 DIO 的工具说明要求“用户明确提出长期修改时才调用”,当前执行层检查接线与重复调度,但没有另做一次“这句话究竟是临时要求还是永久修改”的语义判定。因此业务若要“本次说短点绝不改永久人设”的强保证,仍需补对应采用规则。图片的数量要求也要分别看提示词与程序限制,详见模型选择与程序保证的范围。

Story 与 Sumi 则是其他运行方式,不能接在上面整条流程末尾,当作每轮还要跑的两个模块。Story 维护世界事件和叙事进度,核对实际保存的上轮正文后采用其后果,再准备本轮剧情;当前应用接线替代普通六专家后台。Sumi 使用独立图文协议,按消息和分支保存状态、正文及图片资料,用自己的方式让图文继续。

**世界书现在可以给多种玩法补充本轮设定:**显式配置后,普通 RP、Compact、Agent V2、Story、Sumi 和前台工具循环都可在回复模型调用时使用选中的条目;它不会因此自动进入后台专家或长期保存资料。Sumi 仍不直接继承普通 Agentic、额外日记/表格来源和 Compact 历史压缩;Story 仍替代普通专家后台。实际组合与注入位置。

对产品而言,目前整体做到了哪里

已经有的,是能交付回复、能按选定流程延续资料的应用,以及可供其他业务复用的模型执行和工具能力。普通文字 RP、世界书参与回复、并行连续性分析、前台图文动作、Story 和 Sumi 都能找到对应实现与接线。要采用哪一种,先确定用户体验和这套流程的输入、交付与保存责任。

仍需要具体接入设计的,是跨这些流程的自动协作。例如“后台缺资料时自己再查世界书”“陌生人物一出场就自动建立可编辑、跨会话复用的人物卡”“聊天变化同时同步世界书、表格、人设和剧情状态”,都不能只凭仓库里有相关工具就承诺完成。缺的通常是资料权限与输入、调用时机、结果采用、持久化以及下次读取之间的接线,而不只是再写一个工具名称。

两仓库在这个整体里的分工也由此确定:Harness 组织回复、模型判断、工具执行和资料使用;Worldbook Service 管理作者设定版本,并返回本轮适用的原文。聊天记录、普通状态及部分记忆/图片数据还要通过对应外部业务服务保存。整个产品闭环跨这些服务完成,没有一个统一的“本轮成功”可以替代所有保存与交付结果。

继续查看实现细节、核查范围与源码依据含 1 处更新

这两个仓库目前交付的是一套可组合的文字娱乐基础能力,以及几套已经接好的聊天玩法。用户输入一句话后,先由业务指定采用哪套玩法;程序读取这套玩法需要的角色、历史和资料,把不同工作交给对应模型或工具;当前正文先交付,需要延续的记录按各自规则保存,后续请求再取出并放进模型输入。世界书服务负责作者设定的版本和选择,Harness 负责资料使用、模型与工具执行;聊天、部分记忆及图片还依赖外部服务完成保存。

目前没有一个开箱后就拥有全部工具、全部记忆、全部世界书的统一主 Agent。已经做好的部分包括:通用模型工具循环、固定流程接线、文字回复、并行连续性分析、世界书参与回复、长历史压缩、记忆后端、剧情推进和连续图文。它们的接入程度不同,部分组合还被程序明确禁止。下面先说明“接入后拿到什么、能做什么”,再沿一轮对话看实际运行。

本次更新更新至 2026-10-19 14:51 已完成巡检。本轮补入记忆读取失败时的可选容错、日记变化不再误使压缩摘要失效、Sumi 模型与图文模式接入、生图编译失败后的原始描述兜底,以及已合入的初始化追踪和服务指标。Sumi 今天的生产部署有实际步骤依据;DIO 后台长期修改和摘要质量检查仍在开发分支。查看本次变更;查看待合分支。

整体读完后,再按这条链下探

总览中已经出现的环节 继续看对应细节
业务选择执行方式;两个仓库各自负责什么 运行方式与组合 · Agent 的运行方式 · Harness 的执行能力 · Worldbook 的资料服务
准备角色、历史、状态和本轮世界书 本次输入长什么样 · 容量与可改参数 · 各岗位的提示词 · 世界书导入、选择、注入
写当前回复;并行检查;保存后供后续使用 模型原文到最终交付 · 后台调用 · 状态保存与生效
记住经历、维护字段、处理长历史 记忆与资料的完整生命周期
已有聊天中改输入、换回复、更新人设或重开 消息操作与旧状态 · 角色更新 · 资料冲突 · 世界书 Demo 会话操作
前台图片/长期修改,以及 Story、Sumi 玩法 图片与图文运行 · Story
工具能完成什么,具体怎么调用 业务能力与接线 · 精确工具接口
把示例走到每一个输入、输出和失败分支 两轮完整运行案例 · 异常与重试
接入、成本及版本核对 业务接入 · 成本与记录 · 已核变更 · 候选实现
总览的固定代码依据与核查范围

正文概括自已审两仓代码与各章完整链路,不以单个型号配置代替项目范围。本轮按上述固定源码基线及已完成巡检复核文档,没有刷新远端 main、运行模型或验证生产部署。源码存在、应用接线、运行配置启用和实际效果验证分别判断。

业务请求选择方案[1];资料准备与后台独立输入[2];后台与Actor开始生成[3];专家执行、Director与保存[4];聊天业务保存正文[5];世界书当前选择服务[6]。

前台动作与条件[7];Story分支与普通后台分支[8];Story采用与提交[9];Sumi运行与消息快照[10];组合限制[11]。

SDK Agent公开执行入口[12];SDK源码包版本[13];Core Tools公开入口和版本[14];未指定加载项时的应用默认方案[15];启动加载条件[16];世界书默认向量设置[17]。

各项资料的保存与回读详见第9章;工具是否已接、只是可复用封装或属于候选实现,详见第14、21、24章。同名产品、SDK工具和代码分支不作为同一层并列。

核验范围与开发状态

先对上名字:这些代码具体在做什么

main 看合并后的整体能力;分支看研发新增或修改的逻辑。下表直接标明名称、运行方式和代码位置。

工具索引:Agent/剧情人物与图文 · Harness/上下文、记忆与接入 · Worldbook/导入、绑定与召回。完整分支目录。

主干、分支与需求索引的阅读口径含 1 处更新

main(主干)看合并后的整体结果:已经合入的新增、修复和调整,共同构成这一版主干的运行逻辑。下表说明这套代码现在有什么、怎样工作;后续改动合入时,更新这份整体说明。

分支看研发的具体改动:研发从一个代码版本另开分支,增加或修改逻辑,再把提交推到仓库。表中写明它改哪里、产生什么效果、处于候选还是已有合并记录;已经进入主干的能力,同时体现在 main 栏。分支起点和合入目标按实际记录填写,例如 #170 的目标是 Fusion 分支。

本次更新本页按 10/19 已完成增量巡检回填,状态截到 14:51:Harness main f9b26a9,Worldbook main ad38dce。记忆容错、日记与摘要身份分离、Sumi 模型/图文模式、初始化追踪、编译失败兜底和服务指标已进入主干。Sumi 今天的生产步骤成功;Worldbook 保留 10/09 历史部署证据。DIO #303、摘要审计 #305 仍未合入,#297 仍开放;Fusion 三层分支未重新核 head。旧分支目录保留原读取日期,新进展在对应现状与候选章节区分;本次未重跑远端巡检、产品测试或生产业务。

索引对照 KAS 需求List&优先级(9 月 21 日读取),列出工具名字、类型、用途、产物和现有接线。飞书的一/二/三期是交付计划;这里按代码说明已有部分和仍需接通的部分,不按名字相似就判定完成。

每张表先看两列:“名称与执行方式”说明它是什么、由谁决定下一步;“代码位置”直接写明仓库和 main/开发分支。基础功能在 main、增强仍在分支的项目,在同一格分别标出。后面继续说明运行过程、研发改动和进展;详细分支目录保留一条真实分支一条记录。

这里的 RP 代码仓库正式名称是 roleplay-harness,下文使用这个名字;世界书的独立仓库是 worldbook-service。代码位置按本 Wiki 已核版本填写。

Agent:RP Agent V2、Story、Sumi 与前台工具|现状、工具与分支含 3 处更新

Agent:收到用户输入后,怎样回复、推进剧情并延续记录

Agent 主干的整体情况:已有普通 RP Agent V2、Story 和 Sumi 三种运行方式;回复、后台、图文和状态处理按所选方式执行。前台 Actor/图片/DIO 工具按配置接入。Story、Sumi 都由代码编排流程;普通 V2 后台则允许分工模型选择工具。下表同时标明能力所在仓库与主干/分支;普通链路沿用已核固定源码,Jev 新增按 fa41d220 定向核对。

名称与执行方式(谁决定步骤) 代码位置(主干/开发分支) 现在 main 已经怎样运行 相关分支与具体改动 目前到哪一步
RP Agent V2(角色扮演 Agent 应用)
程序调度+模型选工具。程序安排前后台;后台分工模型在两阶段内选择专家与 Director。
主干:普通 V2
roleplay-harness / main
开发分支:Pioneer 增强
roleplay-harness / codex/pioneer-actor-progress
固定候选 61039e5
Actor(回复模型)写本轮正文。Jev 决策适配已合入、仓库场景尚未开启;默认后台不因此改变。普通 V2 启用后,每个进入生成的逻辑轮先启动后台分工模型;再按需选择剧情、人物、知识、世界时间、承诺与伏笔、场面六类分析工具。首轮/新名字另有必需检查规则。Director(笔记整理模型)按需整理笔记,程序校验出有效变化后才尝试保存;不是每轮都调用六专家或写入新版。
六类专家的职责和结果 · 完整一轮
Pioneer 增强(状态关联与图文接入改造):codex/pioneer-actor-progress 按当前可见回复寻找对应状态,等正文保存后再关联状态,改善重生成后的状态归属;同时增加图文输出、消息保存和图片回填的接线。
展开分支变化
普通 V2 已在主干;这组 Pioneer 增强为已读源码的候选。主干另有 Pioneer 查询、调试接口;候选新增内容以此行列出的改造为准。
Story(代码编排的剧情工作流)
程序定步骤和触发条件。内部六个工具分别准备场面、安排剧情目标和结算;部分步骤调用 LLM。
已在主干
roleplay-harness / main
包含 Story 应用流程和公共 Story 工具。
接入方启用 storyV1 后,程序协调器安排工具执行:回复前准备场面和剧情目标,交给 Actor 写正文;回复后保存待核对记录;下一请求读取上一条实际保存正文,确认后果并推进事件。启用时接替普通 V2 后台。
查看组成、谁调用及完整过程
历史开发分支:codex/pov-story-tools/#134。当前主干已有两层实现:公共的六个世界/叙事工具,以及调用这些工具、连接 Actor 和状态保存的 Story 应用代码。 主干已实现,按 storyV1 配置启用。#134 在分支清单中的记录为 Merged;本行说明主干现有能力。事件提示牌 #250 已合入并随 Core Tools 0.2.3 发包;当前仍需留意旧会话关闭/更换牌组的限制。提示牌实际作用
本次更新Sumi(代码编排的图文工作流)
模型生成正文、状态与绘图描述;程序解析、保存,再异步生图。
已在主干
roleplay-harness / main,固定 f9b26a9。
Chat Service 选择本轮主模型,Sumi 使用该配置生成正文与状态;可通过开关只交文字。图文模式先发 loading,快照提交后才生图;编译器失败时,新图片尝试可使用完整原标签继续。历史不一致仍先核实已存正文再重建。
输入、状态与图片交付
#300 模型/图文模式、#289 初始化观测、#304 原始标签兜底和 #296 指标均已合入;旧候选按历史日期保留。 10/19 13:26 已完成 f9b26a9 production 镜像更新与就绪步骤。有效实验配置、当前 Pod 和客户端体验未独立验收。版本与部署
本次更新Fusion(Narrative 图文业务接线)
程序将正文和图片关联到聊天消息,并分别处理回复、后台和交付结果。
业务分支
roleplay-harness / fusion-harness,9/24 已核历史固定 c8fc61c;未并入 main。
正文先交付,图片失败独立收尾;20 秒正文停顿保护和配置的 5 秒模型对冲;同一消息追加正文可继续关联后台状态;DIO 请求携免计费标记,运行指标另供采集。
当前行为与实际部署
早期 codex/fusion-sumi-message-format/44ffcf1 与 Yuzu #170 保留为历史开发记录;新的图片失败通知 #241、指标 #249、DIO 标记 #253 均进入 Fusion。
早期交付改造
9/24 03:16–03:19 已有 c8fc61c production rollout。没有独立读取当前 Pod;图片在客户端是否收尾、指标是否采到、DIO 钱包是否免扣分别待验证,不能只看请求完成。
Actor/图片/DIO(模型可选的前台工具组)
控制模型选下一步。在已挂载的工具和额度内,选择写正文、安排图片、长期修改或结束。
已在主干
roleplay-harness / main
当前前台工具循环与工具接线。
前台控制模型从已挂载菜单选择动作:actor 写正文,generate_image 安排配图,schedule_dio 向外部服务提交长期修改。DIO 接单后本轮仍继续回复,完成后的有效提示词供后续请求读取。 codex/actor-tool-hooks/#78 是早期工具化分支,主要能力已通过 #108 进入 main。这里列的是模型可调用的工具;分支名里的 hooks 不是这组能力的类型。
展开旧版与当前区别
主要能力已在主干,按所接服务提供工具菜单。#78 在记录时仍 Open;当前参数以主干实现为准。

本次更新同一行按能力区分位置:普通 V2 在 main,Pioneer 所列增强在开发分支;Sumi 图文流程、#289 初始化追踪和 #296 指标已在 main;其他观测/部署候选按各自日期保留。Pioneer 是对现有 RP 接入的增强,Fusion 是图文交付改造;它们不因名字不同就变成几套互不相关的产品。Story、Sumi 的工作流步骤写在应用代码里,包含条件判断、失败处理和异步任务;它们没有通过下方通用 profile 工作流配置来定义步骤。日记、记忆表和历史压缩的完整说明仍在记忆章节,真实分支仍在本页完整目录。

Agent 工具索引:从需求里的名字,找到实际做事的模块

下表对应飞书的“剧情与角色”“世界状态”“角色档案”“多模态”需求。同一个需求可能要几个工具合作;同一个工具也可能参与几项需求。“当前接线”指已核主干实现,不代表某个生产入口已经启用。

飞书需求/想得到的结果 实际工具或模块(类型) 当前怎样用、交出什么 对应程度与详情
Actor 直返与工具调用:该回复时直接写,需要配图或长期修改时再调用 actor、generate_image、schedule_dio、over(前台模型可选动作);普通 Actor(正文生成器) 不启用前台控制器时,Actor 直接写正文;启用 preActorDirector 后,控制模型选动作,程序执行并把回执交回,直到结束。正文本轮交付,图片与 DIO 各走后续流程 **已有接线,按配置启用。**菜单没有默认附带世界书补查或 NPC 建卡。实际菜单 · 参数与回执
角色推演、角色档案与在场名单:人物按身份、动机和知情范围行动 judge_npc(人物分析工具)+audit_knowledge(知情检查工具)+update_director_state(笔记整理工具) 后台拿角色、历史、新输入和旧笔记,分析谁在场、知道什么、为何这样反应;Director 按需整理成新笔记,经校验保存,后续 Actor 读取 **有分析与笔记接线;不是独立人物档案库。**分析不会自动生成可单独编辑、检索的 NPC 卡。人物实例 · 知情实例 · 保存
新角色生成:新 NPC 出场后,补全身份并保存,下次仍是同一个人 Actor+judge_npc+Director;可另接 generate_image_asset(独立图片资产工具) Actor 可以先承接新人出场;后台依据已有材料整理身份与待揭示信息。人物分析经采用后进入持续笔记;单独生图只得到图片资产 **现有部分可组合,完整建卡链未接通。**没有自动执行“创建人物 ID/卡片→发布世界书→下一轮按卡召回”。Actor 本轮临时创造的人物,后台通常要到后续历史里才能看到。完整新人案例 · 独立图片工具
当轮导演工具:先排本条回复的人物、动作、台词、内心和顺序,再让 Actor 演 direct_scene(后台场面顾问);update_director_state(后台笔记整理);preActorDirector(前台控制器);Story 的当前剧情包 三个含“导演”的名字做不同工作:场面顾问给建议;笔记 Director 整理跨轮记录;前台控制器选择正文/图/DIO 动作。Story 则在正文前给当前场面和目标 **不能一比一等同飞书的当轮导演。**普通后台与 Actor 并行,建议不保证用于正在写的这一条;前台控制器也不等于人物动作排演工具。场面顾问 · 前台四动作 · Story 准备
场景分类与动态 preset、叙事节奏:日常、悬疑、战斗有不同写法 Scenario/presetRef(接入配置);selectPreActorSkill/createPreActorDirectorHook(可复用预选实现);analyze_plot、direct_scene;Story 剧情包 业务先选配置与 Prompt;另有模型选择 actor({skill})、返回预配 Actor 参数的实现,但当前主入口未调用此 hook。后台可建议推进/停留/镜头,Story 可交当前目标 **已有配置、节奏建议和未接主入口的预选实现;不是统一自动切 preset 的已运行链。**改长期风格另走 DIO,不等于当轮场景分类。路由与装配 · 剧情建议 · DIO
视角投影:玩家能看到什么,各角色知道什么 audit_knowledge+direct_scene(后台建议);PovPrepareTurnTool(Story 场面准备) 普通 V2 分析知情限制与镜头侧重,保存后用于后续写作;Story 在 Actor 前准备该视角可用的场面资料 **两种运行方式各有实现。**后台建议不是强制过滤玩家信息的权限系统;Story 也没有自动读取本轮世界书条目。知情范围 · Story 输入输出
叙事债务:伏笔、承诺和期限后续能接回来 manage_callbacks(承诺与伏笔分析工具)+Director 例如“日落前还钥匙”:检查未履行承诺,给后续提醒,采用后存入笔记;下一轮再次作为材料 **已有后台接线。**提醒不等于立刻触发事件,也不保证每条伏笔按时兑现。触发、产物与例子
故事时间推进、世界事件推进、事件状态与时间线 普通 V2 的 simulate_world(建议工具);Story 的 PovPrepareTurnTool、PovAdvanceWorldTool、NarrativeSettleEventTool(工作流内工具) V2 对时间经过/场外活动提建议。Story 从保存的世界快照准备场面;后续请求读取上条实际保存正文,推进世界并结算事件,写入新的快照 **两个不同策略。**普通建议与 Story 事件结算不能算同一份世界状态;不能把未来计划当已发生事实。世界顾问 · Story 过程 · 快照保存
多备选规划与选优:选择剧情方向,用户改主意后调整 analyze_plot(建议);NarrativePlanCycleTool、NarrativeDealBeatTool、NarrativeRebranchTool(Story 计划、当前目标、调整分支工具) Story 对已有合格、未完成目标评分选一个并交当前剧情包;主线调整要求最近指定数量的已结算事件给出同一非空用户方向,支线另按停滞阈值处理。普通后台只交剧情分析建议 **已有目标评分和有条件改线;不等于生成几份完整剧情、评分选一份。**用户一句偏离不保证立即改线。六个 Story 工具
多模态信息存储与召回:图片、角色参考和场景资料后续可用 prepare_visual_world/commit_visual_world(视觉状态步骤)、roleplay.state.project_assets(宿主资料读取)、generate_image_asset(资产工具)、Sumi(图文工作流) Imagine 按会话投影人物/线索/世界资料,并准备外观和场景材料供图片描述;本轮实际准备过视觉资料且完成回合,才安排后台更新。Sumi 按消息保存图文状态,图片另可归档 **已有图片链路;视频按人物/事件/场景存储与召回没有已核闭环。**当前画面、参考图、图库、聊天图片是不同产物。Imagine 失败的 pending 问题与 Sumi 恢复机制分别看。视觉目录 · 图片与保存
其他已接能力:下一句建议、长期修改(补齐实际工具目录) auto_reply(业务请求入口);schedule_dio(前台动作) 前者按当前消息与已保存材料生成三条候选供用户选,不代发;后者受理长期风格/角色修改,由外部服务生成有效 Prompt,后续请求读取 **已有入口,依赖各自配置。**快捷回复是宿主请求,不是后台第八个专家;DIO accepted 不等于完成。下一句建议 · 长期修改

补充源码:预选 skill 的可复用实现[1] · 图片使用已有资料的接线[2]。project_assets 是按会话投影已有资料,不是按 query 搜全库;JSON 记忆工具也只是宿主范围内整对象读写,不是素材检索系统。

RP Agent V2 里的六类专家:各检查什么,交回什么

“专家”是六种带专门岗位提示词的 LLM 分析工具。被选中时,程序把角色资料、旧剧情笔记、近期对话、用户新输入,以及这次要检查的问题交给对应模型。每种岗位的模型和提示词按配置读取;返回的是分析建议文字和执行结果。

专家/实际工具名 负责什么问题 会交回怎样的建议(教学例子)
剧情顾问 analyze_plot 用户改变选择后,主线、当前情节或支线是否要调整,接下来怎样承接 用户说“先不进塔,去城门查记录”:建议保留寻找失踪者的目标,把当前方向改为城门调查;不把“想去”记成已经到达
人物顾问 judge_npc 配角是谁、有几人、动机与关系、知道什么、在哪、怎样合理进出场 用户安排一个陌生使者出场:整理其已知身份与所在位置,指出来历和关系仍未知;给出后续可揭示方向。返回的是人物分析,尚不是一张已创建的 NPC 小卡
知识检查员 audit_knowledge 哪些是事实、秘密、谎言或猜测;每个人究竟知道哪一部分 “守卫见到了钥匙,但没人告诉他钥匙的来源”:建议保留这条知情限制。它依据传入材料分析,没有自动检索整本世界书
世界时间与场外活动顾问 simulate_world 时间确实经过或人物分开后,日程、位置、期限和场外人物活动应如何变化 历史写明过了两小时且接近换岗:分析原守卫是否仍在岗、期限是否临近,给后续写作建议;这些建议仍需被采用和保存
承诺与伏笔顾问 manage_callbacks 跟踪承诺、线索、物品、伤势、义务、伏笔与延迟后果,提醒尚未收尾的事 “钥匙是借来的,用户承诺日落前归还”:建议保留归还义务与期限;不强迫本轮立即触发追债或归还
场面顾问/Scene Director direct_scene 选择视角、镜头侧重和角色主动程度,给用户保留选择空间 “让守卫先回应递钥匙这件事,艾琳只提醒风险,把是否解释来历留给用户”:返回写法建议与主动程度建议,不代替用户决定

谁来分工:Orchestrator(后台分工模型)先读取材料和工具菜单,选择本轮需要的检查;程序执行被选中的工具,同批可并行。首轮会在工具启用时补人物、场面检查,有限的新名字识别规则也会补人物检查。六类都在菜单里,不代表每轮六类全跑。

结果谁来用:建议先回到 Orchestrator;需要改笔记时,它调用 update_director_state,由 Director(整份剧情笔记的整理模型)综合旧材料与建议,写出新版。这里的 Director 与上表只提镜头/场面建议的 Scene Director 是两个岗位。程序随后检查内容格式、长度及保存版本,提交成功后,后续 Actor 才能读到新笔记。

保存的“状态”具体是什么:一份跨轮剧情笔记,记录当前场景、人物关系、谁知道什么、物品与承诺、后续方向等。例如“用户已经递出钥匙;后台尚未看到守卫的新回应,是否接收仍待确认”。后台启动时没有 Actor 正在生成的新正文,也没有自动收到本轮给 Actor 选中的世界书原文;它只能按实际收到的材料提出建议。

依据:六工具的名字与职责[3] · 岗位提示词装配[4] · 分工与工具执行[5] · Director 读取建议并生成笔记[6]。完整的调用、失败与保存时序见慢通道,各专家长例见工具职责与例子。

展开 Agent 各项完整过程:输入、执行、保存、下次使用与源码

重点分支:从一句用户输入到下一次使用

以下保留完整运行过程与固定源码依据。示例台词用于解释机制,不是模型实测结果。

main:现在主干里的 RP Agent V2 怎样回复和延续剧情

这一项看主干已经有的普通 RP Agent V2。 它让角色及时回复,同时在后台维护后续需要的剧情资料。main 还包含 Story、Sumi、SDK 和其他能力;“主干有代码”不代表每条 RP 对话都同时启用它们。本卡保留 3b99f4c 的普通运行路径证据;新增的可选 Jev 决策与 Prompt 世界书解析,分别见慢通道更新与取书更新,不改变本卡的默认后台启动规则。

**拿什么进来:**业务提供用户、会话、角色和运行配置,以及当前输入和选定历史。例:“我把铜钥匙递给守卫,请他开门。”程序再读取角色资料和这个会话已保存的 Agent 状态;若这条配置接了世界书,还要为本轮选资料。回复模型和后台分别组装输入,不是把同一个大包发给所有模型。

**这一轮怎样运行:**回复模型 Actor 根据自己的材料写守卫的反应。进入生成的同一逻辑轮,程序安排 Orchestrator(后台分工模型)选择需要的分析工具:剧情、人物、知识、世界时间与场外活动、承诺与伏笔、场面六类,逐项职责见本页专家表。程序并行执行选中的分析;需要保存变化时,再由 Director(笔记整理模型)综合结果,写一整份跨轮剧情笔记。程序检查格式、长度、是否变化及保存版本,符合条件才提交。可以不咨询,也可以没有值得保存的变化。后台不等 Actor 这轮的新正文,因此不能把刚生成的台词当成它已经检查过的证据。

**会拿到两种结果:**用户拿到角色正文,例如“守卫看过钥匙,却仍在索要手令”;后台可能保存“用户已递出钥匙,交接和通行结果在本次后台材料里尚未确认”等状态。正文由接入业务按聊天协议保存,持续状态经 Axon 状态接口保存。二者分别完成,不是一笔同时成功的事务。

**下一句怎么用:**用户说“那我去申请手令”,程序重新取得这次传入的聊天历史和当时已成功保存的状态,供 Actor 继续写。如果后台还没完成,可能仍读旧状态;普通主干不会因为用户点了重生成,就自动撤销之前已经保存的后台状态。

**与其他分支的关系及边界:**这张卡说明普通 RP 的已接链路;默认菜单、实际使用的模型和是否启用图片/DIO/世界书由对应配置决定。没有把仓库里每个工具都自动挂给普通 RP,也没有验证所有线上环境都运行这个固定版本。

main 固定代码:装配、后台、状态和后续读取
  • 普通 Agentic V2 的装配入口[7]。
  • 读取状态并分别准备材料[8]、每个逻辑轮安排后台[9]。
  • 协调器执行专家并读回结果[10]、校验和提交状态[11]。
  • 状态读取和保存接口[12]。

如果前台启用了工具循环,Actor 可以通过 actor 工具被调用,图片和 DIO 依可用服务接入;这仍属于配置选定的主干执行路径,不能将该前台控制器和后台专家协调器当成同一个模型。

codex/pov-story-tools:先安排当前场景,再根据保存的正文结算后果

**Story(代码编排的剧情工作流,内部调用六个世界/叙事工具)。代码位置:roleplay-harness / main。**接入开发者通过 storyV1 启用;程序中的 StoryTurnCoordinator 负责决定各步骤何时执行,Actor 负责写给用户看的正文。条件、顺序和恢复处理写在应用代码里;部分工具调用模型分析剧情。这里的 Story 名称指整套运行方式,codex/pov-story-tools 指其历史开发分支,分支清单中的 #134 状态为 Merged。以下运行过程依据主干 3b99f4c。

**工具具体在里面怎么用:**回复前,程序用 PovPrepareTurnTool 准备场面;需要新的剧情目标时调用 NarrativePlanCycleTool,再用不调用模型的 NarrativeDealBeatTool 挑本轮目标。下一次取到已保存正文后,PovAdvanceWorldTool 更新世界后果;事件结束或中断时用 NarrativeSettleEventTool 核对目标完成情况,满足调整条件时再用 NarrativeRebranchTool 改剧情方向。六个工具由程序按阶段和条件调用,逐项输入输出见 Story 工具表。

**它与 hook 的关系:**Story 通过专用应用适配器接入回复前准备和回复后保存。公共工具的 beforeExecute、afterExecute、afterTurn 是执行前后可挂的回调;这些回调是 hook,Story 本身是使用工具和状态存储的业务运行模式。工具生命周期定义[13]。

**它在解决什么:**让事件、人物所在位置、可见线索和剧情目标有各自进度,并区分“准备让剧情往哪走”和“正文里真正发生了什么”。这与普通 V2 并行维护一份文字状态的时序不同。

**拿什么进来:**同样是“我把铜钥匙递给守卫,请他开门”,加上角色、可见历史以及已保存的 Story 世界/叙事状态。首次没有状态时先初始化;已经有上一轮待核对记录时,先取上一条实际保存的正文和消息关联。

**这一轮怎样运行:**World 部分判断当前在哪、谁在场、用户是在继续眼前事件还是转场;Narrative 部分在需要时规划目标周期,由程序挑满足前提的当前目标。程序把本轮场景与可选方向放进 Actor 输入,准备好后才生成正文。比如先交给 Actor“仍在门口,可以核验身份,不要直接认定进塔”。

**回复之后存什么:**假设 Actor 写出“守卫接过钥匙,但没有开门”。本轮成功后先尝试保存 Story 状态和 pendingActor——对应哪条回复、哪句用户输入、当时准备的场面。它不是已完成的事件结算,也不是让用户点一个“接受”按钮;聊天正文仍由聊天链路保存。这里的状态保存仍可能冲突或失败,程序记录到 Story 报告,不撤销已经完成的角色回复。

**下一句怎么用:**用户说“我想把钥匙拿回来”,Story 先读上一条权威保存正文,核对消息和历史关联,再据此确认“钥匙曾被接收,门没有开”。若关联用户输入或更早已采用正文已经变化、不再匹配,就按当前可见的权威历史重新初始化,不继续套用旧后果。随后处理这句新要求。推进先发生在当前执行内存中,仍要等当前回复成功并完成状态提交,才持久保留。下一次再从保存状态继续。

**与 main 的已知关系及边界:**main 当前装配选择 Story 时,不再同时启动普通 V2 六专家后台;9/22 主干已允许显式配置世界书,条目注入当前 Actor;Story 规划工具不会自动拿到同一批原文。重生成/编辑后重生成在当前接法中走基础 Actor,跳过 Story 准备和写入。不能把 Story 的正文核对机制说成所有 RP 都默认拥有;没有本卡对应部署的生产验收。

Story 当前主干证据与旧分支阅读范围

完整分支名和 #134 的 Merged 状态来自既有 99 分支清单;本卡运行行为依据以下 main 固定文件。旧分支 head 与当前 main 的完整差异比较尚未完成,因此本卡只描述已读主干实现,不列“旧分支独有功能”。Git 名字、PR 标签和当前实现是不同证据,未据此补出旧分支 SHA。

  • Story 与普通后台二选一装配[14]。
  • 读取上一条保存正文并准备本轮场景[15]。
  • 采用正文推进世界及保存 pendingActor[16]。
  • 基础 Actor 回退、重生成和状态接线[17]。
  • World 实际工具[18]、Narrative 计划、派发和结算[19]。
codex/pioneer-actor-progress:图文回复之外,把剧情状态绑回实际回复分支

**固定候选:61039e5,9 月 17 日核查时未进入对应 main 基线。**这个分支的关键变化之一是处理“重生成后,下一轮到底应该拿哪条回复留下的状态”,同时扩展图文生成和交付接线。

**拿什么进来:**用户、角色、会话、选中的消息历史,以及 chat/continue/regenerate/edit-regenerate 这次操作。例:旧回复说“守卫已收下钥匙”;用户改写或重生成后,新回复变成“守卫拒绝接收”。它不能继续无条件沿用旧回复所属状态。

**这一轮怎样运行:**状态读取程序从当前可见助手消息向前查,核对正文内容、用户锚点和状态快照引用,选到对应分支的状态。启用这套图文路径时,Actor 生成正文片段,图片准备工具取这些已写出的片段、角色参考图和视觉资料,编译绘图任务。Narrative 入口处理消息保存、正文交付和图片后续回填;图片结果不要求先于正文全部完成。

**回复之后存什么:**保存用户看到的正文及图片关联,图片任务另外保存尝试和生成结果。后台状态在提交前等待指定的非空助手正文确实已保存;成功提交后,再把状态快照引用挂回该消息;如果这一轮正常结束但没有提交新状态,也会尝试把本轮使用的旧快照引用挂回消息,让下一轮知道沿用了哪份状态。这里等的是“这条正文已经存在”,不是把它重新交给已启动的后台逐句复核。

**下一句怎么用:**用户说“那钥匙还在我手里”,程序沿这次可见消息寻找相符的状态引用,避免把已经换掉的旧回复状态直接当成当前分支状态。视觉资料和图片归属也供对应的后续图文流程使用。如果所有可见消息都找不到合格锚点,读取结果是“未找到状态”,随后用预设的初始文字状态准备 Actor/后台;这不是再调用一个模型重建完整人物。如果已经找到引用、但服务返回的快照引用不一致,则报错,不会当作普通无状态静默继续。

**与 main 的已知关系及边界:**这组候选增强不能当主干默认保证;main 本来就有 pioneer/api.ts 的读状态、调试和建议回复接口,不能笼统说“Pioneer 全部未合并”。正文保存、状态提交、挂接仍是多次操作,可能部分成功。候选也没有自动建立并发布完整 NPC 人物卡的闭环;本卡没有重跑线上验收。

Pioneer 固定候选证据
  • 按可见消息、正文及用户锚点选状态[20]。
  • 等待正文保存、挂接快照及版本提交[21]。
  • 图文请求入口和交付[22]、图片准备[23]、实际生成与尝试记录[24]。
  • 无匹配锚点后的初始状态回退[25]、没有提交新状态时挂接旧快照[26]。
  • main 原有 Pioneer 接口[27]。
codex/fusion-sumi-message-format:让融合生成的图文按现有聊天消息格式交付

**固定候选:44ffcf1,9 月 17 日核查时未进入对应 main 基线。**它着重解决“生成了一段文字和几张图,现有聊天客户端如何接收、存储和显示”,分支名里的 Sumi 指格式对齐,不能据此说内部生成已经换成 Sumi。

**拿什么进来:**融合图文请求及选中的消息历史。例:“让守卫检查钥匙,给这一幕配一张图。”实际绘图仍要等正文中有对应片段,图片还需要角色参考、提示词、所属消息和段落位置。

**这一轮怎样运行:**保留融合生成与独立图片任务。开启增量模式时,先把解析出的部分正文保存到助手消息,再推 chatStream,图片可提前启动;没有开启增量模式时,这条入口等生成结果后才交付。最终先核对保存正文,再发末尾 chatStream 和最终 chat。图片程序确定正文段落锚点,生成成功或失败后发对应图片事件;消息使用原生图片字段持久化。它要让客户端知道“这一张图属于这条回复的这一段”,而不是只交一个没有归属的 URL。

**回复和保存产物:**用户得到文字和异步出现的关联图片;聊天消息保存正文、图片列表及段落关联。私有图片状态和任务元数据留在 Axon memory,不把内部状态直接作为可见对白。增量模式下后续即使失败,先前保存的部分正文仍可能存在,不能把“没收到最终 chat”理解为“消息完全没落库”。既有 Narrative 历史需要兼容读取,不能假设旧消息都已经变成新字段格式。

**下一句怎么用:**后续请求准备历史时,通过兼容投影读到实际选中的文字与图片关联,后续交付沿消息和段落继续定位。它改变消息协议和保存投影,没有由此增加“世界事实自动结算”或“新人物自动建卡”的机制。

**与 main 的已知关系及边界:**这是有固定源码的图文消息候选。所附 staging 记录验证过部分原生继续和重生成交付,但原生单图重试当时没有进入 Fusion;最终那次运行也没有重验 chat 和 edit-regenerate。不能把测试覆盖等同全操作真实验收。它与 Pioneer 的业务内容相近,本卡不据此画出未经 Git 图验证的祖先关系。

Fusion 固定源码和原记录里的验收缺口
  • 格式变更范围、实现文件及 staging 操作记录[28]。
  • 文字流与最终消息入口[29]。
  • 增量正文先保存再推送[30]、最终保存与交付[31]。
  • 原生消息读写与私有元数据[32]。
  • 图片保存和事件交付[33]。

generate_image_list_v2 等是消息存储字段;chatImageGeneratedV2/chatImageGenerateErrorV2 是图片交付事件。它们不是再多出来的几位模型,也不是给模型任意操作消息的授权。

codex/actor-tool-hooks(#78):早期把 Actor、配图和 DIO 接成可调用工具

**原记录:#78 仍 Open,固定旧头 7c368ec。**这是需要保留历史状态的一条:主要能力已经经另一个 PR #108 进入 main 并继续变化,不能把“旧 PR 没关”解释成这套功能还没进主干。

**它在做什么:**让前台控制模型决定何时调用正文生成、何时安排图片、何时请求长期修改,以及何时结束,而不是所有请求永远只有一次固定的正文生成调用。

**拿什么进来:**原有角色、历史、输入和已授权工具。例:“继续守卫查验钥匙的情节,并配一张图。”另一个独立意图例子是“以后把守卫长期改成克制、讲规则的性格”,这对应 DIO 长期修改的业务用途;当前 main 的工具说明进一步限制到用户主动提出长期变化,不能反过来声称旧头已经有完全相同的语义约束。

**旧分支的一轮怎样运行:**控制模型选 actor,程序调用原有 RP 生成器,取得正文片段;需要插图时选 generate_image,程序安排后台绘图,拿回已安排的结果,不等待图片完成;需要长期修改时选 schedule_dio,向外部 DIO 请求接单;最后通过 over 结束。旧版 actor 要求传 maxTokens 分配额度,不能拿这个旧示例直接调用当前 main。

**回复和持久产物:**Actor 片段构成用户正文,沿原有后处理和聊天交付保存。图片经 Imagine 和外部 Image Agent 回写对应消息。DIO 先返回任务回执;真正长期 prompt 由独立 DIO 服务处理,接单不等于改写已经生效,也不是修改当前已生成正文。

**下一句怎么用:**下一轮读取聊天业务带回的历史;如果 DIO 已生成有效的 active prompt,Harness 的对应路径会读回并用于后续准备。图片任务按消息槽位回填。这个分支本身没有“所有工具结果都统一写入一份万能记忆”的机制。

**与 main 的已知关系及边界:**已核对的 Actor/Imagine/DIO/图片接口主要能力已在 main。当前 main 的 actor 参数改为 responseMode,加入符合条件的视觉片段自动排图,图片 MCP 菜单也继续扩展。因此应读成旧实现与合入沿革,而不是待接入新工具包;外部服务和实际场景是否启用仍要另核。

#78 的固定旧代码与 main 对照

旧头文件与行号保留自 9 月 17 日 #78 专项源码审计,本次没有该旧头的本地完整归档可再次逐行校验;当前 main 对照已重读。本次不声称旧分支每一行都已等价移入 main。DIO 的“长期修改”用途包含模型工具说明约束,不能额外宣称执行器已经实现完整的语义权限判断。

Harness:SDK、快慢运行器、Workflow 与工具包|现状、工具与分支

Harness:怎样把模型、工具和业务流程组织起来执行

Harness 主干的整体情况:已有通用执行 SDK、可复用工具包,以及观测和调试入口。接入开发者用这些组件组织模型与工具;业务提供提示词、可用工具、上下文和存储依赖。

名称与执行方式(谁决定步骤) 代码位置(主干/开发分支) main 已形成的能力 相关分支的工作 目前到哪一步
SDK Agent(通用模型工具循环)
模型选择下一步。根据工具返回结果继续选择工具或结束。
已在主干
roleplay-harness / main
通用 SDK 的 Agent 封装。
业务提供模型、提示词和工具,SDK 执行工具循环并交回结果;业务负责解释结果及保存。SDK 与 Workflow 接法 feat/kas-sdk-runtime 等历史分支对应 SDK 建设;当前能力以本行主干说明为准 主干已有。SDK 0.6.0 已发布;新增独立世界书客户端。Pi 慢执行器自 0.5.0 发布,安装版本与应用源码分别查看
SlowTurnRuntime(可独立执行的分析工具循环)
模型选工具,程序管限制。可单独等待分析结果。
已在主干
roleplay-harness / main
SDK 独立慢路。
在业务提供的菜单内调用工具、读取结果,受步骤与预算限制;可按调用方规则提交状态。新增 options.gate 可在调用前决定跳过慢路,查看实际返回 codex/slow-runtime 对应独立慢路的历史开发记录 主干已有;gate 已合入 fa41d220,SDK 0.3.0 不含此增量。普通 V2 尚未使用该 gate,需宿主主动注入
FastSlowRuntime(快慢通道组合器)
程序安排两路并行。快路与慢路内部可以采用不同执行方式。
已在主干
roleplay-harness / main
SDK 快慢协作运行时。
读取状态后安排快路回复与慢路分析。默认快路调用一次模型,也能接入业务自己实现的快流程 属于通用 SDK 主干能力;开发沿革见 feat/kas-sdk-runtime 等记录 主干已有。可以接已有 Workflow;组合器本身不等于通用 Workflow 引擎
固定 profile Workflow(配置节点的工作流执行机制)
程序按节点与依赖执行。节点调用什么能力由接入方预先配置。
已在主干
roleplay-harness / main
应用内固定 profile 执行代码。
profile 声明节点、依赖和结果注入位置,StaticPlanner/CapabilityExecutor 按图执行;Story、Sumi 的专用流程另写在各自应用代码里 本行列主干现有基础机制;与上面 SDK 模型工具循环是不同接法 仓内已有。普通 RP 当前使用空执行图;V2/Story/Sumi 的业务顺序由各自应用代码安排。内部 profile 类型未作为 npm 根入口公开 API
Core Tools(可复用工具包与接口适配器)
调用者安排执行。可由程序直接调用,或适配后供 Agent 模型选择。工具本身各有模型或程序实现。
已在主干
roleplay-harness / main
公共工具包与 Agent 接口适配代码。
封装咨询、JSON 记忆读写和 Story 世界/叙事等工具。程序可直接调用,接入方也可通过适配器挂到 Agent 菜单。工具目录与实际菜单 feat/kas-core-tools、codex/core-tools-pi-adapter、codex/json-memory-tools 等历史分支对应工具封装、接口适配和记忆读写 主干已有实现。每个业务按自己的依赖和用途装载工具
Compact(历史压缩与检查点保存流程)
Harness 计算本次输入占用,达到配置门槛后让摘要模型整理旧对话。
已在主干
roleplay-harness / main;#295 修复已合入 47fb054
保存摘要与覆盖到哪条消息,供后续读取;可显式启用后台提前压缩。超长角色设定的请求内精简仍需配置,最终完整 Actor 输入必须更短且不超预算。完整过程 #196/#198 过滤、#207 累计计数及后台压缩均已有;#295 允许分别合格的计数来源切换,修复误拒,不默认开启角色精简。 代码已合入,按配置启用。#295 的 CI 与镜像构建成功,未见部署步骤;语义保留、费用、P95 和当前配置另验。精简的输入和边界
Worldbook SDK 客户端(HTTP 调用封装)
业务程序直接调用。
已在主干并发布
roleplay-harness / main,SDK 0.6.0
创建、导入、修订、建索引、关联业务对象、检索和选择原文;业务自己把结果放入模型输入。接法 #287 增加独立 @flowgpt/roleplay-harness/worldbook 入口,#288 对齐 Entity 合同 10/9 发包成功;服务部署、数据库迁移和产品采用分别确认。
观测/调试/发布(工程代码与管理接口)
程序或操作者触发。记录运行、试跑工具、执行构建与发布任务。
已在主干
roleplay-harness / main
观测、工具调试和包发布相关实现。
记录模型与工具执行,提供工具输入试跑入口,并支持包版本与发布。观测规则、调试与工具 codex/agent-tracing、codex/agent-sdk-debug-telemetry 对应执行记录;codex/tool-debug-all-tools 扩展工具调试;release/sdk-0.3.0 对应发布工作 主干已有观测接线和十项工具调试目录。观测需启用;测试部署与生产配置按各自证据记录

Harness 工具与运行能力索引:上下文、记忆和接入分别找哪里

这一组里有工具,也有程序固定调用的流程、存储接口和配置。类型写在名字后;例如 Compact 是程序按预算安排的压缩流程,默认同步,也可显式后台执行,不是六位专家之一。

飞书需求/想得到的结果 实际工具或模块(类型) 当前怎样用、交出什么 对应程度与详情
本轮上下文组装:把适用设定、状态与必要历史交给模型 模板渲染、世界书选择、memory recall、上下文预算处理(程序准备流程) 程序按所选方案取资料、填入模板、检查相应预算,形成此次模型的 messages。Actor、后台、专家分别组装 已有多条接线。“信息不足时主动补查”还要求模型菜单真有查询工具;普通后台目前没有默认的世界书/聊天原文搜索工具。每个模型拿到什么 · 实际工具菜单
记忆状态稳定维护:人物、物品、资源和进度变化延续到下一句 普通持续笔记;Axon Go 记忆表;get_memory/update_memory(JSON 工具) 普通 Director 整理笔记,程序校验并按版本提交;表格路径在回复后解析编辑、按版本保存;JSON 工具从宿主提供的 store 读取或整体替换对象 **三种已有机制,不能当作自动同步的一张总表。**何时保存、冲突处理和下一次模板采用各自不同;JSON 工具不会默认挂到普通 RP。跨轮保存时序 · 表格 · JSON
上下文 compact 优化:长聊天仍能接续目标和未决事项 Compact(预算触发的历史压缩流程) 回复前按容量、旧检查点和历史组决定是否压缩;支持配置化输入协议、结构/文本摘要及递归。同步时摘要+保留原文用于本轮;显式后台模式下本轮用现有输入,任务成功保存后供后续请求读取 **主干已升级,策略在 Scenario。**bounded_recent 与保存超时确认有实际条件;摘要不会自带“丢失原文随时查回”的工具。#196/#198 已合入 main,摘要前 Jev 对话组/助手段落过滤和边界搜索默认关闭;属于应用压缩流程,不是模型菜单工具。模式、恢复与误省略边界。输入与产物 · 配置 · 保存
原文存储与召回:按人物、事件、关键词、回合找出处与前后文 聊天消息存储/历史读取;记忆 recall(现有宿主接口) 聊天业务保存已交付正文,后续请求带回历史;已接的记忆后端返回其材料。现有 Axon Go recall 以用户/会话/来源取摘要或表格,没有传本轮 query 做原文搜索 **原文保存与历史读取已有;需求中的统一检索工具未接成普通 RP 菜单。**不能拿世界书检索代替聊天原文检索。原话与进度 · 实际 recall
记忆效果细化:日记、表格、Compact 各管自己的事 diary-orchestrator(日记流程)、表格更新、Compact 日记在生成后按轮数/冷却/额度等判断是否整理;表格记录字段变化;Compact 管本轮窗口。取出后还要经模板采用,才被模型读到 **现有能力有各自生命周期。**效果优化要分别检查漏记、写入失败、读回和模板采用;不是再增加一个“记忆专家”即可完成。日记 · 完整排查
业务扩展与自助调测:启停、替换或新增能力,加前后处理 SDK Agent、Core Tools、toPiTool(接口适配);工具 hooks;Tool Debug(调试服务) 业务提供 Prompt、工具和依赖,模型循环调用;beforeExecute/afterExecute/显式 afterTurn 可做处理。调试服务选单个工具、输入材料并看返回 **机制已在 main。**10 项调试目录不等于线上 Agent 自动有 10 项工具;需安装版本实际导出并完成业务接线。可复用目录 · 调试 · SDK 示例
控制后台何时跑、怎样选工具(需求落地时的执行策略) SlowTurnRuntime.options.gate(调用前策略点);FastSlowRuntime(快慢组合);Jev(可选决策适配器) SDK 宿主的 gate 返回是否运行慢路;Jev 在启用后负责普通 V2 的工具选择与结构参数,选中工具缺失的必需开放参数另由文本模型补全。二者不是同一个功能 **已进 main,启用状态不同。**gate 未接普通 V2,SDK 0.4.0 及后续已发布;旧 0.3.0 不含;Jev 仓内场景未开启。普通 V2 仍每逻辑轮安排后台。SDK gate · Jev 与慢通道
保存二开成果供团队复用;版本发布、升级与回退 apps/SDK/Core Tools/示例与发布配置(仓库组织及工程流程) 通用能力放包中,业务接线放应用中,示例演示装配;接入方固定包/镜像及配置,验证后升级,失败时回退对应版本 **已有代码、示例和发布记录;不是完整的业务认领/成果审核平台。**主干合入、npm 发包、镜像部署和业务验收分别判断;保留原版及数据兼容条件才谈得上回退。接入责任 · 发布与观测 · 版本记录

这里的 Harness 分类不等于整个 roleplay-harness 仓库。该仓库还放了上面的 Agent 应用和下面的世界书接入代码。整仓 main、集成和包布局分支可能涉及多类,目录会显示多个标签及原因。

Worldbook:导入、绑定、本轮选取与调试|现状、工具与分支

Worldbook:作者准备哪些设定,本轮选哪些、怎样交给模型

Worldbook 主干的整体情况:世界书服务负责导入、保存、索引和本轮条目选择;Harness 的接入代码负责绑定书籍并把条目放进模型输入;管理员另有匹配调试接口。服务现在还会累计请求、绑定、选择和索引指标,供监控系统读取;这些记录用于排查,不会自动进入下一轮剧情或改写书籍。两仓配合完成从资料到聊天的这条链。

名称与执行方式(谁决定步骤) 代码位置(主干/开发分支) main 已形成的能力 相关分支的工作 目前到哪一步
世界书资料服务(独立检索与资料管理服务)
调用方提交本轮查询,服务筛选条目并返回原文。
已在主干
worldbook-service / main,ad38dce;10/12–10/13 无新代码
导入、规范化、保存版本、建立索引;按输入和条件选条目,返回原文及理由。Entity 关联兼容旧 Prompt 接口;指标不参与条目选择。数据与导入、本轮选择 #15 滚动部署策略、#19 urllib3 升级仍开放;具体历史分支见目录。 已核到 10/09 ad38dce production 部署成功。这是本次补查的旧部署事实。007 数据迁移、Axon 兼容、当前指标采集和业务效果仍未独立确认。部署边界
世界书聊天接入(程序适配代码与位置协议)
聊天程序在回复前调用。绑定书、取条目、按模板位置装入模型输入。
两仓主干都有代码
聊天装配:roleplay-harness / main
选取与位置协议:worldbook-service / main
接入程序每轮核对会话,按 Prompt 解析书籍到具体版本,再向服务取条目;聊天端声明模板可放位置,将返回原文装入模型输入。原文怎样进入模型 两仓的 boyn/worldbook-placement:服务 #8 负责位置保留与协商,Harness #168 负责装配;Harness 的 boyn/worldbook-integration 对应聊天接入;后续 #188/服务 #12 改为逐轮解析;#288/服务 #20 再统一 Entity 调用并保留旧 Prompt 服务接口 两仓主干已有对应实现。业务仍须配置书籍绑定、服务与模板位置
世界书匹配调试(管理员 API)
管理员发请求触发。服务返回测试输入对应的条目及理由。
已在主干
worldbook-service / main
管理员提交测试输入,查看所选条目及选取原因,帮助调整书中规则。管理范围 服务 boyn/worldbook-admin-match-debug/#7 增加管理员匹配调试能力 服务主干已有实现。调用需相应管理权限
Entity 世界书关联(业务对象关联 API+Demo 读取)
管理接入修改、聊天程序逐轮读取。决定角色、故事或作品编号使用哪些书与版本;现有 RP 仍以 promptId 作为对象编号。
两仓主干已有
Harness #288;Worldbook #20
定向核验 82e0169/ad38dce
保存业务对象与书籍的关联;每轮 conversation.check 后 bindings.resolve,固定版本或跟随 latest,清空绑定可无书聊天;同轮重试复用已选结果。关联接口与Demo读取 boyn/worldbook-demo-associations/#172 为早期提案记录;现行实现按后续 #188/服务 #12 核验,不能仍把整个能力列为候选。 代码已进主干。既有会话下一轮也读取新关联;生产新表迁移、实际 RPC 与业务验收未由主干代码证明。

Worldbook 工具与接口索引:从设定文件,到本轮实际使用

飞书写的“世界书构建与召回”在实现中横跨两个仓库:服务保存并选择原文,Harness 负责每轮找书和组装输入。下面的接口通常由业务程序调用,不是普通后台模型自由选择的工具。

飞书需求/想得到的结果 实际工具或模块(类型) 当前怎样用、交出什么 对应程度与详情
世界书数据设计和业务接入格式:运营准备资料,业务知道传什么 导入预览、书籍创建/修订、条目读取、索引 API(Worldbook 服务接口) 运营将设定转换成支持的 JSON/角色卡数据,预览问题后保存书籍及不可变 revision,按所用检索方式建立索引。输出 book ID、revision、条目及索引状态 **已有数据结构和导入接口。**来源元数据、原卡关系与本局变化不能靠一个标题替代;具体必填项、规范化和示例见正文。重开对话不会自动恢复被运营改掉的 Prompt 绑定。准备数据 · 原始规则与本局变化
绑定角色并决定哪一版生效:换规则后哪一轮看到 Entity 世界书关联 API(兼容旧 Prompt 路由);worldbook.conversation.check+worldbook.bindings.resolve(每轮准备接口) 可信管理接入保存资料分组+业务对象对应的书籍/版本;现有 RP 对象编号仍来自 promptId(当前 Demo 只读关联,不提供保存按钮);本轮先核会话,再 resolve 成具体 revision。固定 revision 保持该版,latest 下轮跟随新 head;同轮重试复用已选结果 **两仓 main 已更新。**与旧会话 pin 机制不同:改 Prompt 关联可影响旧会话下一轮,清空关联则无书继续聊天。生产迁移和真实 RPC 接通另需验证。绑定与版本 · 谁控制、生效时间
世界书规则召回与上下文管理:找有效条目、排序、去重、预算、模板变量 worldbook.select(服务选择)+Harness placement/模板组装(程序流程) query、历史、条件 state、具体书版本与预算 → 入选原文 blocks 和选取/舍弃记录;程序按位置放入当前 Actor 的输入 **已有选择与注入链路。**资格、常驻/动态、优先级及预算共同生效;state 要调用方提供。没有自动把同批原文送给后台或允许后台任意补查。条目怎样选 · 模型实际收到什么
世界书效果细化:复杂查询、冲突、大卡更稳定 规则/关键词/hybrid 检索、索引状态、匹配调试、选择 trace(服务能力及诊断接口) 管理者提交真实输入,查看命中、舍弃和预算原因;检查向量索引是否 ready,按结果调整数据与策略 **有诊断与检索基础,效果仍需真实大卡验收。**服务 ready 不等于索引完成;hybrid 降级不等于语义召回已生效;未内置所有来源之间的语义裁决。匹配规则 · 调试与验收
世界书规则更新与生效:时间、地点和剧情后果改变后,后续规则随之变化 世界书修订/Prompt 绑定/选择条件;另有普通持续状态和 Story 快照 服务能保存新版本、按条件筛选,绑定能使新版本在下一轮被读取;普通 RP 或 Story 各自保存剧情进展 基础环节已有,业务闭环仍未自动接通。“正文确认的变化→改世界书条目→处理与原始规则冲突→下一轮统一采用”没有成为默认流程;不能把下一轮重新 resolve 当作自动写回剧情。冲突与写回边界 · 状态来源

分类不改变核查结论。上面的相关分支用于定位该方向;具体差异核到哪一步,仍以完整目录的逐条记录为准。仅有名称的分支暂按主题归类,不因此升级成“源码已验证”。

分支目录的记录时间与核查范围

这份目录覆盖到哪里

完整列表快照来自 2026-09-17 下午:Harness 14:25–14:27 的五页共 99 条;Worldbook 14:23 共 8 条。随后记录里可确认的分支另外补录,各自保留时间。9/21 补录 codex/compact-jev-history-filter,9/22 更新其 #196 状态为已合入 main;现共 113 条已记录分支,不表示今天远端只有这些。

这不是今天的实时全量扫描,也不是每条分支都已完成源码审阅。Harness 当晚 21:15 的页面已经显示 109 条,但未留下该时刻完整分支表;当前远端读取受限,尚不能补齐并确认最新全集。已保存的完整快照、后来确认的名字、已读实现和待核内容在下表分开显示。读者可以看到缺口,不需要把“有名字”误当“已读透”。

PR 的 Merged/Open/Draft/Closed 是记录时的状态。Merged 不单独证明合进 main;Open 也不单独证明能力不在 main。是否已进入本 Wiki 主干基线,需要合并目标、提交记录或对应实现证据;部署和线上启用还需各自验证。

完整分支目录:按名称、业务或状态查找

两个仓库的全部已记录分支:逐条查业务与证据

“主线对应源码已读”表示核实了主干里同主题的实现,没有自动证明该历史分支的全部差异。“仅名称/仅列表”的条目保留在目录中,具体行为待核;不会为了填满表格而编造。

分类按业务作用,不按仓库名字。一条分支可以有多个标签;筛选显示所有带该标签的记录,原始分支不重复计数。只凭名称暂归类的原因可在该行“依据与范围”中查看。

roleplay-harness:99 条快照+6 条后续补录

真实 Git 分支做什么、对应什么业务变化PR 记录核查程度
Harness Agent Worldbook
main9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
主线
主干包含普通 Agentic V2、Story、Sumi 及工具/SDK/世界书接线等具体实现;这些是同一分支里的路径,不应伪造成独立 Git 分支。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
主线
源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

后续已读主线源码基线(与上述列表时点分开):3b99f4c。

22 条非 Merged 的统计来自较早 13c481b 时点;3b99f4c 为后续主干基线,不将旧 ahead/behind 重算或移用为新时点差异。

分类依据:整仓主线同时包含 RP/Story/Sumi、SDK/工具和世界书接线;放在 Harness 目录用于容纳跨层代码,不代表它仅属于基础框架。

Worldbook Harness Agent
boyn/worldbook-placement9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
功能
让本轮选中的世界书条目进入指定的角色、范例、作者注、对话深度或命名位置;保留消息边界,并在 Demo 显示最终落位。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#168
历史 PR 内容已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据该PR已留存正文;状态仍采用9月17日历史分支页,本轮没有刷新远端。

分类依据:业务目标是让世界书条目落到本轮模型输入的指定位置;SDK 组装器是实现载体,Actor 是使用方。

packages/sdk/src/context-placement.ts

apps/emochi/worldbook/runtime.ts

历史列表 ahead / behind:0 / 1;这是提交图计数,不是新增功能数。

Harness Agent
codex/tool-debug-all-tools9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
功能
把调试目录里原先仅部分可运行的工具扩到全部10项:六专家、导演候选、两记忆工具和独立生图;保存预览后可重载重跑。记忆和导演状态隔离,生图可真实计费。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#169
历史 PR 内容已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据该PR已留存正文;状态仍采用9月17日历史分支页,本轮没有刷新远端。

分类依据:独立调试目录使共用工具可准备输入、执行和重跑;虽涵盖六专家及导演等 RP 工具,主体是通用工具试运行能力。

apps/emochi/tool-debug/worker.ts

apps/emochi/tool-debug/host-tools.ts

历史列表 ahead / behind:0 / 5;这是提交图计数,不是新增功能数。

Harness
codex/tool-debug-staging-config9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
部署
让独立 staging 工具调试服务使用已经验证的模型 Router,修正“配置来源环境等于模型路由环境”的错误;保留原模型默认值和业务流量绑定。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#167
历史 PR 内容已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据该PR已留存正文;状态仍采用9月17日历史分支页,本轮没有刷新远端。

分类依据:修正独立工具调试服务的模型路由与 staging 配置,服务对象是工具调试设施,不是某个玩家 Agent 的运行流程。

历史列表 ahead / behind:3 / 7;这是提交图计数,不是新增功能数。

Agent
codex/pioneer-actor-progress9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
功能
图文生成与交付增强,并让后台状态按可见消息及内容锚点归属到回复分支。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):61039e5。

根任务已深审,关联 fusion/pioneer 主线

分类依据:增强具体图文 Agent 的回复交付,并按可见消息和内容锚点维护后台状态归属。

历史列表 ahead / behind:45 / 56;这是提交图计数,不是新增功能数。

Harness Agent
codex/tool-debug-playground9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
功能
主干现有独立工具调试入口:查看目录、准备输入、执行与取消;可脱离玩家会话试工具配置。该历史分支最初开放哪些工具,不能由今日10项倒推。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#166
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:提供脱离玩家会话的共用工具目录、输入准备、执行和取消入口。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/tool-debug/server.ts

apps/emochi/tool-debug/catalog.ts

历史列表 ahead / behind:3 / 8;这是提交图计数,不是新增功能数。

Agent
perf/sumi-parallel-image-delivery9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
功能
同一 Sumi 回复最多4张图并行生成,仍按正文图序逐张保存和通知,第一张无需等待整批完成。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#162
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:调整 Sumi 单次回复中多张图片的并行生成与按序交付。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/sumi/images.ts

历史列表 ahead / behind:0 / 9;这是提交图计数,不是新增功能数。

Harness
release/sdk-0.3.09/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
部署
SDK 0.3.0 对应变更包括可区分业务请求与运行实例的观测身份、Debug schema,以及显式包装原生 Pi 模型/工具调用;发布状态另以发布记录判断。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#164
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:SDK 版本发布及通用观测、Debug schema、Pi 调用包装,属于可供应用复用的运行组件。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/sdk/CHANGELOG.md

packages/sdk/src/telemetry.ts

历史列表 ahead / behind:0 / 15;这是提交图计数,不是新增功能数。

Harness
codex/sdk-topics9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
文档
增加 SDK 跨组件技术专题文档;已查 PR 范围没有运行时代码、新工具或部署修改。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Open
#159
定向已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

本次打开 PR;40 个 docs Markdown,12 篇跨组件技术专题,无运行时代码、新工具、发布或部署

分类依据:SDK 跨组件技术文档,不是独立 Agent 产品流程。

历史列表 ahead / behind:5 / 19;这是提交图计数,不是新增功能数。

Harness
perf/publish-ci-gate9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
部署
发布工作流要求当前精确 main 提交已有成功 CI,再执行包关联校验和发布,减少未经该提交验证就对外发包的情况。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#165
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:通用包发布前的精确提交 CI 门禁,属于发布基础设施。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

.github/workflows/publish-packages.yml

历史列表 ahead / behind:0 / 18;这是提交图计数,不是新增功能数。

Agent
codex/fusion-sumi-message-format9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
功能
将融合图文交付接到 chatStream/chat 及原生段落图片字段,保留独立图片任务和私有状态。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):44ffcf1。

根任务已深审 fusion 家族

分类依据:融合图文 Agent 的聊天协议、段落图片交付和私有状态接线。

历史列表 ahead / behind:47 / 21;这是提交图计数,不是新增功能数。

Agent
fix/actor-usage9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
修复
名称指向 Actor 用量统计修复,具体差异未核;不能据名称认定哪一种 token 或费用计算已修正。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#163
仅名称
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向具体 Actor 回复阶段的用量统计修复。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 20;这是提交图计数,不是新增功能数。

Harness Agent
codex/agent-tracing9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
功能
接入方可显式包装原生 Pi Agent,记录真实模型请求和工具执行,包括后续轮次替换的工具;观测不替业务接受或保存结果。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#160
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:显式包装原生 Pi Agent 的模型与工具调用观测;提供通用观察接口,由各 Agent 应用接入。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/sdk/src/telemetry.ts

历史列表 ahead / behind:0 / 22;这是提交图计数,不是新增功能数。

Harness Agent
codex/agent-sdk-debug-telemetry9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
功能
为应用运行与步骤记录增加明确的 scenario、业务请求和 run 身份,帮助区分当前正文与独立后台工作;仅在配置开启观测后采集。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#161
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:SDK 运行及步骤身份观测,同时含 RP 应用的接入适配;以共用观测能力为主归类。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/sdk/CHANGELOG.md

packages/sdk/src/telemetry.ts

apps/emochi/telemetry.ts

历史列表 ahead / behind:3 / 26;这是提交图计数,不是新增功能数。

Agent
codex/fusion-existing-production9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
集成
现有正式产品融合接入主题;筛查记录称相关实现已深审,但没有留下此分支独立固定头,不能套用其他 Fusion 头的所有行为。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
仅列表
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

保守标为仅列表:当前依据没有该分支的可独立复核 SHA/差异;不能用同族源码已读替代。

分类依据:名称及已留存说明指向已有正式产品的融合图文接入,具体业务 Agent 为主要对象。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:42 / 56;这是提交图计数,不是新增功能数。

Harness Agent Worldbook
staging9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
集成
集成和部署分支;列表记录 194 ahead 不能解释成 194 项业务能力,也不能证明其全部内容已进 main。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
仅列表
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

集成/部署分支,不能把 194 提交当成 194 个功能

分类依据:整仓集成和部署分支,可能承载多个应用与基础组件;以 Harness 作跨层目录位置,不按提交数伪造业务能力。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:194 / 56;这是提交图计数,不是新增功能数。

Agent Harness
codex/main-staging-unification9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
集成
PR #147 的 AOI state/image 与 Agentic V2 集成;记录目标为 codex/aoi-fusion-integration,不是 main。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Draft
#147
定向已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):28989d9。

原记录目标:codex/aoi-fusion-integration。

SHA 为 PR #147 在既有巡检中固定的 head;未重新查询该名字当前指向。

分类依据:已留存定向审阅范围是 AOI state/image 与 Agentic V2 的集成,归具体 Agent 交付;名称虽叫主干统一,不按名字扩大成整仓统一已完成。

历史列表 ahead / behind:40 / 56;这是提交图计数,不是新增功能数。

Worldbook
boyn/worldbook-deploy-preflight9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
部署
名称指向世界书部署前检查,具体差异未核;不能据此声称当前环境已发布或全部依赖可用。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#153
仅名称
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向世界书接入的部署前检查,服务于世界书业务能力落地。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:3 / 32;这是提交图计数,不是新增功能数。

Worldbook
boyn/worldbook-safe-trace-labels9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
修复
修复世界书 Demo 恢复缓存诊断时,__proto__ 等继承属性名被误当标签而导致 React 渲染崩溃;未知标签按原文展示,保留旧记录。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#155
历史 PR 内容已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据该PR已留存正文;状态仍采用9月17日历史分支页,本轮没有刷新远端。

分类依据:修复世界书 Demo 的诊断记录标签渲染,属于世界书管理与调试体验。

历史列表 ahead / behind:0 / 33;这是提交图计数,不是新增功能数。

Worldbook Agent
boyn/worldbook-turn-traces9/17 14:25–14:27 完整列表
记录:09/17 14:25:02 北京时间
功能
主干会记录本轮选择的世界书条目和最终消息位置,便于判断资料是否真的进入 Actor;记录发生在最终装配与预算处理之后。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#154
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:25:02(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:跟踪本轮世界书选条及最终落入 Actor 的位置,业务目标是确认世界书资料是否实际被使用。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/worldbook/runtime.ts

历史列表 ahead / behind:1 / 35;这是提交图计数,不是新增功能数。

Worldbook
boyn/worldbook-mingding-demo9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
功能
名称指向名为 mingding 的世界书 Demo,具体差异未核;不能仅凭名称补造其角色、运营能力或部署状态。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#152
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向世界书 Demo;没有根据 Demo 名称推定具体角色或运营流程。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 36;这是提交图计数,不是新增功能数。

Worldbook Agent
boyn/worldbook-integration9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
功能
把会话绑定的世界书接到 RP:按本句、公开场景、近期历史和条件选择条目,再把原文放进 Actor;不会自动把同批原文送给普通后台。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#138
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:将会话世界书绑定、选条和原文注入接到 RP 回复;按世界书业务归类,Agent 是消费方。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/worldbook/runtime.ts

adapters/agent-router/dispatch.ts

历史列表 ahead / behind:0 / 37;这是提交图计数,不是新增功能数。

Harness
codex/release-0.2.19/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
部署
名称指向0.2.1版本发布,具体差异未核;当前 changelog 中同版本的 SDK/工具包内容不能替代该分支发布记录。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#151
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向通用版本发布,未见足以归属单一 Agent 应用的证据。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 50;这是提交图计数,不是新增功能数。

Harness
codex/sdk-docs9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
文档
名称指向 SDK 文档整理,具体差异未核;不能将文档增补当作同名运行能力的新开发。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#150
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向可复用 SDK 的文档整理。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 53;这是提交图计数,不是新增功能数。

Harness Agent
codex/slow-runtime9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
功能
提供可被业务完整等待的独立 Slow 执行:自带模型/工具循环和可选 CAS 提交,便于放入持久 Workflow 步骤;不强制同启当前回复。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#149
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:提供可独立等待、可放入持久 Workflow 的慢路执行与可选 CAS 提交;具体业务由调用方装配。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/sdk/src/slow-runtime.ts

packages/sdk/CHANGELOG.md

历史列表 ahead / behind:0 / 57;这是提交图计数,不是新增功能数。

Agent
boyn/sumi-paragraph-alignment9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
修复
Sumi 在付费生图前向业务服务解析真实段落锚点,并校验锚点属于保存正文,再持久化供图片回填使用,减少图片挂错段落。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#148
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:让 Sumi 图片对应真实保存正文的段落,解决具体图文回复落位问题。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/sumi/image-anchors.ts

apps/sumi/images.ts

历史列表 ahead / behind:0 / 59;这是提交图计数,不是新增功能数。

Agent Harness
codex/aoi-tool-staging-release9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
集成
AOI domain/image asset 的 staging 集成与发布,记录涉及钱包结算及明确图片拒绝后的退款边界。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
定向已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):a106e8b。

本次打开树与提交信息;AOI domain + image asset 调用及钱包结算/拒绝退款,交根任务按 fusion 家族核对,不另算一套 NPC 工具

分类依据:已留存范围是 AOI domain/image asset 的应用集成、钱包结算及拒绝退款;属于 AOI/Fusion Agent 的专用发布边界。

历史列表 ahead / behind:154 / 60;这是提交图计数,不是新增功能数。

Agent
codex/aoi-fusion-integration9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
集成
AOI 融合集成分支;该次分支表为 0 ahead,不能据此列成一项还待合并的新能力。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
仅列表
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

0 ahead,不能列为尚未合并的新能力

分类依据:名称及列表说明指向 AOI 与 Fusion 应用接线,不能把 0 ahead 当成新增未合并能力。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 60;这是提交图计数,不是新增功能数。

Harness
codex/sdk-release9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
部署
名称指向 SDK 发布工作,具体差异未核;具体发布版本、包含能力和外部可安装性不能仅从该名称推出。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#146
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 SDK 包发布,不属于某个 Agent 的功能配置。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 61;这是提交图计数,不是新增功能数。

Harness
codex/github-token-only9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
部署
当前发布与 CI 使用 GitHub Actions 的 GITHUB_TOKEN 访问包服务,并显式提供读写权限;该历史分支取消了哪些旧凭证入口未复核。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#145
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:共用 CI 与包发布凭证、权限接线,属于仓库发布设施。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

.github/workflows/publish-packages.yml

.github/workflows/ci.yml

历史列表 ahead / behind:2 / 64;这是提交图计数,不是新增功能数。

Harness
codex/package-linkage9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
部署
发布前先检查包与仓库的关联,减少构建成功但发布到错误归属或不可访问包的风险;未核该历史分支完整改动。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#144
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:发布包与仓库归属校验,是可复用组件的发布保障。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

.github/workflows/publish-packages.yml

历史列表 ahead / behind:3 / 65;这是提交图计数,不是新增功能数。

Harness
fix/package-repository-validation9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
修复
名称指向包与仓库归属的校验修复,具体差异未核;不能据名称指定是哪条校验或权限规则发生变化。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#143
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向包与仓库归属的发布校验修复。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:2 / 66;这是提交图计数,不是新增功能数。

Harness Agent
feat/langfuse9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
功能
通过独立、可选的 Langfuse/OTLP 适配记录运行、模型、工具和状态操作;凭证、采样、正文采集和 flush 仍由接入方控制。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#139
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:可选 Langfuse/OTLP 观测适配由调用方配置,适用于多种运行和工具,不限定具体 RP 产品。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/sdk/src/langfuse.ts

packages/sdk/CHANGELOG.md

历史列表 ahead / behind:4 / 67;这是提交图计数,不是新增功能数。

Harness
codex/release-current9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
部署
名称指向发布当时当前版本,具体差异未核;名称没有提供版本号,不能当成某次已成功发包的证明。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#141
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称只指向某次版本发布,以通用发布暂放 Harness,不能推定具体版本或发包成功。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 68;这是提交图计数,不是新增功能数。

Agent
codex/pov-initializer-recovery9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
修复
Story 对指定的真实 Kaon 临时失败、过滤/协议错误允许进入缺证据处理,保留待结算材料;鉴权、配置、未知错误和外部取消不会统统吞掉。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#137
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:处理 Story 初始化中的指定模型失败与证据缺失,属于事件剧情运行的恢复规则。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/story/model-failure-policy.ts

apps/emochi/story/axon-adapter.ts

packages/tools/CHANGELOG.md

历史列表 ahead / behind:5 / 73;这是提交图计数,不是新增功能数。

Harness Agent
codex/shared-agent-memory9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
功能
共享工具有统一执行生命周期和注入式记忆读写接口,业务可复用这些基础件;会话字段、存储和整轮 afterTurn 时机仍由宿主负责。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#136
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:共用工具生命周期与注入式记忆接口供业务装配;并非某种 Agent 已默认启用的记忆方案。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/tools/src/tool.ts

packages/tools/src/modules/memory/json.ts

packages/tools/CHANGELOG.md

历史列表 ahead / behind:7 / 74;这是提交图计数,不是新增功能数。

Agent Harness
codex/scenario-image9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
部署
应用容器 CI 验证镜像内已包含场景 JSON,且服务能逐项加载,避免只发布代码却缺少实际运行方案。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#135
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:已读对应范围验证 RP 应用镜像含实际场景文件并可加载;它保障应用运行方案交付,不因使用 CI 就归成通用包发布。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

.github/workflows/ci.yml

apps/emochi/scenario-files.ts

历史列表 ahead / behind:1 / 75;这是提交图计数,不是新增功能数。

Agent Harness
codex/pov-story-tools9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
功能
提供世界准备/推进及叙事规划、节拍派发、事件结算、重分支机制;主干 Story 应用先保存待采用正文记录,下一请求核对实际保存正文后采用后果。它不是六咨询专家。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#134
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:业务对象是 Story 的世界推进、剧情规划、节拍、结算与重分支;实现同时含可复用 Story 工具及已接应用,按具体剧情运行归 Agent。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/tools/src/story.ts

packages/tools/src/modules/story/world.ts

packages/tools/src/modules/story/narrative.ts

apps/emochi/story/coordinator.ts

历史列表 ahead / behind:1 / 76;这是提交图计数,不是新增功能数。

Harness
codex/package-release9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
部署/配置
已关闭的包发布主题;现有记录仅分支表,不据此列出独有业务能力。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Closed
#132
仅列表
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

分支表筛查;包发布主题,不作为独立 RP 业务工具

分类依据:历史记录仅显示包发布主题,属于通用发布目录,不推定有独立 RP 能力。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:5 / 77;这是提交图计数,不是新增功能数。

Harness Agent
codex/json-memory-tools9/17 14:25–14:27 完整列表
记录:09/17 14:26:39 北京时间
功能
给业务显式注册 get_memory/update_memory:读取 JSON 和版本,写入整份替换对象,按 expectedRevision 防止旧结果覆盖新值;字段规则和存储作用域由业务提供。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#133
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:39(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:get_memory/update_memory 是业务显式注册的共用 JSON 读写工具,具体字段、存储和使用时机由宿主决定。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/tools/src/memory-tool.ts

adapters/axon/json-memory.ts

历史列表 ahead / behind:1 / 77;这是提交图计数,不是新增功能数。

Agent Harness
codex/scenario-files9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
服务启动时按白名单读取场景文件,并记录来源与配置 hash;旧环境 JSON 可以整条覆盖同名方案,修改文件不代表运行进程热更新。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#131
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:当前对应实现为 RP 应用启动时加载可运行场景及覆盖规则;以具体应用配置归 Agent,同时关联基础装配机制。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/scenario-files.ts

历史列表 ahead / behind:2 / 78;这是提交图计数,不是新增功能数。

Harness Agent
codex/app-package-layout9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
当前仓库把可复用 SDK/工具与应用代码分层:packages/sdk、packages/tools 供复用,apps/emochi 和 apps/sumi 负责具体业务装配;并非安装包即开启应用。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#128
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:整仓应用与共用包的边界调整,横跨 SDK/工具和 RP/Sumi 应用;以 Harness 作结构性跨层目录,不冒充单一业务。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

adapters/agent-router/dispatch.ts

packages/sdk/src/agent.ts

packages/tools/src/tool.ts

历史列表 ahead / behind:0 / 79;这是提交图计数,不是新增功能数。

Harness Agent
codex/atomic-image-mcp9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
名称指向独立图片资产工具与 MCP 接入,具体差异未核;不能把 atomic 一词解读成跨服务生图、计费、保存都具备原子事务。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#126
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向独立图片资产工具与 MCP 接入,暂按可复用工具归类;未证明只服务某个图文 Agent,也未证明跨服务原子事务。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 89;这是提交图计数,不是新增功能数。

Harness Agent
codex/core-tools-pi-adapter9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
将 Core 咨询工具包装成原生 Pi tool,交回工具内容与细节;业务提供可信上下文、模型和提示词,Pi 执行循环。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#125
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:把共用咨询能力包装成原生 Pi 工具,由各业务提供上下文及模型后使用。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/tools/src/pi.ts

历史列表 ahead / behind:0 / 91;这是提交图计数,不是新增功能数。

Agent
codex/vanilla-v3-compact-scenarios9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
部署/配置
已关闭的三个 Vanilla V3 Compact 实验场景部署清单,作者说明已被后续场景文件及 Compact V2 集合替代。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Closed
#130
历史 PR 内容已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

本次读 PR,旧部署 manifest 实验方案,作者明确被 scenario-file 迁移与更新 Compact V2 集合取代

分类依据:历史 Vanilla V3 Compact 场景部署实验,针对具体回复方案,且旧方案已被后续配置替代。

历史列表 ahead / behind:2 / 100;这是提交图计数,不是新增功能数。

Harness Agent
codex/context-compiler9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
把 RP 角色、用户 Persona、近期对话、旧状态和咨询原因编成专家输入;也允许业务提供自定义上下文,避免为非RP业务硬凑角色字段。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#129
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:共享工具包内的上下文编译器,既有 RP 材料整理也允许自定义上下文;按可复用组件归 Harness。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/tools/src/context-compiler.ts

packages/tools/CHANGELOG.md

历史列表 ahead / behind:1 / 100;这是提交图计数,不是新增功能数。

Harness
codex/ci-boundary-handoff9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
部署
名称指向 CI 边界与交接调整,具体差异未核;未把它归成新增玩家能力。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#127
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向仓库 CI 边界与交接约定,未显示某个具体 Agent 的用户流程。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:4 / 101;这是提交图计数,不是新增功能数。

Harness
feat/kas-package-releases9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
部署
当前工作流可单独发布 Core Tools 或 SDK,并区分验证预览与正式发布,保留独立版本和发布验证产物。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#124
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:Core Tools 与 SDK 独立版本、预览和正式包发布,属于通用组件发布体系。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

.github/workflows/publish-packages.yml

packages/sdk/CHANGELOG.md

packages/tools/CHANGELOG.md

历史列表 ahead / behind:0 / 102;这是提交图计数,不是新增功能数。

Harness Agent
feat/kas-sdk-runtime9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
可复用快慢运行:快路可替换成已有 Workflow,慢路使用调用方工具和同轮快照执行,可选版本提交;不自动安装应用工具或外部数据库。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#123
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:提供调用方可替换快路、注册慢路工具的通用 SDK 运行能力,不等同现成 RP Agent 版本。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/sdk/src/runtime.ts

packages/sdk/src/slow-runtime.ts

历史列表 ahead / behind:2 / 111;这是提交图计数,不是新增功能数。

Harness Agent
feat/kas-core-tools9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
抽取可复用的六类咨询能力,业务显式提供模型、提示词和材料;专家返回建议,产品编排和正式状态保存由调用方掌握。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#122
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:六类咨询能力被抽为可复用工具,业务另行提供材料、编排和保存逻辑。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/tools/src/context-compiler.ts

packages/tools/src/pi.ts

packages/tools/CHANGELOG.md

历史列表 ahead / behind:2 / 112;这是提交图计数,不是新增功能数。

Harness
feat/kas-collaboration9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
文档
名称指向 KAS 协作约定,具体差异未核;不能当作新增 Agent 调度或多智能体业务能力。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#121
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 KAS 协作约定,暂放基础框架协作目录,不视为已实现多 Agent 调度。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 113;这是提交图计数,不是新增功能数。

Agent
boyn/sumi-real-images9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
Sumi 可按图片配置调用真实生图,记录生成结果和审核证据,再向对应消息交付;外观参考图占位不等于已生成新图。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#120
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:Sumi 的真实图片生成、审核证据及对应消息交付,属于具体图文 Agent 能力。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/sumi/image-generation.ts

apps/sumi/images.ts

历史列表 ahead / behind:0 / 115;这是提交图计数,不是新增功能数。

Agent
boyn/sumi-existing-conversation9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
把已有普通聊天的可见历史提取为 Sumi 可继续使用的场景状态,保存独立导入检查点和历史指纹;不为旧正文补造图片或镜头事实。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#119
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:把已有聊天导入为 Sumi 可继续使用的场景状态,服务具体图文会话迁移。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/sumi/history.ts

历史列表 ahead / behind:2 / 121;这是提交图计数,不是新增功能数。

Harness Agent
boyn/kaon-image-runtime9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
名称指向 Kaon 图片运行接口接线,具体差异未核;尚不能把它与 Sumi 或前台所有生图入口完全等同。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#117
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 Kaon 图片运行接口,暂按底层可复用图片接线放 Harness;尚未确认它是共用适配器还是某个 Agent 的专用实现。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 125;这是提交图计数,不是新增功能数。

Agent
codex/compact-session-ab-release9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
评测
名称指向按会话比较 Compact 方案的 A/B 发布,具体差异未核;不据此宣布某方案生产效果胜出。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#118
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向会话级 Compact 方案 A/B 发布,属于 RP 长对话策略实验,不能推定实验效果或生产默认。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:3 / 132;这是提交图计数,不是新增功能数。

Agent
codex/compact-v2a-experiment9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
评测
名称指向 Compact V2A 实验,具体差异未核;不把实验名称视作当前生产默认压缩策略。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#116
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 Compact V2A 对话压缩实验,按 RP 上下文处理方案暂归 Agent。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:22 / 133;这是提交图计数,不是新增功能数。

Agent
codex/compact-v1-19/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
修复
Compact 已有受限候选次数、模型调用次数与准备时限等可靠性参数;压缩输出保留事实、互动及未完线索,并按规范校验后才使用。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#114
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:已读对应实现位于 RP 应用 Compact 运行,约束压缩候选、模型调用及准备时间。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/memory/compact-runtime.ts

历史列表 ahead / behind:7 / 134;这是提交图计数,不是新增功能数。

Agent
codex/fix-streaming-response-regex9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
修复
正文正则后处理会影响流式策略:可安全处理时边写边过滤,否则先缓冲或由最终完整内容替换预览,避免直接把未处理原文当最终回复。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#113
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:修正具体 RP Actor 正文流式处理与最终替换策略,直接影响用户收到的回复。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/actor/roleplay-runtime.ts

历史列表 ahead / behind:9 / 135;这是提交图计数,不是新增功能数。

Harness Agent
feat/pi-specialist-tools9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
功能
已关闭且未合并的旧根包 Pi 专家绑定方案;当前 main 已有新包边界的 toPiTool,不能算缺失的六专家工具。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Closed
#115
历史 PR 内容已读
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

本次读 PR、关闭说明,并核 current main 的 Pi 适配器;旧 root-package 实现未合并且被关闭

分类依据:旧的共用专家工具 Pi 适配方案,虽未合并且已被新版包适配替代,分类仍属可复用工具接线。

历史列表 ahead / behind:1 / 135;这是提交图计数,不是新增功能数。

Harness Agent
feat/content-filter-recovery9/17 14:25–14:27 完整列表
记录:09/17 14:26:48 北京时间
修复
名称指向内容过滤后的恢复处理,具体差异未核;主干确有恢复代码,但未确定此历史分支负责的具体错误种类和回退规则。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#112
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:48(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称仅指向内容过滤恢复,缺少足以判断共用模型适配还是 Actor 专用恢复的分支证据;暂放基础执行恢复并关联 Agent,待核边界。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 136;这是提交图计数,不是新增功能数。

Agent Harness
codex/image-wire-contract-fix9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
修复/调整
历史 Image 接线合同修复主题;目前只有列表,未证明相同修复仍未进入 main。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
仅列表
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

分支表筛查;老 Image / staging 家族,交根任务关联审查,未独立断言能力未入 main

分类依据:现有列表说明指向旧 Image/staging 图文接线合同,暂以图文 Agent 的交付集成归类;是否另含通用接口变更未核。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:145 / 177;这是提交图计数,不是新增功能数。

Agent
codex/dio-user-persona-trigger9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
功能
历史 DIO/user Persona 触发相关分支;已看固定头及 staging image 边界发布记录,未独立证明当前新增能力。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
定向已读
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):ee92c3a。

本次打开分支固定头;老 DIO / image 边界发布家族,未将其重复计为新 DIO 工具

分类依据:DIO 与用户 Persona 的触发及图文边界,针对角色对话应用的具体行为。

历史列表 ahead / behind:142 / 177;这是提交图计数,不是新增功能数。

Agent Harness
codex/image-anchor-demo-release9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
部署
名称指向图片锚点 Demo 的发布,具体差异未核;不能从发布分支名称认定图片已在当前用户环境正确落位。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#109
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向图片锚点 Demo 发布,暂以图文回复的图片落位场景归类;未确定其是否仅为共用工具演示。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:3 / 138;这是提交图计数,不是新增功能数。

Agent
codex/agentic-transient-fallback9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
修复
Actor 在满足恢复条件且配置了备选模型时,可对指定临时错误尝试备用配置;已交付的可见文本、取消和不可恢复错误影响是否允许重试。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#111
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:指定临时错误下 Actor 的备选模型恢复及可见正文约束,属于 RP 回复流程。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/actor/roleplay-runtime.ts

历史列表 ahead / behind:4 / 138;这是提交图计数,不是新增功能数。

Agent
codex/remove-production-auto-memory-scenario9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
部署/配置
移除生产 AutoMemory 实验场景配置;是配置清理,不是新增工具。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Open
#110
仅列表
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

分支表筛查;移除生产实验场景主题,不是新增业务工具;PR 详情由根任务处理

分类依据:现有记录指向删除生产 AutoMemory 实验场景配置,属于应用方案清理而非删除通用记忆工具。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 138;这是提交图计数,不是新增功能数。

Agent Harness
codex/dio-imagine-main9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
功能
将当前正文、配图和长期角色修改接成前台动作流程:控制模型可安排 Actor、图片及 DIO;图片补当前消息,DIO 编译后的修改供后续轮使用。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#108
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:将 Actor、图片和长期角色修改接成具体前台动作流程,影响当前图文回复及后续轮角色表现。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/actor/roleplay-runtime.ts

adapters/agent-router/dispatch.ts

历史列表 ahead / behind:2 / 139;这是提交图计数,不是新增功能数。

Agent
codex/dio-prompt-slot-fix9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
修复/调整
历史 DIO prompt slot 修复主题;目前只有列表,不能推断当下主线还缺此修复。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
仅列表
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

分支表筛查;DIO prompt slot 修复家族,未独立断言新增工具

分类依据:名称及列表说明指向 DIO 在角色对话中的提示词插槽修复。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:144 / 141;这是提交图计数,不是新增功能数。

Agent
codex/agentic-v2-dsflash-profile9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
部署
名称指向 Agentic V2 的 DeepSeek Flash 运行配置,具体差异未核;不能据配置分支名声称快慢机制或工具清单另成一种 Agent。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#105
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 Agentic V2 的模型运行配置;是既有 Agent 的配置变体,不另立一种框架。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 142;这是提交图计数,不是新增功能数。

Agent
codex/compact-latency-observability9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
修复/调整
Compact 的选中历史使用和准备阶段耗时观测,已查两提交四文件范围,无新增独立工具注册。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
定向已读
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

本次读 compare 的 2 提交/4 文件范围及可见差异;历史选择窗口与准备耗时观察,没有新增独立 tool 注册文件

分类依据:观察 RP Compact 选中历史及准备耗时,针对具体对话压缩流程。

历史列表 ahead / behind:2 / 149;这是提交图计数,不是新增功能数。

Agent
codex/remove-compact-conversation-dependency9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
修复/调整
Compact 使用已选请求历史、调整会话历史依赖;列表与相邻 compare 有对应提交,未单独固定本分支头。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
未显示 PR
仅列表
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

分支表;对应上一分支 compare 中的 selected-request-history 提交,属于 Compact 历史依赖调整

分类依据:现有列表及相邻差异记录指向 RP Compact 对已选请求历史的使用,按具体上下文准备归类。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 149;这是提交图计数,不是新增功能数。

Agent Harness
codex/actor-tool-hooks9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
功能
早期 Actor/图片/DIO 工具化分支,PR 仍 Open;主要能力已通过 #108 进入 main,旧 PR 状态不等于全部能力待合并。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Open
#78
源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):7c368ec。

独立子任务已深审,不在本次重复

分类依据:Actor/图片/DIO 工具化后用于具体前台 Agent 运行;可复用工具边界为关联层,不把旧 Open PR 误作全部功能未入 main。

历史列表 ahead / behind:50 / 182;这是提交图计数,不是新增功能数。

Agent
codex/add-compact-scenarios-to-deployments9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
部署
名称指向把 Compact 场景加入部署配置,具体差异未核;添加可选场景不代表所有请求自动启用压缩。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#98
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向具体 Compact 对话方案的部署配置,不能视为通用 SDK 发布。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 150;这是提交图计数,不是新增功能数。

Agent
codex/fallback-compact-token-count9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
修复
名称指向 Compact 回退时 token 计数修复,具体差异未核;不能补猜触发条件和数值变化。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#96
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 RP Compact 回退时的 token 计数,按应用上下文压缩归类。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 152;这是提交图计数,不是新增功能数。

Agent
codex/remove-compact-config9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
部署
名称指向移除某项 Compact 配置,具体差异未核;不等于删除整个压缩实现,也不等于当前主干没有 Compact。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#84
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向清理某项对话 Compact 配置,按具体运行方案归类,不据此判定整个压缩能力被删除。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:3 / 154;这是提交图计数,不是新增功能数。

Agent Harness
fix/multi-profile-project-versions9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
修复
主干校验请求项目版本时接受当前版本及显式配置的兼容版本集合,便于多份运行配置协调迁移;该支具体版本组合未复核。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#94
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:已读对应位置为应用服务器及 Agent Router 的请求项目版本兼容,服务多份 RP 运行配置迁移;并非 SDK 包版本发布。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/server.ts

adapters/agent-router/dispatch.ts

历史列表 ahead / behind:0 / 155;这是提交图计数,不是新增功能数。

Agent
fix/main-respect-actor-prompt-manager9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
修复
名称指向 main 中尊重 Actor 指定 PromptManager 的修复,具体差异未核;不能仅按名称确定覆盖优先级变化。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#93
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 Actor 提示词选择修复,作用对象是具体回复模型的输入配置。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:0 / 157;这是提交图计数,不是新增功能数。

Agent Harness
codex/dio-actor-tool-staging9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
部署
名称指向 DIO 与 Actor 工具在 staging 的集成,具体差异未核;历史列表 Merged 不证明其目标为 main,也不证明仍有一套独立的新工具待接。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#88
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 DIO 与 Actor 工具在 staging 的应用集成,按角色对话动作流程归类。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:68 / 177;这是提交图计数,不是新增功能数。

Harness Agent
ci/hinos-staging-image9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
部署/配置
已关闭的 Hinos staging CI 镜像主题;现有记录仅列表。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Closed
#87
仅列表
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

分支表;CI 镜像主题,不列为新增工具

分类依据:仅列表显示 Hinos staging CI 镜像主题,无法确认是否为具体 Agent 专用部署;暂放发布设施目录,若证实专用应用镜像再改归 Agent。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 163;这是提交图计数,不是新增功能数。

Agent
fix/respect-actor-prompt-manager9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
修复
名称指向尊重 Actor PromptManager 选择的修复,具体差异未核;需与 main 对应修复及其合并目标区分。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#86
仅名称
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向具体 Actor 的 PromptManager 选择修复。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:66 / 177;这是提交图计数,不是新增功能数。

Agent
codex/agentic-v2-context-governance9/17 14:25–14:27 完整列表
记录:09/17 14:26:56 北京时间
功能
普通 Agentic 可与 Compact 配合治理上下文:enforce 才让后台使用压缩摘要及保留历史,shadow 主要观察而仍按原历史规划。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#69
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:26:56(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:普通 Agentic V2 与 Compact 的上下文治理接线,决定后台实际使用原始历史还是压缩材料。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/planning/runtime.ts

apps/emochi/server.ts

历史列表 ahead / behind:1 / 164;这是提交图计数,不是新增功能数。

Agent
codex/roleplay-compact-v19/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
功能
长对话在预算触发时可把早期历史压成事实、互动与未完线索摘要,为当前回复保留近期消息和输出空间;不是完整聊天永久记忆。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#68
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:针对 RP 长对话触发历史压缩、保留近期消息与回复空间,是具体应用上下文策略。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/memory/compact-runtime.ts

历史列表 ahead / behind:0 / 165;这是提交图计数,不是新增功能数。

Agent
codex/roleplay-compact-evidence-eval9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
评测
已关闭的 Compact 证据和评估主题;未全文阅读,不推断新增工具。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Closed
#83
仅列表
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

分支表;Compact 证据/评估主题,未全文审,不作为已确认新工具

分类依据:名称及列表说明指向 RP Compact 证据评估,属于该对话策略的评测工作。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:15 / 167;这是提交图计数,不是新增功能数。

Agent
fix/agentic-state-budget-80009/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
修复
普通 Director 状态候选默认及校验上限为8000字符;这是持续状态块的限制,不是模型完整上下文窗口或所有记忆总容量。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#82
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:约束普通 Agentic Director 状态候选长度,针对具体持续状态流程。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/planning/agentic-v2.ts

历史列表 ahead / behind:1 / 178;这是提交图计数,不是新增功能数。

Agent Harness
agent/npc-persona-context9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
修复
专家输入明确区分主角色定义与当前用户 Persona,帮助判断人物身份和视角;Persona 不自动成为 NPC 资料,也不应无证据写成持久事实。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#81
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:业务目标是让 RP 专家正确区分主角色和用户 Persona;实现落在共享 context-compiler,主归角色业务修复并关联 Harness 组件。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/tools/src/context-compiler.ts

历史列表 ahead / behind:0 / 179;这是提交图计数,不是新增功能数。

Agent
agent/keep-latest-ledger9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
修复
状态投影读取最近的有效 ledger 记录并按类型选取有界条目,使后续模型能看到较新的连续性建议;不保证所有历史记录都进入本轮。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#80
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:普通 Agentic 状态投影使用最近有效 ledger,影响后续角色回复可见的连续性资料。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

packages/tools/src/context-compiler.ts

历史列表 ahead / behind:1 / 181;这是提交图计数,不是新增功能数。

Agent
agent/fix-autoreply-global-turn9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
修复
快捷回复按目标 sourceMessageId 查匹配的后台 guidance 并短暂等待,不只取一个会话级最新轮次,减少给旧消息生成建议时错用其他轮状态。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#79
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:按目标消息匹配后台 guidance,避免给旧消息生成快捷回复时使用其他轮状态。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/planning/auto-reply.ts

历史列表 ahead / behind:1 / 182;这是提交图计数,不是新增功能数。

Agent
codex/agentic-debug-progress9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
功能
后台运行可报告规划阶段与调试节点,帮助看到协调/专家/提交的进展;这些观测写入失败不应阻断正文或正式状态保存。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#75
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:报告普通 Agentic 后台的协调、专家与提交阶段,观测对象是具体 RP 状态流程。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/planning/runtime.ts

历史列表 ahead / behind:2 / 185;这是提交图计数,不是新增功能数。

Agent
fix/agentic-short-language-codes9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
修复
语言宏同时识别完整地区代码与基础语言代码,找不到映射时回到 English,减少短语言码被错误当作默认语言。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#74
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:修正 Agentic 语言宏对短语言码的识别,影响应用回复语言输入。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/planning/prompt-template.ts

历史列表 ahead / behind:1 / 185;这是提交图计数,不是新增功能数。

Agent
docs/agentic-actor-prompt-manager-id9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
文档
已关闭的 Actor PromptManager ID 文档主题;现有记录仅列表。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Closed
#71
仅列表
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

分支表;文档主题

分类依据:名称及列表说明指向 Agentic Actor 的 PromptManager ID 文档,说明对象是具体应用配置。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 187;这是提交图计数,不是新增功能数。

Agent
codex/production-pioneer-ingress-topology9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
部署
名称指向生产 Pioneer 入口拓扑调整,具体差异未核;不能据分支名补造路由、集群或当前暴露方式。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#58
仅名称
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 Pioneer Agent 生产入口拓扑,按专用应用部署归类;不推定实际路由和启用状态。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 206;这是提交图计数,不是新增功能数。

Agent
codex/pioneer-ingress-timeout9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
部署
名称指向 Pioneer 入口超时设置,具体差异未核;未确认具体超时数值和对慢请求的实际效果。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#57
仅名称
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 Pioneer Agent 入口超时配置,属于专用应用运行维护。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 207;这是提交图计数,不是新增功能数。

Agent
codex/agentic-parity-remediation9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
修复
名称指向 Agentic 与已有基线行为的对齐整改,具体差异未核;不能将“parity”当作所有线上行为已完全一致的验证结论。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#56
仅名称
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向具体 Agentic 与已有产品基线的行为对齐,不据名称认定全部行为已验证一致。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:17 / 208;这是提交图计数,不是新增功能数。

Agent
fix/agentic-director-repair-cost-telemetry9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
修复/调整
已关闭的 Director 修复及费用观测主题;未全文阅读,不证明其差异尚未进 main。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Closed
#54
仅列表
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

分支表;Director 修复/费用观测主题,未全文审,不作为已确认新工具

分类依据:名称及列表说明指向普通 Agentic Director 修复及其费用观测,归具体后台状态流程。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:3 / 209;这是提交图计数,不是新增功能数。

Agent Harness
codex/go-diary-orchestrator9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
功能
对启用日记来源的完整对话安排后台日记任务,读取日记生成策略与轮次条件,生成并保存记录,再按规则处理合并摘要等后续工作。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#25
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:当前对应实现按启用的会话日记来源生成并保存日记,属于 RP 应用的记忆业务编排;不是通用 Workflow 引擎。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/memory/diary-orchestrator.ts

apps/emochi/memory/axon-memory-runtime.ts

历史列表 ahead / behind:4 / 240;这是提交图计数,不是新增功能数。

Agent Harness
codex/go-memory-workflow-client9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
功能
按启用的来源从 Axon 召回日记摘要及记忆表;完成回复后按接线安排日记和表格写入,不因模块存在就每轮查询所有记忆。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#24
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:当前对应实现为 RP 应用显式召回日记/记忆表并安排写入,按具体记忆接线归类;名字含 Workflow 不代表共用工作流运行时。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

apps/emochi/memory/axon-memory-runtime.ts

历史列表 ahead / behind:1 / 241;这是提交图计数,不是新增功能数。

Agent Harness
agent/consume-closed-loop-context9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
功能
闭环请求携带用户、会话、角色及对话材料后,应用按选中方案装配角色输入、记忆、Actor和所选状态流程;与上游已经准备好消息的直接模型路径分开。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#10
主线对应源码已读
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

用途依据已读main对应实现/既有源码审阅,未核该分支完整diff及合并目标;不是分支独有增量的断言。

分类依据:闭环 RP 请求由应用装配角色、记忆、Actor 及状态流程;路由和输入适配为基础组件关联。 归类依据已留存主线对应实现说明,不替代该分支历史差异核验。

adapters/agent-router/dispatch.ts

历史列表 ahead / behind:1 / 257;这是提交图计数,不是新增功能数。

Harness
agent/update-actions-v79/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
部署
名称指向 GitHub Actions v7 更新,具体差异未核;不对应新增玩家功能。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#2
仅名称
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向通用 GitHub Actions 升级;前缀 agent 不把仓库 CI 变成玩家 Agent 能力。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 265;这是提交图计数,不是新增功能数。

Harness Agent
agent/phase-1-harness9/17 14:25–14:27 完整列表
记录:09/17 14:27:06 北京时间
功能
名称指向 Harness 第一阶段框架,具体差异未核;今日完整快慢、Story和世界书能力不能倒推为这一初始分支已具备。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#1
仅名称
依据与范围

分支/PR 记录时点:09/17 14:27:06(北京时间)。

仅根据精确分支名解释主题;没有声称读过该分支提交或实现。

分类依据:名称指向 Harness 初期框架阶段,以基础组件归类;不倒推其已经包含后来全部业务。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:2 / 266;这是提交图计数,不是新增功能数。

Agent
fix/yuzu-narrative-staging9/17 后续补录
记录:09/17 19:36:01 北京时间
功能
融合图文聊天增加 Yuzu 模型选择及回执隔离;钱包 model_tier 仍为 Aoi。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Open
#170
定向差异已读
依据与范围

分支/PR 记录时点:09/17 19:36:01(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):de0ea87。

原记录目标:codex/fusion-sumi-message-format。

分支名由原始 PR/合并记录恢复;代码阅读范围及部署边界见对应章节。

分类依据:融合图文聊天中的 Yuzu 模型选择、回执隔离与钱包层级边界,属于具体 Agent 运行方案。

Agent
boyn/sumi-image-persistence9/17 后续补录
记录:09/17 19:33:02 北京时间
功能
Sumi 每张图完成后另存图片历史;符合审核条件的成功图再进入图库。聊天显示图片与图库归档分别完成,外部归档接口仍需可用。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#171
主线实现已读
依据与范围

分支/PR 记录时点:09/17 19:33:02(北京时间)。

原记录目标:main。

分支名由原始 PR/合并记录恢复;代码阅读范围及部署边界见对应章节。

分类依据:Sumi 图片历史保存及符合审核条件后的图库归档,属于该图文应用结果持久化。

Worldbook Agent
boyn/worldbook-demo-associations9/17 后续补录
记录:09/17 19:35:31 北京时间
功能
提案:浏览器按用户管理 Prompt 与世界书绑定,同时保留会话固定版本。尚未逐读实现。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Open
#172
仅 PR 描述与清单
依据与范围

分支/PR 记录时点:09/17 19:35:31(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):0c9df14。

原记录目标:main。

分支名由原始 PR/合并记录恢复;代码阅读范围及部署边界见对应章节。

分类依据:已留存提案是用户 Prompt 与世界书的浏览器绑定及会话版本规则;按世界书关联管理归类,尚未逐读实现。 此处按已留存 PR 提案暂归类,不代表实现已核验。

Agent
codex/persist-sumi-telemetry9/17 后续补录
记录:09/17 19:35:40 北京时间
部署
Sumi 测试部署更新镜像时同时保留观测开关并检查配置;不代表生产观测已启用。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Open
#173
工作流差异已读
依据与范围

分支/PR 记录时点:09/17 19:35:40(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):c3bae9b。

原记录目标:main。

分支名由原始 PR/合并记录恢复;代码阅读范围及部署边界见对应章节。

分类依据:Sumi 测试部署保留观测开关的专用发布修复,不能因使用工作流就归成通用 Harness 发布。

Agent
boyn/sumi-image-event-dimensions9/17 后续补录
记录:09/17 21:14:51 北京时间
修复
给客户端发送图片开始生成的信号,并在完成通知里带上本次请求的图片宽高;尺寸来自请求,非重新测量成品像素。复用旧结果不补发开始事件。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#176
主线实现已读
依据与范围

分支/PR 记录时点:09/17 21:14:51(北京时间)。

原记录目标:main。

分支名由原始 PR/合并记录恢复;代码阅读范围及部署边界见对应章节。

分类依据:Sumi 图片开始通知与完成通知尺寸字段,属于客户端图文交付协议。

Harness Agent
codex/compact-jev-history-filter9/22 已完成巡检更新
记录:09/22 08:42:00 北京时间
功能
Compact 摘要前可用 Jev 筛完整对话组;#196 已合入 main,默认 off;#198 另加助手段落过滤与边界搜索。供应商超限回退恢复原输入;语义误省略需验收。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#196
合入主干及当前调用链已读
依据与范围

分支/PR 记录时点:09/22 08:42:00(北京时间)。

已核源码版本(不据此推定列表当时的分支指针):63d27c4。

原记录目标:main。

保留原分支名;合入63d27c40,当前a4f5bb83定向核对。旧2dc1cbe8仅为9/21 Draft版本,不代表当前状态。

分类依据:应用 Compact 的上下文准备与检查点治理;Jev 分类供角色回复前的压缩流程使用,非专家菜单或通用 SDK 新接口。

固定记录/代码依据 1

固定记录/代码依据 2

worldbook-service:8 条完整快照

真实 Git 分支做什么、对应什么业务变化PR 记录核查程度
Worldbook Harness Agent
main9/17 14:23 完整列表
记录:09/17 14:23:00 北京时间
主线
世界书导入、保存、修订、检索、条目选择及上下文块输出的主线,另有可选向量索引和管理接口。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
主线
固定主干代码已审
依据与范围

分支/PR 记录时点:09/17 14:23:00(北京时间)。

后续已读主线源码基线(与上述列表时点分开):9edea52。

14:23 主干为 b0af622;同日 21:15 已核主干前进至 9edea528。晚间 #9/#10 不计入 14:23 的分支清单。

分类依据:整个仓库主线的业务对象就是世界书导入、修订、检索、选条和上下文块输出,因此归 Worldbook;Harness/Agent 是接入方,不把专门服务主线误当跨三类总仓。

Worldbook Harness Agent
boyn/worldbook-placement9/17 14:23 完整列表
记录:09/17 14:23:00 北京时间
上下文装配协议
保留八种条目插入位置,并让宿主声明本轮可用位置/插槽;服务据此筛选并返回可组装进 Prompt 的 blocks。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#8
PR 与相关实现已定向审读
依据与范围

分支/PR 记录时点:09/17 14:23:00(北京时间)。

已于 11:16 合入 b0af622;9edea528 的相关 models/selection/importer 页面仍以 b0af622 为最近修改,主线行为亦已复核。

分类依据:服务保留条目插入位置并按宿主可用插槽筛选、输出 blocks,属于世界书数据和选条合同;宿主负责后续组装。

原有角色前、角色后、at_depth,加上示例前、示例后、作者注释顶部/底部、命名 outlet,共八种。原生条目与导入器保留位置,outlet_name 必须合法。

placement_capabilities 由宿主声明可用位置与 outlet。可选条目无处可放返回 placement_unavailable;通过其余资格检查的 required 条目无处可放则报 required_placement_unavailable。

不传 capabilities 按旧三种位置处理;显式空 positions 表示没有位置。

服务返回 blocks 及位置,宿主负责实际 messages/模板组装;聚合 context 顺序不是最终 Prompt 顺序。选择/导入策略标识为 native-bounded-v2/st-inert-v2。

旧 revision 不自动迁移。重新 preview 原文件、发布完整新 revision,必要时建索引,再显式升级 pin;重复文件上传会去重,不能代替迁移。

固定记录/代码依据 1

固定记录/代码依据 2

固定记录/代码依据 3

固定记录/代码依据 4

固定记录/代码依据 5

固定记录/代码依据 6

历史列表 ahead / behind:2 / 1;这是提交图计数,不是新增功能数。

Worldbook
boyn/worldbook-admin-match-debug9/17 14:23 完整列表
记录:09/17 14:23:00 北京时间
管理调试接口
管理端显式指定租户、书、版本和测试输入,查看本轮会选中哪些条目及其原因。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#7
PR 与相关实现已定向审读
依据与范围

分支/PR 记录时点:09/17 14:23:00(北京时间)。

已于 01:14 合入 f8d05b1,早于清单基线;晚间 9edea528 固定 app.py 也保留此接口。

分类依据:世界书管理端的选条测试与命中原因查看,属于资料管理和诊断能力。

POST /v1/admin/context/select 接收 {tenant_id, selection: SelectRequest},调用已有 service.context(body.tenant_id, body.selection)。

按同一套 rules/hybrid 选择,返回 blocks、context、选择理由、预算及降级信息;普通接口仍使用服务配置的 tenant。

它调试已保存条目,不生成 NPC 小卡、不写世界状态、不建索引、不生成聊天正文;hybrid 仍可能调用 query embedding。

固定记录/代码依据 1

固定记录/代码依据 2

固定记录/代码依据 3

固定记录/代码依据 4

历史列表 ahead / behind:1 / 2;这是提交图计数,不是新增功能数。

Worldbook
boyn/worldbook-cd-image-only9/17 14:23 完整列表
记录:09/17 14:23:00 北京时间
发布流程
发布流程修复:提交标题明确为仅更新 worldbook 镜像;具体工作流步骤未逐行复核。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#6
列表与 main 提交标题已核;该分支实现未全读
依据与范围

分支/PR 记录时点:09/17 14:23:00(北京时间)。

14:23 列表显示 #6 已合并;9/16 main 已是 #6 的 3a11e333。不能据此宣称实际部署已验证。

分类依据:发布工作流专门更新世界书服务镜像,按世界书服务运维归类,不扩大为通用 Harness 发布机制。 归类依据列表及提交标题,不代表完整实现已核验。

历史列表 ahead / behind:1 / 3;这是提交图计数,不是新增功能数。

Worldbook
boyn/worldbook-service-cd9/17 14:23 完整列表
记录:09/17 14:23:00 北京时间
发布流程(按名称归类)
分支名指向 worldbook-service 持续部署。仅确认名称和 #5 已合并,未恢复具体新增工作流/部署步骤。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#5
仅历史分支列表
依据与范围

分支/PR 记录时点:09/17 14:23:00(北京时间)。

14:23 关联 PR #5 为 Merged。未复核该分支完整历史 diff 或当前 head;ahead 不表示仍有待合并功能。

分类依据:名称及历史列表指向世界书专用持续部署,按服务自身运维归类。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 4;这是提交图计数,不是新增功能数。

Worldbook
boyn/worldbook-no-auth9/17 14:23 完整列表
记录:09/17 14:23:00 北京时间
认证接入(按名称归类)
分支名指向服务认证处理。仅确认名称和 #3 已合并,未复原原始 diff,不能将当前所有认证行为都归因于这个 PR。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#3
仅历史分支列表;当前 main 认证边界另有源码审计
依据与范围

分支/PR 记录时点:09/17 14:23:00(北京时间)。

14:23 关联 PR #3 为 Merged。9edea528 本身无请求认证是另行核实的主干事实,不能冒充已经完整审读 #3。

分类依据:名称及历史列表指向世界书服务认证处理,按世界书访问边界归类;当前 main 审计不能替代该分支 diff。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 6;这是提交图计数,不是新增功能数。

Worldbook
boyn/remove-worldbook-traces9/17 14:23 完整列表
记录:09/17 14:23:00 北京时间
观测清理(按名称归类)
分支名指向移除 worldbook traces。仅确认名称和 #2 已合并;未确认具体删除了哪些字段、调用或采集。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#2
仅历史分支列表
依据与范围

分支/PR 记录时点:09/17 14:23:00(北京时间)。

14:23 关联 PR #2 为 Merged。未复核该分支完整历史 diff、当前 head 或生产可观测性配置。

分类依据:名称及历史列表指向世界书 traces 清理,属于世界书服务观测范围,具体删改未核。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:1 / 7;这是提交图计数,不是新增功能数。

Worldbook Harness Agent
boyn/worldbook-integration9/17 14:23 完整列表
记录:09/17 14:23:00 北京时间
集成(按名称归类)
分支名指向世界书集成。仅确认名称和 #1 已合并;主干能力另有审计,但未重建这条分支五个提交的具体边界。相关实现/历史说明(按该章基线,非自动等同旧分支增量)
Merged
#1
仅历史分支列表
依据与范围

分支/PR 记录时点:09/17 14:23:00(北京时间)。

14:23 关联 PR #1 为 Merged。不能把后来主干的所有世界书能力都归为这个 PR,也不据 ahead=5 判断有五项未合并能力。

分类依据:名称及历史列表指向世界书服务集成,按世界书业务目录归类;不能将后来主干全部能力归入这条历史分支。 此处仅依现有名称/列表主题暂归类,不代表已完成该分支代码核验。

历史列表 ahead / behind:5 / 8;这是提交图计数,不是新增功能数。

后续变更还有尚未恢复完整分支名的项目:Harness #177 已进入固定主干,保存 Sumi 图片归档时的正文快照;Worldbook #9/#10 已进入固定主干,分别涉及向量配置与重索引、管理端按租户导入和索引。它们继续保留在原实现章节、世界书章节和唯一变更记录,不猜一个分支名填表。

下载本目录的数据记录。记录包含名字、PR 状态、核查程度、业务说明、已知版本和来源范围;不包含私人会话原文。

继续下探:这些分支中的代码分别由哪个仓库、应用和外部服务负责

Roleplay 现状总览已经把输入、回复、保存和后续使用连成整体。本章进一步说明:这条业务链中的哪些工作由 Harness 完成,哪些来自世界书服务,哪些需要外部业务保存和提供。

两个仓库分别交付什么

项目 已有内容 业务怎样用它
roleplay-harness 通用 Agent 执行组件、可调用工具,以及仓内已经组合好的文字 RP、剧情和图文应用 可以取一个工具、组织自己的 Agent 或 Workflow,也可以采用仓内应用的现成执行流程
worldbook-service 世界书文件导入与规范化、书籍和不可变内容版本、索引、搜索、本轮条目选择 作者先准备和发布设定;聊天接入方指定书籍版本及本轮材料,服务返回应交给模型的条目原文和选取说明

两者合作时,世界书服务负责找出适用资料,Harness 负责把返回内容放到正确的模型输入位置,再执行本轮回复。聊天中发生的新事件,不会因为这轮查询了世界书就自动写回作者的条目。

Axon、聊天服务、模型网关及部分外部记忆/图片服务不属于这两个仓库的全部源码范围。下面会区分“仓库里已有实现”和“仓库只调用外部接口”,不把接口存在当作外部功能已经逐项验证。

Harness 内部有三层,不是一个固定流程

**第一层是通用执行组件。**业务提供输入准备、模型、工具和结果解释方式,可以让模型判断下一步并调用工具;也可以把一次 Agent 调用放入既定 Workflow。SDK 还提供现成的单次文本调用、受约束的分析执行,以及当前输出与后台处理并行的组合。这些是可选用法,没有要求所有业务先走快慢系统。

**第二层是工具。**仓库封装了人物与剧情分析、读取/写入 JSON 记录、世界与叙事操作、图像等能力。工具需要实际注册,并得到相应材料、模型或存储接口,才会被某次执行使用。某个工具内部可以再调用模型;某些操作直接访问存储。工具名不决定它一定在本轮前台还是后台执行。

**第三层是现成应用。**这些应用把输入准备、工具调用、保存及产品结果接到一起。文字 RP 相关实现在 apps/emochi,独立图文实现在 apps/sumi;目录名说明代码位置,不代表用户必须先理解或接入同名产品。

现成运行方式 用户输入之后主要做什么 交付与保存
直接回复 使用准备好的角色和对话材料调用回复模型 当前正文;消息保存由对应聊天接入负责
回复+普通 Agentic 后台 当前回复与后台分析从同轮材料出发;后台按需咨询专家、整理状态 本轮正文;经检查和保存的持续状态供后续读取
前台工具循环 本轮控制模型安排写正文、图片或长期指令等已注册动作,并读取结果决定后续动作 本轮文字/图片任务等;可与普通后台按配置协作
Story 剧情流程 读取已采用的上轮正文,维护世界与叙事进度,再准备本轮可推进的事件 当前正文、待核对正文记录、世界/叙事快照;当前接线替换普通六专家后台
Sumi 图文流程 用历史及已有场景/人物资料生成新正文、更新资料和绘图描述 按消息保存的图文状态及图片交付;有自己的协议和生命周期

世界书、日记、记忆表和历史压缩属于可以接入执行流程的资料能力;它们各有调用条件。**一张能力清单不能被当成一次请求的必经步骤。**哪些组合允许、入口怎样选择,集中在执行方式与组合;本轮每个模型实际拿到的内容集中在上下文组装。

从业务结果追到具体记录

用同一个世界说明不同内容的归属:作者设定“北塔需要城主手令”,用户在聊天中借走铜钥匙,后来又归还。三件事会进入不同的资料流程。

需要保留的内容 属于哪条资料流程 什么时候再次产生作用
“北塔需要城主手令” 作者发布的世界书条目及内容版本 本轮被选中、放进模型请求后,影响这次生成
“用户刚才说已归还钥匙” 已保存的聊天消息 后续请求带回且保留这段原文时,模型能读到
“钥匙已归还,找人约定未完成” 选用的状态/记忆流程:普通 Agentic、Story、Sumi、日记或表格各有自己的产物 对应流程成功保存,并由后续消费者读取;它们不会自动互相同步
“哪些旧对话已经被压成摘要” Compact 压缩记录 通过覆盖与内容检查后,用于后续输入准备
“本轮为什么选了手令规则、没选其他条目” 本次世界书选择结果与诊断记录 用于本轮装配与排查;本次核对的世界书版本没有将它保存成跨轮冷却或持续激活状态

记忆与资料生命周期逐项说明这些记录的输入、产物、保存位置、读取者和失败结果。世界书导入、选择、注入的完整流程在世界书主题组;不会要求读者从一个型号的部署配置推断整个项目的能力。

实现入口与证据

要找的内容 仓库中的位置
通用 Agent、快慢组合、工具目录、任务与观测 roleplay-harness/packages/sdk
可复用工具及其模型/存储接口 roleplay-harness/packages/tools
文字 RP 的角色、回复、后台、记忆、Story 与世界书接线 roleplay-harness/apps/emochi、adapters/agent-router
独立图文状态与图片交付 roleplay-harness/apps/sumi
世界书导入、内容版本、选择规则、索引与选择诊断 worldbook-service/src/worldbook

本 Wiki 按固定源码解释已有行为,候选分支和历史变更单独列出。配置文件是应用的一种使用实例,实际某段会话是否加载并运行它,需要运行配置及结果记录确认。

源码依据:仓库边界与现成执行路径

仓库交付与目录[40];通用执行组件导出[41];普通回复与后台接线[42];世界书应用组合限制[43];世界书选择服务[44]。各数据的完整字段与保存路径见第 9 章各自展开项。

整体闭环的代码证据 · 17 处
  1. 业务请求选择方案 ↗
  2. 资料准备与后台独立输入 ↗
  3. 后台与Actor开始生成 ↗
  4. 专家执行、Director与保存 ↗
  5. 聊天业务保存正文 ↗
  6. 世界书当前选择服务 ↗
  7. 前台动作与条件 ↗
  8. Story分支与普通后台分支 ↗
  9. Story采用与提交 ↗
  10. Sumi运行与消息快照 ↗
  11. 组合限制 ↗
  12. SDK Agent公开执行入口 ↗
  13. SDK源码包版本 ↗
  14. Core Tools公开入口和版本 ↗
  15. 未指定加载项时的应用默认方案 ↗
  16. 启动加载条件 ↗
  17. 世界书默认向量设置 ↗
能力与工具目录的代码证据 · 44 处
  1. 预选 skill 的可复用实现 ↗
  2. 图片使用已有资料的接线 ↗
  3. 六工具的名字与职责 ↗
  4. 岗位提示词装配 ↗
  5. 分工与工具执行 ↗
  6. Director 读取建议并生成笔记 ↗
  7. 普通 Agentic V2 的装配入口 ↗
  8. 读取状态并分别准备材料 ↗
  9. 每个逻辑轮安排后台 ↗
  10. 协调器执行专家并读回结果 ↗
  11. 校验和提交状态 ↗
  12. 状态读取和保存接口 ↗
  13. 工具生命周期定义 ↗
  14. Story 与普通后台二选一装配 ↗
  15. 读取上一条保存正文并准备本轮场景 ↗
  16. 采用正文推进世界及保存 pendingActor ↗
  17. 基础 Actor 回退、重生成和状态接线 ↗
  18. World 实际工具 ↗
  19. Narrative 计划、派发和结算 ↗
  20. 按可见消息、正文及用户锚点选状态 ↗
  21. 等待正文保存、挂接快照及版本提交 ↗
  22. 图文请求入口和交付 ↗
  23. 图片准备 ↗
  24. 实际生成与尝试记录 ↗
  25. 无匹配锚点后的初始状态回退 ↗
  26. 没有提交新状态时挂接旧快照 ↗
  27. main 原有 Pioneer 接口 ↗
  28. 格式变更范围、实现文件及 staging 操作记录 ↗
  29. 文字流与最终消息入口 ↗
  30. 增量正文先保存再推送 ↗
  31. 最终保存与交付 ↗
  32. 原生消息读写与私有元数据 ↗
  33. 图片保存和事件交付 ↗
  34. #78 固定旧头的 Actor 循环 ↗
  35. 旧参数与预算执行 ↗
  36. 旧 DIO 接入 ↗
  37. 旧 Imagine 接入 ↗
  38. main 当前前台工具 schema ↗
  39. 当前 DIO 的后续读取 ↗
  40. 仓库交付与目录 ↗
  41. 通用执行组件导出 ↗
  42. 普通回复与后台接线 ↗
  43. 世界书应用组合限制 ↗
  44. 世界书选择服务 ↗