dsh-deepseek-monitor

DSH Deepseek Monitor

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

中文 | English

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）在 agent 从运行转为空闲时推一次信号，面板马上重新拉数据；老宿主没有该路由时自动退回 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 生效
• 侧边栏独立配置：侧边栏有自己的一套「显示哪些项 + 顺序」，与头部互不影响；面板里的开关控制显示，顺序直接在侧边栏里长按某一行拖动调整

预览

会话头部（横排信息段）

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

侧边栏底部（竖排）

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

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

平台 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__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），宿主检测到 agent 从运行转为空闲就推一条 refresh，面板立刻刷新；老宿主自动退回 60 秒轮询
• 新版本提示：插件每 30 分钟查一次 npm 最新版，有新版本时齿轮右上角亮红点，面板顶部显示「新版本：vX.X.X」
• 一键更新：面板顶部版本行点「更新」在 profile 目录执行 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