deepseekplugins

DeepSeek Harness 插件

dsh-usage-stats-jianweid

DSH API 用量统计：token、请求、轮次、缓存命中、费用估算与多提供商余额/配额。（英文原文）

工具与能力
跳到安装方式

来源信息

GitHub 仓库
jianweideng0515-create/dsh-usage-stats
最近更新
2026年8月21日
分类
工具与能力
GitHub stars
3
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/jianweideng0515-create/dsh-usage-stats
插件名：dsh-usage-stats-jianweid
作者：jianweideng0515-create

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

@abcdefu_cja/dsh-usage-stats

![npm version](https://www.npmjs.com/package/@abcdefu_cja/dsh-usage-stats) ![license](./LICENSE) ![tests](https://github.com/jianweideng0515-create/dsh-usage-stats/actions)

DSH Web 的 API 用量统计插件：精确统计 token、请求、轮次、缓存命中率与费用，同时监控 OpenCode 订阅配额与 DeepSeek 官方余额。装完即用，无需任何配置。

精确计量直接读取 provider usage 报告，采用 DSH 的 (turn, step) 替换语义——非启发式估算
独立插件不属于 dsh-web-ui 家族，经官方 settings.section 槽挂载为设置页专属 Tab
多提供商余额OpenCode 配额与 DeepSeek 余额并行快照，各自失败互不影响

目录

  • [功能特性](#功能特性)
  • [截图](#截图)
  • [安装](#安装)
  • [配置](#配置)
  • [余额自动检测](#余额自动检测)
  • [架构](#架构)
  • [开发](#开发)
  • [已知限制](#已知限制)
  • [许可](#许可)

功能特性

用量概览 Tab

  • 常驻 KPI：Token 总量（含费用）、请求数、完成轮次、活跃天数、缓存命中率、提供商动态卡
  • Token 四分色拆分条（输入 / 缓存读 / 缓存写 / 输出）
  • 堆叠柱状趋势图：按模型分段着色，Y 轴中文刻度（万/亿），悬停查看当日明细；可切换 费用 / 请求数 指标
  • 模型明细表 + 最贵会话排行（费用降序 Top 10）
  • 一键导出当前范围的按日 × 分模型明细 CSV（Excel 直接打开）

模型与缓存 Tab

  • 模型占比 Donut 图 + 缓存效率诊断（命中率、节省 token、节省比例）

余额与配额 Tab

  • OpenCode 订阅配额三窗口进度条（滚动 / 每周 / 每月 + 重置倒计时）
  • DeepSeek 官方余额（金额 / 预计可用天数 / 充值页跳转 / 手动刷新）

其他

  • 会话用量面板：会话页按钮展开当前会话实时消耗
  • 日费用阈值提醒：今日费用超过 alertDailyCost 时顶部常驻横幅
  • 7 / 14 / 30 / 90 天与自定义范围；30s 轮询（ETag 条件请求，未变化 304 短路）

截图

用量概览

<img src="docs/image-20260816035032614.png" alt="用量概览 Tab：KPI 卡、Token 拆分、堆叠柱状趋势图、模型明细" width="480" />

模型与缓存

<img src="docs/image-20260816035059875.png" alt="模型与缓存 Tab：模型占比 Donut 与缓存效率诊断" width="480" />

余额与配额

<img src="docs/image-20260816035141846.png" alt="余额与配额 Tab：OpenCode 配额三窗口与 DeepSeek 余额" width="480" />

会话用量面板

<img src="docs/image-20260816035247662.png" alt="会话页用量面板：累计消耗与最近请求" width="640" />

安装

npm（推荐）

npm i @abcdefu_cja/dsh-usage-stats
dsh plugin --profile web add @abcdefu_cja/dsh-usage-stats

GitHub 克隆 / 本地开发

git clone https://github.com/jianweideng0515-create/dsh-usage-stats
dsh plugin --profile web add link:/path/to/dsh-usage-stats

安装后重启 dsh web，设置页左侧导航出现「用量统计」入口：

<img src="docs/image-20260816034838256.png" alt="设置页左侧导航中的用量统计入口" style="width: 280px;" />

配置文件方式（可选）

也可写入个人 DSH 覆盖层 ~/.dsh/config.yaml（保存即热加载）：

- insert:
    - id: usage-stats
      name: '@abcdefu_cja/dsh-usage-stats'
      config:
        enabled: true
        currency: CNY
        balance:
          mode: auto
          refreshMs: 600000

所有配置项均可选，默认值见下表。

配置

| Key | 类型 | 默认 | 含义 | |---|---|---|---| | enabled | boolean | true | 总开关 | | currency | string | CNY | 费用与余额的显示货币（¥ / $） | | alertDailyCost | number | 关 | 日费用阈值：今日费用达到该值时页面顶部渲染超限横幅 | | prices | Record<string, ModelPrice> | 内置 DeepSeek 价目 | 每百万 token 单价，按模型键覆盖内置表 | | defaultPrice | ModelPrice | 无（按 0 计） | 未在 prices 中的模型的兜底单价 | | balance.mode | 'auto' \| 'manual' \| 'off' | auto | auto 自动检测已知 provider；manual 固定端点；off 关闭 | | balance.baseUrl | string | 无 | 余额端点基址（manual 必填） | | balance.path | string | /user/balance | 追加到基址的路径 | | balance.apiKeyEnv | string | DEEPSEEK_API_KEY | 存放 API key 的环境变量名 | | balance.refreshMs | number | 600000 | 余额刷新间隔（毫秒，最小 1000） |

ModelPrice 为 { input, cacheRead, cacheWrite, output }（每百万 token，非负数）。内置 DeepSeek 价目：

模型inputcacheReadcacheWriteoutput
deepseek-chat20.528
deepseek-reasoner41416

余额自动检测

auto 模式同时检测以下 provider（端点内置，profile 无 baseURL 也可推断）：

provider端点key 环境变量展示
OpenCode GoGET opencode.ai/zen/go/v1/usageOPENCODE_GO_API_KEY订阅配额三窗口
DeepSeekGET api.deepseek.com/user/balanceDEEPSEEK_API_KEY金额余额 + 预计可用天数

key 优先进程环境变量，其次 ~/.dsh/.credentials.yaml。

架构

flowchart LR
    A["session/event 流（全局）"] --> B["宿主端 UsageStatsMeter"]
    B --> C[("dsh-usage-stats.json<br/>防抖落盘")]
    B --> D["/api/dsh-usage-stats/*<br/>loopback 围栏"]
    D --> E["浏览器端 Tab / 会话面板<br/>30s 轮询 + ETag"]
    F["OpenCode /usage"] --> G["余额客户端（并行）"]
    H["DeepSeek /user/balance"] --> G
    G --> D
  • 宿主端：订阅 session/event（全局），把每次请求折入 UsageStatsMeter，按日（本地时区）与分模型桶聚合。落盘原子写（tmp + rename，损坏转 .bak 重建）；余额客户端并行拉取全部已检测 provider，各自失败互不影响。
  • 浏览器端：设置页左侧导航独立 Tab（settings.section 槽）+ 会话页用量按钮（conversation.session.header.utilities 槽）。
  • 对模型透明：不注入提示片段、不注册工具，每请求零额外 token，无 KV 缓存影响。
  • 导出形态：inject / Config / apply，无默认导出；计量、计价、存储、查询与 provider 检测均为纯函数并有单元测试。

开发

pnpm install
pnpm build    # tsc -b && tsdown（宿主 ESM + 浏览器闭包工厂 bundle）
pnpm test     # vitest：宿主纯函数单测 + jsdom 组件测试

源码结构：

src/
├─ index.ts           # 装配：事件订阅 / 落盘 / 路由注册 / 余额定时器
├─ meter.ts           # 计量状态机（token / 请求 / 轮次 / 费用）
├─ query.ts           # 区间聚合（补零时间轴）
├─ pricing.ts         # 价目表计费
├─ balance.ts         # 多 provider 快照客户端
├─ provider-detect.ts # 端点自动检测
├─ routes.ts          # 只读 HTTP 路由（loopback 围栏）
├─ store.ts           # 原子落盘
└─ client/            # 浏览器端（卡片 / 图表 / 会话面板 / 设置）

已知限制

  • 费用是估算：按价目表 × provider 上报用量计算，非账单方发票；请以实际账单为准。
  • 余额取决于 provider 端点：DeepSeek 余额要求有效官方 key（OpenCode 的 key 不通用）；OpenCode 配额接口可能受 Cloudflare 延迟惩罚（已用浏览器 UA + 25s 超时缓解）。
  • 历史自启用时起算：启用前的使用不回填。
  • 留存：按日数据保留 730 天，会话保留最近 500 个。

许可

BSD-3-Clause，见 [LICENSE](./LICENSE)。

返回搜索打开 GitHub 仓库

更多相关插件

查看分类