DSH 提供插件扩展能力。在智能体开发或调试过程中，需要实时掌握 DeepSeek 账户的剩余额度。dsh-balance 插件将余额信息直接嵌入输入框工具行（模型选择器旁），无需切换页面即可查看。
插件说明¶
- 项目名称：
wyxcn445/dsh-balance - 维护者：Wyxcn445
- 许可证：MIT
核心功能¶
- 余额胶囊：在输入框工具行显示主钱包余额（优先显示人民币），附带状态色点。
- 明细面板：点击胶囊展开面板，查看充值余额（各币种）、赠送额度、用量明细、去充值入口及最近更新时间。
- 自动刷新：每 20 秒自动刷新；标签页重新可见时立即刷新；打开面板时强制刷新。
- 降级处理：未登录、服务缺失或查询失败时，显示可读提示，不会导致输入框报错。
数据来源与安全¶
- 链路设计：浏览器端不直接访问平台接口。账户凭证只在宿主侧可见。
- 请求路由：通过宿主端注册的只读路由
GET /api/dsh-balance获取数据。 - 访问限制：该路由仅接受来自回环地址（127.0.0.1 / ::1）的请求。
- 鉴权机制：该路由未走 DSH 的令牌鉴权，仅靠回环限制。
- 性能说明：余额查询属于外部网络请求，首次加载可能有短暂延迟。
前置条件¶
本插件读取的是 DSH 内置 deepseekAccount 服务的账户数据。
已在 DSH 中登录 DeepSeek 账号（平台会话）。只配置了
DEEPSEEK_API_KEY但未在 DSH 里登录账号的用户，胶囊会显示「余额未登录」。
安装与启用¶
dsh plugin --profile <你的profile名> add github:Wyxcn445/dsh-balance
安装后刷新浏览器页面即可看到余额胶囊。
使用¶
- 无需配置：接口为只读，无需任何配置项。
- 查看余额：刷新页面后，在输入框工具行（模型选择器旁）查看余额胶囊。
- 查看明细：点击胶囊展开面板，查看详细的充值、赠送及用量信息。
注意事项¶
- 凭证安全：浏览器端不直接访问平台接口，凭证只在宿主侧可见。
- 网络请求：余额查询属于外部网络请求，首次加载可能有短暂延迟。
- 访问范围：仅接受来自回环地址（127.0.0.1 / ::1）的请求。
- 鉴权方式：该路由未走 DSH 的令牌鉴权，仅靠回环限制。
