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 大版本升级后需要复核一次

数据来源与口径

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

两点如实说明：

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

已知边界

• 只在 Web / 桌面 GUI 里有命令面（纯客户端命令），headless / CLI 没有该命令
• 上下文容量取自 provider 上报值，模型没上报时该行按缺失处理
• 余额药丸里的 CLIENT_VERSION 硬编码为 0.2.0-rc.2（客户端插件运行时读不到 shell 版本）。DSH 升级后若平台拒收，药丸会显示 余额 接口异常·<code>，改这一处常量即可
• 包名 @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