前言¶

DeepSeek Harness (DSH) 采用插件化架构。在开发或调试时，经常需要确认当前路由在提供者账本上的实际余额，而不是基于本地 Token 的估算。dsh-gateway-wallet 插件将此功能集成到侧边栏中，直接读取站点账本。

插件介绍¶

这是一个独立第三方社区项目，由 MuAllen 维护。它读取当前 API key 在站点账本上的剩余额度和实扣，支持 Sub2API、New API 与 DeepSeek 官方。本插件与 TokenLedger（用量账本）是互补关系：用量账本记的是本机会话里的 token；本插件读的是站点给这把 key 的余额。

安装与启用¶

需要使用 DeepSeek Harness 的 web profile。

dsh plugin --profile web add github:MuAllen/dsh-gateway-wallet

重启 DSH，并硬刷新浏览器。侧边栏底部会出现「站点余额」。

升级或卸载：

dsh plugin --profile web update dsh-gateway-wallet
dsh plugin --profile web remove dsh-gateway-wallet

核心功能¶

插件在 DSH 侧边栏左下角增加“站点余额”入口，点开后显示：

• 当前路由、令牌名、脱敏 Key（sk-••••xxxx）；配了多条路由时可切换查看。
• 金额信息：余额、今日实扣、累计已用。
• 用量统计：今日 / 累计 token 桶与请求数。
• 套餐信息：套餐名、RPM / TPM。
• 余额告警：余额低于 $1 / ¥5 时，侧边栏按钮打点（侧栏收起时仍能看见）。

支持范围与接口¶

插件通过探测接口返回来识别站点类型，并读取相应数据：

• Sub2API（如部分国内中转）：读取 /v1/usage。获取余额、今日/累计实扣、token 桶。
• New API / One API 等分支：读取 /api/usage/token/。获取额度、已用；今日仅日志完整返回时显示。key 额度不限时余额显示为未公布，令牌栏单独标明这把 key 不限。
• DeepSeek 官方：读取 /user/balance。仅显示余额；没有今日实扣。

对不匹配的站点会说明原因，不会按另一套程序换算额度。

注意事项¶

• 本插件是独立第三方社区项目，与 DeepSeek、各中转站均无隶属、赞助或背书关系。
• 面板上的金额以站点当时返回为准，不是对账单或税务凭证。接口变更、站点口径或网络失败都可能导致空白或与控制台不一致。
• 本软件按 MIT 许可证「按现状」提供，作者不对使用本插件造成的损失承担责任。
• 完整 API Key 仅在本机 Host 进程内用作 Authorization 头，不会进入浏览器，也不会发到本插件作者的任何服务器。

链接¶

• GitHub: https://github.com/MuAllen/dsh-gateway-wallet