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（前者优先）
统计口径
- 数据源为携带
data.usage 的记录：对话调用 assistant/message，压缩上下文的调用 compaction/summary
total = input + output + cacheRead + cacheWrite，reasoning 单列- 按模型维度取
provider 与 model（对话调用在 message.source，压缩调用在事件顶层），缺失记为 unknown
- 按会话维度记录标题、工作目录、创建与最近活跃时间
- 按本地自然日划分日期
- 不含会话标题自动生成等辅助调用的用量：dsh 只记录这类调用的请求，不记录返回的用量
数据存储
账本位于 $DSH_HOME/storages/dsh-usage-stats/ledger.sqlite，SQLite 存储。首次启动自动扫描历史会话并导入，后续随事件实时增量更新，重启后可从账本恢复。
开发者
- 工程规范见
AGENTS.md；架构、数据流与统计口径见 docs/ARCHITECTURE.md
- 风格经验（lint 之外的统一约定）见
docs/STYLE.md
- 接口协议见
docs/API.md
- 模块结构见
docs/STRUCTURE.md，由 pnpm tree 生成
- 发布流程见
.agents/skills/release/SKILL.md（发版技能，可直接加载执行）
- 更新日志见
CHANGELOG.md，每次发版同步记录功能更新与 Bug 修复
License
MIT
