Name: dsh-usage-stats
Author: xfqz86

Installer

dsh plugin --profile web add github:xfqz86/dsh-usage-stats

README

dsh-usage-stats — DSH 用量统计插件

DSH 的 Web 用量统计插件，按模型、会话、日期三个维度统计 token 用量与调用次数，挂载于侧边栏底部展示今日用量，点击打开详情面板。

功能

侧边栏底部常驻今日用量，宽列与收起状态自适应展示；点击打开详情面板
概览：今日与总计、每日热力图，以及下面三项额度卡片
按日期、会话、模型分别统计 token 用量
日期页每行末尾点「明细」，弹窗看这一天分别花在哪些会话、哪些模型上
模型页每行末尾点「明细」，弹窗看这块模型的每日用量与用它的会话
会话页主会话行末尾点「明细」，弹窗看这条会话的用量按日期、按模型摊开，子会话一并计入
模型统计重定向：可以把某个供应商的某个模型的用量算到另一个供应商的某个模型名下
DeepSeek 余额，展示多币种余额
OpenCode Go 额度，展示滚动 5 小时、本周、本月三档已使用额度
Z.ai 额度，展示滚动 5 小时、本周已使用额度，以及每月 Web 搜索次数
关于页：版本、数据与隐私说明、常用链接，以及检查更新；发现新版本可查看更新说明并一键升级，当前版本领先线上时显示「本地版本较新」
会话标题旁 session-id 徽标，支持一键复制

界面截图

侧边栏底部：


概览	日期	会话	模型	设置

安装与卸载

在 DeepSeek Harness 网页版或桌面版中安装

在 添加插件 向导的「包名或地址」输入框中填写 @xfqz86/dsh-usage-stats，然后点击安装：

Add_plugin_wizard

你也可以填入 github:xfqz86/dsh-usage-stats#release，来体验最新代码（可能包含未开发完成的功能）。

使用 `dsh` CLI 安装

# 安装最新发行版
dsh plugin --profile web add @xfqz86/dsh-usage-stats

# 安装最新代码版本（可能包含未开发完成的功能）
dsh plugin --profile web add github:xfqz86/dsh-usage-stats#release

更新插件

dsh plugin --profile web update @xfqz86/dsh-usage-stats

也可以打开面板的「关于」页点「检查更新」：发现新版本会直接提示，点开能看到这一版的更新说明；点「立即升级」会在后台装上最新版，装好后重启一次 DSH 生效。

本地开发

git clone https://github.com/xfqz86/dsh-usage-stats.git
cd dsh-usage-stats
pnpm install --frozen-lockfile
pnpm build
dsh plugin --profile web add "link:$(pwd)"
# 后续改动后重新 pnpm build，浏览器刷新即可；服务端改动需重启 dsh

卸载

dsh plugin --profile web remove @xfqz86/dsh-usage-stats

设置

设置位于详情面板的设置 Tab，保存在 DSH 该 profile 的配置文件 $DSH_HOME/profiles/<profile>/cordis.patch.yml（$DSH_HOME 未设置的情况下默认为 ~/.dsh）的 usage-stats 条目里。配置文件只写改过的字段。

设置 Tab 可改：三项额度监控的开关、是否在侧边栏展示、抓取间隔（最短 3 分钟），会话标题旁 session-id 徽标开关，以及模型统计重定向规则。

设置 Tab 的「配置迁移」折叠区可以把当前偏好导出成一串配置串（Base64 文本，直接复制粘贴即可），在别的机器、别的 profile 的设置 Tab 里粘贴导入：导入以配置串为准整份覆盖，配置串里没有的项回到默认值，适合备份还原与两台机器对齐。

设置 Tab 底部的「账本操作」折叠区为清零与重建，需二次确认；扫描历史会话期间（面板顶部显示“扫描中…”）两项置灰不可点，等扫描结束自动恢复。

需展示额度时，在 DSH 凭据中心配置对应 Key（同名多项时按顺序取第一个配好的）：

DeepSeek：DEEPSEEK_API_KEY（也认 DEEPSEEK_APIKEY、DEEPSEEK_API_TOKEN、DEEPSEEK_TOKEN）
OpenCode Go：OPENCODE_GO_API_KEY
Z.ai：ZAI_CODING_CN_API_KEY 或 ZAI_API_KEY（前者优先）