DeepSeek Harness 插件

dsh_token_usage

Local 30-day token usage heatmap for DeepSeek Harness: sidebar action above Settings, popup from session JSONL.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
xbyzzZ/dsh_token_usage
最近更新
2026年8月20日
分类
记忆
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/xbyzzZ/dsh_token_usage
插件名:dsh_token_usage
作者:xbyzzZ

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-token-usage

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

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

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

官方插件规范:

界面

![用量弹窗:30 天热力图和按模型统计](image/Snipaste_2026-08-20_11-27-54.png)

  • 入口: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.jsondsh.profile.bundles

装完重启 DSH。左下角设置上方会出现「用量」。

如果 dsh plugin addpnpm 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-usagesummary 接口取数。