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 →