用量监控面板 moyuer233/dsh-deepseek-monitor

DSH Deepseek Monitor

_✨ DeepSeek Harness 插件：余额、Token 用量与费用实时可见 ✨_

DeepSeek 用量监控 —— DeepSeek Harness (DSH) 插件：在会话头部与侧边栏实时显示 DeepSeek 平台的余额、日/月/累计 Token 总量与费用，支持长按拖动排序与开关配置；另附一个本地用量代理，为走 Anthropic 兼容协议的子代理（如 Claude Code）精确记账。

本插件使用 platform.deepseek.com Web 端内部接口（非公开契约）查询你自己的账户数据，仅限个人使用；接口结构若被 DeepSeek 变更，需要同步更新 lib/platform.mjs。

安装

标准 DSH bundle 格式（根包即插件，既可从 npm 安装，也可从 GitHub 一条命令安装）。当前版本 0.4.2，npm 包名 dsh-deepseek-monitor-moyuer233。

从 npm 安装（推荐）
dsh plugin --profile web add dsh-deepseek-monitor-moyuer233

或直接从 GitHub 安装
dsh plugin --profile web add github:moyuer233/dsh-deepseek-monitor

装完重启 DSH（宿主在启动时加载新 bundle；此后客户端改动走 HMR，刷新页面即可）。

安装命令会把本仓库作为依赖装进 profile（~/.dsh/profiles/web/），其 cordis.patch.yml 自动向 profile 注入 dsm-usage 条目（宿主路由 + 浏览器端 bundle）。

旧版手工安装（@local/dsh-host-deepseek-usage + @local/dsh-client-ui-deepseek-usage 拷贝到 profile）已被上面的命令取代。升级前请从 ~/.dsh/profiles/web/cordis.patch.yml 移除对应的 - insert: 段，并删除 ~/.dsh/profiles/node_modules/@local/ 下的两个旧目录。

功能

- 会话头部横排信息段：余额 / 日 Token / 月 Token / 日费用 / 月费用 / 总费用 / Token 总量，每段独立开关；长按显示块即可拖动排序，拖动过程中看到的顺序就是松手后的顺序
- 两个展示位：会话头部（横排）与侧边栏底部（竖排）；点信息段或 ⚙ 弹出完整详情与配置面板
- 每轮对话结束立即刷新：智能体从运行转为空闲时，宿主通过 SSE（/dsm/events）推一次信号，面板马上重新拉数据；老宿主没有该路由时自动退回 60 秒轮询（页面隐藏时暂停；多个展示位与多个标签页共用同一次采集）
- 配置双通道持久化（localStorage + 宿主 config.json，与应用随机端口无关）
- 默认零配置：直接复用 DSH 的 DeepSeek 账号登录态；未登录时可在面板「高级」里手动填 token 兜底
- 按 API Key 过滤：面板里可切换「全部 Key」或某一个 Key，口径与平台用量页的「API Key」筛选一致（默认全部 Key）
- 累计（总）数据：Token 逐月累加并跨月缓存；费用在「全部 Key」时取账户 total_costs，选中某个 Key 时按该 Key 逐月累加
- 本地用量代理（可选）：拦截 Anthropic 兼容请求，精确解析 SSE/JSON 用量并记账
- 余额不足提醒：余额低于阈值时弹窗，点「去充值」跳平台充值页；阈值（默认 ¥5）与提醒间隔（默认 6 小时）都能在面板里改，也能整个关掉
- 余额合并显示：余额 = 充值余额 + 赠送余额，赠送部分用强调色括注在后面（例：¥100（¥50赠送））
- 新版本提示与一键更新：有新版时齿轮右上角亮红点，面板顶部把「版本」直接换成「新版本：vX.X.X」，点「更新」即可安装；更新失败会在单行输入框里给出原因（单击可复制），重启 DSH 生效
- 侧边栏独立配置：侧边栏有自己的一套「显示哪些项 + 顺序」，与头部互不影响；面板里的开关控制显示，顺序直接在侧边栏里长按某一行拖动调整

预览

会话头部（横排信息段）

header

配置面板（显示开关；排序改到会话头部直接拖）

config

侧边栏底部（竖排）

sidebar

长按显示块拖动排序（拖动中即时预览）

drag

余额不足提醒（点「去充值」跳转平台充值页）

alert

平台 Token（默认零配置）

在 DSH 里登录 DeepSeek 账号（设置 → 账号）即可，插件自动复用登录态，不用再抓 token。

凭据来源按顺序取第一个可用的：

1. DS_PLATFORM_TOKEN 环境变量（脚本 / 临时换号）
2. DSH 账号登录态（读取账号服务的 getPlatformSession()，请求头 x-dsh-auth-token）
3. 手动填写的 token（面板 →「高级：手动填 token」，走 Authorization: Bearer）

手动填写出现在三种情况：没登录、想用别的账号、或平台换了接口导致账号态不可用。
抓 token 的老办法仍在「高级」里：打开平台页 → 书签/控制台代码复制 userToken → 粘贴保存（保存走宿主 POST /dsm/token 原子写入 ~/.dsh/deepseek-monitor/platform-token）。

账号登录 / 退出 / 换 token 都会让用量缓存立刻作废，下一轮自动用新的凭据重算。

配置

- 会话头部按日 / 月 / 总量显示 Token 与费用（余额另列）；长按显示块拖动即可调整顺序，面板内的开关只控制显隐
- 侧边栏是独立的一套：面板「侧边栏显示项」里的开关只控制显示，顺序在侧边栏里长按拖动调整；改动只影响侧边栏，不动头部
- 配置持久化：~/.dsh/deepseek-monitor/config.json（宿主，与应用端口无关）+ localStorage（会话内）
- 界面语言：面板内可切换中文 / English（默认中文）
- API Key：面板内可切换「全部 Key」或某一个 Key（与平台用量页的「API Key」筛选同口径，默认全部 Key）

数据来源（platform.deepseek.com 内部 API）

| 接口 | 内容 |
| GET /api/v0/users/get_user_summary | 余额 / 赠送 / 累计费用（账户级，无 Key 维度） |
| GET /api/v0/users/get_api_keys | 账户下的 API Key 列表 |
| GET /api/v0/usage/by_api_key/amount?start&end&tz | 按 Key 的 token 用量（窗口为秒级、按日边界对齐） |
| GET /api/v0/usage/by_api_key/cost?start&end&tz | 按 Key 的费用 |

鉴权：DSH 账号登录态（请求头 x-dsh-auth-token），或手填的平台 token（Authorization: Bearer）；两者都不是 API Key。

0.2.3 及更早用的是 /usage/amount、/usage/cost：那两个接口是账户级、按模型聚合、没有 Key 维度。账户下有多个 Key 时，用它们算出的数字必然大于平台页面筛掉其它 Key 之后的值—— 所以 0.2.4 起改用 by_api_key 这一对，并在面板里提供 Key 选择。

本地用量代理（可选）

把子 Claude Code（或任何 Anthropic 兼容客户端）的 ANTHROPIC_BASE_URL 指向本地代理，代理转发到 DeepSeek 并精确解析 token 用量记账：

客户端 ──▶ 本代理 (127.0.0.1:8899) ──▶ https://api.deepseek.com/anthropic │ ▼ usage.jsonl（每请求一条：token/费用/耗时）

node proxy.mjs # 启动代理（默认 127.0.0.1:8899）
node stats.mjs # totals | today | recent [n] | live | balance
npm test # 自测：代理 + 宿主采集 + 宿主路由（全内置 mock，无需真实 Key）

接入 @deepseek-ai/dsh-subagent-claude-code 时，在 profile 补丁的 provider 行加：

- id: subagent-claude-code
name: '@deepseek-ai/dsh-subagent-claude-code'
config:
env: !!js Object.fromEntries(Object.entries({
ANTHROPIC_BASE_URL: 'http://127.0.0.1:8899',
ANTHROPIC_AUTH_TOKEN: process.env.DEEPSEEK_API_KEY
}).filter(([, v]) => v !== undefined && v !== ''))

环境变量

| 变量 | 默认值 | 说明 |
| DS_MONITOR_PORT | 8899 | 代理监听端口 |
| DS_MONITOR_HOST | 127.0.0.1 | 监听地址 |
| DS_MONITOR_UPSTREAM | https://api.deepseek.com/anthropic | 上游端点 |
| DS_MONITOR_LOG | ~/.dsh/deepseek-monitor/usage.jsonl | 代理记账文件 |
| DS_MONITOR_LOG_MAX_BYTES | 33554432（32 MB） | 记账文件上限，超过就轮转出一代 .1 |
| DS_MONITOR_ALLOWED_HOSTS | 仅回环名与 IP 字面量 | 额外允许访问宿主路由的 Host（逗号分隔）， 关闭校验 |
| DS_MONITOR_LATEST_BASE | 镜像 + 官方 registry | 新版本查询源（逗号分隔，按顺序尝试） |
| DS_MONITOR_API_KEY | 回退 ANTHROPIC_AUTH_TOKEN/DEEPSEEK_API_KEY | stats balance 用 |
| DS_PLATFORM_TOKEN | 无 | 手动指定平台 token，优先于 DSH 账号登录态 |
| DS_MONITOR_TZ_OFFSET | 8 | 记账时区偏移（小时）：平台按该时区切分「日」 |
| DS_MONITOR_TTL_MS | 30000 | 宿主侧用量结果缓存时长（毫秒），0 关闭缓存 |
| DS_MONITOR_HISTORY_CONCURRENCY | 6 | 历史月份并发拉取上限 |
| DS_PRICE_<MODEL>_IN/_CACHE_HIT/_OUT | 内置默认表 | 单价覆盖（元/百万 token） |

定价（默认，可用 DS_PRICE_ 覆盖）

| 模型 | 输入 | 缓存命中 | 输出 |
| deepseek-chat | 0.27 | 0.07 | 1.10 |
| deepseek-reasoner | 0.55 | 0.14 | 2.19 |
| deepseek-v4-pro | 1.00 | 0.25 | 3.00 |
| 未知模型 | 1.00 | 0.10 | 2.00 |

费用按 Anthropic 协议语义：cache_creation_input_tokens 按全价输入计， cache_read_input_tokens 按缓存命中价计。

记账记录示例

{"ts":"2026-08-15T08:00:00.000Z","runId":"...","kind":"messages","streaming":true,"model":"deepseek-chat","status":200,"inputTokens":1000,"cacheCreation":200,"cacheRead":300,"outputTokens":500,"inputCost":0.00027,"cacheCreationCost":0.000054,"cacheReadCost":0.000021,"outputCost":0.00055,"totalCostCny":0.000895,"error":null,"durationMs":1234}

兼容性

- 主题变量：DSH 0.2 把 --dsw-alias-fill-l2、--dsw-alias-accent、--dsw-alias-danger、--dsw-alias-success、--dsw-static-neutral-0 等一批变量改了名。插件用「新名 → 旧名 → 中性兜底」的链式 var()，0.1 与 0.2+ 都能取到主题色；兜底不再写死深色，浅色主题不会退化成黑底。
- 宿主路由：webServer.register 依次尝试 0.2 的 { kind, path, handler }、{ path, handler } 与更早的 (path, handler) 三种签名。
- 账号登录态：deepseekAccount 服务不存在或未登录时自动回落到手填 token，不阻塞面板。
- 客户端依赖：bundle 只 require("react") / require("react-dom")，dsh.client.inject 为空，不依赖任何 @deepseek-ai/dsh-client- 子包。

已知限制

- 代理只统计经过它的请求；直接访问 DeepSeek 的流量不计入
- stats balance 走 DeepSeek 原生余额端点（https://api.deepseek.com/user/balance），需有效 API Key
- 子代理本身是一次性运行（dsh-subagent-claude-code 的限制），监控粒度到请求级
- 平台内部接口非公开契约，可能随平台更新而变化

更新日志

0.4.2

- 自更新更稳：先在 PATH 与常见全局目录里定位 pnpm.cmd，找不到时再交给 cmd /d /s /c 让 shell 找；失败提示保留具体错误

0.4.1

- 自更新改用 pnpm：profile 由 pnpm 管理时用 pnpm update <包> 刷新依赖与锁（在此之前用 npm 会绕过锁文件，重装时版本被锁里的旧提交打回，实测从 0.4.0 退回 0.2.4）；找不到 pnpm 时给出明确提示

0.4.0

- 余额合并显示：充值余额与赠送余额合并成一个数字，赠送部分用强调色括注（¥100（¥50赠送））；余额不足提醒也改按合计判断
- 每轮对话结束自动刷新：新增 /dsm/events（SSE），宿主检测到智能体从运行转为空闲就推一条 refresh，面板立刻刷新；老宿主自动退回 60 秒轮询
- 新版本提示：插件每 30 分钟查一次 npm 最新版，有新版本时齿轮右上角亮红点，面板顶部显示「新版本：vX.X.X」
- 一键更新：面板顶部版本行点「更新」，在配置档目录执行 npm install，重启 DSH 生效；失败时把错误原因放进单行输入框，单击复制
- 兼容性：主题变量改为「新名 → 旧名」链式兜底（DSH 0.1 与 0.2+ 都可用），去掉写死的深色兜底（修复浅色主题下变黑底）；宿主路由注册兼容旧签名；dsh.client.inject 置空

0.3.0

- 零配置：默认复用 DSH 的 DeepSeek 账号登录态，不再需要去浏览器抓 userToken；登录 / 退出 / 换账号后用量缓存自动作废
- 鉴权双模式：账号登录态走平台请求头 x-dsh-auth-token，手填 token 仍走 Authorization: Bearer
- 面板「平台 Token」区改为显示来源（已通过 DSH 账号登录 / 正在使用手动 Token / 未登录）；未登录时直接给出手填框，书签与抓取入口收进「高级」
- 只读账号服务的公开方法 getPlatformSession()，不直接读 ~/.dsh/.credentials.yaml
- 手动 token 文件、DS_PLATFORM_TOKEN、DS_MONITOR_ 环境变量全部保留，升级无需任何操作

0.2.4

- 新增「API Key」筛选：面板里可切换「全部 Key」或某一个 Key，口径与平台用量页的「API Key」下拉一致（默认全部 Key）
- 数据接口改用 by_api_key 系列：此前的 /usage/amount、/usage/cost 是账户级、没有 Key 维度，账户下有多个 Key 时算出的数字必然大于平台页面筛掉其它 Key 之后的值
- 累计费用在「全部 Key」时仍取账户 total_costs；选中某个 Key 时改为按该 Key 逐月累加（账户汇总没有 Key 维度）
- 采集缓存/单飞的键加入所选 Key，换 Key 会立刻拉新数据，而不是复用上一个 Key 的结果
- 修复「今日」恒为 0：此前今日数据是从账户级月度响应里筛"当天那个桶"得到的，账户级接口并不提供当天的可用分桶；改用 by_api_key 的当日窗口（end 按平台自身算法取"结束日次日零点"）后与平台页面一致
- 会话头部的显示块可直接拖动排序：长按 250 ms 进入拖动，拖动中顺序即时重排（所见即所得），松手落盘；配置面板不再用 ≡ 手柄排序，只保留显示开关
- 新增「余额不足提醒」：余额低于阈值时弹窗，点「去充值」跳平台充值页；阈值（默认 ¥5）与提醒间隔（默认 6 小时）都能在面板里改，也能整个关掉；静默状态只存本地，余额回升到阈值以上自动解除
- 配置面板加了限高滚动（min(78vh, 760px)）：内容变长后，底部「平台 Token」区不再掉出窗口点不到
- 侧边栏改为独立配置：显示哪些项与顺序都与头部解耦（面板里的开关只控显示，顺序在侧边栏里长按拖动调整）；老配置自动按头部推导，升级后外观不变

0.2.3

- 安全：三条宿主路由改为校验 Host（只放行回环名与 IP 字面量）—— 此前只校验 Origin / Sec-Fetch-Site，而 DNS rebinding 下这两个信号都由浏览器算成"同源"，可被用来改写配置或读取用量。经域名或反向代理访问时用 DS_MONITOR_ALLOWED_HOSTS 放行
- 修复代理遇到畸形请求目标（absolute-form、OPTIONS *，且上游配成"带端口无路径"）抛未捕获异常、整个代理进程退出的问题
- 修复单个历史月份拉取失败会连坐余额 / 今日 / 本月数据、整份响应变成失败的问题；累计部分独立降级，界面显示「—」并在响应里带 alltimeError
- 修复 stats.mjs live 把跨轮询被截断的半行连游标一起吃掉、该记录永久丢失的问题
- 修复 stats.mjs 遇到字符串型记账字段直接崩溃的问题
- 代理在客户端中途断开时补记一笔账（此前这段已消耗的 token 完全不计入）
- 记账文件加上限并轮转一代（DS_MONITOR_LOG_MAX_BYTES，默认 32 MB），stats 两代都统计
- 界面：请求加 20 秒超时，避免宿主"接了连接却不回"导致刷新永久停住；去掉嵌套三元
- DS_MONITOR_TTL_MS 传非法值时回退默认，不再静默关掉缓存

0.2.2

- 修复「今日」按 UTC 取日期，导致北京时间 00:00–08:00 显示前一天数据的问题（时区可用 DS_MONITOR_TZ_OFFSET 调整）
- 修复代理把带 query 的 /v1/messages 记成 other、该请求 token 与费用记 0 的问题
- 修复记账日志里被 TCP 切断的多字节字符（中文错误信息）变成乱码的问题
- 用量采集：宿主侧 30 秒缓存并合并并发请求，历史月份并发拉取，记账文件改为增量解析
- 界面：多个展示位与多个标签页共用同一次采集，页面隐藏时暂停轮询
- 宿主写接口（token / 配置）增加同源校验与 JSON 要求，配置只接受标量与字符串数组
- 代理请求体加上限（32 MB）；/dsm/usage 补方法校验与错误处理
- 文档：移除已不存在的「用量」标签页说明与截图

0.2.1

- 文档：中英 README 内容对齐（合并重复的安装节、去掉 emoji 与分隔线），正文补上当前版本号与更新日志。无功能改动

0.2.0

- npm 首个发布版本：余额与日 / 月 / 累计用量面板、拖拽排序与开关配置、浏览器通用 Token 获取、可选本地用量代理、界面语言切换

如果觉得好用，请给个 Star 支持一下，欢迎提交 Issue 和 Pull Request。

License

MIT