DeepSeek Harness 接入 NixAPI：自定义模型 API 配置教程

从安装 DeepSeek Harness 到添加自定义 OpenAI 兼容提供商，配置 NixAPI 地址、密钥和模型，并验证工作区内的工具调用。

DeepSeek Harness（DSH）是 DeepSeek 开源的 Agent 工具，提供桌面端和 Web UI。它支持自定义模型 API，因此可以按照 OpenAI 兼容协议配置 NixAPI。本文按 2026 年 10 月 30 日的官方文档整理；配置方式经过文档核对，实际调用取决于你的 Key 权限与所选模型的协议支持。

1. 准备接口信息

在 NixAPI 控制台创建 API Key，并从官网模型定价页复制一个支持工具调用的聊天模型 ID。

配置项	值
提供商 ID	`nixapi`
显示名称	`NixAPI`
Base URL	`https://api.nixapi.com/v1`
API 协议	OpenAI Chat Completions
API Key	你的 NixAPI Key
模型 ID	从当前模型列表复制

模型 ID 不是显示名称。不要直接把 NIXAPI_MODEL_ID 当成真实模型提交，也不要把官网地址 https://nixapi.com/pricing 当成 API 地址。

2. 启动 DeepSeek Harness

从 DeepSeek Harness 官网下载桌面版。也可以安装 Node.js 后，在终端运行官方命令：

npx @deepseek-ai/dsh web

Web UI 默认使用 http://127.0.0.1:3080；若终端打印了其他地址，以终端输出为准。安装与启动说明见官方 README。

3. 添加自定义提供商

打开 设置 → 模型 → 添加模型提供商，切换到 自定义模型 API（Custom model API），按照上表填写。

这里使用自定义入口，而不是把 NixAPI Key 填进默认的 DeepSeek 官方服务卡片。选择 OpenAI Chat Completions，避免误选 OpenAI Responses 或 Anthropic Messages。

在模型目录里尝试“获取可用模型”，选择需要的聊天模型；获取不到时手动填写准确模型 ID，再保存。模型列表请求成功也不代表 Agent 工具调用已验证。官方模型配置说明列出了各字段与模型发现行为。

4. 验证工作区和工具调用

新建一个用于测试的目录，将它添加为工作区并选中。然后新开会话，选择 NixAPI 下刚添加的模型，依次发送：

只回复：NixAPI 连接成功。

请列出当前工作区中的文件，并概括目录结构，暂时不要修改文件。

第一步验证基本对话；第二步观察执行轨迹中是否有真实的工具调用和返回结果。DSH 在首次选择工作区前无法开始会话，见官方 Web UI 指南。

5. 排查常见问题

401 / 密钥不可用：检查 Key 是否完整、账号余额和模型访问权限；修改后保存提供商。
404 / 路径错误：确认使用 https://api.nixapi.com/v1，不要在 Base URL 后追加 /chat/completions。
模型不存在：从官网定价页重新复制 ID，并确认 Key 所在分组可调用。
能聊天但工具调用失败：确认模型支持工具调用和流式响应，先换一个已确认兼容的聊天模型；不要仅依据普通聊天成功就认定配置完整。

需要高级配置时，当前 Web profile 使用 $DSH_HOME/profiles/web/cordis.patch.yml，默认通常位于 ~/.dsh/profiles/web/cordis.patch.yml。请从设置页打开实际配置文件，保留已有提供商；不要套用旧版 settings.yaml 示例。适配器文档说明了协议及凭据引用。