shuai0503/dsh-plugin-provider-console ↗★ 2

dsh-plugin-provider-console

DeepSeek Harness 插件:多账户余额查询/刷新 + 通用模型 API 调用入口。Provider console for DeepSeek Harness: multi-account balance checks and a generic OpenAI-compatible invocation tool.

Package
dsh-plugin-provider-console
Compatibility
Unverified
Harness peer range
>=0.2.0-rc.2 || >=0.2.1-rc.2 || >=0.2.2-rc.1
Cordis peer range
^4.0.4 || >=4.0.6-alpha.2 <5.0.0
Version
0.2.3
License
MIT
Last updated
Nov 13, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:shuai0503/dsh-plugin-provider-console

零配置:自动识别已配置的服务商

大多数用户不需要写任何配置。

如果你的 DSH 已经配过某个服务商的 API Key(DEEPSEEK_API_KEY / MOONSHOT_API_KEY / ZHIPU_API_KEY / DASHSCOPE_API_KEY / SILICONFLOW_API_KEY 等),插件启动时会自动探测到, 直接生成对应账户。装完就能问「我还剩多少钱」。

设计上刻意注意了三点:

  • 探测行为说明 —— 首轮对每个服务商调用一次 ctx.credentials.resolve()(与 DSH 自身调用等价), 取到的值只存在于注册中心的内存私有表里,不落盘、不进配置文件、不进日志; listAccounts()、工具输出、诊断报告一律只见 hasApiKey 布尔值
  • 不会发任何网络请求 —— 探测只问 DSH 的凭据服务,不碰外部接口
  • 按需降级 —— 宿主没有凭据服务时静默跳过,其余功能完全不受影响(credentials 不是硬依赖)

配置项:

config:
  autoDiscover: true          # 默认 true,设为 false 可完全关闭自动探测
  autoDiscoverProviders: []   # 可选,只探测点名的服务商,如 [deepseek, zhipu]

探测结果可以随时问模型:「运行 provider_status」,它会告诉你开关状态、探测到几个、 以及每个服务商是「已配置」还是「未配置」。

顺序很重要:你显式配置的账户永远优先。自动探测遇到同名账户会跳过,一个字节都不改。

手动配置(需要多账户或自定义时)

自动探测只覆盖「一个服务商一个账户」的常见情况。要管理多个账户、自定义 label、 设置预警阈值时,再在 profile 的 cordis.patch.yml 里挂载:

- insert:
    - id: provider-console
      name: dsh-plugin-provider-console
      config:
        accounts:
          - id: ds-main
            provider: deepseek
            label: DeepSeek 主账号
            apiKeyEnv: DEEPSEEK_API_KEY
            defaultModel: deepseek-chat
            lowBalanceThreshold: 20

密钥放在哪里(按推荐顺序):

  1. 推荐:DSH 设置页 → 模型 / 凭据,填一次。 值会写进 ~/.dsh/.credentials.yaml 的 refs: 下, 自动探测读的就是这里,配完立即生效,无需重启。

  2. 也可以直接在账户里引用环境变量:

    apiKey: "${DEEPSEEK_API_KEY}"
    
  3. 环境变量(有坑,最后选):把变量设到系统/用户环境变量里,然后重启 DSH 应用。

    ⚠️ DSH 桌面版是 Electron 进程,只继承启动它时的环境变量。 在另一个 PowerShell 窗口里 export 对已经运行的 DSH 完全无效—— 这是最常见的「我明明设了却提示没有 Key」的原因。

配置落点写清楚之后,验证只有三步:

  1. 重启 DSH
  2. 打开左侧栏「服务商控制台」——看到账户表就是生效了
  3. 看不到就跑一次 provider_status,把输出贴上来排查

也可以把账户写成 JSON 文件放进 accountsDir 目录批量管理,见 examples/accounts.json。