@dsh-external/dsh-wallet-switcher
第三方 API 接入 DSH 查询余额插件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Mengshang-spec/dsh-third-party-api-balance-wallet#3be2813d8e70af89bbbe3995726e086ef9904e17Wallet Switcher 以 @dsh-external/dsh-wallet-switcher 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DSH 输入框底部显示第三方 API 账户余额和今日用量的插件。
插件面向使用 Sub2API 搭建的站点，默认查询：
GET https://hgapi.dieqiyun.top/v1/usage
Authorization: Bearer sk-...
它使用长期 sk- API Key，不使用网页登录会话，因此不会因为网页登录 JWT 的 24 小时有效期而每天要求重新粘贴令牌。
当前版本：0.3.1
在 DSH 中运行：
dsh plugin --profile web add github:Mengshang-spec/dsh-third-party-api-balance-wallet
安装或升级后重启 DSH，让宿主和浏览器端插件重新加载。
如果 DSH 已经配置了目标站点的模型 provider，插件可以自动找到余额地址和 Key：
~/.dsh/settings.yaml 中的 provider 有 baseURL 和 apiKeyEnv；~/.dsh/.credentials.yaml 的 refs 中有对应的 apiKeyEnv；sk- 开头。插件会按 settings.yaml 中 provider 的顺序，选择第一个满足以下条件的 provider：
baseURL 是公网 HTTPS 地址；apiKeyEnv 和凭据。自动发现后，插件会查询：
{provider.baseURL}/v1/usage
因此，只要第三方站点是 Sub2API，并且已经作为 DSH provider 配置好，通常不需要在插件面板中填写任何内容。
自动发现失败时，点击余额面板右侧的设置按钮（齿轮）。
填写目标站点的长期 API Key，例如：
sk-xxxxxxxxxxxxxxxx
不要填写浏览器开发者工具中看到的网页登录 JWT，也不要填写 Authorization: Bearer eyJ... 这一类网页登录令牌。
Sub2API 站点通常填写：
https://你的站点/v1/usage
例如：
https://hgapi.dieqiyun.top/v1/usage
https://cfapi.dieqiyun.top/v1/usage
填入后点击“保存”。Key 会保存到 DSH profile 下的：
<DSH_PROFILE_DIR>/dsh-wallet-switcher/settings.json
如果没有设置 DSH_PROFILE_DIR，默认位置是：
~/.dsh/profiles/web/dsh-wallet-switcher/settings.json
“货币单位”是可选项，可以填写 USD、CNY、$ 或 ¥。插件不会自行换算金额，单位应以服务商面板显示为准。
对于标准 Sub2API 站点，插件假定余额接口返回类似结构：
{
"balance": 61.41163914,
"isValid": true,
"mode": "unrestricted",
"daily_usage": [
{
"date": "2026-09-13",
"requests": 46,
"total_tokens": 6244709,
"cost": 8.7992584,
"actual_cost": 2.1998146
}
]
}
插件也兼容余额字段：
balance
remaining
quota.remaining
如果站点不是 Sub2API，接口路径或返回字段可能不同，不能保证直接兼容。
也可以在启动 DSH 前设置：
$env:DSH_WALLET_USAGE_URL = 'https://hgapi.dieqiyun.top/v1/usage'
$env:DSH_WALLET_API_KEY = 'sk-xxxxxxxxxxxxxxxx'
$env:DSH_WALLET_CURRENCY = 'USD'
配置优先级从高到低：
插件面板保存的 settings.json
> DSH_WALLET_* 环境变量或插件配置
> DSH provider 自动发现
> 旧 accessToken 配置（仅当值本身是 sk- Key）
> 默认 https://hgapi.dieqiyun.top/v1/usage
确认 Key 属于当前余额接口对应的站点。不同站点的 Key 不一定通用。不要把网页登录 JWT 当成 API Key。
确认地址是否是：
https://站点/v1/usage
不要填写订阅列表接口、模型聊天接口或网页账户接口。
等待一段时间后再刷新。插件默认每 30 分钟查询一次，不会高频重试。
插件只允许公网 HTTPS 地址，以下地址会被拒绝：
http:// 地址；localhost、127.0.0.1；10.0.0.0/8、172.16.0.0/12、192.168.0.0/16 等内网地址；这是为了避免 DSH 宿主被当作 SSRF 请求跳板。
localStorage；升级时会清理 0.2.x 遗留的旧凭据；npm test
npm run check
当前测试覆盖余额解析、URL 安全校验、DSH 配置自动发现、宿主路由、凭据持久化和浏览器端轮询逻辑。