dsh-usage-stats DSH 插件

该插件在 DSH Web 界面中增加用量统计页面，包含 53 周热力图、Token/缓存/余额看板以及工作区别名管理。所有数据来自持久化会话日志，安装后自动回填历史。

如何安装 dsh-usage-stats DSH 插件

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

复制不会执行命令。安装 dsh-usage-stats DSH 插件前请核对仓库和版本。

dsh-usage-stats DSH 插件数据来源

dsh-usage-stats DSH 插件快照日期：2026年8月16日

discovered

dsh-usage-stats DSH 插件能做什么

53 周 GitHub 风格热力图，按工作区显示每日使用次数
统计卡片：总 Token 数、缓存命中率、账户余额、连续使用天数、各工作区 Token 进度条
工作区别名管理，持久化保存
时间范围切换（近 30 天 / 近 90 天 / 全部）
亮暗主题自适应及动画效果

dsh-usage-stats DSH 插件适合哪些场景

追踪不同工作区每日使用强度
监控 Token 消耗和缓存命中率以优化提示词
在 DSH 页面内直接查看账户余额
为工作区设置友好别名，便于管理

dsh-usage-stats DSH 插件适合谁

希望可视化用量统计的 DeepSeek Harness 用户
管理多个工作区并关注 Token 成本的开发者

dsh-usage-stats DSH 插件的限制

仅统计能归属到已注册工作区（按会话 cwd 匹配）的会话
余额查询需要配置 DeepSeek API Key，未配置时显示引导文案
插件仅支持 DSH 的 web profile

dsh-usage-stats DSH 插件的仓库 README 摘录

以下文字摘自 dsh-usage-stats DSH 插件的上游仓库 Make0209/dsh-usage-stats 的 README，版权归原作者，仅作引用。

DeepSeek Harness 插件：GitHub 风格用量热力图 + Token / 缓存命中 / 账户余额看板 + 工作区别名管理。 - **热力图**：53 周 GitHub 绿，每完成一个回合点亮；悬停按工作区显示次数明细与当日 Token - **统计卡片**：总花费 Token（分项）、缓存命中率、账户余额（DeepSeek 官方接口）、总使用次数、连续使用、各工作区 Token 进度条 - **工作区别名**：头部「✎ 工作区别名」管理，持久化保存（`$DSH_HOME/storages` 的 KV 单元 `usage-stats-aliases`） - 时间范围切换（近 30 天 / 近 90 天 / 全部）、动画、亮暗主题自适应 ## 效果截图 ![用量统计页面效果截图 1](assets/screenshot-1.png) ![用量统计页面效果截图 2](assets/screenshot-2.png) ## 安装本插件是标准的 DSH 社区插件包（声明 `dsh.bundle` manifest + web client 半），数据全部来自持久化会话日志，安装后自动回填历史。 ### 方式一：官方插件命令（推荐） ```bash dsh plugin --profile web add dsh-usage-stats ``` 安装后刷新页面即可，无需手动改配置、无需重启。 ### 方式二：手动注册（本地包） 1. 把本目录放入任意位置，并在 `$DSH_HOME/profiles/node_modules/` 下创建指向本目录的符号链接（Windows 用 junction）： ```powershell New-Item -ItemType Junction -Path "$env:DSH_HOME\profiles\node_modules\dsh-usage-stats" -Target "<本目录绝对路径>" ``` 2. 在 `$DSH_HOME/profiles/web/cordis.patch.yml` 添加一行： ```yaml - insert: - id: usage-stats name: dsh-usage-stats ``` 用户 patch 层会被热重载：保存后刷新页面即可。 ## 架构 - **Host 半**（`lib/index.js`）：扫描持久化会话日志聚合用量（`turn/end` + `assistant/message.usage`），监听 `session/event` 实时折叠；通过 `webServer` 服务注册数据路由： - `GET /api/usage-stats` — 统

阅读完整 README仓库许可: MIT

dsh-usage-stats DSH 插件常见问题

如何安装 dsh-usage-stats？

在终端中运行 `dsh plugin --profile web add dsh-usage-stats`，然后刷新 DSH 网页页面即可。无需手动修改配置或重启服务。

安装后在哪里查看热力图？

插件会在设置面板中添加一个“用量统计”页面。在 DSH Web 界面的侧边栏中寻找名为“Usage Stats”的新区域即可进入。

查看余额需要配置 API Key 吗？

是的，余额查询复用 `llm-deepseek` 的 API Key 配置。如果未设置 API Key，余额卡片会显示引导文案，而不是实际余额。

卸载插件后使用数据会丢失吗？

不会。所有使用数据都来自 DSH 的持久化会话日志。插件只是读取并聚合这些日志，卸载只移除 UI 界面，底层数据仍然保留。

能否用这个插件重命名工作区？

可以。插件在统计页面顶部提供了“✎ 工作区别名”管理功能。别名会持久化保存在 `$DSH_HOME/storages` 的 `usage-stats-aliases` KV 单元中。