xixi66666/dsh-deepseek-platform-usage ↗★ 0

dsh-deepseek-platform-usage

DeepSeek 开放平台账单用量面板 for DeepSeek Harness: daily tokens and cost per model / billing type / API key, plus hourly detail, synced from platform.deepseek.com. 适合需要直接在客户端内统计和监控API Key真实消费的用户。

パッケージ
dsh-deepseek-platform-usage
互換性
未検証
バージョン
0.1.3
ライセンス
MIT
最終更新
2026/10/26

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:xixi66666/dsh-deepseek-platform-usage

ドキュメント

README 全文を読む ↗

dsh-deepseek-platform-usage

DeepSeek Harness(DSH)插件:把 DeepSeek 开放平台的账单用量搬进设置页。

按 API Key 计费的每日 tokens 与真实金额、按模型 / 计费类型 / API Key 的拆分、某一天的 24 小时明细,全部在 DSH 里查看,不需要额外开一个桌面程序。

非官方工具。数据来自 platform.deepseek.com 上「用量信息」页面调用的私有接口,接口没有公开文档、可能随平台改版失效。请仅用于统计本人账号。

目录

它能做什么

  • 今天 / 本月 / 累计用了多少 tokens、花了多少钱(平台账单口径,不是按价格表估算)。
  • 按维度拆解:切换「按模型 / 按计费类型 / 按 API Key」,看同一段时间里各占多少。
  • 看趋势:每日堆叠柱状图,支持 7 / 30 / 90 / 365 天与全部历史。
  • 看时段:点任意一天的柱子,切换成当天 24 小时的分时明细(平台只保留最近两天的小时数据,插件每次同步会把它们存下来)。

界面

平台用量面板

示例数据(离线 fixture),非真实账单。

环境要求

项目要求
DSH>= 0.2.0-rc.2 = 22(宿主半区用 AbortSignal.timeout、fetch)
网络能访问 https://platform.deepseek.com;同步走宿主进程,代理环境见 常见问题
凭证一个 DeepSeek 开放平台的 userToken(见第 1 步)

安装

插件包不在 npm 上,用打包后的 tarball 安装。


#    → dsh-deepseek-platform-usage-0.1.3.tgz

## 使用说明

### 第 1 步:拿到 userToken

`userToken` 是平台登录成功后写在浏览器 `localStorage` 里的会话凭证。平台没有 OAuth,也没有「用 API Key 换 token」的接口,所以这一步只能在**已登录的浏览器**里手工取一次。

三种取法,任选其一:

**方法 A:DevTools 面板(最直观)**

1. 浏览器打开  并登录;
2. 按 `F12` 打开开发者工具 → **Application**(Firefox 叫「存储」)→ **Local Storage** → `https://platform.deepseek.com`;
3. 在右侧找到键 `userToken`,它的值是 `{"value":"一串不透明字符","__version":"0"}`;
4. 复制整段值(插件会自己剥掉外层包装),或者只复制 `value` 里面的那串。

**方法 B:Console 一行**

在同一个页面的 Console 里执行:

```js
copy(JSON.parse(localStorage.getItem('userToken')).value)

token 直接进剪贴板(copy() 只在 DevTools 里可用)。

方法 C:从请求头抄

F12 → Network → 刷新页面 → 随便点开一条 /api/v0/usage/... 请求 → Headers → Request Headers → authorization: Bearer xxxxx → 复制 Bearer 后面那段。

这串 token 等价于该账号的只读账单权限(能看用量、费用、API Key 列表)。按密码对待:不要贴到聊天里、不要提交进仓库。它只存在本机的插件存储中。

第 2 步:绑定凭证

设置 → 平台用量,第一次打开会看到「绑定平台凭证」,两种方式选一种:

方式操作说明
从 token.json 导入填一个 JSON 文件的绝对路径 → 点「导入并验证」文件内容形如 {"user_token": "..."};也接受 {"value":"...","__version":"0"} 和纯文本。路径会记在本机,下次自动填好
粘贴 userToken切到「粘贴 userToken」,粘进去 → 点「校验并保存」不用建文件,最快

两种方式都会先验证再落盘:插件用 GET /api/v0/users/get_user_summary 试一次,失败会在面板里显示原因(过期、网络、返回格式不对),不会写入半截凭证。

第 3 步:首次同步

绑定成功后会自动跑一次同步,也可以随时点右上角「立即同步」。过程中按钮会显示当前阶段(同步中… → 同步费用… → 同步分时…),期间可以继续用别的设置页。

首次同步做的事:

  1. 以 30 天为窗口,从今天往前逐段拉取 usage/by_api_key/amount 与 usage/by_api_key/cost;
  2. 连续两个空窗口即停止——刚注册的账号通常 3 个窗口就结束,有两年历史的账号会多跑十几轮;
  3. 再抓今天和昨天的 bucket=3600 分时;
  4. 拉一次账号汇总(余额/累计花费)做快照。

请求是串行的,每个之间隔 300ms。第一次通常几秒到十几秒;历史越长窗口越多,按窗口数线性增长。

同步结束后,卡片和图表会自己刷新。标题行会显示「数据更新于 MM-DD HH:mm」。

读懂面板

① 概览卡片

卡片含义
累计 Tokens本地已有全部历史之和,副标题是请求数与覆盖天数
累计花费平台 cost 接口返回的金额之和,币种跟随平台
本月 Tokens当前自然月(GMT+8)的 tokens 与费用
今日 Tokens今天(GMT+8)的 tokens 与费用

② 每日用量

  • 右上角两个开关:分组(按模型 / 按计费类型 / 按 API Key)和范围(7 / 30 / 90 / 365 天 / 全部)。
  • 每根柱子是一天的总量,颜色按当前分组堆叠;图例在下方,带各段合计。
  • 鼠标悬停(或键盘 Tab 聚焦)任意柱子,会浮出当天明细:tokens、请求数、费用,以及占比最高的几段。
  • 点柱子进入该日分时视图;左上角「← 返回按天」回到日视图。
  • 没有数据的日期画成 0,而不是跳过——空档期不会被压缩成一格。

③ 分时视图

24 个小时一格不少(安静的凌晨也占一格)。柱高是当小时 tokens,悬浮能看到当小时费用与请求数。平台只保留最近两天的小时数据,更早的日期点进来会是空状态并给出说明。

④ 用量构成

「模型 / API Key」两个页签,列出该区间的 tokens、占比、请求数、费用。占比按 tokens 计算。

⑤ 凭证与数据

显示凭证来源(文件导入 / 手动粘贴)、保存时间、上次同步时间、数据覆盖范围、本地存储位置;「自动同步」下拉可选择间隔或关闭,右侧提示下次预计同步时刻;底部是「退出登录」和「清空数据」。

日常使用

  • 自动同步:默认每 30 分钟一次。到点且没有正在进行的同步时,插件在后台拉一次增量(1 个日窗口 + 今明两天分时 + 汇总,共 7 个请求),完成后面板自己刷新。间隔可在「凭证与数据 → 自动同步」里改成 15 分钟 / 1 小时 / 3 小时或关闭;关闭后仍会在启动时补一次(门槛 12 小时)。
  • 手动同步:右上角「立即同步」,任何时候都可以点;正在同步时按钮禁用。
  • 刷新:右上角「刷新」只重新读取本地数据和状态,不联网。
  • 退出登录:清除凭证,保留数据(之后可以换 token 再绑)。
  • 清空数据:删除全部用量/费用/分时行,保留凭证与自动同步设置,面板回到空状态。

日常使用

  • 自动同步:默认每 30 分钟一次。到点且没有正在进行的同步时,插件在后台拉一次增量(1 个日窗口 + 今明两天分时 + 汇总,共 7 个请求),完成后面板自己刷新。间隔可在「凭证与数据 → 自动同步」里改成 15 分钟 / 1 小时 / 3 小时或关闭;关闭后仍会在启动时补一次(门槛 12 小时)。
  • 手动同步:右上角「立即同步」,任何时候都可以点;正在同步时按钮禁用。
  • 刷新:右上角「刷新」只重新读取本地数据和状态,不联网。
  • 退出登录:清除凭证,保留数据(之后可以换 token 再绑)。
  • 清空数据:删除全部用量/费用/分时行,保留凭证与自动同步设置,面板回到空状态。