kkbsgg/dsh-balance

dsh-balance

CI
License
Version

DeepSeek Harness 插件，在编辑器的模型座位旁以一小段文本显示所选模型提供商的账户余额，前提是为当前对话选择了一个模型（及其推理强度）。

工作原理

- 宿主端（lib/index.js，一个 Cordis 插件）在 webserver 上挂载一个回环 HTTP 路由——GET /dsh-balance/balance?provider=。该路由通过标准凭据服务解析所选提供商自身的 API 密钥（DeepSeek 官方路由使用 llm-deepseek 配置段，自定义/其他路由使用 llm-pi-ai 提供商表），然后探测提供商的余额：先尝试 DeepSeek 风格的 GET /user/balance，回退到 OpenAI 风格的 GET /v1/dashboard/billing/credit_grants。密钥绝不会跨越网络边界。
- 客户端端（client/client.js，一个 Web 客户端插件）在 conversation.input.right 插槽中注册一个座位（紧邻模型选择器）。它订阅活动会话的模型选择目录（modelDirectories），将所选提供商传递给路由，并且仅在选择了 id 非空的模型后才渲染——空选择会隐藏文本，而不是保留过期的余额。每 60 秒轮询一次；点击文本可立即刷新。

安装

从源码安装（任意 DSH 配置文件）

该包声明了 dsh.bundle 清单，因此一旦仓库可解析，即可通过标准插件命令安装：

dsh plugin add @kkbsgg/dsh-balance

手动安装（打包版 DSH Desktop）

当该包可从配置文件的 node_modules 解析时，向配置文件补丁（$DSH_HOME/profiles//cordis.patch.yml）添加一行加载器条目：

- insert:
- id: balance
name: 'dsh-balance'

然后重启应用，以便加载器组合新条目。之后对客户端 bundle 的编辑会通过客户端 HMR 通道热重载。

对于打包版 DSH Desktop 应用，该包位于应用的解包 node_modules 中，并以 junction 形式链接到 $DSH_HOME/profiles/node_modules，因此配置文件加载器解析它的方式与内置插件完全一致。

注意：该包是手动安装到 pnpm 管理的提升存储中的。
之后在配置文件中执行 pnpm install 可能会将其清除；如果在插件市场安装后余额文本消失，请重新创建该链接。

仓库结构

dsh-balance/  (@kkbsgg/dsh-balance)
├── lib/index.js           # 宿主端（Cordis 插件 + 余额路由）
├── client/client.js       # 客户端端（Web 客户端插件 bundle）
├── test/smoke.test.mjs    # 宿主端冒烟测试（运行：node test/smoke.test.mjs）
├── cordis.patch.yml       # dsh.bundle 补丁（市场可安装性）
├── package.json           # dsh.bundle + dsh.client 清单
├── CHANGELOG.md
├── .editorconfig
└── README.md

当前安装在 DSH Desktop 应用中的实时副本位于该应用的
解包后的 node_modules 下；此仓库是唯一可信来源。在此处更改代码后，
请将文件重新同步到已安装的副本中（或从此仓库安装该包并重新创建
配置文件链接）。

响应结构
jsonc
{ "ok": true, "isAvailable": true,
"balanceInfos": [{ "currency": "CNY", "totalBalance": "110.00", "grantedBalance": "10.00", "toppedUpBalance": "100.00" }],
"fetchedAt": "2026-01-01T00:00:00.000Z" }
{ "ok": false, "code": "no-api-key", "message": "no credential configured for DEEPSEEK_API_KEY" }