Skip to content

使用Pi subagen时经常出现这个问题 #888

Closed

Description

@chasel1681
                                                                                                          │
  • Nod│ ✓ harness-frontend [fresh] · fc9... complete│◆ Assistant · claude-sonnet-5 │
  • UI │ ✓ delivery-reviewer [fresh] · 2e... complete││ ❌ [ACP] Compression FAILED: range m00001..m00260: Summary too long (27417 chars, max 20000). Strip noise — keep critical paths, decisions, errors, and code references. Or pass │
  • 语 │ ✓ newton-backend [fresh] · 0258f454 complete││ summaryMaxChars to increase the limit — don't lose critical info just to fit.

Activity

  1. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 收到,正在排查。

    初步定位(已核对代码):这条报错来自 acp-kernel 的压缩校验 validateCompressionRange——单次 compress 调用里某条 range 的 summary 超过默认上限(maxSummaryLength = 20000 字符)时,整次压缩会被原子拒绝,报 Summary too long (27417 chars, max 20000)。

    为什么用 Pi subagent 时"经常"出现:subagent 的工作内容很密集(读文件、跑构建等产生大量工具输出),无论是父会话累积多个 subagent 结果、还是子会话自身上下文快速膨胀,可压缩区间往往都很大;模型倾向于把一大段历史压成"一条"超长 summary,于是撞上 20000 上限、整次失败。当前注入给模型的压缩哲学提示里只说了"可以一次批量多条 range",但没有告诉它"每条 summary 有长度上限、大区间应拆成多条更小的 range 各自写 summary"——这是根因层面的缺口。

    我的修复方向:在注入的压缩指引(nudge + 常驻哲学提示)里补一条字节稳定的规则,明确每个 summary 的长度预算,并引导对大区间做拆分(多条小 range、各自紧凑 summary),从源头降低这类失败频率。稍后给出 PR。

  2. chasel1681 commented on Sep 17, 2026

    @chasel1681
    Author
     … 3 older signal lines: ❌ [ACP] Compression FAILED: no valid ranges parsed (kind=no-valid-ranges, dropped=2). Rejected entries: 还有个这个问题
    
  3. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    谢谢反馈。这里其实是两个独立的错误,分开处理:

    错误 1:Summary too long (27417 chars, max 20000) — 已修复

    根因:acp-kernel 在任何一个 range 的摘要超过 compress.maxSummaryLength(默认 20000 字符)时,会原子性地拒绝整个 compress 调用。密集的 subagent 场景(大量子任务结果、长工具输出)下,模型倾向于对一个大 range 写一份巨型单体摘要,直接撞上限。而现有提示只说了"可以把多个 range 批量放进一次触发",从未提过每个摘要有字符上限、大/密范围应该拆分——模型在选范围的时刻没有任何信号,重试时还会重复同样的错误。

    修复(PR #889):在所有压缩引导面(nudge 消息 + 持久哲学提示,plugin/proxy 两种模式都覆盖——你用的 Pi 属于 plugin 模式,proxy 侧 nudge 正是它的压缩触发器)追加一条字节稳定的引导:每个摘要有硬字符上限;一个超限摘要会让整次调用失败;range 大或内容密时,按逻辑边界拆成多个小 range、各自写简洁摘要、批量放进一次调用。不硬编码数字(任何上限配置下都保持正确),字节稳定常量(不打断 prefix cache)。纯提示文本改动,落在既有注入点上,无 wire 形态/状态/配置变更;新增回归测试。typecheck / 全量测试(1670 pass / 0 fail)/ build 全绿。

    PR: #889

    一句话总结:修复了"单份摘要过长导致整次压缩失败"的问题(提示从未告诉模型有每摘要字符上限、应拆分开),在两种模式的压缩提示中加入拆分引导,纯文本改动、测试通过,可以合并。

    错误 2:no valid ranges parsed (kind=no-valid-ranges, dropped=2) — 需要你的日志定位

    这个错误发生在解析阶段:模型一次 compress 调用提交了 2 个 range 条目,全部没通过结构校验(常见原因:字段缺失、summary 为空、条目格式无法解析)。注意这一阶段只查结构,不查引用编号是否存在——编号不存在/已失效产生的是另一种错误,不是这个。

    每条被拒条目的具体原因代理端都有记录。麻烦帮忙取一下这几行(没有敏感信息,可直接贴出):

    grep "acp-compress-input\|no valid ranges" ~/.local/state/billion-context/bili.log | tail -20

    关键是含 reasons=[entry 0: ..., entry 1: ...] 的那行。你截图里 "Rejected entries:" 后面是空的(看起来被截断了),日志里的信息更完整。另外方便的话报一下 bili 版本(bili --version)。

    与 #887 的关系:同日有 issue #887 报告了同一场景族下的相关 bug——当消息引用编号与当前消息顺序不一致(subagent 交错时容易出现)时,nudge 显示的范围与实际解析选中的消息不符,导致 "Total compressible content too small",且附带了离线复现。如果错误 2 的日志显示引用编号异常,两者可能同根因。拿到日志后我继续查。

    顺带发现(按规范在本线程报告)

    排查中发现一个潜在交互:#853 把 preflight 摘要生成的输出上限提到了 32768 tokens,但 requestSummary(src/preflight.ts:665)只检查下限(MIN_SUMMARY_CHARS)、没有上限检查;若生成的摘要超过 20000 字符,applyRanges 会失败且该 range 被静默跳过(src/preflight.ts:896-899)——密集溢出场景下 preflight 可能恰好折不了它该处理的范围。建议 preflight 在 apply 前对照 maxSummaryLength 做上限检查,或对齐两处上限。先报告于此,是否值得单独处理由 owner 判断。

  4. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    补充:PR #889 的 CI 已全部通过(typecheck / 全量测试 ubuntu+windows × Node 22/24 / build / version-guard / codex e2e 均绿),与 master 无冲突,处于可合并状态。

    #889

    一句话总结:错误 1(单摘要超 20000 字符导致整次压缩失败)已修复并提 PR #889,CI 全绿可合并;错误 2(no valid ranges parsed)等你贴 bili.log 里含 reasons=[entry 0: …] 的那行日志后继续定位。

  5. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    本pr有两个问题需要ework协助处理:

    1. 由于改了提示词,我们的提示词大多数出自内核 https://github.com/ranxianglei/acp-kernal 理论上在内核处理比较好.
    2. 提示词现在都支持可配置,现在的提示词在本项目是不可配置的.
    3. 提示词支持动态扩展pack,现在的提示词不支持.
    4. lean pack没有相关改动,需要评估.
  6. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    逐条核对过了,四点全部成立,正确归属确实是内核。评估与方案如下:

    逐条确认(代码已验证)

    1. 内核归属:成立。两个载体都在内核内生成——system prompt = buildCompressSystemPrompt/Hybrid(prompts, surface.promptSections)(bili 只是 re-export,src/compress-tool.ts:46-48,Phase K1 薄壳),nudge = renderNudgeText(nudge, prompts, surface.nudgeSections)。我现在的做法是在 bili 侧渲染之后追加 note(7 个注入点),确实绕开了提示词治理层。
    2. 可配置:成立。现有机制是 compress.prompts.{compressPhilosophy, howToCompressRules, tier2/tier3} + acknowledgePromptsRisk 门控(src/compress-settings.ts:106-120);我的 note 是 bili 硬编码常量,不可覆盖、不可关闭。
    3. 动态扩展 pack:成立。promptPack 解析链 project .billion-context/packs > user <configDir>/packs > builtin {default, lean};pack 可覆盖 surface.prompts.<rule> 与 nudgeSections(tri-state:string=替换、null=禁用)、toolPrompts;我的 note 对 pack 完全不可见。
    4. lean pack 评估:leanPack(builtin:lean)是 token-lean surface(单行 toolPrompts + 精简 adapter sections)。当前部署链下 lean 实际只改变 wire 侧 toolPrompts(adapters.pi.* sections 不被 bili/内核消费,是留给原生 agent host 的)。我的 ~700 字符 note 在 lean 下也原样追加,与其设计目标相悖;LEAN_HOW_TO_COMPRESS 里也没有 budget 规则。结论:失败模式(单摘要超限→整次调用失败)对所有 surface 同样存在,guardrail 不能在 lean 下消失;但措辞应分层——完整规则进持久 system prompt 一次(字节稳定、prefix-cache 友好、成本摊薄),nudge 时刻只留 ~150 字符短提醒,lean pack 配精简变体。

    修复方案(移入 acp-kernel)

    内核 PR(ranxianglei/acp-kernel):

    1. 把 per-summary budget 规则追加进 defaultPrompts.howToCompressRules——topic 上它属于 HOW TO COMPRESS 规则;function/text/hybrid 三个 builder 都继承它 → 覆盖 bili 全部 4 个 system-prompt 注入点 + preflight(src/preflight.ts:549)+ 其他用内核 builder 的 host。自动获得可配置性(第 2 点)与 pack 可覆盖性(第 3 点),无需新配置面。
    2. NUDGE_SECTION_KEYS 新增一个 tri-state key(如 summaryBudget),内置默认值为 ~150 字符短提醒,由 renderNudgeText 输出;pack 可替换或禁用。
    3. lean pack 加精简版一句话(LEAN_HOW_TO_COMPRESS);nudge 默认值保持足够短,lean 无需特殊处理。
    4. 内核侧测试:断言规则出现在 builder/nudge 输出 + pack 覆盖路径生效。

    billion-context PR #889(内核发布后更新):移除 bili 侧 SUMMARY_BUDGET_NOTE + 7 处 wrap + 对应测试;bump acp-kernel pin 到新版本;重建 + 全量验证。该 PR 变成承载内核改动的载体(仍 Fixes #888)。

    时序(按 AGENTS.md 跨仓依赖规则):kernel PR 合并(人工)→ CI 发布 acp-kernel vX → npm 验证 → 更新 #889(删本地 note + bump pin)→ #889 合并(人工)。内核落地前 #889 维持现状(绿色 stopgap,无回归窗口),落地后转换。

    放置位置我选 howToCompressRules 而非 compressPhilosophy(这是 HOW-TO 规则不是哲学陈述;philosophy 段跨版本更稳定)。有不同意见请指出,否则我现在就开始准备内核 PR。

  7. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    继续

  8. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    已按四点要求把改动挪到内核侧:acp-kernel PR ranxianglei/acp-kernel#321 (CI 全绿、与 master 无冲突)。

    改动内容(commit 116aa4d,9 files / +64 −6)

    1. src/compression-rules.ts:HOW_TO_COMPRESS_RULES 末尾追加 PER-SUMMARY LENGTH BUDGET 段——每个摘要有硬字符上限;一个超限摘要会让整次调用失败;大/密 range 按逻辑边界拆成多个小 range、各自写简洁摘要、批量放进一次调用。不硬编码数字(任何上限配置下都正确),字节稳定。三个 system prompt builder 通过 prompts.howToCompressRules 自动继承,preflight 的摘要提示同样覆盖。
    2. src/nudge-text.ts:新增 tri-state nudge section summaryBudget(string 替换 / null 移除),默认一条 ~140 字符的现场提醒,gentle/emergency/tier 三条路径都输出。刻意保持短——lean surface 无需专门覆盖;完整规则只在 HOW_TO_COMPRESS_RULES 里出现一次。
    3. src/packs.ts:summaryBudget 加入 NUDGE_SECTION_KEYS,pack 可替换/禁用;lean pack 的精简契约 LEAN_HOW_TO_COMPRESS 补一行预算规则(~130 字符 vs 完整版 ~700)——第 4 点评估结论:lean 需要对应改动,但只需一行。
    4. 可配置性免费获得:compress.prompts.howToCompressRules 本来就支持整段覆盖(resolvePrompts),pack 的 surface.prompts.howToCompressRules + nudgeSections.summaryBudget 现在两个载体都能管到。
    5. 测试:规则存在性守卫(使用Pi subagen时经常出现这个问题 #888 回归)、nudge 三路径提醒 + override/null 行为、pack sanitize 保留新 key、golden prompt fixtures 重新基线(diff 恰好只有追加段落,逐行核对过)。

    验证:typecheck 干净 / 807/807 tests / build 成功;CI(test 22+24、pr-validation、build-artifact)全绿。无 wire/状态/schema 变更,新 key 纯增量可选。

    后续流程(按内核 AGENTS.md 跨仓规则):#321 由你合并 → CI 发布 acp-kernel 新版本 → 我 npm view 确认后更新 bili PR #889:删掉本地的临时 note(SUMMARY_BUDGET_NOTE + 7 处注入点包装 + 2 个测试)、升级 kernel pin、重跑全套验证推送。然后两个 PR 依次合并即可。#889 在此之前保持现状作为可用的临时方案。

    一句话总结:按评审意见把"每摘要长度上限 + 大范围拆分"引导从 bili 本地注入移入 acp-kernel(PR #321,走 prompts/packs 治理层、可配置、lean 已适配),CI 全绿待合并;合并发布后我会同步更新 bili PR #889 再收口。

  9. ranxianglei commented on Sep 19, 2026

    @ranxianglei
    Owner

    已按四点要求把改动挪到内核侧:acp-kernel PR ranxianglei/acp-kernel#321

    我看了,限制模型写过长摘要不好,会导致质量下降.这个是opencode-acp的教训.

    我理解这个是不是nudge调大导致的 如果是,这可能导致过高摘要 应该最大值同步放大.

    另外你需要看这个相关提示词是不是已经进入master 如果是需要提交pr撤回.

    最根本的方法:扩大摘要提示词上限

  10. ranxianglei commented on Sep 19, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    收到,按新方向处理。先回答你的核查要求,再给方案。

    核查:相关提示词是否已进入 master — 没有,无需撤回

    你的假设成立(代码证据)

    • 上限是扁平常量,与被压缩范围大小无关:kernel src/config.ts:27 maxSummaryLength: 20000;校验处 src/compress.ts:1078 effectiveMax = spec.summaryMaxChars ?? cfg.maxSummaryLength。
    • nudge 触发参数 minContextLimitPct 0.45 / maxContextLimitPct 0.75——200K 窗口下,到触发时可压缩范围轻松达到数万 token。报错里的 m00001..m00260(260 条消息)就是这种大 range。
    • 27417 字符对 260 条消息其实是合理密度——模型写的是忠实摘要,被扁平上限拒绝。per-call summaryMaxChars 逃生口存在(错误信息甚至提了),但模型不会主动用。
    • 结论同意你的判断:问题不是模型摘要太长,而是上限不随 range 放大。限制模型反而损失质量(opencode-acp 教训)。

    建议方案(推荐比例放大,附最小化备选)

    推荐:校验时按比例放大上限。 在 validateCompressionRange 把 effectiveMax 改为 max(floor, ceil(sourceChars × ratio)),sourceChars = range 内消息总字符数(SingleRangeInput.messages 已在作用域内,零签名改动):

    • floor 保持 20000、ratio 建议 0.35:源内容 < ~57K 字符的小 range 行为与今天完全一致(cap 仍 20000),回归面为零;大 range 上限随大小同步放大——正是你说的"最大值同步放大"。
    • 自限性:摘要不可能超过源内容的 35%,超大 T1 块后续由 T2/T3 分层蒸馏继续压缩;若模型真写出 >35% 的注水摘要,仍会被拒且错误信息显示有效上限(现有文案不用改)。
    • bili 侧配套:暴露 compress.maxSummaryLength 配置项(作为 floor/整体覆盖)透传 kernelConfig;pin 从 0.0.69 升到新版本——注意这会连带引入 0.0.69 之后的全部内核修复(含 [Bug] 消息引用编号与当前顺序不一致时,compress 范围提示会选错消息,导致“内容不足”失败 #887 的 formatRanges 修复 feat: clamp effective window to codex's model perception for codex clients (#321 PR-E1) #324),全套测试重跑。
    • 附带收益:我此前报告的 preflight 发现自动消解——上限放大后,preflight 生成的长摘要(输出预算已是 32768 tokens)不会再被校验拒绝而静默跳过。

    备选(最小改动):只把扁平默认值 20000→60000 + 配置透传。更简单,但超大 burst range 会再次撞墙,只是推迟同类失败——不推荐。

    流程

    你拍板数字(floor/ratio,或直接说用备选)→ 我提内核 PR → 合并发布后更新 bili PR #889(删本地临时 note、加配置透传、升 pin、全套验证)→ 两个 PR 依次合并收口。

    一句话总结:已核实两处改动均未进 master/发布产物、无需撤回(#321 已关);确认根因是扁平 20K 上限不随 range 放大,建议改为 max(20000, 源字符×0.35) 的比例上限(小 range 零变化、大 range 同步放大、自限且可配置),等你拍板数字后开工。

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

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions