dsh-provider-pro：为自定义供应方补全官方能力

前言¶

DeepSeek Harness (DSH) 的 llm-pi-ai provider 允许用户手动添加自定义供应方，但默认状态下，这些自定义渠道缺失了部分官方渠道才有的能力，例如 User-Agent 控制、推理等级切换和图片输入声明。

dsh-provider-pro 是一个由 Mortal520 维护的插件，它为这些手动添加的供应方补上了上述能力。它通过数据层的自动补全和运行时的配置覆盖，实现了零逐模型配置的开箱即用体验。

核心功能¶

本插件主要提供以下四种能力：

1. 自定义 User-Agent
   为每个自定义供应方设置请求 UA。这会覆盖 DSH 内置的 attribution 头，可用于应对按 UA 限流的供应方，或禁止非官方终端访问的策略。
2. 推理等级切换
   在对话模型选择器中提供与官方渠道相同的下拉菜单（off/low/medium/high/max）。数据层会自动为缺少 reasoningEfforts 的自定义模型补全五档词典，无需手动配置。
3. 图片输入声明
   在模型卡片中提供“支持图片输入”复选框。勾选后，插件会将 input: [text, image] 写入模型配置，使 DSH 允许向该模型附加图片。
4. 一键全量探测与测活
   提供内置的探测功能，针对每个模型进行三项实测：
   • 上下文窗口：拉取并回填 contextWindow/maxTokens。
   • 角色兼容：测试 developer 角色兼容性，若被拒且 system 可用，自动修复。
   • 图片输入与延迟：发送真实流式请求验证图片接受情况及首 token 延迟。

安装与启用¶

插件需要 DSH Desktop 2.0.15+ 环境运行。

使用以下命令安装（需指定 --profile desktop）：

dsh plugin --profile desktop add github:Mortal520/dsh-provider-pro

如果上述命令因构建权限问题失败，也可以直接使用仓库内已提交的构建产物：

# 本地仓库方式
dsh plugin --profile desktop add ./dsh-provider-pro

# tarball 方式（需先 pnpm pack）
dsh plugin --profile desktop add ./dsh-provider-pro-0.6.1.tgz

安装完成后，必须重启 DSH Desktop 应用 才能使插件生效。

使用方法¶

安装后，在 DSH 的「设置」页面中找到「模型增强」部分（通常位于「模型」下方）。

1. 开启总开关：
   找到“为全部自定义模型启用推理等级切换”开关并打开。关闭后，自动补全的档位会被移除。
2. 配置 User-Agent：
   为每个供应方填写 User-Agent 并保存。留空保存即清除覆盖。
3. 声明图片输入：
   在模型卡片中勾选“支持图片输入”复选框。
4. 实测：
   点击模型旁的“探测”按钮，进行全量测活。

注意事项¶

• 环境要求：必须使用 DSH Desktop 2.0.15+（对应 dsh-* 0.1.7-rc.2 版本）。旧版设置模型（settings.yaml 退役）将无法使用。
• UI 语言限制：对话模型选择器内部的档位名（如 Off / Minimal / Max）是 dsh-llm-pi-ai 硬编码的英文，第三方插件无法修改。中文功能仅限于本插件的设置页。
• 补档器生效范围：推理等级的自动补档器只对手声明 models[] 的条目生效，不触碰 modelOverrides 与官方渠道。

总结¶

dsh-provider-pro 通过插件化的方式，将官方渠道的高级配置能力（UA、推理等级、图片输入）下放到了自定义供应方，解决了手动配置繁琐的问题。适合需要在 DSH 中集成自定义 API，但又希望保持官方渠道同等交互体验的用户。

• GitHub 仓库
• 社区目录