实用指南 · 独立指南
DeepSeek Harness API 协议选择：端点与模型配置
API Key 正确不代表端点配置正确。协议决定请求格式，Base URL 决定服务器，模型 ID 决定实际调用的模型。先核对这三个独立字段，能避免把格式错误当成密钥失效。以下流程依据 0.1.7-rc.2 官方文档，旧版本的界面和字段可能不同。
资料状态: 官方文档复核于 dsh-v0.2.1-alpha.1（5badb15）。npm 与 PyPI 发布身份单独记录；未将新版文档复核视为本机运行实测。 新版本发布后请重新核对官方资料。
分享仅包含公开链接，不携带本地进度或私人配置。
从提供商的接口约定开始
“兼容 OpenAI”可能只指 Chat Completions，不一定支持 Responses。以实际端点的文档为准，不根据产品名称推断。
- 记录明确支持的协议和 Base URL。
- 核对该端点真实提供的模型 ID。
- 确认任务需要的工具调用等能力。
每种协议建立独立提供商
进入 Settings → Models → Custom model API。官方文档列出的协议值为 openai-completions、openai-responses、anthropic-messages。同一网关需要两种协议时，使用两个不同的提供商 ID。
- 提供商 ID 使用稳定的小写标识，已有会话和凭据会引用它。
- 保存后在新会话选择模型进行验证。
按失败层级定位
认证错误先检查密钥，模型不存在先检查模型列表，请求格式错误再检查协议。每次只改一个字段，重复同一个简单任务。
- 发现模型失败时，可以手动输入端点明确支持的模型。
- 分享诊断结果前移除密钥和私有地址。
区分自定义协议与原生适配器
协议选择器配置自定义 pi-ai 提供商。新版 GitHub 的 llm-deepseek 仅使用 Messages，不接受 protocol 字段。如果它报告 protocol is not configurable，应检查原生适配器保存的配置行并删除不支持的字段，而不是给它填另一个协议。
官方资料
使用新版本前，打开以下固定版本或注明核验日期的资料。