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）在 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 生效
侧边栏独立配置：侧边栏有自己的一套「显示哪些项 + 顺序」，与头部互不影响；面板里的开关控制显示，顺序直接在侧边栏里长按某一行拖动调整

预览

会话头部（横排信息段）

header

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

config

侧边栏底部（竖排）

sidebar

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

drag

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

alert

平台 Token（默认零配置）

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

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

DS_PLATFORM_TOKEN 环境变量（脚本 / 临时换号）
DSH 账号登录态（读取账号服务的 getPlatformSession()，请求头 x-dsh-auth-token）
手动填写的 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），宿主检测到 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

dsh-deepseek-monitor-moyuer233

Install

Source

Creators

Readme

DSH Deepseek Monitor

安装

功能

预览

平台 Token（默认零配置）

配置

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

本地用量代理（可选）

环境变量

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

记账记录示例

兼容性

已知限制

更新日志

0.4.2

0.4.1

0.4.0

0.3.0

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

License

Install

Source

Creators

Readme

DSH Deepseek Monitor

安装

功能

预览

平台 Token（默认零配置）

配置

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

本地用量代理（可选）

环境变量

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

记账记录示例

兼容性

已知限制

更新日志

0.4.2

0.4.1

0.4.0

0.3.0

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

License

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