DSH（DeepSeek Harness）提供了一个统一的对话与管理界面，但在实际使用中，开发者往往需要同时对接 DeepSeek、智谱、Moonshot 等多个服务商。频繁切换到各个平台查看余额或配额会打断工作流。
dsh-ai-wallet 插件在 DSH 界面右下角提供了一个可拖动的悬浮球，实时聚合显示当前对话模型对应的余额/配额，点击展开即可查看所有已配置供应商的金额余额或配额余量。
核心功能¶
悬浮球与面板是插件的主要交互形式。悬浮球固定在界面任意位置，支持自由拖动，位置会自动记忆。
球面会实时显示当前对话正在使用的模型对应的余额/配额（数据基于最近一次模型调用推断，每 60 秒自动刷新）。点击球体或遮罩层可展开完整的余额面板。
面板提供以下能力：
- 一屏查看所有已配置供应商的金额余额或配额余量。
- 对于配额型供应商，展示进度条与重置时间。
- 支持手动刷新，并对未配置 Key 或 API 错误提供友好提示。
插件内置 8 套主题（包括液态玻璃、浅色玻璃、赛博青、Dracula 等），可在面板底部一键切换。主题与悬浮球的位置会持久化保存到服务端文件（~/.dsh/dsh-ai-wallet.prefs.json），不随 DSH 端口变化丢失。
安装与启用¶
通过命令行安装插件。安装后需重启 DSH 才能生效。
dsh plugin --profile desktop add dsh-ai-wallet
配置与使用¶
默认情况下，插件会启用 deepseek 和 zhipu 两个供应商。在 profile 的 cordis.patch.yml 中覆盖配置，可以调整面板展示顺序或启用特定供应商。
- id: dsh-ai-wallet
config:
providers:
- deepseek
- moonshot
- zhipu
providers 数组中的顺序决定了面板上各供应商的排列顺序。
自定义供应商接入¶
对于不在内置白名单中的供应商，或者使用私有端点的供应商，可通过 config.customProviders 声明式接入，无需修改源码。支持 quota（进度条）与 balance（金额行）两种类型，鉴权方式支持 bearer（默认）与 cookie。
- id: dsh-ai-wallet
config:
providers:
- deepseek
- my-gateway
customProviders:
- id: my-gateway
name: 内部网关
kind: quota
url: https://your-gateway.example.com/api/profile/quota
auth: cookie
keyNames: [GATEWAY_COOKIE]
fields:
level: data.status
limits:
label: 月度配额
remaining: data.remainingCny
total: data.limitCny
percentage: data.utilizationPercent
resetTime: data.period.resetsAt
支持的供应商¶
插件内置支持以下供应商的余额查询：
- DeepSeek
- 智谱 GLM (Zhipu)
- Z.ai (GLM 国际)
- Moonshot (Kimi)
- MiniMax
- StepFun (阶跃星辰)
- SiliconFlow (硅基流动)
- OpenRouter
- xAI (Grok)
注意事项¶
- xAI 限制：
xai供应商使用的是社区维护的非官方 credits 端点。由于 xAI 预付费 credits 没有公开 API，若该社区端点失效，面板会显示错误。 - 不支持查询的供应商：仅控制台查询、无公开余额 API 的供应商（如通义千问、百川、Groq）暂不支持。OpenAI 和 Anthropic 的普通 Key 也不支持用量查询，故未内置。
- 权限与安全：插件以 DSH 进程权限运行。安装前建议检查源码与许可证（MIT）。
总结¶
dsh-ai-wallet 通过悬浮球与面板的形式，将多供应商的余额与配额查询集中在 DSH 界面内。开发者无需离开当前工作流即可监控资源使用情况，适合需要同时管理多个 AI 服务账户的场景。
