DeepSeek Harness (DSH) 的模型管理页面,官方适配器存在功能缺失。插件 dsh-llm-hub 旨在补全这些缺失的能力:网关可达性探测、模型目录拉取并勾选写回、余额/配额常驻显示,以及协议与接入地址的可见性。该插件由 webkubor 维护,遵循 MIT 协议。
核心功能¶
插件为模型页提供了以下能力:
- 余额与配额常驻:卡片下方常驻显示余额信息,支持阈值预警。
- 模型目录拉取:支持一键拉取网关在售列表,实测可拉取 71 个模型(针对 modelgo)。
- 网关探测与状态:显示实测延迟、健康状态与在售数量;若未配置 baseURL,会明确提示。
- 用量统计:统计本月用量,展示前 5 个最常用模型,支持 CSV 导出。
- 可用性过滤:静默从下拉列表中移除确凿不可用的 provider,并在卡片上标红提示原因。
- 子代理工具:安装后自动注册 codex、claude、agy 等外部 agent 工具。
安装与启用¶
该插件零运行时依赖,不改动 DSH 安装。
- 执行安装命令:
npx @deepseek-ai/dsh plugin --profile web add @dsh-plugins/dsh-llm-hub
-
将
@dsh-plugins/dsh-llm-hub加进~/.dsh/profiles/web/package.json的dsh.profile.bundles数组。 -
重启 DSH(boot graph 变了必须重启,热载不生效)。
典型用法¶
- 模型发现:进入「设置 → 模型」,选择 DeepSeek(官方直连)卡片,点击「获取可用模型」。
- 旁路卡详情:在任意 pi-ai provider(如 modelgo、minimax、zai-coding-cn)卡片下方,可查看探测结果、拉取目录及余额信息。
- 家族面板:在设置 → 模型底部,可查看「Webkubor DSH 扩展家族」状态。
行为与注意¶
- 密钥解析:与官方适配器一致,支持
request.baseURL、request.apiKey、环境变量$DEEPSEEK_BASE_URL等顺序。 - 安全:余额接口仅允许同源读取,拒绝跨站读取。
- 不可用过滤:隐藏 provider 的判定只认确凿证据(fail-open 策略),拿不准一律保留,以避免误藏可用模型。
- 无破坏性变更:旧版配置在升级后仍兼容。