前言¶

用 DeepSeek 开放平台做 API 调用时，tokens 和真实花费分散在 platform.deepseek.com 的「用量信息」里。若你已经在 DeepSeek Harness（DSH）里做客户端或智能体开发，再单独开浏览器对照账单，切换成本高，也不便于和本地开发环境放在一起看。

下面介绍社区插件 dsh-deepseek-platform-usage（维护者 xixi66666，分类：客户端）：把平台账单口径的每日 tokens、费用，以及按模型 / 计费类型 / API Key 的拆分和分时明细，放进 DSH 设置页的「平台用量」面板。数据来自平台页面调用的私有接口，非官方工具；接口无公开文档，可能随平台改版失效，仅适合统计本人账号。

这是什么¶

• 仓库： xixi66666/dsh-deepseek-platform-usage
• 目录页： SkillHub 插件条目
• 当前版本（资料）：0.1.3，许可 MIT
• 定位：DeepSeek 开放平台账单用量面板（DSH 插件），按模型 / 计费类型 / API Key 展示每日 tokens 与费用，含某天的 24 小时明细；不需要额外开桌面程序。

插件以当前 DSH 进程权限运行，会向 https://platform.deepseek.com 发起同步请求；安装前建议自行查看源码与许可证。

核心功能¶

资料中明确的能力如下。

概览

• 今天 / 本月 / 累计的 tokens 与花费（平台账单口径，不是按价格表本地估算）。
• 累计花费取自平台 cost 接口，币种跟随平台（通常 CNY）。

维度与趋势

• 切换「按模型 / 按计费类型 / 按 API Key」看同一段时间占比。
• 每日堆叠柱状图，范围可选 7 / 30 / 90 / 365 天或全部历史。
• 点击任意一天的柱子，进入该日 24 小时分时；平台只保留最近两天的小时数据，插件每次同步会把当时能拿到的两天存到本地。

同步与存储

• 首次同步以 30 天为窗口向前拉取用量与费用，连续两个空窗口停止；再抓今、昨分时并拉账号汇总。
• 默认每 30 分钟自动增量同步（可改为 15 分钟 / 1 小时 / 3 小时或关闭）；也可手动「立即同步」。
• 数据与 userToken 存在 DSH 插件存储（ctx.storage 单元 dsh_platform_usage），不上传第三方。

统计口径（摘要）

• tokens = input_cache_hit_tokens + input_cache_miss_tokens + output_tokens；不把会与拆分桶重复的汇总桶计入。
• 日期按 GMT+8 切日，与运行机器时区无关。
• 单账号：换账号需先「清空数据」再同步。

环境要求¶

安装与启用¶

插件包不在 npm 上，需在本仓库源码目录打包成 tarball 再装进 web profile。资料中的命令如下（路径请换成你本机实际位置，Windows 建议用正斜杠）。

# 1. 在源码目录打包
cd <本仓库源码目录>
npm pack
#    → dsh-deepseek-platform-usage-0.1.3.tgz

# 2. 装进 web profile（路径用正斜杠）
dsh plugin --profile web add file:C:/path/to/dsh-deepseek-platform-usage-0.1.3.tgz

安装会把包写入 profile 的 dependencies、追加到 dsh.profile.bundles，并解压到 node_modules。完成后重启 DSH Desktop（或由 HMR 重新组合），再刷新页面（Ctrl+R）；设置页左侧会出现「平台用量」。

说明：Windows 上若用 dsh plugin add file:D:/某个目录（目录而非 tarball），可能因 pnpm 路径解析报 ENOENT，应走 tarball。

典型用法¶

1、拿到 userToken¶

在已登录 https://platform.deepseek.com 的浏览器中任选一种方式：

DevTools：Application → Local Storage → 键 userToken，复制整段 JSON 或其中 value 字段。

Console 一行（DevTools 内）：

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

Network：任一条 /api/v0/usage/... 请求的 authorization: Bearer 后面那段。

token 等价于该账号的只读账单权限，按密码对待，不要提交进仓库或发到聊天。

2、绑定凭证¶

设置 → 平台用量 →「绑定平台凭证」：

• 从 token.json 导入：路径形如 {"user_token": "..."}，也接受平台 localStorage 格式或纯文本；点「导入并验证」。
• 或切到「粘贴 userToken」→「校验并保存」。

绑定前会用 GET /api/v0/users/get_user_summary 验证，失败不会写入半截凭证。

3、首次同步与日常操作¶

绑定成功后会自动同步，也可点右上角「立即同步」。同步阶段会显示「同步中…」「同步费用…」「同步分时…」等提示。

• 刷新：只读本地，不联网。
• 退出登录：清凭证，保留历史数据。
• 清空数据：删全部用量行，保留凭证与自动同步设置。

读懂面板时：概览卡片看累计 / 本月 / 今日；每日图用分组与范围开关；点柱子进分时；「用量构成」页签看模型与 API Key 占比（按 tokens）。

适用场景与注意¶

适合谁

• 已在 DSH（web profile）里开发、希望在本机设置页对照 DeepSeek 开放平台真实账单与用量的开发者。
• 需要按模型、计费类型、Key 看趋势，并偶尔下钻到最近两天的小时明细的人。

务必知晓的限制

• 依赖平台未公开的私有接口，改版可能导致同步失败（会报错，不会静默算错）。
• 分时仅平台保留的最近两天；更早日期只有按日汇总。
• 当前版本无数据导出/导入；无自定义起止日期（仅预设天数与「全部」）；一次只绑一个 userToken。
• 插件 HTTP 路由仅服务回环地址；写操作需本次启动的 capability token。

社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文介绍的是社区维护的客户端类插件。

结尾¶

dsh-deepseek-platform-usage 把 DeepSeek 开放平台账单用量搬进 DSH 设置页：平台口径的费用与 tokens、多维拆分、日趋势与有限的分时明细，配合自动或手动同步在本机留存。若你要安装，以 README 中的 tarball 流程为准，并留意 DSH 与 Node 版本要求。

• 目录页：https://www.skillhub.cn/plugins/xixi66666/dsh-deepseek-platform-usage
• GitHub：https://github.com/xixi66666/dsh-deepseek-platform-usage