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.
설치
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
密钥放在哪里(按推荐顺序):
-
推荐:DSH 设置页 → 模型 / 凭据,填一次。 值会写进
~/.dsh/.credentials.yaml的refs:下, 自动探测读的就是这里,配完立即生效,无需重启。 -
也可以直接在账户里引用环境变量:
apiKey: "${DEEPSEEK_API_KEY}" -
环境变量(有坑,最后选):把变量设到系统/用户环境变量里,然后重启 DSH 应用。
⚠️ DSH 桌面版是 Electron 进程,只继承启动它时的环境变量。 在另一个 PowerShell 窗口里
export对已经运行的 DSH 完全无效—— 这是最常见的「我明明设了却提示没有 Key」的原因。
配置落点写清楚之后,验证只有三步:
- 重启 DSH
- 打开左侧栏「服务商控制台」——看到账户表就是生效了
- 看不到就跑一次
provider_status,把输出贴上来排查
也可以把账户写成 JSON 文件放进 accountsDir 目录批量管理,见 examples/accounts.json。