余额用量计费 paolomandica/dsh-cost-usage-monitor

dsh-cost-usage-monitor

一个 DeepSeek Harness 插件，把账户余额和会话用量费用放进 composer dock，紧挨着内置的统计 pill。

这些数字从哪来

| 数据 | 来源 |
| 计费 token | tokenUsage 会话投影（@deepseek-ai/dsh-token-meter）——服务商上报的 uncachedInputTokens、cacheReadTokens、cacheWriteTokens、outputTokens |
| 计价路由 | modelSelection 会话投影（@deepseek-ai/dsh-api-session-controller）——next 缺失时回退到 lastUsed |
| 余额 | 本插件的 Host 半部分：它解析 DEEPSEEK_API_KEY 凭据，从文档中的 GET /user/balance 端点提供 GET /usage-monitor/balance，浏览器半部分再读取它 |
| 每 1M token 价格 | 本插件——可编辑，持久化在 localStorage |

余额刻意在 Host 侧获取：API key 属于 Host，api.deepseek.com 不返回 CORS 头，余额也不属于任何会话投影。浏览器读取自己 Host 的路由，所以 key 永远不会到达页面：

// GET /usage-monitor/balance
{ "ok": true, "isAvailable": true, "fetchedAt": 1791234567890,
"wallets": [{ "currency": "CNY", "totalBalance": "42.50",
"grantedBalance": "5.00", "toppedUpBalance": "37.50" }] }
// failures answer 4xx/5xx with { "ok": false, "error": { "code", "message" } }

401/403 表示 DeepSeek 拒绝了凭据，503 表示该配置档没有配置 DEEPSEEK_API_KEY，504 表示服务商 10 秒内没有响应，502 表示服务商或网络出错。面板会直接显示这条消息，而不是一直等待。

费用只是估算。 运行时上报精确的 token 用量，但不带任何路由的货币价格，所以插件内置一张可编辑的价格表，初始值取自服务商的标价。以服务商的账单为准。

默认值是 DeepSeek 公布的非高峰标价（美元 / 1M token）：

| 模型 | 输入（缓存未命中） | 缓存读取（命中） | 缓存写入 | 输出 |
| deepseek-flash（DeepSeek-V4.1-Flash）、deepseek-v4-flash、deepseek-chat | 0.15 | 0.003 | 0.15 | 0.6 |
| deepseek-v4-pro、deepseek-reasoner | 0.66 | 0.022 | 0.66 | 1.98 |
| 其他任意模型（回退行） | 0.15 | 0.003 | 0.15 | 0.6 |

周一至周五 UTC 01:00–04:00 和 06:00–10:00 期间，DeepSeek 按非高峰费率的两倍收取高峰费用。插件自己套用这个系数——Peak × 字段，默认 2——面板会说明当前生效的是哪档费率。中文公开节假日在上游属于非高峰，但这里没有建模，所以节假日的工作日按高峰计价。cacheWrite 没有单独公布的收费，按缓存未命中费率计算。

编辑会话当前模型的字段，然后按 Save prices；Reset to defaults 会丢弃覆盖值。路由不在表中的会话，由回退行计价；当模型还未知时，编辑器编辑的就是这一行。覆盖值持久化在 localStorage 的 dsh-cost-usage-monitor/prices/v1 下。

价格会变。AGENTS.md 记录了去哪里读当前价格，以及刷新这张表、上面 README 里的表、测试预期值的具体步骤。

行为

- 条目位于 conversation.composer.dock（顺序 20，在宿主统计胶囊之后），在有东西可报告之前一直隐藏：测得的用量，或者余额路由实际返回的钱包。
- 余额在首次挂载时读取，每 60 s 最多一次，跨挂载去重，并可从面板的 ↻ 按钮按需重新读取。条目卸载时计时器停止。
- 配置档里没有余额路由 → 面板会说明这一点，费用一侧仍然可用。凭据被拒绝或服务商不可达 → 面板显示原因。
- 不会向会话日志、模型请求或系统提示词写入任何内容。Host 一侧只注册那一个只读余额路由；组件本身是一个浏览器模块加上现有服务。

布局

package.json dsh.bundle.patch + dsh.client (platform, inject)
cordis.patch.yml inserts the Loader row
index.js Host half: registers GET /usage-monitor/balance
client.js Browser module: dock entry, panel, stores
locale/en.json Plugin-manager display metadata
locale/zh.json
icon.svg
assets/ README artwork
test/render.test.mjs Renders the browser half under a React double
test/host.test.mjs Drives the Host balance route under webServer/credentials doubles
AGENTS.md Where to read current prices; how to refresh them

安装

从 npm 安装 —— 预构建路径，所以 pnpm 从不运行构建脚本，用户也不授予安装时代码执行权限：

dsh plugin --profile desktop add dsh-cost-usage-monitor

从 GitHub 安装的是源码，不带构建好的入口点；用户授权后，pnpm 会运行包的 prepare 脚本。除非你要固定到某个已读过的 commit，否则优先用 npm 形式：

dsh plugin --profile desktop add github:paolomandica/dsh-cost-usage-monitor

开发期间，用绝对路径链接一份检出：

dsh plugin --profile desktop add /path/to/dsh-cost-usage-monitor

dsh plugin 在配置档目录里运行 pnpm，然后把每个声明了 dsh.bundle 的已安装包加入 dsh.profile.bundles。Host 重新组合配置档并浏览器包会实时发布；如果入口没有出现，刷新页面即可。确认包已通过页面的启动图完成组装：

curl -s -H "Cookie: <the dsh-auth cookie>" http://127.0.0.1:19387/ | grep -o 'dsh-cost-usage-monitor[^"]'

余额路由需要 Web 包的 webServer 服务，以及一个能解析到的 DEEPSEEK_API_KEY（凭据存储，或 Host 进程环境）。直接检查它——这条路由在回环地址上无需认证，和本地服务器的其余部分一样：

curl -s http://127.0.0.1:19387/usage-monitor/balance

测试

node --check index.js && node --check client.js
node test/host.test.mjs
node test/render.test.mjs

test/render.test.mjs 会拿一个精简的 React 替身来执行 client.js，用假的 slot 注册表驱动 apply()，把 fetch 打桩成余额路由，然后断言药丸和面板渲染出预期的费用、钱包和价格字段——包括空数据、凭据被拒、路由不可达这几种情况。它会冻结 Date，让高峰和非高峰电价都能确定性地跑到。

test/host.test.mjs 把 index.js 当普通模块导入（这同时也证明 Host 那一半没有解析任何 @deepseek-ai/ 包），在 webServer/credentials 替身上挂载路由，然后断言服务商请求、组装好的成功响应体，以及每一个失败码。

卸载

dsh plugin --profile desktop remove dsh-cost-usage-monitor

许可证

MIT