前言¶
DeepSeek Harness (DSH) 是一个 OpenAI 兼容的适配器，其配置主要通过 settings.yaml 文件管理。DSH 的模型页面仅编辑了端点、凭证和模型列表等常见字段，许多决定请求成败的关键配置——如重试策略、超时设置、请求头、User-Agent 以及推理（Reasoning）的具体参数——隐藏在 YAML 文件中，无法通过界面直接操作。
DSH 的核心理念是“一切皆插件”。dsh-advanced-provider-settings 插件旨在解决这一痛点，它通过 WebUI 将这些隐藏的配置项暴露出来，允许在不直接编辑 YAML 文件的情况下，对 Provider 进行精细化管理。
插件简介¶
这是一个由 misswell 维护的 WebUI 插件。它通过 DeepSeek Harness 的扩展插槽注入 UI，直接操作 llm-pi-ai 命名空间的设置，实现了对 Provider 级别配置的图形化管理。该插件使用 DeepSeek Harness 内置的 revision-fenced settings transport 进行安全写入，确保配置文件的注释和未修改字段保持原样。
核心功能¶
该插件支持从模型级到 Provider 级别的多维度配置：
-
思考等级映射
支持off,minimal,low,medium,high,xhigh,max等全等级配置。可以设置路由默认等级，也可以为每个模型单独配置等级映射，以及每级的 Token 预算。 -
第三方 DeepSeek 端点配置
针对非deepseek.com域名的第三方端点（如自建 vLLM、云网关），允许手动声明方言（dialect）、推理努力程度（reasoning effort）以及修正max_tokens字段的拼写，从而确保请求格式符合端点要求。 -
模型级通道编辑
针对路由级别的models列表和目录（catalog）路由采用不同的编辑通道。目录路由可通过modelOverrides编辑显示名称、上下文窗口和最大输出 Token。 -
Provider 级别配置
提供全局和单 Provider 的请求头设置、User-Agent 预设（Chrome, Safari, Firefox 等）、重试策略（预设或自定义）、超时设置、传输方式、Vision 图像预算以及 26 个兼容性标志。 -
安全写入机制
通过 revision-fenced settings transport，插件在不修改 Harness 源代码、不进行 DOM 抓取、不修改node_modules的情况下，安全地将配置写入 YAML 文件。
安装与启用¶
安装该插件需要 Node.js 版本 >= 20。
dsh plugin add github:misswell/dsh-advanced-provider-settings
安装完成后，插件会自动注入到 DSH 的 Web UI 中，并在模型列表和提供商卡片中显示相应的编辑入口。
典型用法¶
该插件主要应用于以下场景：
-
对接第三方 DeepSeek 端点
当将 DSH 指向一个非官方域名（如公司代理或自建网关）时，插件允许你显式声明thinkingFormat为deepseek，设置推理等级，并修正字段拼写（如使用max_tokens而非 OpenAI 的max_completion_tokens），从而在请求发送前预览并确保格式正确。 -
目录路由模型覆盖
如果路由引用了已安装的目录，插件允许你通过modelOverrides针对特定模型调整显示名称、上下文窗口大小和最大输出 Token。 -
满足网关白名单
某些网关客户端有白名单限制。利用插件提供的 User-Agent 预设（如 Chrome、Safari、Firefox），可以满足网关对客户端标识的要求。
适用场景与注意¶
- 版本兼容性：该插件当前版本为 v0.4.7，已针对 DeepSeek Harness 0.2.0-rc.2 和 0.2.1-alpha.4 进行了验证。
- 权限与安全：插件运行在 DSH 进程的上下文中，安装前应检查其源代码和许可证（MIT）。
- 功能范围：该插件专注于 Provider 级别的通用配置，不涉及凭证管理等敏感信息的直接编辑。
结语¶
dsh-advanced-provider-settings 弥补了 DeepSeek Harness 在配置管理上的空白，将 YAML 中的深层配置转化为可视化的操作面板，降低了对接第三方 DeepSeek 端点的门槛，提升了调试和维护的效率。
