dsh-ai-wallet
DSH 插件：多个 AI 提供商的一键账户余额和配额面板（DeepSeek、Zhipu GLM、Z.ai、Moonshot、MiniMax、StepFun、SiliconFlow、OpenRouter、xAI）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:gouzijing0821/dsh-ai-wallet#69bdc3e5d5e4671445fca55383f01668858f0c49Ai Wallet 以 dsh-ai-wallet 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DSH（DeepSeek Harness）AI 钱包插件——可拖动悬浮球实时显示当前使用模型的余额 / 配额，点击展开多供应商余额面板。
液态玻璃（默认）/ 浅色玻璃 / 磷光绿 / 赛博青 / Dracula / Nord 冰蓝 / 琥珀 / 羊皮纸——面板底部一键切换，主题与悬浮球位置持久化到服务端文件（~/.dsh/dsh-ai-wallet.prefs.json），不随 DSH 端口变化丢失。
| ID | 名称 | 类型 | 需要的 Key |
|---|---|---|---|
deepseek | DeepSeek | 金额余额 | DEEPSEEK_API_KEY |
zhipu | 智谱 GLM | 配额 | ZP_API_KEY / ZHIPU_API_KEY |
zai | Z.ai (GLM 国际) | 配额 | Z_AI_API_KEY |
moonshot | Moonshot Kimi | 金额余额 | MOONSHOT_API_KEY |
minimax | MiniMax | 配额 | MINIMAX_API_KEY |
stepfun | StepFun 阶跃星辰 | 金额余额 | STEP_API_KEY |
siliconflow | SiliconFlow 硅基流动 | 金额余额 | SILICONFLOW_API_KEY |
openrouter | OpenRouter | 金额余额 | OPENROUTER_API_KEY |
xai | xAI / Grok | 金额余额 | XAI_API_KEY |
说明：
- 供应商 API 以官方文档为准，字段可能随版本调整。
xai使用社区维护的非官方 credits 端点（xAI 预付费 credits 无公开 API），若失效会显示错误。- 仅控制台查询、无公开余额 API 的供应商（通义千问、百川、Groq）暂不支持；OpenAI / Anthropic 普通 key 查不了用量，故未内置。
dsh plugin --profile desktop add dsh-ai-wallet
重启 DSH 后生效。
默认启用 deepseek + zhipu。在 profile 的 cordis.patch.yml 中覆盖：
- id: dsh-ai-wallet
config:
providers:
- deepseek
- moonshot
- zhipu
providers 数组顺序即面板展示顺序，支持全部供应商 ID 中的任意子集。
不在内置白名单、或走私有端点的供应商，可通过 config.customProviders 声明式接入，无需改源码。支持 quota 与 balance 两种类型，鉴权支持 bearer（默认）与 cookie。
- id: dsh-ai-wallet
config:
providers:
- deepseek
- my-gateway
customProviders:
- id: my-gateway
name: 内部网关
kind: quota # quota | balance
url: https://your-gateway.example.com/api/profile/quota
auth: cookie # cookie | bearer
keyNames: [GATEWAY_COOKIE]
fields:
level: data.status
limits:
# 单条配额可省略 items；多条时写响应里数组的路径
# items: data.plans
label: 月度配额
remaining: data.remainingCny
total: data.limitCny
percentage: data.utilizationPercent
resetTime: data.period.resetsAt
字段说明：
id / name：供应商标识与面板显示名。kind：quota（进度条 + 剩余/重置）或 balance（金额行）。url：余额/配额接口地址。auth：cookie 时把 keyNames 读到的值放进 Cookie 头；bearer（默认）放 Authorization: Bearer <value>。keyNames：读取凭据的环境变量名（.env / ~/.dsh/.credentials.yaml），按顺序尝试。fields.limits：quota 响应的字段映射（均为到响应的点路径）。label 可为路径或常量文本；items 可选，指向响应里的数组以显示多条配额。fields.rows：balance 时的行映射，[{ label, path, suffix? }]。lib/index.js — 服务端：/ds-balance/v1 余额聚合路由、/ds-balance/v1/prefs 偏好读写路由；PROVIDERS 注册表 + collect() 汇总；注入 sessionQuery 从 DSH 会话推断当前模型（assistant/message 事件 → source.provider/model → PROVIDER_ALIASES 映射）lib/client.js — 客户端：悬浮球 + 面板渲染、主题系统、拖拽；当前模型与映射由服务端于 active.balanceProvider 下发，客户端只渲染不推断新增供应商：在 lib/index.js 的 PROVIDERS 中加一项 { name, kind, keyNames, fetch(key) }，或按上文通过 config.customProviders 声明式接入；两种方式客户端都无需改动。
MIT