dsh-token-usage：DeepSeek Harness 本地 Token 用量看板

DeepSeek Harness 是本地智能体开发环境。开发者需要监控 Token 消耗。该插件解决此问题。

插件简介¶

dsh-token-usage 是面向 DeepSeek Harness 的本地用量看板插件。它由 xbyzzZ 维护，遵循 MIT 许可证。

核心功能¶

数据源：只读 $DSH_HOME/sessions 里的 session.l.zstd。
时间范围：按最近 30 天汇总 provider 回报的 token usage。
界面入口：在 Web 侧栏设置上方放入口，点击打开用量弹窗。
展示形式：热力图 + 按模型表。
技术实现：独立 bundle 插件，不改 DSH 源码，不引入 SQLite。
主题支持：支持暗色/浅色模式。

安装与配置¶

进入插件目录后执行安装命令：

dsh plugin --profile web add .

这会在 $DSH_HOME/profiles/web 用 pnpm 装上插件，并追加进 package.json 的 dsh.profile.bundles。安装后重启 DSH，左下角设置上方会出现「用量」入口。

若 dsh plugin add 报错 pnpm v11.12.0 is a broken release，这是 profile 的 packageManager 钉死了坏版本。需将 $DSH_HOME/profiles/web/package.json 里的 pin 改为 pnpm@11.22.0（或更新的可用版本），再执行安装命令。

插件自带 cordis.patch.yml。若要覆盖配置，需整段重写 config：

- insert:
    - id: dsh-token-usage
      name: dsh-token-usage
      config:
        days: 30
        maxFiles: 4000
        maxFileBytes: 33554432

界面与用法¶

入口：Web 侧栏设置按钮上方。

弹窗内容：
* 最近 30 天热力图。
* 新产生 / 有用量的天 / 会话数量。
* 热力图颜色：浅色模式为白到蓝，暗色模式为黑到蓝；无用量为白 / 黑。
* 模型表：包含 provider + 模型名、步数、输入、输出、缓存读、缓存写、推理。
* 空数据：还没有带 usage 的会话。
* 失败：读不了本地 JSONL，可再扫一次。

数据口径¶

统计对象：只统计会话日志里的 assistant/message.usage（同 turn/step 后写覆盖前写）。
新产生计算：inputTokens + outputTokens + cacheWriteTokens。
独立列表：缓存读、推理单独列表，不并进热力图主数字。
旧会话：没有 usage 的旧会话不按字数估算。

技术注意事项¶

运行环境：需要 Node >= 22。
Profile 限制：Host 在没有 connection 的 headless profile 里不会注册 RPC。
数据获取：Web profile 会通过 /token-usage 的 summary 接口取数。

结语¶

该插件为 DSH 本地开发提供了轻量级的用量监控能力。更多细节与源码可查阅插件目录或GitHub 仓库。