前言¶
在 DeepSeek Harness 里跑智能体时，模型调用会消耗 API 额度；DeepSeek 控制台也能看到账户余额和平台侧消费，但开发过程中若要在 Harness Web 界面里一眼看到「还剩多少、本月花了多少、今天本地跑了多少 token」，往往要在浏览器标签和终端之间来回切。社区插件 dsh-deepseek-balance（维护者 changan0617，分类：客户端）在 Web 配置页注册一块可拖拽、可折叠的浮动卡片，集中展示账户余额、平台官方消费统计，以及 Harness 本进程内的本地用量计数。
这是什么¶
dsh-deepseek-balance 是面向 DSH Web UI 的客户端插件：宿主侧提供余额查询、llm/stream 用量统计和 HTTP JSON 路由；Web 侧注入浮动卡片 UI。它解决的是「在 Harness 里开发、调试时同步掌握 DeepSeek 余额与两类用量（平台账单 vs 本地调用）」的问题，而不是替代 DeepSeek 官方控制台。
- 仓库：changan0617/dsh-deepseek-balance
- 社区目录页：skillhub.cn 插件条目
- 当前 package 版本：1.1.0（MIT 许可证）
核心功能¶
下面介绍插件在资料中明确列出的能力。
Web 浮动卡片¶
插件在 shell.overlay 上注册浮动卡片，默认位于右上角，支持拖拽与折叠。
账户余额¶
展示 DeepSeek 账户余额（总额 / 赠送 / 充值部分），每 60 秒 刷新一次。
平台官方消费¶
从 DeepSeek 控制台使用的私有 Dashboard 接口读取当月消费、当日消费、当月 token 用量：
platform.deepseek.com/api/v0/usage/costplatform.deepseek.com/api/v0/usage/amount?month=<M>&year=<Y>
认证方式为浏览器里的平台 userToken（资料说明：JSON.parse(localStorage.userToken).value）。API Key 无法访问这些接口。若返回码 40002 / 40003，表示 token 已过期，需要重新获取。
userToken 在卡片里手动填写，仅保存在内存中，不会写入磁盘。
本地用量（Harness 侧）¶
展示「今日」在 Harness 内统计的本地数据：API 请求次数、输入/输出 token、缓存命中次数。统计来源是 Harness 自身的 llm/stream 调用，不是 DeepSeek 平台账单；进程重启后计数会清零。
API Key 解析顺序¶
查询余额等需要 Key 的操作，按以下优先级解析：
- 卡片内手动输入的 Key（内存）
- credentials 服务中的
DEEPSEEK_API_KEY - 环境变量
DEEPSEEK_API_KEY
工程布局（便于审阅源码）¶
| 路径 | 作用 |
|---|---|
package.json |
声明 dsh.client（Web bundle）及 ./client 导出 |
lib/index.js |
宿主：llm/stream 计数、HTTPS 余额查询、/api/dsh-deepseek-balance JSON 路由 |
lib/client.js |
Web 浮动卡片 UI（plain __ModuleLoader__ 格式，无构建步骤） |
安装与启用¶
资料中的安装方式为手动放置包目录，并在 profile 组合里插入 Cordis 补丁，没有 dsh plugin add github:... 一类的一行命令。按下面步骤操作。
- 将插件安装到：
~/.dsh/profiles/node_modules/dsh-deepseek-balance
- 在
~/.dsh/profiles/web/cordis.patch.yml中增加插入项：
- insert:
- id: deepseek-balance
name: dsh-deepseek-balance
- 下次启动 Harness 后生效。
卸载时：删除上述 insert 条目，并删除 node_modules 下对应目录。
peer 依赖（安装时需满足版本约束，见仓库 package.json）包括 @deepseek-ai/cordis、@deepseek-ai/dsh-credentials、Web 客户端 UI 与 @deepseek-ai/dsh-host-webserver 等，具体范围以仓库为准。
典型用法¶
经过上面的安装步骤后，打开 DSH Web 配置/Profile 界面，应能看到右上角浮动卡片。
- 若需平台侧「本月/今日消费」：在 DeepSeek 控制台页面从
localStorage.userToken取得有效 token，填入卡片；token 过期时按接口错误码重新获取。 - 若余额查询未自动命中 Key：按优先级在卡片输入 Key，或配置 credentials / 环境变量
DEEPSEEK_API_KEY。 - 本地用量块用于观察当前 Harness 进程内的调用量，便于调试；与平台账单对账时以控制台为准。
宿主还提供 JSON 路由 /api/dsh-deepseek-balance，可供同一 Web 服务下的其他集成读取聚合数据（字段以实现为准，见 lib/index.js）。
适用场景与注意¶
适合谁：长期在 DSH Web UI 里开发、需要同时看余额、平台消费和本进程调用量的 DeepSeek API 用户。
务必知晓：
- 平台消费数据来自非公开 Dashboard 接口，可能无预告变更；依赖新鲜的 userToken，与 API Key 权限模型不同。
- 本地用量仅统计 Harness 内
llm/stream，重启清零，不是平台计费数据。 - 插件以当前 DSH 进程权限运行；安装前请阅读 GitHub 源码 与 MIT 许可证，自行评估 Key、token 在内存中的处理方式是否可接受。
- SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；本文事实以仓库 README 与
package.json为准。
结尾¶
dsh-deepseek-balance 把 DeepSeek 余额、平台 Dashboard 消费与 Harness 本地 stream 用量收拢到 Web 界面一块卡片里，减少在控制台与 Harness 之间切换的成本。进一步了解可访问 社区目录页 与 GitHub 仓库。
