前言¶
在 DeepSeek Harness（DSH）里跑推理和 Agent，难免会关心平台侧的钱包余额、累计消费和按 API Key 的用量。常规做法是离开 Harness，打开 platform.deepseek.com/usage，重新登录后再对账。步骤分散，且本地日志估算与平台计费口径也不一定一致。
下面介绍的插件 dsh-deepseek-usage-overview（维护者 user654name，仓库 GitHub）是面向 DSH Web GUI 的客户端类插件：在 Harness 内部注册为 shell.overlay 内页，用 DSH 已登录的 DeepSeek 平台账号拉取与官方用量页同源的聚合数据，而不是要求复制 Platform userToken，也不从本地会话估算费用。
这是什么¶
一句话定位：DeepSeek Harness Web 界面里的内嵌用量面板，展示充值余额、累计消费、按时间与 API Key 的筛选汇总，以及消费柱状图。
- 分类：客户端（浏览器半区 + 宿主半区 bundle）
- 许可证：MIT（见仓库
LICENSE） - 当前版本（
package.json）：0.1.0 - 前置：
@deepseek-ai/dsh >= 0.2.2，Node.js >= 20；须在「设置 → 账号与余额」登录 DeepSeek 账号。仅配置推理用DEEPSEEK_API_KEY不足以让本插件工作。
核心功能¶
打开方式¶
- 侧边栏底部「用量」按钮（设置按钮旁；侧边栏收起时仅图标）
- 设置面板标题栏「用量」按钮（关闭按钮旁）
- 窗口右下角约 200 px 区域内双击（若安装了右下角小鲸鱼挂件，双击鲸鱼身体同样生效）
页面内容¶
| 区块 | 说明 |
|---|---|
| 余额 | 充值余额、赠送余额（有则显示）、余额预警、「去充值」 |
| 累计消费 | 账户币种的平台累计消费 |
| 筛选 | 今天 / 昨天 / 近 7 天 / 近 30 天 / 本月；按 API Key 过滤；清除筛选；CSV 导出 |
| 汇总 | 所选时间与 Key 的消费金额、API 请求次数、Tokens |
| 图表 | 消费柱状图（今天按小时、更长区间按天）；可在「调用类型（模型 / 工具）」与「按 API Key」分组间切换 |
UI 跟随 Harness 明暗主题与语言（中英）；浏览器半区为手写 window.__ModuleLoader__ bundle，无需单独构建。
工作原理（简要）¶
浏览器内页通过 GET /api/deepseek-usage/overview 向本机 DSH Host 取数。宿主半区用 deepseekAccount.getPlatformSession() 取得已登录凭据，再请求平台用量页使用的私有接口（如 get_user_summary、usage/by_api_key/amount 与 cost 等），聚合并缓存 30 秒。响应中不包含账号 token 或平台原始敏感载荷，仅聚合数字与 Key 显示名；路由仅接受本机回环 GET，非本机返回 403。
安装与启用¶
安装前请自行查看仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，会代表已登录账号访问 platform.deepseek.com 相关接口。
前置：Web GUI 可用，且已在 DSH 中登录 DeepSeek 平台账号。
从 GitHub 安装（资料原文命令）：
dsh plugin --profile <profile> add github:user654name/dsh-deepseek-usage-overview
从本地目录安装：
dsh plugin --profile <profile> add /绝对路径/dsh-deepseek-usage-overview
常见 profile：桌面端用 desktop，dsh web 用 web。安装后强制刷新 Web 页面（Ctrl+F5），避免浏览器缓存旧客户端 bundle。
插件以 bundle 挂载：cordis.patch.yml 挂宿主半区，package.json 的 dsh.client 声明浏览器半区；不需要额外配置项（空 config: {} 即可）。
典型用法¶
- 完成安装并刷新页面后，用上述任一入口打开用量内页。
- 在顶部选择时间维度，必要时在 API Key 下拉框中只查看某一个 Key。
- 查看余额、累计消费与汇总卡片；在图表区切换分组方式阅读消费趋势。
- 需要离线对账时，使用 CSV 导出当前筛选下的明细。
- 若数字与平台页略有差异：平台数据最多延迟约 5 分钟，页面另有 30 秒内存缓存，可点刷新；加
refresh=1可绕过缓存（宿主 API 参数，见 README）。
未登录时页面显示本地化「未登录」；某个私有接口失败时可能提示「用量明细暂时不可用」，余额与累计消费仍可能可见。
适用场景与注意¶
适合谁
- 日常在 DSH Web 中开发、调试 Agent，希望不离开界面就对齐 平台真实计费口径 的用量与余额。
- 多 API Key 场景下需要按 Key 看金额、请求次数与 Tokens，并导出 CSV。
务必注意
- 依赖 DeepSeek 账号登录，纯 API Key、未登录平台的场景不支持。
- 上游为平台未公开的私有接口，平台变更可能导致明细降级（余额 + 累计消费仍可显示）。
- 仅展示平台暴露的 CNY / USD 等钱包逻辑；多币种按 README 说明选取。
- 社区目录 SkillHub 插件页 与 GitHub 为独立生态信息源，与 DeepSeek / 幻方无官方应用商店从属关系。
结尾¶
经过上面的步骤，你可以在 DSH 侧边栏或右下角双击直接进入用量面板，减少跳转浏览器和二次登录。进一步细节、FAQ 与已知限制见仓库 README。
- 目录页：https://www.skillhub.cn/plugins/user654name/dsh-deepseek-usage-overview
- GitHub：https://github.com/user654name/dsh-deepseek-usage-overview
