前言¶

DeepSeek Harness（下文简称 dsh）是 DeepSeek AI 开源的智能体运行时，架构口号是「Everything is a Plugin / 一切皆插件」。模型、工具、会话、沙箱和界面都可以拆成插件来组合。日常用它写代码、跑任务时，用量其实一直在涨：每个回合消耗多少 Token、缓存命中高不高、哪个工作区最烧额度，默认界面并不集中展示。

GitHub 贡献图那种 53 周绿格子，很多人已经习惯用它判断「这周有没有在干活」。Make0209 维护的社区插件 dsh-usage-stats，就是把类似的活跃格子，加上 Token、缓存命中、账户余额和工作区别名，装进 dsh Web 端的设置页。

需要先说明两点。第一，DeepSeek Harness 插件目录 是社区独立站点，和 DeepSeek / 幻方没有官方从属关系。第二，官方仓库目前仍标注 developer preview，接口可能不兼容。本文按 2026 年 8 月 18 日打开的目录详情页、GitHub 仓库 README 与源码交叉核对，不编造使用反馈。

这是什么¶

dsh-usage-stats 是面向 DeepSeek Harness Web 端的用量看板插件，目录分类为「工具与能力」，许可证 MIT，主要语言 JavaScript，package.json 中的版本号为 1.0.0。维护者是 Make0209。截至 2026 年 8 月 18 日，GitHub 仓库 star 数为 17。

一句话定位：扫描本机持久化会话日志，按已注册工作区聚合回合次数和 Token，在设置面板里画出 53 周 GitHub 风格热力图，并附带余额查询与工作区别名。

GitHub 上还有其他同名仓库，功能和安装命令并不相同。本文只写 Make0209/dsh-usage-stats。安装时请带上完整仓库路径，不要只凭插件名搜索。

核心功能¶

仓库 README 和源码对得上的能力，可以分成下面几块。

1、53 周用量热力图。格子配色接近 GitHub 绿，按「完成一个回合点亮一次」计数，口径包含子代理会话。颜色分五档：0 次、1 次及以上、3 次及以上、6 次及以上、10 次及以上。鼠标悬停某一天，会按工作区列出当日回合次数，以及输入 / 缓存命中 / 输出 Token。点击工作区芯片可以筛选热力图和明细表。

2、统计卡片。页面默认展示：总花费 Token（输入、缓存命中、输出、推理分项）、缓存命中率、账户余额、各工作区 Token 花费进度条（先列出用量最高的 3 个）、总使用次数、连续使用天数。缓存命中率按 cacheRead / (input + cacheRead) 计算。卡片数字首次加载时有滚动动画，界面跟随 Web UI 的亮暗主题。

3、时间范围。右上角可以在「近 30 天」「近 90 天」「全部」之间切换，默认是近 90 天。热力图本身固定覆盖约 53 周；30 / 90 天主要影响卡片汇总和工作区明细表。

4、工作区别名。头部有「✎ 工作区别名」按钮。别名写入 $DSH_HOME/storages 里的 KV 单元 usage-stats-aliases，卸载或重启后仍在。单个别名最长 80 个字符；回车保存一项，清空输入框则恢复文件夹名，也可以一次性全部保存。

5、数据来源。使用次数和 Token 全部来自 dsh 持久化会话日志，Host 半读取 turn/end 与 assistant/message.usage，并监听 session/event 做实时折叠。插件激活时会回填历史，卸载或重启不会丢掉这些日志。只统计能按会话 cwd 匹配到已注册工作区的会话，匹配不上的不会出现在图上。

6、账户余额。余额走 DeepSeek 开放平台的 https://api.deepseek.com/user/balance，复用 llm-deepseek 的 API Key 配置，插件自己不另存一份密钥。未配置 Key 时卡片会显示引导文案。查询结果默认缓存 5 分钟；页面上的「刷新」会带 force=1 强制再查。

插件包声明了 dsh.bundle manifest 和 Web client 半，package.json 里 dsh.client.platform 为 web。Host 半在 lib/index.js，Client 半在 lib/client.js，通过设置面板槽位 settings.section 注册名为「用量统计」的一页。README 写明包内无第三方依赖：Host 只用 Cordis 服务，Client 只用模块表提供的 React。

安装与启用¶

目录页给出的安装命令如下，在 DeepSeek Harness 终端里运行即可。dsh CLI 会从 GitHub 解析插件并装进当前配置：

dsh plugin add github:Make0209/dsh-usage-stats

这是社区插件，会以当前 dsh 进程的权限运行，安装时可能执行代码。装之前先看仓库源码和 MIT 许可证。需要可复现安装时，把 commit 哈希钉死。仓库 main 分支在 2026 年 8 月 14 日的最新提交是 8992d306cdca8857b4362868d591fde3689765b0：

dsh plugin add github:Make0209/dsh-usage-stats#8992d306cdca8857b4362868d591fde3689765b0

仓库 README 另外给了一条针对 Web profile 的写法，和这个插件的 platform: web 声明一致。如果当前默认 profile 不是 web，可以用这一条：

dsh plugin --profile web add dsh-usage-stats

README 的说明是：安装后刷新页面即可，不必手改配置、也不必重启 dsh。如果是本地目录调试，README 还提供了手动注册步骤：在 $DSH_HOME/profiles/node_modules/ 下做符号链接（Windows 用 junction），再往 $DSH_HOME/profiles/web/cordis.patch.yml 插入：

- insert:
    - id: usage-stats
      name: dsh-usage-stats

用户 patch 层会热重载，保存后再刷新页面。

典型用法¶

装好并刷新 Web UI 之后，按下面顺序就能看到数据。这些步骤对应 README 和 lib/client.js 里的界面，不是额外编出来的操作手册。

1、打开设置，进入「用量统计」。Client 半把页面挂在 settings.section 槽位，标签就是这四个字。首次进入可能显示「正在加载用量统计…」，随后会出现历史回填进度条，文案类似「正在统计历史会话 scanned / total」。扫描结束后进度条消失。

2、看卡片和热力图。如果本机还没有能归属到工作区的会话，页面会提示「还没有使用记录。开始对话后，这里会点亮。」有数据时，上方是六张卡片，下方是 53 周格子和工作区明细表。明细表列回合、输入、缓存命中、输出、推理、合计、命中率和占比。

3、切换时间范围。点「近 30 天」「近 90 天」或「全部」。热力图格子仍按 53 周排布；卡片上的 Token、命中率、回合数，以及明细表，会按所选窗口重算。

4、悬停和筛选。把鼠标放在某个格子上，能看到该日各工作区的次数和 Token。点热力图上方的工作区芯片，或点明细表某一行，可以只看这个工作区；再点一次取消筛选。

5、改工作区别名。点「✎ 工作区别名」，给已注册工作区填项目名，回车保存单项，或点「全部保存」。别名会出现在芯片、悬停提示和明细表标题上，底层路径仍保留。

6、看余额。已在 dsh 里配好 DeepSeek API Key 时，卡片会显示币种和金额（源码按 CNY / USD 格式化）。没配 Key 时不会报错退出，只是卡片处于缺密钥状态。点「刷新」会强制再查一次余额，同时刷新统计快照。

Host 半对外暴露的数据路由也可以对照源码理解页面从哪取数，一般不用手工调用：

• GET /api/usage-stats：统计快照（含扫描进度、按日数据、工作区汇总、别名）
• GET /api/usage-stats/balance?force=1：账户余额
• POST /api/usage-stats/alias：设置工作区别名

适用场景与注意事项¶

这个插件适合已经在用 dsh web、并且希望把本机会话用量看清楚的人：要核对缓存命中是否生效、比较多个工作区的 Token 占比、或者只是想用一张年历图回顾自己最近有没有持续在用 dsh。它不做计费账单导出，也不统计未注册工作区里的会话。

使用前注意下面几条，都来自 README 或源码，不是推断。

1、运行权限。插件以当前 dsh 进程权限运行，安装时可能执行代码。装之前检查 源码仓库 和 MIT 许可证。

2、只覆盖能匹配工作区的会话。统计按会话 cwd 去对已注册工作区路径。cwd 为空、或对不上任何工作区的会话，不会进入热力图和明细。

3、面向 Web UI。package.json 声明 client platform 为 web，设置页也只挂在 Web 端。纯终端 / TUI 用法不在这个插件的范围内。

4、余额查询的环境依赖。用量统计本身读本地日志，不需要联网。余额则要有 API Key，并且 Host 半会拉起 curl.exe 或 powershell.exe 去请求官方接口。当前实现明显偏向 Windows；在没有这两条命令的环境里，热力图和 Token 卡片仍可用，余额卡片可能一直失败。

5、同名插件不要装错。社区里至少还有其他 dsh-usage-stats 仓库，有的做多供应商余额，有的做 CSV 导出。目录页安装命令带的是 github:Make0209/dsh-usage-stats，以这一条为准。

6、dsh 仍在快速迭代。官方 README 写明 developer preview，可能出现破坏性变更。钉死 commit 比始终跟踪 main 更容易复现。

小结¶

dsh-usage-stats 把 GitHub 贡献图那套 53 周格子搬进了 DeepSeek Harness 的设置页，并补上 Token 分项、缓存命中、连续使用天数、工作区别名和（在 Key 可用时）官方余额。数据来自本机会话日志，安装后会回填历史，不另搞一套账本。

它是 Make0209 维护的 MIT 社区插件，不是 DeepSeek 官方应用商店里的条目。目录页和仓库地址如下，安装前建议对照源码再执行命令：

• 目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-usage-stats-make0209/
• GitHub：https://github.com/Make0209/dsh-usage-stats
• DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness