前言¶
用 DeepSeek Harness（DSH）跑模型时，账户里还剩多少额度往往要另开网页或控制台去查。侧栏里只有会话、模型和「More」菜单，余额不在视线范围内，调 key 或排查「为什么突然 401」时也不方便对照。
下面介绍社区插件 DeepSeek Balance（仓库 brunojomosi/dsh-plugin-deepseek-saldo）：在左侧边栏 More 按钮正上方增加一行余额，复用 DSH 里 deepseek-official 提供方同一套 DEEPSEEK_API_KEY，不额外装依赖。维护者为 Brunojomosi；在 SkillHub 目录中归类为客户端插件。DSH 生态主张「一切皆插件」，SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
DeepSeek Balance 是一个 DSH 客户端插件：从 DeepSeek 官方余额接口读取充值 + 赠送合计金额，按浏览器区域设置格式化显示；失败时在行内显示 —，原因放在悬停提示里。
界面示意（来自 README）：
[icon] Balance US$ 12.34
[•••] More
核心功能¶
以下能力均来自仓库 README，可与实现对照。
- 数据来源：宿主侧请求
GET https://api.deepseek.com/user/balance，使用已配置的DEEPSEEK_API_KEY（与 DSH Models 页或启动进程环境变量中的 key 一致）。 - 展示内容：显示 API 返回的总余额及币种（多为 USD）；悬停可见赠送额、充值额、上次读取时间及使用提示。
- 刷新策略：窗口可见时每 60 秒自动刷新；点击该行可强制重新拉取（绕过宿主约 30 秒的缓存）。
- 失败处理：缺 key、401/403、网络超时等会在 tooltip 说明；余额低于新请求所需下限时以警告色提示。
- 隐私边界：对外仅访问
https://api.deepseek.com/user/balance；密钥留在宿主进程，页面通过已认证的 DSH Connection 路由/api/deepseek-balance/state只拿到数字、币种与时间戳；无遥测、不写文件、不读 cookie/localStorage、不执行命令。
实现结构上，宿主入口为 lib/index.js（注册路由并调 API），浏览器侧为 lib/client.js（在 sidebar.footer.action 注册行），cordis.patch.yml 将 deepseek-balance 写入 profile Loader；设置 → 插件列表中的标题与描述见 locale/en.json、locale/zh.json。
环境与依赖¶
- DSH 版本：README 写明在 0.2.1-rc.2 上测试（使用客户端 slot API 与带认证的 harness Connection）。
- 凭证：必须配置
DEEPSEEK_API_KEY（DSH Models 页面，或启动 DSH 的进程环境变量）。 - 其它：无第三方依赖、无安装脚本；许可证 MIT（
package.json版本 1.0.2）。
安装与启用¶
插件以本机文件夹形式由 DSH 链接安装，文件夹需长期保留；README 建议放在例如：
%USERPROFILE%\.dsh-plugins\dsh-plugin-deepseek-saldo
避免放在「下载」或 DSH 安装目录内，以免清理或升级误删。
在 DSH 已打开的前提下，向智能体说明本地包的绝对路径，由 plugin_manager 安装。README 示例（路径按你的机器修改）：
install the plugin from the folder
C:\path\to\clone
首次安装后侧栏行会自动出现，无需重启。若从设置 → 插件卸载后重装同一包，浏览器模块 id 为 dsh-plugin-deepseek-saldo，DSH 可能缓存旧模块为 absent，行需重启应用后才恢复——属 harness 行为，非插件独有逻辑。
卸载：设置 → Plugins → DeepSeek Balance → uninstall，或使用 plugin_manager 的 remove_bundle；若提示则需重启。
典型用法¶
- 确认 Models 或环境中已配置有效的
DEEPSEEK_API_KEY。 - 安装插件后展开左侧边栏，在 More 上方查看 Balance 行。
- 需要即时数字时点击该行；细节（赠送/充值/时间）鼠标悬停查看。
- 侧栏收起到约 56 px 窄轨时该行会隐藏，需展开侧栏才能看到。
适用场景与注意¶
适合：长期在 DSH 里用 DeepSeek 官方 API、希望侧栏一眼看到余额、避免频繁切到网页控制台的用户。
限制（README 原文）：
- 余额对应当前
DEEPSEEK_API_KEY的 API 账户；环境里更换 key 后，下一轮刷新会读新账户。 - API 币种限于 CNY 或 USD；双钱包并存时行上优先 USD，另一币种在 tooltip；无其它币种与换算。
- 插件在 当前 DSH 进程权限下运行，安装前宜自行审阅源码与 MIT 许可证；仅信任维护者与仓库内容后再安装。
