前言¶
在 DeepSeek Harness（DSH）里用 DeepSeek 模型对话或跑智能体时，Platform 上的充值余额和赠送额度不会自动出现在界面里。常见做法是打开浏览器登录 Platform 查 Usage，或自己写脚本调余额接口——打断工作流，也容易在余额不足时才从报错里发现。
下面介绍维护者 JaMoLpE88 发布的客户端插件 dsh-deepseek-balance（npm 包名 @jamolpe88/dsh-deepseek-balance）。它在 Composer 工具栏里显示紧凑余额 pill，点击可展开各币种的充值、赠送与合计，并链到官方 Usage / Top up 页面；无需单独配置 API Key 或插件设置页。
这是什么¶
dsh-deepseek-balance 是 DSH 的 客户端（Composer UI） 插件：在共享居中的 pill 组里展示当前 DeepSeek 账户各币种余额，点击打开详情对话框。
插件读取 DSH 已保存的 DEEPSEEK_API_KEY，或在未配置 Key 时使用 Harness 内已登录的 DeepSeek 账户；不读 Platform Cookie、不爬 Usage 页、不在插件内再存 Key。分类上属于 DSH 社区目录中的「客户端」类插件；安装与源码见 SkillHub 目录页 与 GitHub 仓库。
核心功能¶
已核实能力如下（与 README 一致）：
- 紧凑 pill：同一行展示账户持有的各币种余额，格式类似
[logo] $8.23 · ¥120.00；赠送部分带礼物图标，充值部分为 plain 数字；余额为 0 的币种不在 pill 里出现。 - 详情对话框：点击 pill 打开；每种币种分别显示 topped-up、granted、total（含零值）；另显示多币种合计说明（如
$8.23 + ¥120.00，因币种不可相加）；无余额或 API 表明余额不足以支撑调用时以红色提示 No balance。 - 官方链接：对话框内提供 Platform Usage 与 Top up 入口。
- 刷新：默认每 60 秒拉取一次，窗口重新可见时也会刷新；对话框内可手动 Refresh。
- 显示条件：仅当 Composer 当前模型属于 DeepSeek 提供商（
deepseek-official或deepseek-account）时显示；新建空 Session、尚未发送首条消息时，若模型控件指向 DeepSeek，pill 也会出现。 - 布局：与同作者其他 Composer 插件共用居中 pill 组，多个 pill 并排居中、间距固定；Composer 行过窄时整组隐藏。
插件不做的事：不展示赠送过期倒计时（官方无可用接口）、不保存余额历史或图表、不增加 Agent 工具或命令、非 DeepSeek 模型选中时不渲染任何 UI。
安装与启用¶
环境要求（来自 README）：
- DSH Desktop，版本
>= 0.2.1-rc.3，profile 为desktop（文档在0.2.1-rc.3、Windows 11 上测试）。 - Settings → Models 中已配置 DeepSeek 提供商（
DEEPSEEK_API_KEY），或已在 Harness 登录 DeepSeek 账户。 - Node 22+（由 DSH 自带运行时满足）。
从 npm 安装：
dsh plugin --profile desktop add @jamolpe88/dsh-deepseek-balance
从 GitHub 安装：
dsh plugin --profile desktop add github:JaMoLpE88/dsh-deepseek-balance
安装后刷新 DSH 窗口。在任意 Session 里将活动模型选为 DeepSeek 提供商即可在 Composer 看到 pill。
插件无配置文件、无设置页、无阈值或刷新间隔自定义项——有 DeepSeek 模型与凭证时 Host 侧调官方余额 API，无则整插件不显示。
典型用法¶
- 在 Settings → Models 配好 DeepSeek，或在 Harness 登录 DeepSeek 账户。
- 在 Composer 选择 DeepSeek 提供商下的模型；pill 出现在工具栏居中 pill 组中，可与同作者其他 pill 并排。
- 点击 pill 打开详情；需要即时数据时点 Refresh。
- 点对话框外、按 Escape 或再次点击 pill 关闭。
Host 侧对带 Key 的场景调用：
GET https://api.deepseek.com/user/balance
Authorization: Bearer <DEEPSEEK_API_KEY>
无 Key 时由 Host 通过已登录账户的 getBalance 等价读取；浏览器侧仅访问同源路由 /api/deepseek-balance 与 /api/deepseek-balance/refresh，Key 不进入前端。
本地诊断（DSH 运行时端口每次启动可能变化，以当前界面 URL 为准）：
curl http://127.0.0.1:59863/api/deepseek-balance
返回余额、数据来源、错误码与新鲜度标记，不包含 Key。
适用场景与注意¶
适合：长期在 DSH Desktop 用 DeepSeek 官方或账户模型、希望在写 prompt 前一眼确认各币种充值与赠送余额、并快速跳转充值或用量页的用户。
注意：
- 插件以当前 DSH 进程权限 运行，Host 会使用 DSH 凭证服务中的
DEEPSEEK_API_KEY（环境变量DEEPSEEK_API_KEY为后备）。安装前请自行查看 仓库源码 与 MIT 许可证（package.json当前版本 0.1.2）。 - 文档写明平台测试侧重 Windows 11；其他桌面环境需自行验证。
- DSH 插件生态遵循「一切皆插件」；SkillHub 目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
上游失败时插件保留上次已知余额并标记 stale，不会清空 pill；结果在 Host 侧缓存约 55 秒，与 60 秒轮询共享请求。
结尾¶
dsh-deepseek-balance 把 DeepSeek Platform 的多币种余额收进 Composer 一行 pill 和可点击详情，零配置依赖 DSH 已有凭证或登录态。需要安装说明与行为细节时，以 README 为准：
