1. 从空白 provider 表单开始

打开 Settings → Models 并添加 provider。使用 provider 准确的 API base 和协议。不要把生产 key 粘贴到截图、issue 或共享的终端记录中。

空白 provider 表单把 provider 标识、API base、协议、secret 和模型清单分开。截图中的 Harness UI 为英文。Harness 0.1.0-rc.7 · macOS 26.4 · Node.js 24.19 · isolated Web Profile · 截图日期 2026-08-20 · 官方源代码

2. 让协议与 provider 一致

选择 endpoint 实际实现的协议。兼容 OpenAI 的 URL 并不表示所有模型名、流式模式或工具调用行为都兼容。

协议选择属于 provider 合同的一部分,应根据 provider 文档确认,而不是只根据 URL 猜测。截图中的 Harness UI 为英文。Harness 0.1.0-rc.7 · macOS 26.4 · Node.js 24.19 · isolated Web Profile · 截图日期 2026-08-20 · 官方源代码

3. 先添加一个模型并保护凭据

  • provider 支持时使用权限受限的 key。
  • 真实远程 provider 的 API base 应使用 HTTPS。
  • 先添加一个准确的模型 ID;别名可能掩盖配置错误。
  • 不要提交包含 secret 的 Profile 或 DSH_HOME 文件。
本指南使用仅限 localhost 的模拟 provider 和一次性 key。它只展示字段,不证明任何商业 provider 的兼容性。截图中的 Harness UI 为英文。Harness 0.1.0-rc.7 · macOS 26.4 · Node.js 24.19 · isolated Web Profile · 截图日期 2026-08-20 · 官方源代码

4. 保存并确认 provider 清单

保存后确认 provider 和模型已经出现在 Settings 中。测试新 provider 时,保留一个已知可用的 provider。

provider 保存在隔离的 DSH_HOME 中;没有使用真实凭据或外部模型服务。截图中的 Harness UI 为英文。Harness 0.1.0-rc.7 · macOS 26.4 · Node.js 24.19 · isolated Web Profile · 截图日期 2026-08-20 · 官方源代码

5. 在任务界面中选择模型

返回任务界面并明确选择模型。在 Settings 中看到 provider,并不能证明当前会话正在使用它。

选择器确认下一项任务将使用哪个模型。本地验证条目与官方模型选项清楚分开。截图中的 Harness UI 为英文。Harness 0.1.0-rc.7 · macOS 26.4 · Node.js 24.19 · isolated Web Profile · 截图日期 2026-08-20 · 官方源代码

6. 运行最小但有意义的任务

使用不含敏感信息、预期答案确定的提示。截图显示本地模拟响应,因此只验证 Harness 配置流程和恢复能力,不验证远程 provider 质量、计费、工具或生产兼容性。

provider 配置后,一个最小本地任务成功完成。测试没有外部模型成本,也没有暴露真实 API key。截图中的 Harness UI 为英文。Harness 0.1.0-rc.7 · macOS 26.4 · Node.js 24.19 · isolated Web Profile · 截图日期 2026-08-20 · 官方源代码
基线可用后浏览 Plugin