dsh-provider-billing

English | 中文

DeepSeek Harness 提供方账户余额插件（独立维护，不在官方仓库内）。在 Models 设置页的每个提供方行内显示该路由所存 API 密钥对应的余额，每个路由带刷新控件。密钥从不离开宿主：浏览器只发送路由 id，宿主从配置面解析端点和凭据后，询问提供方的 OpenAI 兼容 /user/balance 端点。

宿主要求：本插件渲染在 Models 页的 settings.models.row 贡献洞中，该洞只由较新的 harness 构建声明。旧版宿主不受支持：插件会打印明确的加载失败报错，而不是静默降级。请勿在不受支持的宿主上安装。

安装

三种方式等价，任选其一：

1. npm

dsh plugin --profile web add dsh-provider-billing

已发布到 npm：dsh-provider-billing —— 最省事的方式：tarball 自带构建好的 lib/ 与 cordis.patch.yml，安装时不执行任何构建。

2. GitHub

dsh plugin --profile web add github:ZeroingIn/dsh-provider-billing

GitHub 直装获取的是源码：安装时 pnpm 会运行本包的 prepare 脚本（tsdown，完全自包含——不依赖兄弟 checkout，不从 npm 解析 @deepseek-ai/*）。pnpm ≥10 会要求先显式放行构建脚本——把 pnpm 打印的包键加入 profile 的 pnpm-workspace.yaml：

allowBuilds:
  dsh-provider-billing: true

放行 = 允许在安装时执行本包代码。如需锁定构建，可在包名后追加 commit：github:ZeroingIn/dsh-provider-billing#。

3. tarball

pnpm pack        # 产出 dsh-provider-billing-0.1.1.tgz
dsh plugin --profile web add ./dsh-provider-billing-0.1.1.tgz

本地开发

dsh plugin --profile web add link:/绝对路径/dsh-provider-billing

link: 直接链接本目录：改代码 → pnpm build → 宿主半改动重启 dsh web，仅客户端改动刷新浏览器即可（客户端 bundle 实时服务在 /plugins/dsh-provider-billing/client.js）。稳定后切 npm/GitHub 分发。

配置

- id: provider-billing
  name: dsh-provider-billing
  config:
    providers: [deepseek-official]

providers 指名可检查的提供方路由（目录中不存在的路由不会出现）。UI 固定为 Models 行内形态（settings.models.row）——没有其他形态，不做向下兼容。

工作原理

• 宿主半（src/index.ts）：一个插件行通过 注册回环钉住的通用 RPC 通道（，端点 /），回环围栏由 Connection 强制（与特权 方法同一道围栏）。 解析路由的已存密钥与端点（profile → 派生 → 适配器默认，每个都先查凭据 seam 再查信任环境，先命中者胜出）后请求 。