moyuer233/dsh-deepseek-monitor

DSH Deepseek Monitor

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

license npm version npm downloads
commit activity last commit
node DeepSeek Harness

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

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

安装

标准 DSH bundle 格式（根包即插件，既可从 npm 安装，也可从 GitHub 一条命令安装）。当前版本 0.2.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 总量，每段独立开关、可通过 ≡ 手柄拖拽排序
- 两个展示位：会话头部（横排）与侧边栏底部（竖排）；点信息段或 ⚙ 弹出完整详情与配置面板
- 60 秒自动刷新（页面隐藏时暂停；多个展示位与多个标签页共用同一次采集）；配置双通道持久化（localStorage + 宿主 config.json，与应用随机端口无关）
- 浏览器通用 Token 获取：书签一键复制 / 控制台代码 / 面板内粘贴保存（自动去引号，立即生效）
- 累计（总）数据：费用取平台 total_costs，Token 逐月累加并跨月缓存
- 本地用量代理（可选）：拦截 Anthropic 兼容请求，精确解析 SSE/JSON 用量并记账

预览

会话头部（横排信息段）

header

配置面板（开关 + 拖拽排序）

config

侧边栏底部（竖排）

sidebar

获取平台 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（默认中文）

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

| 接口 | 内容 |
|---|---|
| GET /api/v0/users/get_user_summary | 余额 / 赠送 / 累计费用 |
| GET /api/v0/usage/amount?month&year | 按天 token 用量 |
| GET /api/v0/usage/cost?month&year | 按天费用 |

鉴权为平台登录 token（浏览器 userToken，非 API 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_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__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.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