@ychris12138/dsh-usage-stats

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

dsh-usage-stats

<!-- stable-version: 0.3.7 -->




为 DeepSeek Harness 网页端提供多供应商账户监测与 Token 用量分析。

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

展示图使用脱敏演示数据；插件不会把 API Key、Cookie、管理 PAT 或上游原始响应发送到浏览器。


🐋 OrcaRouter sponsors this project and is available as an optional OpenAI-compatible provider. Learn more · Referral link.

一眼看懂 / At a glance

· 能力 · 说明

💳 · 统一账户卡片 · API 供应商显示余额，Token Plan 显示分窗口额度；面板一次只呈现当前供应商

📊 · Token 用量分析 · 今日、本月、累计、缓存命中率、月历热图，以及供应商分组与组内模型用量排行

💰 · 估算费用与预算 · 按事件时间匹配历史价格，提供日/月费用、session 级聚合及可选预算预警

🔄 · 后台监测 · 账户按 active/detail/background 自适应刷新；间隔可配置或完全关闭，本地 Token 聚合保持独立运行

🧩 · 可扩展适配器 · 支持 New API、Sub2API、通用余额模板，以及声明式 JSON Pointer 自定义查询

📦 · 安全导出 · 提供 daily/session CSV 与版本化 JSON；Unicode、CSV 公式前缀和不完整费用均安全处理

🔒 · 本机安全边界 · 数据端点仅接受回环 GET；OrcaRouter preset 仅由带防跨站请求头的显式回环 POST 写入；凭据只在服务端解析

界面支持中文和英文。浏览器只请求当前选择的 provider；账户自动刷新由服务端统一调度。手动刷新会更新用量、供应商列表，并强制刷新当前账户，不会批量强制请求其他供应商。

快速安装 / Quick start

本版本为 @ychris12138/dsh-usage-stats@0.3.7。npm 与市场安装要求该精确版本已经发布；发布前验收使用从冻结提交构建并核对哈希的本地 .tgz。

基础功能支持 @deepseek-ai/dsh >= 0.1.0-rc.6。安装时选择实际使用的 profile：命令行网页通常是 web，Desktop 使用 desktop；不要把插件装到另一个 profile 后只刷新当前窗口。DSH Desktop 的 DeepSeek Account 登录余额接入依赖 DSH 0.2.0-rc.2+ 提供的 Host account service；旧版 Harness 仍继续使用 API Key 余额路径。

确认 npm 上存在本版本后，优先安装精确版本；DSH Desktop Market 使用同一个包：

dsh plugin --profile web add "@ychris12138/dsh-usage-stats@0.3.7"

Desktop 安装时将上面的 --profile web 改为 --profile desktop，并使用 Desktop 对应的 DSH CLI。只有明确测试未发布 source/RC 时才使用 GitHub 来源；验收指定候选版本时优先安装从该提交打出的本地 .tgz，以免跟随分支变化。GitHub main 可能领先 npm stable。

安装后重启对应 profile 的 DSH Host；Desktop 需要退出并重新打开应用，然后刷新客户端。只刷新窗口不会加载新的服务端插件。侧边栏底部会出现“用量/余额”（Usage/Balance）入口。

插件市场 GUI 安装（DSH Community Market，Path A 标准来源）

本仓库按 DSH Community Market 目录 adapter 指南 的标准来源（Path A） 接入，无需修改 Market 代码。内置两份目录数据：

• catalog/catalog-source.json — 来源 manifest（catalog-source.schema.json v1.0.0）
• catalog/v1/plugins.json — 标准 provider page（catalog-provider-page.schema.json v1.0.0）

使用前提（重要）：市场托管安装只接受 npm registry 的精确稳定版本，git 条目仅可浏览。dsh-usage-stats 这个 npm 名已被其他项目占用，因此目录条目身份使用 @ychris12138/dsh-usage-stats。本版本 package 与 catalog 元数据均为 0.3.6；目录中的版本号不代表 npm 发布已完成。每个新版本都按以下顺序发布：

1. 在 release 分支运行 npm run release:sync -- <version> 同步 package、lockfile、README 与 catalog，检查候选包。npm 发布前不要把新 catalog 合入 main，因为 Pages 会自动部署。

2. 从冻结的 .tgz 发布 scoped 公共包：npm publish /absolute/path/to/ychris12138-dsh-usage-stats-0.3.6.tgz --access public --registry=https://registry.npmjs.org/，再核对 registry tarball 与冻结包的哈希。

3. npm 包核验通过后，将 main 快进到冻结的发布提交，触发 Pages 部署；核验 https://ychris12138.github.io/dsh-usage-stats/v1/plugins 的精确版本（manifest 与 endpoint 必须同源、HTTPS 443、无凭据）。

4. 在 DSH 插件市场 → 来源管理 → 添加来源，粘贴 manifest URL：https://ychris12138.github.io/dsh-usage-stats/catalog-source.json，选择后即可走「可恢复安装边界」GUI 安装。

目录若先指向尚未发布的版本，市场安装会 fail-closed，这是预期行为。只有 npm、Pages catalog 与 Desktop Market 实际安装全部验证后，才算完成发布。

升级或卸载：

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

<details>

<summary><strong>兼容安装器：无法使用 dsh plugin 时展开</strong></summary>

PowerShell、命令提示符和 macOS/Linux 终端使用同一条命令：

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

安装器会把运行文件复制到 ~/.dsh/profiles/node_modules/@ychris12138/dsh-usage-stats，并在 profiles/web/cordis.patch.yml 中以带引号的 scoped identity 幂等启用插件。重复运行即可更新，不会重复追加配置；旧版 name: dsh-usage-stats 和未加引号的 name: @ychris12138/dsh-usage-stats 会自动迁移。设置了 DSH_HOME 时使用该目录。

dsh plugin 与 npx 是两条独立安装路径，请选择其中一种；不要同时保留手工 Cordis entry 和 bundle 注册，否则会重复挂载。

# 预览，不修改文件
npx --yes github:Ychris12138/dsh-usage-stats --dry-run

# 检查现有安装
npx --yes github:Ychris12138/dsh-usage-stats --check

# 安装但不修改 Cordis patch
npx --yes github:Ychris12138/dsh-usage-stats --no-enable

无法使用 npx 时可从源码运行 node scripts/install.mjs。

</details>

支持的账户类型 / Providers

插件自动发现官方 DeepSeek API Key 路由、DSH 0.2 的 deepseek-account 路由，以及 llm-pi-ai 中的 provider profile。只有存在公开账户接口、Host-owned account service 或显式 monitor 的供应商才会查询账户；Token 用量统计不需要额外凭据。

DSH 0.2 Desktop：0.3.5 已支持 Host-owned deepseek-account 登录余额；该路径依赖 DSH 0.2.0-rc.2+ 的 account service，不读取原始 token、Cookie 或 PKCE。旧版 Harness 与 API Key DeepSeek 仍继续使用 /user/balance 路径。

Provider / adapter · 模式 · 默认凭据 · 上游接口

DeepSeek API Key · 余额 · provider apiKeyEnv · /user/balance

DeepSeek Account（DSH 0.2 Desktop） · 余额 · DSH Host-owned account grant；插件不读取 token/cookie · deepseekAccount.getState() + getBalance()

OpenRouter · 余额 · OPENROUTER_MANAGEMENT_KEY · /api/v1/credits

OrcaRouter · 余额 · ORCAROUTER_API_KEY · /v1/balance（旧部署回退到账单摘要接口）

Moonshot / Kimi API · 余额 · provider apiKeyEnv · /v1/users/me/balance

OpenCode Go · 订阅 · OPENCODE_API_KEY，兼容旧 OPENCODE_GO_API_KEY · /inference/go/v1/usage（兼容旧 /zen/go/v1/usage）

Z.ai / 智谱 · 订阅 · 全球区 ZAI_API_KEY；中国区 ZAI_CODING_CN_API_KEY · Coding Plan quota/subscription

Kimi For Coding · 订阅 · `KIMI_API

…(truncated)