前言¶
DeepSeek Harness (DSH) 支持 openai-completions、openai-responses 和 anthropic-messages 等自定义协议。手动配置这些协议的模型能力、元数据以及 Headers 往往比较繁琐。dsh-relay-models 插件通过 Web 界面提供解决方案：它从 pi.dev 目录获取模型信息并自动补全，支持供应商列表的拖拽排序，以及 Headers 和 User-Agent 的覆写。
核心功能¶
- 混合协议模型发现与元数据匹配：自动补全缺失的模型名称、上下文窗口和输出上限。
- Web 配置：提供可视化的模型列表和供应商管理界面。
- 自定义提供方模型能力：支持为自定义提供方添加模型能力。
- Headers 编辑：支持编辑请求 Headers。
- User-Agent 覆写：支持覆写请求的 User-Agent。
- 供应商列表拖拽排序：支持通过拖拽或键盘快捷键调整供应商顺序。
- 自动兼容性对齐：自动对齐当前 Host 的 schema，不维护自己的白名单。
安装与启用¶
使用 npm 安装插件：
npx @deepseek-ai/dsh@latest plugin --profile web add dsh-relay-models@latest
也可以从 GitHub 安装：
npx @deepseek-ai/dsh@latest plugin --profile web add github:Xichun123/dsh-relay-models
安装后重启对应 profile 并刷新 Web 页面。
典型用法¶
模型补全¶
- 打开 DSH 设置 -> 模型。
- 添加自定义提供方，填写协议、API 地址和凭据。
- 插件会自动从 pi.dev 目录匹配模型，并补全名称、上下文窗口等元数据。如果未匹配，可以手动选择目录模型。
- 点击宿主的“保存”按钮以持久化补全后的字段。
Headers 与 User-Agent 覆写¶
- 先保存自定义提供方。
- 打开编辑 -> 自定义设置 -> API 协议下方的 Headers (JSON)。
- 填写字符串值的 JSON 对象，例如：
{
"User-Agent": "claude-cli/2.1.263 (external, cli)",
"X-Tenant": "example"
}
- 点击 保存 Headers。此字段单独提交，不由下方宿主的“保存”按钮提交。
- Headers 存入 DSH 原生配置
llm-pi-ai.providers.<提供方 ID>.headers。
供应商排序¶
在 设置 -> 模型 中，拖动供应商名称左侧的 ⠿ 手柄调整位置，松开后自动保存。也可以用 Tab 聚焦手柄后按 ↑ / ↓ 键调整。
注意事项¶
- 依赖要求：插件运行在 DeepSeek Harness，需要 peer 依赖
^0.1.3-alpha.2 || ^0.1.5-alpha.1。 - Headers 保存：Headers 需要单独保存，不会与主设置一起提交。若 Headers 格式错误，不会阻止主设置的保存。
- 排序范围：供应商排序仅保存在当前浏览器、当前站点的
localStorage中，刷新或重新打开设置后保留，但不会影响 API 调用优先级。 - 重试机制：插件不管理失败重试，完全依赖 Host 的原生发现机制。
- 兼容性对齐：兼容性自动跟随当前 Host 的 schema，不导入其他适配器包。
结语¶
该插件通过 Web 界面解决了 DSH 自定义协议配置繁琐的问题，适合需要管理多供应商、自定义 Headers 或希望自动同步模型元数据的用户。更多详情及源码请访问 GitHub 仓库。
