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 用量与调用次数，挂载于侧边栏底部展示今日用量，点击打开详情面板。

功能

侧边栏底部今日统计，宽列与 56px rail 自适应展示
详情面板按概览、日期、会话、模型、设置组织
模型统计重定向：在设置页配置「把某个供应商的某个模型的用量算到另一个供应商的某个模型名下」，模型页按规则归并展示（账本原始数据不变）
OpenCode Go 额度，展示滚动 5 小时、本周、本月三档剩余额度
DeepSeek 余额，展示多币种余额
Z.ai 额度，展示滚动 5 小时与本周百分比，以及每月 Web 搜索次数
会话标题旁 session-id 徽标，悬停浮现复制按钮（设置页可关，默认开）

侧边栏底部

_概览	_日期
_会话	_模型
_设置

安装与卸载

本插件为标准 cordis 组合包，通过 profile 注入 web。

从 npm 安装

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

从 GitHub 安装

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

从 tarball 安装

dsh plugin --profile web add https://github.com/xfqz86/dsh-usage-stats/releases/latest/download/xfqz86-dsh-usage-stats.tgz

固定地址，始终指向最新 Release 的 tarball。

本地开发

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

卸载

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

设置

设置位于详情面板的设置 Tab，保存在 DSH 的配置文件 ~/.dsh/settings.yaml（$DSH_HOME 改变时随之变化）的 usage-stats 段里，换浏览器、换设备登录同一台 DSH 都用同一份偏好。按 DeepSeek 余额、OpenCode Go 额度、Z.ai 额度、模型统计重定向、会话自上而下排列。

启用 DeepSeek 余额监控与侧边栏展示，关闭监控则停止轮询，面板与侧边栏均不展示
启用 OpenCode Go 额度监控与侧边栏展示，仅控制芯片，面板内详情仍可见
启用 Z.ai 额度监控与侧边栏展示，逻辑同上
各额度抓取间隔均为默认 5 分钟，下限 3 分钟
会话标题旁显示会话 ID（默认开启，支持悬停复制），关闭后标题右侧不再挂徽标

配置文件里只写改过的字段，例如把 Go 额度抓取间隔改成 10 分钟：

usage-stats:
  goFetchMinutes: 10

旧版本把设置存在浏览器本地存储里，升级后首次打开会把旧设置自动写进配置文件，之后不再使用浏览器存储（服务端设置不可用时旧值会保留，不会丢）。

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

需展示额度时，在 DSH 凭据中心配置对应 Key：

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