🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
广告☁️ 云服务器特惠阿里云首购 8 折 · 腾讯云合作特惠
DeepSeek Harness Hub
← 返回列表

xfqz86/dsh-usage-stats

DeepSeek Harnessspec-screened扫描:低风险在 GitHub 查看 ↗
⚠ 装前注意

DSH Web 插件:侧边栏中的 Token 使用统计

基本兼容但装前注意:未发布到 npm registry,仅可从源码安装 · 最近上游提交 2026/9/24 · 已提供中文文档
综合分
31.5
GitHub 分
31.5
用户评分
—
★ Stars
2
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add xfqz86/dsh-usage-stats
未发布到 npm registry,仅可从源码安装,改用 GitHub 源安装
信任档位:仅索引本站尚未对其实装验证,仅收录元数据
是什么
dsh 原生插件 · tool
装得上吗
静态安装检查有提示项,装前建议看一眼 README
安全吗
本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
还在维护吗
活跃:最近一次提交在 1 天前

档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →

数据截至 2026/9/25(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查⚠ 装前注意

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包@xfqz86/dsh-usage-stats(未发布到 npm,仅可源码安装)
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

未发布到 npm registry,仅可从源码安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/21 23:35:52

依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/cordis-plugin-loader@deepseek-ai/cordis-plugin-timer@deepseek-ai/dsh-api-gateway@deepseek-ai/dsh-api-remotes@deepseek-ai/dsh-app-boot@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-ui-conversation@deepseek-ai/dsh-client-ui-primitives@deepseek-ai/dsh-client-ui-renderer@deepseek-ai/dsh-client-ui-session
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

由 DeepSeek 最新模型翻译生成
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 该 profile 的配置文件 ~/.dsh/profiles//cordis.patch.yml($DSH_HOME 改变时随之变化)的 usage-stats 条目里,换浏览器、换设备登录同一台 DSH 都用同一份偏好。按 DeepSeek 余额、OpenCode Go 额度、Z.ai 额度、模型统计重定向、会话自上而下排列。

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

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

- id: usage-stats
name: '@xfqz86/dsh-usage-stats'
config:
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

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入社群

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

DPharness QQ 群二维码,QQ 扫码进群
QQ 扫码进群
DPharness 飞书群二维码,飞书扫码进群
飞书扫码进群