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.2.4，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 总量，每段独立开关；长按显示块即可拖动排序，拖动过程中看到的顺序就是松手后的顺序
• 两个展示位：会话头部（横排）与侧边栏底部（竖排）；点信息段或 ⚙ 弹出完整详情与配置面板
• 60 秒自动刷新（页面隐藏时暂停；多个展示位与多个标签页共用同一次采集）；配置双通道持久化（localStorage + 宿主 config.json，与应用随机端口无关）
• 浏览器通用 Token 获取：书签一键复制 / 控制台代码 / 面板内粘贴保存（自动去引号，立即生效）
• 按 API Key 过滤：面板里可切换「全部 Key」或某一个 Key，口径与平台用量页的「API Key」筛选一致（默认全部 Key）
• 累计（总）数据：Token 逐月累加并跨月缓存；费用在「全部 Key」时取账户 total_costs，选中某个 Key 时按该 Key 逐月累加
• 本地用量代理（可选）：拦截 Anthropic 兼容请求，精确解析 SSE/JSON 用量并记账
• 余额不足提醒：余额低于阈值时弹窗，点「去充值」跳平台充值页；阈值（默认 ¥5）与提醒间隔（默认 6 小时）都能在面板里改，也能整个关掉
• 侧边栏独立配置：侧边栏有自己的一套「显示哪些项 + 顺序」，与头部互不影响；面板里的开关控制显示，顺序直接在侧边栏里长按某一行拖动调整

预览

会话头部（横排信息段）

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

侧边栏底部（竖排）

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

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

获取平台 Token（浏览器通用，Edge/Chrome/桌面端均可）

1. 打开配置面板 → 「平台 Token」区
2. 点「打开平台页面」并登录
3. 把「获取 Token」链接拖到浏览器书签栏；之后登录平台页时点一下书签即自动复制 Token （备选：复制书签链接手动建书签，或复制控制台代码在 F12 里执行）
4. 回到面板粘贴（自动去引号）→ 保存，立即生效，无需重启

保存走宿主 POST /dsm/token 原子写入 ~/.dsh/deepseek-monitor/platform-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 的费用

鉴权为平台登录 token（浏览器 userToken，非 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_API_KEY	回退 ANTHROPIC_AUTH_TOKEN/DEEPSEEK_API_KEY	stats balance 用
DS_PLATFORM_TOKEN	无	平台 token（也可写入 ~/.dsh/deepseek-monitor/platform-token）
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}

已知限制

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

更新日志

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