返回目录

dsh-usage-stats

编辑精选维护状态: 活跃

ychris12138/dsh-usage-stats

为 DeepSeek Harness Web GUI 提供提供方余额、订阅额度与 Token 用量分析。

前往 GitHub
$ dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats"

146

星标

16

Fork

JavaScript

语言

MIT

许可证

2026-08-14

创建于

2026-09-02

最近推送

MIT 协议的原生 dsh web 插件,在 DeepSeek Harness 内监测多供应商余额、订阅额度与 Token 用量——统一账户卡片、月历热图,以及声明式 JSON Pointer 适配器,凭据始终留在服务端。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-25

许可证

MIT

01它能帮你完成什么?

  • 在 DeepSeek Harness 网页端内监测多供应商账户余额、订阅额度与 Token 用量

    统一账户卡片(API 余额或分窗口 Token Plan 额度)以及网页端侧边栏里的 Token 用量分析

    运行付费 API 供应商、希望不离开界面就能盯住支出的 DeepSeek Harness(dsh web)使用者

  • 按日期、供应商与模型拆解 DeepSeek Harness 的 Token 用量

    今日 / 本月 / 累计总量、缓存命中率、月历热图,以及按日期/供应商/模型下钻

    需要跨供应商、跨模型追踪 Token 支出的重度用户与团队

02如何接入 DeepSeek Harness?

前置条件

  • 需要 DeepSeek Harness 的 `web` profile——README 要求 `@deepseek-ai/dsh >= 0.1.0-rc.6`
  • 在 `~/.dsh/.credentials.yaml` 中配置好供应商凭据(安装器不会读取或写入该文件)

安装步骤

  1. 01

    $ dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats"

  2. 02

    重启正在运行的 `dsh web` 并在浏览器中硬刷新

    $ dsh web

  3. 03

    $ npx --yes github:Ychris12138/dsh-usage-stats

验证接入成功

  • 重启并硬刷新后,侧边栏底部会出现「用量/余额」(Usage/Balance)入口

回滚

  • dsh plugin --profile web remove "@ychris12138/dsh-usage-stats"

03DSH 适配与能力边界

DSH 适配原生运行时

原生 dsh web 插件:通过 `dsh plugin --profile web add` 安装,在 DeepSeek Harness 网页端侧边栏挂载「用量/余额」面板,并暴露五个仅回环的 API 端点。

  • 统一账户卡片

    由 Harness 从 `~/.dsh/.credentials.yaml` 解析出的已配置供应商凭据(API Key、Management Key 或 auth.json)单供应商余额快照或分窗口 Token Plan 额度卡片——一次只显示一个供应商

  • Token 用量分析

    来自 `assistant/chunk` 或 `assistant/message` 事件、由供应商上报的 `usage`今日 / 本月 / 累计总量、缓存命中率、月历热图,按日期/供应商/模型下钻

  • 后台监测

    服务端启动信号加上全部已配置账户刷新后的账户余额与本地 Token 聚合

    服务端启动后即刷新,之后每五分钟更新全部已配置账户与本地 Token 聚合
  • 可扩展适配器

    New API、Sub2API、通用余额模板,或声明式 JSON Pointer 查询从受支持的上游端点归一化出的账户/额度

04适合谁?何时不该用?

适合

  • 运行付费 API 供应商、希望不离开界面就能盯住支出的 DeepSeek Harness(dsh web)使用者
  • 需要跨供应商、跨模型追踪 Token 支出的重度用户与团队

不适合

  • 五个 API 端点仅接受回环 GET,并校验 peer socket 与 Host;凭据只在服务端解析,只发往校验后的供应商地址——绝不发往浏览器。
  • OpenRouter 账户余额需要单独的 OPENROUTER_MANAGEMENT_KEY;插件不会用普通推理 KEY(OPENROUTER_API_KEY)去试探,缺少管理 Key 时卡片显示「未配置」。

05兼容性、维护与安全提示

  • 五个 API 端点仅接受回环 GET,并校验 peer socket 与 Host;凭据只在服务端解析,只发往校验后的供应商地址——绝不发往浏览器。
  • OpenRouter 账户余额需要单独的 OPENROUTER_MANAGEMENT_KEY;插件不会用普通推理 KEY(OPENROUTER_API_KEY)去试探,缺少管理 Key 时卡片显示「未配置」。
  • DSH 插件市场 GUI 安装需要已发布的 scoped npm 包 `@ychris12138/dsh-usage-stats`;发布前的目录条目可浏览但安装保持禁用(fail-closed)。
2026-08-142026-08-24v0.2.10

MIT · 活跃维护中(最新发布 v0.2.10,2026-08-22)

06常见问题

怎么把 dsh-usage-stats 装进 DeepSeek Harness?

执行 `dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats"`,然后重启 `dsh web` 并在浏览器硬刷新,侧边栏会出现「用量/余额」入口。若 `dsh plugin` 不可用,`npx --yes github:Ychris12138/dsh-usage-stats` 是等效的安装器。

支持哪些供应商和账户类型?

它会自动发现官方 DeepSeek 路由与 provider profile,并支持 DeepSeek、OpenRouter、Moonshot/Kimi、OpenCode Go、Z.ai、Kimi For Coding、MiniMax、Ollama 云、New API、Sub2API,以及声明式 JSON Pointer monitor。没有公开余额接口的供应商仍会统计 Token,卡片显示「不支持」而非猜测余额。

我的 API Key 或 Cookie 会泄露到浏览器吗?

不会。API Key、Cookie、管理 PAT 与上游响应都不会进入浏览器、插件缓存或日志。五个端点仅接受回环 GET 并校验 peer socket + Host;凭据只在服务端解析,只发往校验后的供应商地址。

OpenRouter 需要和普通推理不同的 Key 吗?

需要。OpenRouter 余额使用单独的 OPENROUTER_MANAGEMENT_KEY,而非普通推理用的 OPENROUTER_API_KEY。缺少管理 Key 时卡片显示「未配置」,插件不会拿推理 Key 去试探。

能从 DSH 插件市场 GUI 安装吗?

仓库内置 Path A 标准来源目录,但市场 GUI 的「安装」按钮只有在 scoped npm 包 `@ychris12138/dsh-usage-stats` 发布后才可用;在此之前目录条目可浏览,但安装保持禁用(fail-closed)。

08数据与来源

  • 作者声明github.com612d7a80581e…

    Provider balances, subscription quotas, and token-usage analytics for the DeepSeek Harness Web GUI (`dsh web`).

  • 作者声明github.com612d7a80581e…

    需要 DeepSeek Harness `web` profile(`@deepseek-ai/dsh >= 0.1.0-rc.6`)。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-25。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。