Skip to content

[PR] fix: Save and export the latest assistant reply in the handover document | fix: 交接文档保存并导出最新一条助手回复 - #4248

Merged
ranxianglei merged 6 commits into
ranxianglei:masterfrom
yanhuojiyusheng:2026-10-21_handoff-latest-reply
Oct 26, 2026
Merged

ranxianglei merged 6 commits into
ranxianglei:masterfrom
yanhuojiyusheng:2026-10-21_handoff-latest-reply

Conversation

@yanhuojiyusheng

@yanhuojiyusheng yanhuojiyusheng commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

Closes #4247.
Fixes #4268.

问题与根因

交接快照只保存本轮入站请求(snapshotMessages())。本轮生成的助手回复要等客户端下一次请求作为历史重发,才进入快照,因此直接导出时缺少最新回复。

此外,最新回复和入站历史都可能同时包含 reasoning 与正文。kernel 的 _reasoning_: 没有结束边界,网页会把同一 assistant 块中的后续正文收进 thinking 折叠框。

方案

  • 插件模式在现有 chat / responses / JSON pipe 的解析、过滤与 flush 点采集已接受的回复;代理模式复用循环 emit 事件和真实工具调用,只在最终成功轮保存。完整 JSON 复用现有 wire codec。
  • 统一采集器 src/server/handoff-response.ts 按到达顺序保存 text / reasoning / tool-call,限制为 1,500,000 bytes,超限整体弃存。
  • 回复仅存入导出用 metadata,绑定请求计数与快照身份,新快照到达即清除;不回灌模型,不参与压缩身份或用量记账。
  • 最新回复以单个 ### assistant 块追加,保持内容到达顺序。
  • 最新回复与历史快照共用 handoffCells():仅在导出副本的 reasoning 末尾加入不可见结束标记,再交给既有 kernel renderer。按结构化 contentType 分段,不依赖网页启发式判断,不修改 kernel、原始快照、消息 ID 或签名。
  • 网页只在尚未关闭的 thinking 段消费结束标记。普通正文和代码示例中的同名标记保留;reasoning 内的字面标记通过成对编码保留,避免提前结束思考。
  • 保留维护者追加的字节预算常量、codec 失败 debug 日志与 storage-render golden 更新。

不采用

  • 不新增独立 SSE 解析器:复用既有生产解析流程,避免协议逻辑重复。
  • 不增加详情页自动刷新:刷新不能补回后端未保存的回复,用户可手动刷新。
  • 不把一次回复拆成两条 assistant 消息,也不把所有 reasoning 移到最前面:保留单次回复和原始顺序。
  • 不修改 kernel:bili 导出入口仍保有结构化 cell 类型,可在导出副本上显式补边界,无需从已扁平化的 Markdown 猜测。

验证

最新补丁基于 d7b60343 完成验证,并提交为 2691e484:

  • web-handoff-roles、handoff-response、cli-export、loop-core:51/51 通过。
  • plugin-protocol 的 handoff 用例:2/2 通过。
  • 覆盖最新回复进入下一轮历史快照后仍正确分段、folded/full 导出组合、原始会话状态不变、字面结束标记保留、单 assistant 块及交错思考/工具调用顺序。
  • npm run typecheck、npm run build、git diff --check 通过;构建的 dist 导入/外部依赖检查通过。
  • 用户已完成本地手动测试,未发现问题。
  • 真实 Codex E2E 本机缺少 codex 二进制,未运行;新 head 的完整回归以远程 CI 为准,尚不宣称全绿。

成本与边界

会话 metadata 可额外持久化最多 1,500,000 bytes 的最新回复,下一次快照清除。客户端转发字节由生产管道开/关采集对比验证;展示边界改动仅影响 bili 交接导出与网页渲染。

历史回复边界现已覆盖,不再保留“历史路径尚未修复”的限制。kernel 自身面向其他消费者的独立导出行为未在本 PR 中修改。

@ranxianglei ranxianglei changed the title fix: 交接文档保存并导出最新一条助手回复 [PR] fix: Save and export the latest assistant reply in the handover document | fix: 交接文档保存并导出最新一条助手回复 Oct 22, 2026
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重: 不重复。 本 PR 直接修 #4247(交接文档缺最后一条助手回复);open/closed 的 issue 与 PR 里无其他触及 handoff/export 采集点的条目(open PR 清单已核对,最近的 #4243/#4238 等均为其他域)。

标签: bug + scope/wiring + p2(缺陷类;两条出站路径都在请求管道上采集;导出功能局部异常、有绕行——再发一条消息即可补上,不到 p1)。客户端跨车道(插件模式 Hermes/pi + 代理模式任意纯客户端),按跨车道不打规则不加客户端标签。

开始审核:分支已取到本地(2026-10-21_handoff-latest-reply,单 commit 0f8bb94c9,12 文件 +621/−9,与 PR 描述一致),正在逐文件读 diff + 跑针对性测试,结论稍后按八问给出。

@ranxianglei ranxianglei added bug Something isn't working p2 scope/wiring labels Oct 22, 2026
@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch from 0f8bb94 to 2a74786 Compare October 22, 2026 02:22
ranxianglei pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 22, 2026
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

审核完成,结论先行:方向正确、修到了根因、回归审查通过,CI 绿后可合(人工合并——跨模块且动了会话持久化格式,不满足自动合并条件)。审核期间发现分支 rebase 过(base 从 release v0.1.204 后移到 #4246 合并之后),已核对:交接相关 12 个文件两个版本逐字节一致,以下结论对当前 head 全部有效。另向 PR 分支补了一个小修 commit(文末)。

八问作答:

  1. 是什么问题:交接文档(Web 详情 / bili export)缺最新一条助手回复——快照只保存"本轮入站请求",回复穿过 bili 不落盘,导出永远滞后一轮;会话结束时最后一条回复永久缺失。
  2. 什么原因导致的:src/session.ts 的 snapshotMessages() 在模型生成之前把入站请求存为 lastMessages;回复字节要等客户端下一轮当历史重发才落盘。根因是出站侧没有采集点,不是页面没刷新——方案因此正确避开了两个坑(另起 SE 解析器、自动刷新,都是治标)。
  3. 影响范围与严重程度:所有"收到回复后直接导出"的场景(Web 详情页、CLI 导出)缺最后一条回复,直到下一次请求;有绕行(再发一条消息),p2。影响面 = 交接/导出面,跨车道:插件模式(Hermes/pi)与代理模式(纯客户端压缩循环)都受影响,两条路径不重叠,只修一边会留另一半的同一 bug——本 PR 两边都修了,我核对了不重叠性。
  4. 怎么修复的:在现有出站解析流程的就地采集点采集后置过滤后的已接受回复,不新增解析器。插件模式在 chat/responses/json 三条 pipe 已有的文本过滤、尾部 flush、工具参数汇合点读取已算好的结果(src/plugin.ts);代理模式记录已转发的 emit 事件与真实工具调用、只在最终成功轮保存(src/loop/core.ts);非流式 JSON 复用 kernel 四个 wire codec(captureHandoffJson)。统一采集器 src/server/handoff-response.ts:有序 text/reasoning/tool-call、每格字节计账、1.5MB 上限超限整体丢弃;存 session.metadata.handoffResponse,绑定请求计数 + 快照指针(新快照到达即清除),不回灌模型、不参与压缩身份与用量记账;导出以现有 ### assistant 角色块追加(不新增 ## 节标题——网页渲染器按角色分块,陌生标题会落入上一条消息正文,测试专门钉住了这点)。
  5. 是否有回归问题:逐项清点,未发现回归。审过的既有行为及结论:
    • 客户端字节:四协议 × 流式/JSON + loop responses/openai + malformed SSE 全做了开/关采集字节对比,一致(采集点全是只读旁路,flush 尾部折叠点也已逐一核实不多计不漏计);
    • 用量计费、压缩身份/快照:不变(handoffResponse 是独立 metadata,snapshotMessages 主逻辑未动,测试断言其不改动 lastMessages);
    • 保存门禁:loop 仅成功轮保存(截断/流错误/中断/failed finishReason → 不存);插件 pipe 要求 terminal 且无 error 且连接正常;side requests(sidePassthrough)按 KDD#9 排除;
    • 代理模式临时工具调用(compress/decompress/acp_status)不记录——与客户端视图一致(KDD#7);
    • 导出输出:无待存回复时输出与原先逐字节相同;
    • 陈旧绑定防护:请求计数不符或新快照已到达即弃存(含存储重载往返测试)。
      有意变更披露(旧→新 + 原因):① 导出内容:无 ### assistant 段 → 有待存回复时追加一段(功能本体);② 会话文件:可携带 ≤1.5MB metadata.handoffResponse 直到下一次快照(持久化代价,issue 已披露;普通回复 ROM 级);③ 每次成功回复多一次 dirty-mark(走既有防抖 persist,无额外 IO 风暴);④ v2 fallback 导出的措辞仅在存在回复时变化。
  6. 是否破坏缓存:否——客户端转发字节逐字节一致,前缀缓存不受影响。
  7. 是否改了设计方向:否——纯增量模块 + 只读采集点,无新协议面。
  8. 是否引入新配置:否。

测试质量:真测试、断言有牙——生产管道开/关采集对比(客户端字节必须一致)× 四协议、多轮接力保留、失败轮不存、非法 metadata 不抛错、真实 WEB_CLIENT 渲染器角色分块回归钉住。本地 typecheck / build / 65 个定向测试(handoff-response、web-handoff-roles、cli-export、loop-core、plugin-protocol)全绿。

已推送到 PR 分支的小修(独立 commit 630b7f9bd,你的原 commit 原样保留,未 rebase/替换):

  • 1_500_000 字面量在两处硬编码(src/server/handoff-response.ts 与 src/plugin.ts)→ 抽成具名常量 HANDOFF_REPLY_MAX_BYTES;
  • captureHandoffJson 的 catch 原来静默丢弃 codec 失败 → 补一行 debug 日志,否则导出侧数据丢失无法排查。
    推送后重跑 typecheck/build/定向测试全绿。

状态:CI 正在新 head 上跑(gate 层全绿,test 层进行中);真实 Codex E2E 由 CI 覆盖(本机无 codex 二进制未跑成,issue 已注明)。CI 绿后可合。

@yanhuojiyusheng

Copy link
Copy Markdown
Contributor Author

补充修复已推送:1426e79d(fix: keep handoff answer text outside thinking blocks)。

实际验证发现,最新回复虽然已经保存,网页仍可能看起来“只有思考”:kernel 的 renderMessage() 用 _reasoning_: 开始思考内容,却没有结束标记;同一个 assistant 块内后续正文被 splitHandoffBody() 一并放进 thinking 折叠框。

本次在最新回复的 reasoning → text 边界输出不可见的 <!-- /reasoning --> 标记,网页消费该标记后恢复正文渲染。整次回复仍只有一个 ### assistant 分隔符。另修正了本地候选实现将所有 reasoning 集中到前面的做法:现在严格保留 text / reasoning / tool-call 的到达顺序,避免二次思考被挪到工具调用之前。

验证:web-handoff-roles、handoff-response、cli-export 共 29/29 通过;npm run typecheck、npm run build、unused-export gate 和 git diff --check 通过。构建仍有既有 pi-host-stub CONFIG_DIR_NAME 与 kernel bare-import 警告。

边界:本次只修复新采集的最新回复。探针确认,入站历史快照经 kernel renderHandoff() 导出时也缺少 reasoning 结束边界,历史答案仍可能落入 thinking;这条既有路径尚未修改,需要另行跟踪。

CI 状态更正:旧 head 630b7f9b 有 3 个 test 分片失败,尚未读取失败日志,不能判断是否与本 PR 有关,也不能宣称 CI 全绿。新 head 的检查需重新观察。旧 head 的真实客户端 E2E 为 skipped,因此此前“由 CI 覆盖”只能视为待办,不能视为已验证。

yanhuojiyusheng pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 22, 2026
@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch from 1426e79 to 9c94476 Compare October 22, 2026 05:29
ranxianglei pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 22, 2026
…anxianglei#4248)

The reply-capture feature persists session.metadata.handoffResponse on
successful replies; the storage-render goldens pin persisted-state digests,
so their metadata/stateDigest sections drift by design. Regenerated via
scripts/update-storage-render-goldens.ts; verified the delta is exactly the
new handoffResponse field (wire bodies, block contents, stats unchanged).

Pushed by the reviewing agent as a CI fix for this PR branch.
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

第二轮审核完成(1426e79d,另含我随后推的 golden 修复提交 d7b60343f)。结论先行:修法正确、实现核验通过、代码无阻断缺陷;旧 head 的 CI 红里有一个真问题(golden 漂移),已修复推送;其余红分片逐条定性为环境噪声。新 head CI 转绿后可合。

我做了什么

  1. 通读 1426e79d 全部改动(export.ts 标记常量 + renderReplyCells / web client.ts splitHandoffBody 消费标记 / 3 个新测试),并对照 kernel/src/handoff.ts:52 核实「思考块只有 _reasoning_: 起始、无结束标记」这一前提——属实;
  2. 本地复验:typecheck/build 干净,定向测试 68/68 全过(含你新增的 3 个);
  3. 把旧 head 三个红分片的完整失败日志都读了(你评论里说尚未读——现在读完了,定性见下表);
  4. 发现其中一个失败是本 PR 引入 → 已修并推送(见下)。

结构化八问

  1. 是什么问题:回复同时含思考与正文时,网页交接文档把正文折进 thinking 框,看起来「只有思考没有答案」。
  2. 什么原因导致的:kernel renderMessage() 的思考块只有起始行无终止标记,而网页渲染器按「进入 _reasoning_: 后直到块结束都是思考」解析——两边对边界的假设不一致。历史块一直如此(既有行为),本 PR 把最新回复纳入同一渲染面后暴露。
  3. 影响范围与严重程度:仅网页交接视图(+CLI 导出 markdown 的原始文本);触发条件=回复同时含 reasoning 与正文;体验级——内容都在只是折叠错位置,不丢数据。
  4. 怎么修复的:不动 kernel,在宿主导出层为「最新回复」段的 reasoning→text 边界插入不可见 <!-- /reasoning --> 标记,网页渲染器见到即关闭思考段;严格保留 text/reasoning/tool-call 到达顺序(你修的二次思考挪位我核过,测试把顺序钉死了)。
  5. 是否有回归问题:逐项审过——(a) 历史消息块不含标记,解析路径与之前逐字节等价 ✓;(b) 出站字节/计费/压缩身份不变(测试钉基线 deepEqual)✓;(c) CLI 导出节结构不变 ✓。发现并修掉一处真实 CI 失败:storage-render golden 套件钉住持久化状态摘要,新字段 metadata.handoffResponse 使其必红——不是代码错,是 golden 未随契约更新;已用官方脚本重新生成,并核验 delta 恰好只有该字段(wire 体/块内容/stats 摘要全部不变,另直接 dump 驱动会话的 metadata 确认新增键就是 handoffResponse)。
  6. 是否破坏缓存:否——出站字节与会话身份键均未变。
  7. 是否改了设计方向:否。标记是宿主导出层的呈现约定,kernel 契约未动。
  8. 是否引入了新的配置:无新 env/config。

旧 head 三个红分片逐条定性(回应你的状态更正)

分片 现象 定性
ubuntu-24 shard1 日志停在第 2133 个测试中途,零 not ok,作业 ~21 分钟后被杀 runner 超时被杀,非测试失败
ubuntu-22 shard2 + windows 4× storage-render golden 失败 本 PR 引入(见第 5 问),已修:d7b60343f
windows 另 2× e2e #4079 failureType: cancelledByParent + “event loop has already resolved” 事件循环排空型挂起(#3665 家族 flake),非断言失败;master 已合入 #4251 专门修这对测试的确定性 teardown,你的新 base 已包含
各分片的 not ok … # SKIP no SMT solver available verif 求解器缺失自动跳过 无害——master 绿 CI(0a9c639e5)里有同样的行

我的补充提交 d7b60343f

我操作期间你 rebase 强推了新 head(9c94476f7,base 升到 0a9c639e5),首版提交被拒 non-fast-forward;已核对两个 base 间 golden 文件完全一致,干净 cherry-pick 到你新 head 之上并全量复验(golden 5/5 + 定向 68/68 + typecheck + build 全绿)后推送,未动你的任何 commit。仓库规则要求 golden 重新生成在 PR 描述里给理由——理由已写进该 commit message(有意的契约变更 + delta 逐项核验),建议你在 PR body 补一行引用即可。

范围边界确认 + 新立项

你标注的边界我同意并已落实:入站历史快照走同一 kernel 渲染器,同样缺 reasoning 结束边界,历史答案仍会落入思考框——这是 master 上即可复现的既有行为,与本 PR 无关;其症状(内容错位 vs 内容缺失)与机制(渲染契约缺终止符 vs 采集点缺失)均不同于 #4247,按仓库政策单独立项:#4268(已打 bug/p2/scope/kernel)。本 PR 不扩面。

行为变更披露(补充,均有意)

  • 网页交接视图:最新回复块现在是思考进折叠框、正文在外(此前:_reasoning_: 之后全部出现在思考框内);
  • CLI bili export 原始 markdown:最新回复段的思考与正文之间会有一行字面 <!-- /reasoning --> 注释——渲染后不可见、纯文本可见,是常量被两个消费面共用的外观副作用,可接受。

判定

d7b60343f 本地全绿;新 head CI 目前 23 绿 / 0 红(test 分片还在跑),转绿后由人工合并(涉及持久化格式新增 + 多模块,不走 auto-merge)。真实客户端 E2E 由 CI 车道覆盖(本机无 codex 二进制,与你报告一致)。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

第三轮:你新推的 2691e484b(fix: preserve reasoning boundaries in historical handoff replies)我已审完——这把我上一轮单独立项的 #4268(历史快照渲染边界)直接修掉了,#4268 已按「由本 PR 覆盖」关闭。结论:无阻断缺陷,本地全绿,新 head CI 目前 0 红(test 分片还在跑),转绿后可合。

这个提交改了什么(机制层面)

标记方案从「只在最新回复段、按 reasoning→text 过渡插独立标记行」改为「每个 reasoning 单元格的文本尾部内嵌标记」(handoffCells()),并且同时作用于历史快照消息和最新回复段。内核 renderHandoff 是纯渲染函数(只按 role/id 分组、逐条 renderMessage,不消费文本做其他用途),所以宿主侧在渲染前变换消息是安全的;变换用 spread 复制、不改存盘对象(新测试用渲染前后 JSON 对比钉死了这一点)。

两个我重点核过的边界:

  1. 字面标记转义:模型/用户内容里真的写了 <!-- /reasoning --> 行时,reasoning 单元格内的该行被加倍(一行变两行),渲染器消费一行作边界、留一行作可见文本——测试「literal reasoning-end markers remain visible…」把 user/assistant/reasoning 三种位置都钉住了;
  2. 渲染器守卫:标记只在「当前处于打开的思考段」时才消费,其余情况落为普通文本,不会误吞正文;思考后再思考(tool-call 之后二次 reasoning)的顺序保持原样。

八问(针对本次增量)

  1. 是什么问题:上一轮只修了「最新回复」段的思考/正文边界;历史快照里的同类消息仍会把答案折进思考框(即 Handoff doc folds answer text into the thinking box for messages that contain reasoning | 交接文档把含思考过程的历史回复正文折进思考框 #4268)。
  2. 什么原因导致的:kernel 思考块无结束标记 + 渲染器按块解析——与上轮同一根因,只是覆盖面从追加段扩到全部历史消息。
  3. 影响范围与严重程度:网页交接视图的历史消息块(+CLI 导出原始 markdown);体验级,不丢数据。
  4. 怎么修复的:见上——标记内嵌进每个 reasoning 单元格、历史与最新回复统一处理,比「两段各打补丁」更收敛(单一变换点)。
  5. 是否有回归问题:审过——(a) kernel 渲染路径对变换后消息的行为不变(纯渲染、按 id/role 分组,prune 只看覆盖集不看文本)✓;(b) 存盘 lastMessages/metadata 不被渲染改动 ✓(测试钉死);(c) v2 兜底路径(无快照、只有 block summaries)不受影响——那条路的原文是预存文本 blob,本来就没有也不新增标记,行为与之前一致 ✓;(d) 出站 wire/计费/压缩身份依旧零接触 ✓。一个外观变化要披露:bili export 原始 markdown 里现在历史块也会出现字面 <!-- /reasoning --> 行(此前只有最新回复段有)——渲染后不可见,纯文本可见,可接受。
  6. 是否破坏缓存:否。
  7. 是否改了设计方向:否,且比上一版更收敛(单一变换点替代两处补丁)。
  8. 是否引入了新的配置:无。

状态

等三个 test 分片转绿即可人工合并(持久化格式新增 + 多模块,不走 auto-merge)。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

CI 状态更新:2691e484b 全部检查完成——33 success / 15 skipped / 0 failure / 0 cancelled,全绿。包括旧 head 上超时被杀的 test (ubuntu-latest, 24, 1) 分片这次也正常跑完(旧 head 那次是 runner ~21 分钟被杀、日志里零失败断言,属环境噪声;本次同一分片在新 base + golden 修复后一次通过)。

至此三轮审核结论汇总:机制核验通过、回归审计通过(含 golden 漂移已修)、测试真实有效、本地 75/75 + typecheck/build 干净、远程 CI 全绿。可以合并——涉及持久化格式新增与多模块,按仓库规则由人工合并。行为变更披露都在前两轮回复里(导出新增 ### assistant 段、会话文件 ≤1.5MB metadata、网页思考/正文边界修复、CLI 原始 markdown 的标记行外观变化)。

yanhuojiyusheng pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 22, 2026
@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch from 2691e48 to fac4d0a Compare October 22, 2026 08:31
yanhuojiyusheng pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 24, 2026
@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch 2 times, most recently from 91a4ac7 to b031d73 Compare October 24, 2026 10:16
yanhuojiyusheng pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 24, 2026
yanhuojiyusheng pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 24, 2026
@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch from fe96f2f to 7242313 Compare October 24, 2026 10:39
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

CI 已修好并推回 PR 分支。docs-sync 红与 PR 的功能代码无关——是一个已存在的灰度开关缺了文档种子。已在 PR head 上补齐种子并重新生成,本地验证「重新生成零漂移」。新 head:e60177fef(在 e8826ec 之上追加一个 docs 提交)。

八问

  1. 是什么问题:docs-sync(配置文档漂移守卫)红。它跑 tools/gen-config-docs.mjs generate 后,发现 CONFIGURATION.md / CONFIGURATION.zh-CN.md 里有一行 rollout.features.pluginLaneServerHistory,但生成器从种子重算不出来,判为漂移而失败。

  2. 什么原因导致的:该灰度开关(Plugin lanes: pin identity to client msgids, render outbound from the server-owned history | 插件车道服务端正史:消息身份钉在客户端 id 上,出站前缀由正史渲染 #4491 插件车道服务端正史)合入 master 时,文档行是手写进两个 md 的,却漏了对应种子条目(website/config-reference/rollout.yaml)。生成器只认种子,种子没这行 → 重算时把它丢掉 → 漂移。且那行手写内容还违反生成器两条契约(描述带反引号、中/英默认值不一致),本就不可能是生成器产物。本 PR 因 merge 了 master 而继承了这份漂移。

  3. 影响范围与严重程度:仅 docs-sync 这一道 CI 门禁红,卡在本 PR 合并前;不影响任何运行行为或线上用户。严重度低(纯文档一致性),但不修则此 PR 合不了,且它还是 test/static-gates/e2e 的前置 needs,一并被跳过。

  4. 怎么修复的:在 website/config-reference/rollout.yaml 补上缺失的种子条目(key/type/default/env/desc_en/desc_zh),按生成器契约去掉描述里的反引号、默认值统一为单一值,再跑 generate 重新生成并提交 md 产物。属根治(补齐单一数据源),不是删行掩盖症状。

  5. 是否有回归问题:无行为回归——改动只有 yaml 种子 + 两个 md 文档,不碰任何 src/ 代码、wire、kernel 或配置语义;check-coverage(守卫 B)重跑仍绿。

  6. 是否破坏缓存:不涉及缓存/重试/游标/去重。唯一文档措辞变化:ZH 默认值由手写的 0(关) 归一为 0 (off)(生成器不支持按语言分默认值,且其余所有 ZH 行都用英文默认值);EN 默认值不变。属文档规范化,非行为变更。

  7. 是否改了设计方向:不涉及,架构/边界/数据流无转向。

  8. 是否引入了新的配置:没有新增任何配置项或环境变量。只是把一个已存在的开关(rollout.features.pluginLaneServerHistory / env BILI_ROLLOUT_PLUGIN_LANE_SERVER_HISTORY)补进文档种子,使其能被正确生成。

判定:可继续等 CI。docs-sync 应转绿,随之放行的下游 test/static-gates/e2e 会接着跑;本次为纯文档种子补齐,不应触发它们失败。

@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch from e60177f to 52afa10 Compare October 24, 2026 11:36
yanhuojiyusheng pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 24, 2026
@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch from 52afa10 to 0381682 Compare October 24, 2026 13:20
yanhuojiyusheng pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 24, 2026
@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch from db0a208 to 2ab1bc3 Compare October 24, 2026 14:18
yanhuojiyusheng pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 24, 2026
yanhuojiyusheng pushed a commit to yanhuojiyusheng/billion-context that referenced this pull request Oct 24, 2026
@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch from 2ab1bc3 to 3b0fd4a Compare October 24, 2026 15:02
yanhuojiyusheng and others added 5 commits October 25, 2026 16:09
Closes ranxianglei#4247.

Bili 的交接快照只保存本轮入站请求,生成的回复穿过代理却不落盘,
导出要等客户端下一次请求重发历史才补上,会话结束时最后一条回复
永远缺失。

- 从现有回复解析点就地采集后置过滤后的回复(插件 chat/responses/
  json pipes 与压缩循环两条出站路径),不新增 SSE 解析器,不改写
  任何转发字节;
- 回复存入会话 metadata 仅作导出用,绑定请求计数与快照指针,新
  快照到达即清除,不回灌模型、不参与压缩身份与用量记账;
- 导出时以现有 ### assistant 角色块附加回复,不新增节标题;元数据
  格式非法时忽略不崩溃;
- 测试:生产管道四种协议采集/客户端字节一致性、代理循环文本-工具
  顺序与失败轮丢弃、持久化重载(legacy/full)、接力轮与陈旧绑定、
  网页交接渲染器角色分块回归(标题不落入上一条消息正文)。
Apply export-only reasoning boundaries to both request snapshots and the latest reply.
Consume end markers only inside active thinking segments and preserve literal markers.
Cover next-request snapshots, folded/full export modes and unchanged session state.

Fixes ranxianglei#4268
@yanhuojiyusheng
yanhuojiyusheng force-pushed the 2026-10-21_handoff-latest-reply branch from 3b0fd4a to fc1ff34 Compare October 25, 2026 08:13
@ranxianglei
ranxianglei merged commit 84ad668 into ranxianglei:master Oct 26, 2026
24 checks passed
ranxianglei pushed a commit that referenced this pull request Oct 26, 2026
…solution)

Union at the runCompressLoop call site: keep master's new 'reply'
(handoff-reply, #4248) plus this PR's 'visibilityMode' tri-state.
Merged loop options accept both (reply?: HandoffReply / visibilityMode?: VisibilityMode).
@github-actions

Copy link
Copy Markdown
Contributor

📦 Merged Build Published

This merge to master was published as 0.0.848-master.84ad668 (rolling master tag).

npm install -g billion-context@0.0.848-master.84ad668  # this exact build
npm install -g billion-context@master  # always the newest merged build

npm view billion-context@master prints the current version at any time.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working p2 scope/wiring

Projects

None yet

2 participants