dsh-token-usage

面向 DeepSeek Harness 的本地用量看板插件。

它只读 $DSH_HOME/sessions（默认 ~/.dsh/sessions）里的 session.jsonl.zstd，按最近 30 天汇总 provider 回报的 token usage，并在 Web 侧栏 设置上方 放一个入口。点击后打开用量弹窗：热力图 + 按模型表。

这是独立 bundle 插件，不改 DSH 源码，不替换整条侧栏，不引入 SQLite。

官方插件规范：

• 工具插件开发
• 发布规范
• Cordis 基础

界面

• 入口：sidebar.footer.action，在设置按钮上方
• 弹窗：最近 30 天热力图、新产生 / 有用量的天 / 会话
• 热力图：浅色白到蓝，暗色黑到蓝；没有用量为白 / 黑
• 模型表：provider + 模型名、步数、输入、输出、缓存读、缓存写、推理
• 空数据：还没有带 usage 的会话
• 失败：读不了本地 JSONL，可再扫一次

数字口径

只统计会话日志里的 assistant/message.usage（同 turn/step 后写覆盖前写）。

• 新产生 = inputTokens + outputTokens + cacheWriteTokens
• 缓存读、推理单独列表，不并进热力图主数字
• 没有 usage 的旧会话不按字数估算

安装

进入这个插件目录后执行：

dsh plugin --profile web add .

也可以传绝对路径：

dsh plugin --profile web add /path/to/dsh_dashbord

这会：

1. 在 $DSH_HOME/profiles/web 用 pnpm 装上 dsh-token-usage
2. 把它追加进 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

开发

node --test test/*.test.js

Host 在没有 connection 的 headless profile 里不会注册 RPC；Web profile 会通过 /token-usage 的 summary 接口取数。