Skip to content

给每个客户端适配压缩状态看板 #1920

Closed

Description

@ranxianglei

给每个客户端适配压缩状态看板,有一些是命令行 有一些是web 有一些是桌面

有的是在最下边状态栏
有的可以最右边状态烂

无论如何 在每个会话上能看到一些基本数据,
比如类似这里的数据
按照空间大小挑选重要的放上去.
比如累计省token,缓存,压缩摘要存在个数等等

billion-context@0.1.179 · pack: lean

Context (session accounting, host footer scale): 11% (96k / 869k) — includes compressed originals; shrinks slower than the sent view
Growth: +28k since last nudge

Sent to LLM (after compression, est.): 89k (10% of limit)
Session-only (compressed originals, est.): 1.7M — pruned from every request; the footer/nudge still count them

Token Breakdown (sent view):
Tool ██████░░░░░░░░░░░░░░ 30% 27k
SysPrompt ████░░░░░░░░░░░░░░░░ 21% 19k
Text ██████░░░░░░░░░░░░░░ 28% 25k
Code ░░░░░░░░░░░░░░░░░░░░ 2% 1.7k
Summaries ████░░░░░░░░░░░░░░░░ 18% 16k

Nudge: idle — max compressible 39955 < threshold 50000

Compressible ranges (3, oldest first):
m04177–m04203 27 msgs 4.3K [tool 65% | text 35%]
m04216–m04217 2 msgs 3.2K [PROTECTED: compress — not compressible]
m04301–m04451 151 msgs 37.1K [35.7K compressible | 1.5K protected: compress] · 3 user msgs

Blocks: 35 active / 105 total (1.6M tokens compressed, cumulative)
[b1] T1 3.0k→232: ACP状态解读+两项任务下达
[b4] T1 1.6k→60: pfa-9cab 会话线排查(排除)
[b5] T1 2.2k→64: 会话全景清单(已完成)
[b6] T1 1.7k→134: _unknown 会话与 ~/.pi/acp.log 初查
[b7] T1 6.8k→74: 双任务下达+旧调查残留

Activity

  1. ranxianglei commented on Oct 2, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷

    查重结论:检索了 open+closed issues,无重复条目。相关既有功能:/acp 状态面板(pi/omp/opencode/dsh)、/acp-cache 报告、Web UI 会话看板(localhost:8787)、GET /__bili/plugin/status 端点。本 issue 是在这些之上的增量需求——从「按需查询」升级为「每个会话常驻可见的迷你看板」,判为独立新功能项,非重复。

    现状盘点(数据层已齐,不用重建):

    • 代理已按会话聚合全部所需数据:累计省 token(tokensSaved + ledger netSaved)、缓存命中率、压缩块数/累计压缩量、nudge 状态、上下文窗口占比——即 issue 截图里的全部数据。
    • GET /__bili/plugin/status?conversationId=… 已返回结构化 JSON + 全文 panel + Web UI 深链;Web UI 本身已经是「web 类看板」(总览 + 每会话详情 + 缓存曲线),这一类基本完成。
    • 真正的缺口:没有任何客户端 UI 有常驻可见的紧凑状态——现在必须手动跑 /acp 或开网页。

    各客户端接缝核查(是否真有「常驻位置」,逐一实查过宿主 API):

    客户端 常驻接缝 适配方式
    pi / omp(TUI) ✅ ctx.ui.setStatus(key, text)——官方扩展 API,在底部状态栏设独立槽位(可传 undefined 清除);可在 turn_end/agent_end/压缩事件上刷新 min 档一行写进底部状态栏;可选 setWidget(编辑器上/下方)放宽档
    claude ✅ statusLine 设置——周期执行 shell 命令、stdout 渲染到底部状态栏;stdin JSON 带 session_id(与 bili 用的 x-claude-code-session-id 同源) 附带 bili statusline CLI;installer 写入 managed settings(复用 #964 机制)
    opencode(V1/V2) ❌ 插件 API 只有 events/tools/commands/合成消息行(Notice ≤1KB),无状态栏接缝 只能瞬时提示(tui.toast.show)+ 按需 /acp + Web 深链;常驻需上游提供接缝
    dsh ⚠️ 待查(TUI/headless profile 无 webServer,web profile 有;需实现期探测) 先保 /acp + Web 深链;查到接缝再单独适配
    codex/kimi/hermes/zcode ❌ 仅 MCP tools,无 UI 渲染面 按需 acp_status tool(已有)+ Web 深链
    gemini/iflow/qwen/mcode/aider/copilot/amp/goose/jcode/trae/codebuddy/qoder ❌ 无插件/MCP 接缝或闭源二进制 文档化兜底(CLIENTS.md 矩阵),引导用 Web UI

    「每个客户端」无法形态统一——接缝可用性不同,方案用能力矩阵覆盖:有真接缝的给真状态栏,没有的给最接近的兜底并如实记录。

    推荐方案(单一数据源 + 每客户端薄渲染器,v1 不新增配置字段):

    1. Phase 0(代理核心):handlePluginStatus 在现有字段旁增加结构化 stats 对象 + 预渲染分档一行:
      • min(约 ≤60 字符):bili 11% 96k/869k · saved 1.7M · 35blk · cache 96%——上下文占比 + 累计省 token + 摘要块数 + 缓存命中,即 issue 点名的三项都在;
      • med:+ nudge 状态 / 距上次 nudge 增长;
      • full 保持现有 /acp panel 不变。
        所有客户端读同一端点,多客户端数字永不漂移。
    2. Phase 1(前两条真底部栏):pi/omp setStatus(事件驱动刷新;旧版本宿主缺该 API 时 optional-chaining 自动降级,与现有 inert-safe 模式一致)+ claude statusLine(bili statusline)。这两条接缝最稳、覆盖最高频 lane。
    3. Phase 2:opencode 瞬时提示兜底、dsh 接缝探测、CLIENTS.md 每客户端看板适配矩阵文档。

    待你拍板(均附我的明确建议,不是开放选择题):

    1. v1 范围 = 代理核心 + pi/omp + claude 底部栏,其余客户端按矩阵兜底并文档化——建议照此执行。
    2. 默认策略:有接缝即默认 ON(纯增量 UI,零 wire 影响,不碰压缩路径)。若要全局 kill switch 属于新增配置项,请定 key 名与默认值(config surface 纪律),我不擅自发明。
    3. min 档指标集确认:上下文占比/窗口、累计省 token(net 优先,无 ledger 时本地估计)、块数、缓存命中、请求数可选。想换指标(如 gross vs net)现在说。
    4. 「最右边状态栏」:pi 只有 setWidget(编辑器上/下,非严格右侧),其他客户端无右侧接缝——建议底部状态栏为主形态,宽区为加分项而非硬要求。

    拍板后我从 Phase 0 开始(PR 引用本 issue)。

  2. ranxianglei commented on Oct 2, 2026

    @ranxianglei
    OwnerAuthor

    你无论分几个阶段 都只有1 pr 继续

  3. ranxianglei commented on Oct 2, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 完成 —— PR 已开:https://github.com/ranxianglei/billion-context/pull/1927(单 PR 含全部阶段,按你的拍板)。

    做了什么:每个客户端在自己的最宽可用界面上看到压缩状态,且所有界面打印的都是同一条代理渲染的行(GET /__bili/plugin/status 新增 stats + 预渲染 statusLine.{min,med}),客户端只负责输出,数字永不漂移。

    各客户端落点:

    • pi / omp —— 常驻底部状态栏:ctx.ui.setStatus("billion-context", …)(带 key 槽位,不碰其他扩展),模型回合结束(turn_end/agent_end)与压缩后刷新,会话切换同步清除(in-flight 刷新有代际守卫,不会复活旧行);没有该接缝的旧宿主静默降级
    • Claude Code —— 底部状态行:bili plugin install claude 写入受管 statusLine 条目(<node> <root>/dist/index.js statusline),新 CLI 从 stdin 拿会话 id、打印 min 行;任何错误都空行退出 0,绝不让 claude 失败;用户自己的 statusLine 安装/卸载都不碰
    • opencode V1/V2、dsh、codex/kimi/hermes/zcode —— 按需 /acp + acp_status 工具 + web 深链(插件 API 无持久状态栏接缝,dsh 闭源)
    • gemini/iflow/qwen 等纯启动器客户端 —— web UI(http://localhost:8787)即看板
    • CLIENTS.md + CLIENTS.zh-CN.md 已加每客户端适配矩阵(中英同步)

    行格式(min 档 ≤60 字符):bili 11% 96k/869k · saved 1.7M · 35blk · cache 96%;med 档加请求数与 nudge 进度(nudge 12k/50k);saved 有折叠后取台账净盈亏(可为负),否则本地估计带 ~;数据缺的段单独缺席,不出占位符。完整细节不变:/acp 面板 / acp_status / web 会话页(含缓存曲线)。

    与 triage 方案的偏差(如实报告):"opencode 瞬时 toast"未实现——opencode 插件 API 只有 tui.toast.show 订阅侧,没有可验证的发射 API,且 2.x API 面明确不稳定(CLIENTS.md caveats),写未验证的发射调用是猜测;opencode 保留既有三件套。dsh 同理保持文档化。


    结构化七问:

    1. 是什么问题:功能缺口——压缩状态此前只有全量 /acp 面板和 web UI 两个出口,窄界面(底部状态栏这类)没有紧凑形态,多数客户端没有任何常驻看板。
    2. 什么原因导致的:不是缺数据(代理端 stats + 缓存台账 + 内核 panel 全都有),是缺一层"按空间大小挑指标"的紧凑渲染,以及各客户端到该数据的接线——数据层与展示层之间没有契约。
    3. 怎么修复的:把渲染器放在代理端(单一 canonical renderer,分 min/med 档),经既有 status 端点下发;客户端适配器只做"打印代理渲染好的内容",从机制上消灭跨客户端格式漂移;CLI 类(claude)走受管配置块、进程内类(pi/omp)走宿主事件接缝,全程 inert-safe 降级。
    4. 是否有回归问题:端点响应纯增量(既有字段逐字节不变,phase 分支未动);pi/omp 仅多订阅两个事件,宿主不发即惰性;claude 受管块对 foreign statusLine 一律 report-and-skip(装与卸都不动用户值)。typecheck/build/定向测试全绿(126 pass / 0 fail / 8 skipped-live)。一处披露:omp identity register failure throttles(tests/plugin-agent.test.ts:2066)在本机高负载下偶发失败——stash 掉本 diff 在干净 master 上同样失败,属预存时序敏感测试(500ms 节流窗 vs 共享机器迭代延迟),非本 PR 引入,CI 为准。
    5. 是否破坏缓存:不涉及。统计路径严格只读(buildStatusLineStats 刻意不调用会写 metadata 的 getCacheLedger);wire 零改动,prefix cache、重试、去重键全部不受影响。
    6. 是否改了设计方向:没有。代理仍是唯一压缩权威;渲染放代理端正是为了守住这个方向(客户端零逻辑)。
    7. 是否引入了新的配置:零新增配置字段——无 config.json 键、无新 BILI_* env、无新 flag(statusline 子命令本身复用既有 --origin/BILI_MCP_PROXY 通道);claude 受管块多一个机器自管键,走既有 [native] claude: three-mode alignment (proxy / launcher / native plugin) + runtime-info #964 never-clobber 规则。

    合并判定建议:可合(CI 绿后)。合并动作按规矩由你来。

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions