前言¶
DeepSeek Harness (DSH) 的状态栏中存在两个独立的钱包来源：一个是登录账号的 Platform 钱包（包含充值与赠送余额），另一个是 API Key 对应的官方余额。目前的社区插件大多只覆盖了 API Key 余额，无法查看登录账号内的实际可用资金。
dsh-dual-balance 插件将这两个来源统一展示在状态栏中。它利用 DSH 内置的 deepseekAccount 服务读取账号余额，同时调用官方 /user/balance 接口读取 Key 余额。对于同一笔钱，它会自动合并显示；对于不同账号，则并排展示。
核心功能¶
- 双余额显示：同时显示登录账号的 Platform 钱包余额与 API Key 余额。
- 智能折叠：当两个来源属于同一账号时，自动折叠为一段显示。
- 详情面板：点击药丸状图标可展开详情，包含充值/赠送明细。
- 零配置：无需额外配置，安装后即用。
- 安全可靠：密钥仅在 Host 进程内使用，浏览器只通过只读路由读取数字。
- 失败处理：读取失败时保留上次成功值并标记
⚠，绝不显示为 0。 - 视觉对齐：复用官方 CSS 原语，与状态栏其他药丸像素级对齐。
安装与启用¶
本插件要求 DSH 版本 0.1.5-rc.1 或更高，以及 Node.js >= 20。包内自带预构建的 lib/，无需额外构建步骤。
从仓库安装（推荐）：
dsh plugin --profile web add github:fangweixuan26-hash/dsh-dual-balance
从本地目录安装（用于开发调试）：
dsh plugin --profile desktop add /path/to/dsh-dual-balance
安装后，Web 端与 Desktop 端界面会自动刷新。若未变化，请手动刷新页面。
卸载：
dsh plugin --profile web remove dsh-dual-balance
使用说明¶
安装完成后，状态栏会出现一枚新的药丸。药丸会根据当前状态显示不同内容：
- 同一账号：显示为
余额 ¥9.49。 - 不同账号：显示为
账号 ¥13.78 | API ¥2.00。 - 账号未登录：显示
账号 未登录。 - API Key 未配置：显示
API 未配置。 - 读取失败：保留上次成功值并标记
⚠。 - 不可达：显示
余额不可用。
刷新逻辑：
- 空闲 60 秒自动刷新一次。
- 点击药丸打开面板时强制刷新一次。
技术细节¶
- 口径：优先显示 CNY，若无 CNY 则显示绝对值最大的币种。
- 折叠判定：当两个来源均就绪、币种相同且账号侧总额与 API 侧总额差值 ≤ 0.01 时，视为同一笔钱进行折叠。
- 依赖：零 npm 运行时依赖。
- 安全：账号凭证与 API Key 仅在 Host 进程内使用，浏览器通过本地只读路由获取数据。
总结¶
dsh-dual-balance 解决了 DSH 用户无法在状态栏直接查看登录账号 Platform 钱包余额的问题。它通过复用官方原语，提供了安全、稳定且视觉一致的余额查看体验。
