上下文用量面板 mounta1n-18/dsh-context-usage

dsh-context-usage

一个 DeepSeek Harness 的 Web 插件：把「这条对话到底把上下文烧到哪了」做成一屏可读的可视化面板 —— /context 斜杠命令、作曲器里的占用按钮、以及 composer 上方的用量总览。

对标 Claude Code 的 /context：同样的分段占用 + 容量占比，但补齐了它在 DSH 里缺失的部分 —— 累计计费用量、轮数/步数/输出速度、账户余额。

面板截图

它解决什么

DSH 原生的上下文信息散落在作曲器下方那条底栏里：一个圆环 + 三个计费药丸。你知道「用了多少」，但不知道 用在哪（系统提示词？工具定义？对话历史？），也看不到本会话的累计消耗和速度。

这个插件把那些数字集中成一块面板，并把官方底栏整行隐藏、把纵向空间还给对话区（隐藏项全部有去处，见下）。

功能

- /context 斜杠命令 —— 带插件自有的图标与中文简介，一键开合面板
- 占用按钮 —— 作曲器控件行（发送键与模型选择器之间）的 ◔ 67%，实时跟随，点击开合
- 用量面板 —— 作曲器上方，四块信息并排：
- 总览：三段圆环 + 666.1K / 1M + 占比 + 轮数 · 步数 · tok/s
- 占用图：36×5 的方块阵列，按 系统 / 工具 / 消息 三类着色，其余为自由空间
- 本会话累计：未命中 / 命中 / 命中率 / 输出（provider 计费口径）
- 图例：系统提示词 / 工具定义 / 对话消息 / 自由空间 的色块与数值
- 余额药丸 —— 作曲器右侧显示账户余额，前台每 10 秒刷新，悬停显示取样时间；未登录/无钱包/接口异常都有明确状态
- 零依赖、无构建 —— 手写纯 JavaScript，只 require('react')，样式只用宿主主题 token。没有 src/、没有 pnpm install、没有 pnpm run build

安装

安装只能通过 DSH 的 plugin_manager 工具完成 —— 这是官方唯一支持的路径（官方技能明确禁止手改 profile 的 package.json / cordis.patch.yml，也禁止在 profile 里自己跑 pnpm）。

开发模式（文件夹链接，改代码即时生效）：

plugin_manager { "action": "install_bundle", "target": "<本仓库的绝对路径>" }

发布模式（tarball 独立副本，本体可删可移）：

powershell -File scripts\pack.ps1 # 生成 local-dsh-context-usage-<version>.tgz

plugin_manager { "action": "install_bundle", "target": "<tgz 的绝对路径>" }

装好后敲 /context，或点作曲器右下角（模型选择器与发送键之间）的 ◔ xx% 按钮。

完整的验证 / 升级 / 卸载 / 迁移步骤见 INSTALL.md（那份是写给 agent 读的）。

它隐藏了官方底栏，那些信息去哪了

挂载时本插件会整行隐藏作曲器下方那条官方底栏（原版占用圆环 + 轮/步/速度药丸 + 计费用量药丸），信息全部有去处：

| 官方底栏 | 去向 |
| 占用率圆环 | 面板总览 + 作曲器占用按钮 |
| 未命中 / 命中 / 输出 / 计费 | 面板「本会话累计」 |
| 轮数 / 步数 / 输出速度 | 面板总览第三行 |
| 账户余额 | 作曲器控件行（占用按钮右侧） |

官方没有可用的开关 —— ui-conversation 的 Config 只有 busyEnter 一项；conversation.input.activity 槽虽然能抑制圆环，但同一处 hidden: activity 会把模型选择器和本插件按钮一起藏掉。

所以实现方式是本插件自有的一张样式表，作用域由本插件放进该 dock 的锚点元素限定：

[class$="_dock"]:has([data-context-usage="composer-dock-anchor"]) { display: none !important }

- 只可能命中本插件锚点所在的那个 dock，不会波及其他面板
- 想恢复官方底栏：把 client.js 里的 HIDE_SHIPPED_DOCK 改成 false
- 依赖 _dock 这个 CSS Module 命名后缀，DSH 大版本升级后需要复核一次

数据来源与口径

数据全部来自宿主已有的投影，没有自算、没有埋点、不发额外请求：

| 面板元素 | 来源 | 口径 |
| 容量 / 占用 | contextPressure.contextWindow、pressureTokens | provider 每次请求上报，换模型自动跟随，包内不硬编码容量 |
| 系统 / 工具 / 消息 | contextBreakdown | 见下方说明 |
| 未命中 / 命中 / 命中率 / 输出 | tokenUsage | provider 上报的计费口径（本会话累计） |
| 轮数 / 步数 / 输出速度 | sessionStats | 宿主统计 |
| 余额 | ctx.remote.account.getBalance | 宿主直连 Platform，宿主侧无缓存 |

两点如实说明：

1. 占用图的三段构成是估算：contextBreakdown 给出三段 token 数，但方块按「每 token 约 4 字符」折算格数，与真实 token 边界不严格等价。占用率本身（pressureTokens / contextWindow）是精确上报值。
2. 「本会话累计」与「占用图」不同源：前者是计费口径的累计值，后者是当前请求的上下文构成。两者不该互相验算，这是有意保留的。

已知边界

- 只在 Web / 桌面 GUI 里有命令面（纯客户端命令），headless / CLI 没有该命令
- 上下文容量取自 provider 上报值，模型没上报时该行按缺失处理
- 余额药丸里的 CLIENT_VERSION 硬编码为 0.2.0-rc.2（客户端插件运行时读不到 shell 版本）。DSH 升级后若平台拒收，药丸会显示 余额 接口异常·，改这一处常量即可
- 包名 @local/dsh-context-usage 里的 @local 是「只装进本机 profile、从不发布到 npm」的意思，不是真实的 npm scope；private: true 同理

目录结构

package.json # 包清单：dsh.bundle.patch（Host 行）+ dsh.client（浏览器半）+ icon + locale cordis.patch.yml # 一行 insert，把本包挂进 profile 条目树 index.js # Host 半：空壳（不注册任何东西） client.js # Client 半：全部逻辑（约 800 行手写 JS） locale/zh.json # 插件页展示的标题与描述 locale/en.json icon.svg # 插件页图标（三段圆环） scripts/pack.ps1 # 打包成可独立安装的 tarball INSTALL.md # 写给 agent 的安装/卸载/迁移说明 docs/ # README 配图

开发

改 client.js → 开发模式下页面自动热更；如果页面仍跑着旧 bundle（浏览器会按 id 去重注册），在插件管理里 disable → enable 再 Ctrl+R。Host 半（index.js）改动需要重启 DSH。

卸载

plugin_manager { "action": "remove_bundle", "target": "@local/dsh-context-usage" }

然后检查 ~/.dsh/profiles/<profile>/cordis.patch.yml，删掉 plugin_manager 追加的覆盖项：

- id: context-usage
disabled: false

开发模式下先卸载再删文件夹。详见 INSTALL.md。

License

MIT