Skip to content

[PR] fix(external-summary): stop repeated total failures and recover after repair - #6905

Open
xwc2020-2 wants to merge 1 commit into
ranxianglei:masterfrom
xwc2020-2:2026-11-16_external-summary-repeat-guard
Open

xwc2020-2 wants to merge 1 commit into
ranxianglei:masterfrom
xwc2020-2:2026-11-16_external-summary-repeat-guard

Conversation

@xwc2020-2

Copy link
Copy Markdown

⚠️ MODEL-FACING TEXT CHANGE

摘要全失败和配置无效的回执现在附带连续失败保护与恢复条件;达到阈值后的回执明确要求继续原任务、暂停压缩。新增完整回执断言固定模型可见的失败计数及冷却说明,避免模型误以为反复换范围即可修复外部服务。

Fixes #6903

外部摘要的所有候选失败时,原分支直接返回,绕过既有 compressFailStreak。因此即使两个候选连续返回 HTTP 403,后续 compress 仍会继续派发。本修复将该路径和无效配置路径接入现有会话保护:三次连续失败后在下一次候选派发前拒绝;已阻断的调用不会延长冷却。失败时保持原消息及压缩状态。

恢复沿用现有配置与十分钟衰减机制:摘要设置、解析后的凭据、全局摘要长度或有效单次 summaryMaxChars 变化后允许重试,成功折叠清除计数。元数据仅保存配置指纹。普通解析/范围错误与外部摘要失败分别统计连续次数;共享队列拥塞且没有实际候选派发时不累计服务失败。

本 PR 聚焦重复失败保护,关联 #6890 的错误诊断改进和 #3659 的更广摘要改进;不复制其诊断实现,不修改默认摘要超时预算。保护位于共用的 applyConfiguredCompression,不改变 plugin/proxy 两种模式的摘要承载格式。不新增配置字段,也不修改 kernel、版本或依赖锁文件。

验证:

  • 在未修复主线上先运行新增回归,初轮 8 项中 7 项失败,复现原缺口;审查新增的另外 4 项恢复/失败分类回归修复前全部失败、修复后全部通过。
  • node --import ./tests/preload-test-env.mjs --import tsx --test tests/external-summary*.test.ts tests/compress-loop-breaker.test.ts tests/compress-fail-guard.test.ts:206 通过、0 失败、1 跳过。
  • npm run typecheck、npm run build、git diff --check;构建的 dist-import-annotations 与 dist-external 检查通过。
  • 真实 Codex E2E 的配置上游端口不可达,预检跳过,未将其计为通过。全量回归结论以此 PR 推送 head 的远程 CI 为准。

🤖 Generated with Claude Code

⚠️ MODEL-FACING TEXT CHANGE
外部摘要失败回执明确说明服务恢复条件,避免诱导调用者反复更换范围。

将外部摘要全失败和无效配置接入现有连续失败保护;达到阈值后在派发前拒绝,配置、有效凭据、摘要长度设置变化或冷却到期可恢复,成功折叠清零。零派发的共享队列拥塞不计入服务失败。

Fixes ranxianglei#6903

Co-Authored-By: Claude Code <noreply@anthropic.com>
@ranxianglei ranxianglei changed the title fix(external-summary): stop repeated total failures and recover after repair [PR] fix(external-summary): stop repeated total failures and recover after repair Nov 16, 2026
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

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

查重: 不重复。 #6905 是「外部摘要全失败绕过连败保护」这一缺口的唯一 PR;相关条目互补而非并列——#6890(非 fetch 类失败诊断命名,PR 正文明确不复制其实现)、#6885(默认超时预算过小导致长载荷 100% 失败,机制不同,本 PR 不改默认超时预算)、#3638(持久失败背景现象,#6903 是其中独立可验证的缺口)。

标签: bug + scope/kernel + p2(压缩引擎外部摘要路径的保护缺口,缺陷类;会话可用但 compress 反复失败浪费外部调用,有绕行,故 p2)。

结构化八问

  1. 是什么问题: 外部摘要服务整体失败(所有候选都失败)或外部摘要配置无效时,compress 调用直接返回、不进入既有「三次连续失败」断路器——模型可以对一个不可用的摘要服务无限重派请求,会话得不到保护。
  2. 什么原因导致的: applyConfiguredCompression() 的全失败分支与无效配置分支都直接 return,绕过了会话级连败计数 compressFailStreak(正常路径经 applyRanges → noteCompressLoopFailure,外部摘要路径从未接入)。根因是外部摘要路径未接入既有失败保护机制,而非保护机制本身有缺陷。
  3. 影响范围与严重程度: 影响启用了外部摘要且摘要服务不可用(凭据失效、服务宕机、配置错误)的会话。p2——主对话与主模型不受影响,但 compress 反复失败、反复消耗外部 API 调用,模型可能循环 compress 调用消耗上下文;有绕行(继续任务不压缩,或修复配置/凭据)。
  4. 怎么修复的: 把外部摘要路径接入既有会话保护——(a) 连续三次全失败后在派发前拒绝(不发任何 HTTP 请求);(b) 被拒绝的调用不延长冷却;(c) 配置指纹(外部摘要设置 + 解析后凭据 + proxy + 摘要长度上限)变化或 10 分钟冷却后允许重试;(d) 成功折叠清除计数;(e) 纯共享队列拥塞(无实际候选派发,attempts=0)不计为服务失败;(f) 普通解析/范围错误与外部摘要失败分别统计连败。
  5. 是否有回归问题: 逐项审过既有行为——recordCompressFailure 既有调用点与文案不变(新增第 4 参默认 true);[bug] DSH 桌面端 0.1.188:宿主原生压缩落地摧毁折叠基底 → 同一区间永久不可锚定、compress 连片失败并熔断(compaction-basic auto:false 仍无效) #2432 既有 cause 判定测试(substrate-destruction 等)不受影响(新增 XOR 复位仅当恰好一侧为 external-summary 时触发);nudge 门与 acp_status 展示是 cause 无关的,与既有 cause 行为一致;无效配置路径新增的输入解析对畸形输入不抛错(返回空 ranges),无新崩溃路径。一处有意行为变更(PR 正文已披露): 外部摘要失败与其他失败改为分别统计连败——外部失败会把非外部失败连败重置为 1(反之亦然),substrate-destruction 与外部失败交替的场景下断路器晚一次失败才武装,属不同故障域的合理边界。无意外回归。
  6. 是否破坏缓存: 不涉及。不触碰缓存/重试/增量游标/去重键策略;每候选 5xx 重试策略不变。
  7. 是否改了设计方向: 不变。复用既有 3 次阈值、10 分钟衰减与会话元数据持久化机制;不改变 plugin/proxy 两模式的摘要承载格式;不新增配置字段;不改 kernel/版本/依赖锁文件。
  8. 是否引入了新的配置: 无新用户配置。会话元数据新增 externalSummaryConfigHash 字段(64 字符 sha256 配置指纹,用于判定断路器复位)——属内部状态而非用户配置;测试验证凭据字节不进入元数据。

验证(均在 PR head 892c2561a2 上本地重跑,基于最新 master de895aa88c):

  • 定向回归: tests/external-summary*.test.ts + issue2146/847/2432/4812 断路器套件 → 233 通过、0 失败、1 跳过
  • 回归测试有效性: 将 3 个 src 文件还原到 master、保留 PR 测试文件 → 12 项新测试中 11 项失败(复现原缺口),唯一通过的是凭据泄露守卫(它本就是守卫而非 bug 复现)——与 PR 正文声明一致
  • npm run typecheck 干净;npm run build 通过,dist-import-annotations/dist-external 检查 OK
  • 远程 CI 全绿: 30 项 = 24 success + 6 skipped(env 门控的 e2e 车道)+ 0 failed
  • 模型可见文案(⚠️ PR 正文已声明): 按消费链推理——无幻影值(N 为真实连败数、10 分钟为真实冷却),单一可执行指令(无 bili 插件模式下 allowDshCompaction 在 responses 线路上完全失效 —— DSH 原生压缩落地、折叠基底被摧毁、compress 连片失败 #2360 双指令矛盾),receipt 级测试钉死精确的模型可见字符串

小发现(非阻塞,不要求修改)

  1. PR 正文的测试命令引用了两个不存在的文件名(tests/compress-loop-breaker.test.ts / tests/compress-fail-guard.test.ts),实际文件为 tests/issue2146-compress-loop-breaker.test.ts / tests/issue847-compress-failure-guards.test.ts——实际套件已跑且绿。
  2. 理论绕过: 模型若交替「解析失败调用」与「外部摘要调用」,外部连败会被 XOR 复位保持在 n=1,断路器无法武装——但每个循环仍消耗上下文并发出快速失败请求,per-spec 守卫仍会升级,影响有界。
  3. per-range summaryMaxChars 进入复位指纹: 模型每次改 summaryMaxChars 可复位断路器——属刻意设计(超限拒绝场景不必等 10 分钟),且回执文案未宣传该恢复路径(保守方向)。
  4. work.length===0 && hasProbeChanges 分支(src/external-summary-compress.ts:122)返回裸拒绝、未进失败计数——罕见边缘(探测改变了状态但未收集到内容),不太可能形成循环。

结论: 可合并。 方向正确(根因修复而非治标)、实现完整(#6903 的 7 项要求全覆盖)、测试真实(11/12 在未修复 master 上失败)、CI 全绿、diff 干净(4 文件 +235/-4,全部与本修复相关)。agent 不代合并,请自行合并: #6905

This branch has not been deployed

No deployments
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/kernel

Projects

None yet

2 participants