DeepSeek Harness 可以接第三方 API 吗？插件化架构下的模型接入全攻略
DeepSeek Harness 是 DeepSeek 开源的 Agent 运行框架，核心设计是 "一切皆插件"（Everything is a Plugin）。关于 "能否接第三方 API" 这个问题，答案是：完全可以。Harness 通过插件化架构原生支持接入第三方模型 API，无论是 OpenAI、Anthropic、智谱 GLM、MiniMax 等商业模型，还是 Ollama 等本地部署模型，均可通过配置或插件无缝接入。
一、三种接入方式
根据需求不同，接入第三方 API 主要有以下三种方式：
方式一：通过设置界面添加预置提供方（最推荐）
这是最便捷的方式，无需接触配置文件。在 Harness Web UI 中打开 设置 → 模型，点击 添加提供方，从列表中选择 OpenAI、Anthropic 等预置提供方，填入 API 密钥并保存即可。
方式二：通过社区插件一键接入
社区已开发了大量 Provider 插件，支持一键接入各类模型。以 dsh-provider-quick-config 插件为例，安装后会在 Web UI 的发送按钮旁边显示一个 "+" 按钮。点击即可在界面中配置模型提供方，无需手动编辑配置文件。预置厂商包括智谱 GLM、MiniMax、OpenAI GPT、Anthropic Claude、本地模型（Ollama），端点、协议、推理格式、模型列表全部预填。安装命令如下：
dsh plugin --profile web add dsh-provider-quick-config安装后重启 Harness 即可生效。
方式三：自定义提供方（适合自建网关或未收录厂商）
如果目标模型不在预置列表中，可选择 添加自定义提供方。填写 Provider ID、Base URL、API 协议、API 密钥以及至少一个模型 ID 即可。这一步同样可在 Web UI 中完成，无需手写配置文件。
二、技术原理：为什么能接得这么灵活？
Harness 之所以能灵活接入第三方 API，关键在于其 LLM 适配器层的设计。Harness 内置了通用多提供方适配器，基于 @earendil-works/pi-ai 构建。
这一层的核心能力是：接入 OpenAI 兼容网关、自建服务，或比已安装 catalog 更新的提供方，都属于配置而非改代码。每个提供方的端点、协议格式、模型列表都可以通过配置声明，不需要修改 Harness 源码。已配置的提供方会继承端点、协议与模型 catalog，并支持逐字段覆盖。
三、已确认支持的第三方 API
根据官方文档和社区实践，目前已确认可接入的第三方 API 包括：
| 提供方 | 接入方式 | 说明 |
|---|---|---|
| OpenAI | 预置提供方 / 社区插件 | 支持 GPT 系列模型 |
| Anthropic Claude | 预置提供方 / 社区插件 | 支持 Claude 系列模型 |
| 智谱 GLM | 社区插件 | 支持 GLM 系列模型 |
| MiniMax | 社区插件 | 支持 MiniMax 系列模型 |
| Ollama（本地） | 社区插件 | 支持本地部署的开源模型 |
| OpenAI Codex | 社区插件 | 通过 dsh-codex-provider 接入 |
| 百度千帆 | 自定义提供方 | 通过 OpenAI 兼容协议接入 |
| 任何 OpenAI 兼容网关 | 自定义提供方 | 自建代理或第三方网关 |
四、常见注意事项
1. 密钥存储位置
API 密钥存储在 $DSH_HOME/.credentials.yaml 中，设置页面保存后只显示脱敏后的描述符，不会暴露明文密钥。
2. 自定义提供方的视觉模型配置
如果自定义提供方的模型支持图像输入，需要在 $DSH_HOME/settings.yaml 中为该模型显式声明 input: [text, image]，否则 Harness 会将其视为纯文本模型。
3. 原生认证提供方需特殊配置
Bedrock、Vertex、Azure 和 Codex 等提供方使用原生认证方式（AWS 凭证、ADC 项目、OAuth 等），仅填写 API 密钥无法完成配置。
4. 社区插件的稳定性
Harness 目前仍处于 Developer Preview 阶段，官方明确提醒未来会出现破坏兼容性的变更。社区插件由第三方维护，使用前建议查看其活跃度和更新频率。
五、总结
DeepSeek Harness 通过 "一切皆插件" 的架构，原生支持接入第三方 API。无论是通过 Web UI 添加预置提供方、安装社区插件一键接入，还是自定义提供方接入自建网关，都可以在不修改源码的情况下完成。目前已确认可接入 OpenAI、Anthropic、智谱 GLM、MiniMax、Ollama、百度千帆等主流模型 API。对于大多数用户，推荐通过 Web UI 添加预置提供方或安装社区插件，这是最快捷的方式。
