[ranxianglei]

Version-only release. Changes since v0.1.87 (17 merged PRs):

Fixes

• fix #590: pi plugin mode reports folded usage, suppress host backfill #591 / pi plugin 模式宿主 usage 回填未压缩基线:footer 显示 302.7%/1M 与实际请求(折叠后 ~57K)不符 #590 — pi plugin 模式宿主 usage 回填改折叠口径：armHostUsageCredit 在 arming chokepoint 对 pluginAgent === "pi" 关闸（pi 插件取消了 pi 自身 auto-compact，未压缩基线只造成 footer 302.7% 显示混乱）；omp / codex / 普通代理客户端保留 代理压缩不上报改写量,宿主上下文会计塌缩至 ~0(omps recordAnchoredHistoryRewrite 零调用);且持久化 lastInputTokens 恢复无钳制,旧版负值升级后复活 #408 未压缩基线
• fix: preflight tries all viable ranges before declaring exhaustion #575 / Preflight fail-fast 502 "no range could be compressed" misjudges a huge over-window session 鈥?minutes later the same session compresses 88% in one shot #569 — preflight 遍历所有可行 range 才宣告耗尽
• feat(#535): dsh phase 4 — split by destination (last overlay shrinks to loopback) #544 / 注入零文件化:废除 overlay/临时目录机制(#531 设计返工) #535 — dsh phase 4：按目的地分流（loopback → /bili/ overlay，远端 https → CONNECT+MITM，明文 http → env 路由）；loopback 判定改 dotted-quad 127/8
• fix: status panel counts outbound system prompt + tool schema (#532) #534 / 面板 Sent to LLM(sent view)漏计 system prompt+工具 schema:plugin.ts 硬编码 systemPromptTokens: 0,SysPrompt 行永不可渲染(#425 不覆盖) #532 — 状态面板计入出站 system prompt + tool schema tokens
• fix: forward-proxy requests no longer misread as self, restoring per-upstream window config (#562) #563 / bug: 标准 HTTP 代理请求被误判为自身请求，导致上游模型窗口配置失效 #562 — forward-proxy 请求不再被误判为 self，恢复 per-upstream window 配置
• fix: instance registry lost-update — per-instance marker files (#527) #528 / instance registry lost-update: shutdown unregister can wipe a concurrently-starting proxy's registration #527 — 实例注册表 lost-update 修复：per-instance marker 文件
• fix: report uncompressed baseline in host usage + clamp negative persisted token stats (#408) #425 / 代理压缩不上报改写量,宿主上下文会计塌缩至 ~0(omps recordAnchoredHistoryRewrite 零调用);且持久化 lastInputTokens 恢复无钳制,旧版负值升级后复活 #408 — 宿主 usage 上报未压缩基线 + 负值持久化 token 统计 clamp
• fix: keep Responses assistant history valid after compression (#564) #565 / Compression breaks Responses assistant history ordering, causing repeated invalid_assistant_history 400s #564 — Responses 压缩后保持 assistant 历史合法
• fix: guard side requests against over-window payloads (#554) #557 / side request(max_tokens<=200)绕过 preflight 且不检查载荷体积,携带全量历史直转上游导致 400 #554 — side request 防 over-window payload（估计器偏差容忍）
• fix #401: persist bounded folded-view snapshot instead of full raw history #587 / sessions 存储三重膨胀:叶块 blockContents 逐字节重复 50%、零 GC、每次启动两遍全量同步解析(实测 387MB/+60MB 每天/2s 起步) #401 — 持久化改有界折叠快照（BILI_PERSIST_TAIL_TOKENS 默认 16384），磁盘占用从 63.2% 降到个位数百分比
• fix: align undici transport timeouts with idle watchdog; add BILI_UPSTREAM_TIMEOUT_MS (#551) #556 / 上游长时间 prefill(首 token 前无输出)被 undici 默认 bodyTimeout=300s 掐断,UPSTREAM_TIMEOUT_MS=10min 配置形同虚设,大上下文请求必超时 #551 — 上游空闲超时 12 分钟 + BILI_UPSTREAM_TIMEOUT_MS
• fix: skip auto-update when running from a git source checkout (#580) #581 / auto-update overwrites tracked files when run from a git source checkout (findInstallDir resolves to repo root) #580 — git source checkout 跳过 auto-update
• fix: count system+tools wire overhead in the preflight trigger (#470) #576 / track: plugin-mode proxy-side emergency truncation (last-resort backstop, deferred from #467) #470 — preflight 触发器计入 system+tools wire overhead
• fix: compat.roles wire role rewrite for role-rejecting upstreams (#552) #579 / billion-context: 400 Bad Request when codex sends role: "developer" messages — request a request-body compat transform hook #552 — compat role 改写（dev↔system/user 自动学习重试）+ fetch-util 定时器竞态
• fix: acp_status derives ranges/nudge from live state, not the prepare-time snapshot (#389) #397 / acp_status 缝合报告:Compressible ranges/Nudge 读冻结的 ctx.nudge,压缩成功后旧区间与新块同框并存 #387 — /acp status 现算 live ranges（统一 3 处 dispatcher）
• fix: preflight relaxes the soft-protected recent zone under overflow (#330) #337 / preflight fail-fast × soft-protection livelock: over-window payload with nothing foldable outside the protected zone 502s forever #330 — preflight 软区降零（fit gate 含 imageTokens）

Docs

• docs: AGENTS.md — require issue tracking for discovered/fixed problems #586 — AGENTS.md：问题发现/修复必须留 issue 痕迹

Pre-flight

typecheck ✓ · tests 1140/1142（2 个已知 plugin-agent 环境失败）✓ · build ✓

[github-actions]

📦 Built Package Artifact

Branch: 2026-09-07_release-v0.1.88 (01fd5de)

Option A — Install from npm PR tag (recommended)

npm install -g billion-context@pr-592

Each push to this PR publishes a new version under the pr-592 npm tag.

Option B — Download artifact

1. Download the artifact from the Actions run
2. Extract the tarball and install:

tar xzf billion-context-pr592.tgz
npm install -g package

---

This comment is automatically updated on each push.