前言¶

DeepSeek Harness（DSH）通过插件扩展能力，模型接入通常写在 settings.yaml 或依赖 llm-pi-ai 相关配置。当你需要对接多个 OpenAI 兼容或 Anthropic 协议端点、为每个模型单独设置上下文窗口、推理能力与重试策略时，手写 YAML 容易出错，也不便于在运行中的 Harness 里快速试错。

下面介绍社区插件 marvekg/deepseek-harness-model-config（维护者 MarvekG）。它在 Harness Web UI 中增加「模型高级配置」页面，用图形界面创建自定义模型端点，并为每个模型编辑能力参数。

这是什么¶

该插件面向已安装并可运行的 dsh 用户，在 Web 端提供模型端点与 per-model 参数管理，底层仍走 Harness 的 llm-pi-ai 配置流程。插件在 GitHub 上约 30 stars（截至 2026-08-26），采用 MIT 许可证；社区目录页见 SkillHub。SkillHub 为独立社区站点，与 DeepSeek / 幻方无官方从属关系。

核心功能¶

端点管理¶

• 新增自定义端点：名称、URL、API Key 和协议。
• 支持在 provider 层配置自定义请求 Header，并应用于模型请求；「获取可用模型」仍使用 API Key。
• 协议支持 openai-completions、openai-responses、anthropic-messages。
• 通过统一的 GET /models 流程拉取候选模型，支持按模型 ID 或显示名称搜索、全选、反选和全不选。
• 无需拉取即可手动输入模型 ID；重复 ID 会直接选中已有模型。
• 新增端点与已保存端点共用编辑器；已保存端点可重新拉取模型，新增模型默认不勾选，已有勾选在刷新后保留。

端点高级参数¶

端点高级参数包括默认容量、输入模态、推理兼容、缓存、传输、超时和重试策略。一般保持默认即可。完整说明见仓库文档 llm-pi-ai 参数参考。

模型参数与 models.dev 补全¶

从 models.dev 补全缺失的上下文窗口、最大输出、输入模态和推理能力；优先按显示名称（回退到模型 ID）选择官方 provider，找不到时选择默认 provider，并可在保存前切换完整 provider 记录。保留端点返回或用户输入的显示名称原始大小写；编辑显示名称后会重新匹配 provider。

保存前可编辑每个模型的容量、文本/图片输入和 reasoningEfforts，并查看不含密钥的配置预览。模型参数一般能自动填写，前提是要能访问 https://models.dev。

安全与国际化¶

API Key 仅经 Harness 凭据存储写入，不会进入 settings.yaml 或配置预览。所有界面文案支持中文和英文，跟随 Harness 语言设置。

安装与启用¶

需要已安装并可运行的 dsh。默认从 GitHub 安装到 Web profile：

dsh plugin --profile web add github:MarvekG/deepseek-harness-model-config
dsh web

打开 Web UI 的「设置 → 模型高级配置」，即可新增端点或编辑现有 llm-pi-ai 模型配置。

如需固定版本，在仓库地址后附加 commit SHA：

dsh plugin --profile web add github:MarvekG/deepseek-harness-model-config#<sha>

安装前建议阅读仓库源码与 MIT 许可证。插件以当前 dsh 进程权限运行，安装即授予其对 Harness 配置与凭据存储的访问能力。

典型用法¶

新增端点并勾选模型¶

1. 启动 Web UI 后进入「设置 → 模型高级配置」。
2. 填写端点名称、BASE_URL、API-KEY，选择协议。
3. 点击获取模型，在列表中勾选需要的模型 ID。
4. 检查端点高级参数（通常保持默认）和模型参数（重点核对上下文大小、最大输出长度）。
5. 确认配置预览无误后保存。

也可跳过拉取，直接手动输入模型 ID 添加；若 ID 已存在，会自动选中对应条目。

编辑已有端点¶

已保存端点可在同一编辑器中修改。需要更新模型列表时，对端点执行重新拉取；刷新后新增项默认不勾选，原有勾选状态会保留。

本地调试¶

克隆仓库后，在仓库根目录以本地 link: 依赖安装：

dsh plugin --profile web add .
dsh web

更新与卸载¶

更新采用「先卸载旧版本，再安装新版本」：

dsh plugin --profile web remove dsh-models-config-plugin
dsh plugin --profile web add github:MarvekG/deepseek-harness-model-config
dsh web

本地调试时，将第二条命令替换为 dsh plugin --profile web add .。

卸载：

dsh plugin --profile web remove dsh-models-config-plugin

注意：卸载命令使用的插件 ID 为 dsh-models-config-plugin（见 package.json 的 name 字段），与 GitHub 仓库名不同。

适用场景与注意¶

适合需要在 Harness Web UI 中集中管理多个 LLM 端点、并为每个模型单独调整容量与推理参数的场景，例如对接自建 OpenAI 兼容网关、Anthropic 代理，或在同一 Harness 实例中混用多家模型。

使用前请确认：

• 已安装并可正常启动 dsh web。
• 端点 URL 与协议选择与上游服务一致。
• 若依赖 models.dev 自动补全参数，运行环境需能访问 https://models.dev。
• 自定义 Header 仅作用于模型推理请求，不影响拉取模型列表时的鉴权方式。

链接¶

• 社区目录：SkillHub - deepseek-harness-model-config
• 源码与文档：GitHub - MarvekG/deepseek-harness-model-config

经过上面的步骤，你可以在 Harness Web UI 里完成端点创建、模型选择与 per-model 参数调整，而无需反复手写 settings.yaml。