准备连接参数
先准备好以下信息。Provider ID 会成为提供方的永久标识，建议一次确定并保持小写。
aigokey必须使用小写；保存后不建议修改。AIGOKEY模型选择器中显示的名称。https://llm.aigokey.cn/v1填写 AIGOKEY 的 OpenAI 兼容接口地址。openai-responses按 DeepSeek Harness 的协议选项填写。sk-你的API密钥粘贴完整密钥，前后不要加入空格或引号。打开模型设置
启动 DeepSeek Harness Web UI 并登录管理界面，然后按下面的路径进入自定义提供方表单。
- 启动 DeepSeek Harness Web UI，并登录管理界面。
- 打开左侧或顶部的“设置”。
- 进入“模型”页面。
- 点击“添加自定义提供方”。
当服务来自公司网关、自建服务，或内置目录中没有对应模型时，可以使用这个入口。
填写 AIGOKEY 提供方
在表单中按下表填写。字段名称可能随 DeepSeek Harness 版本略有变化，但值保持一致。
aigokeyAIGOKEYhttps://llm.aigokey.cn/v1openai-responsessk-你的API密钥DeepSeek Harness 会安全保存密钥。保存后页面只显示脱敏描述，不会再次返回明文密钥。
添加至少一个模型
自定义提供方必须关联至少一个模型。优先使用自动获取；如果接口不支持模型发现，就手动录入准确的模型 ID。
方式 A · 获取可用模型
- 在模型列表区域点击“获取可用模型”。
- 等待 DeepSeek Harness 使用当前 API 地址和密钥查询模型列表。
- 从返回结果中勾选要使用的模型。
- 点击“保存”。
方式 B · 手动录入模型
- 点击“添加模型”，或在模型输入框中选择手动添加。
- 填写 AIGOKEY 实际支持的模型 ID。
- 确认模型 ID 与 AIGOKEY 控制台或接口文档中的名称完全一致。
- 点击“保存”。
不要随意填写模型名称。模型 ID 不存在或拼写不一致时，发送请求会出现 UNKNOWN_MODEL。
选择并测试 AIGOKEY 模型
配置保存后不需要重启服务器，下一次请求会读取新的模型设置。测试新配置时建议新建会话。
- 打开模型选择器。
- 找到显示名称为 AIGOKEY 的提供方。
- 选择刚刚添加的模型。
- 新建会话并发送一条测试消息。
已经发送过请求的旧会话会继续使用日志中记录的模型。需要验证新配置时，请新建会话。
常见问题与处理方式
先根据错误提示定位配置项，再重新保存提供方设置。
提示 MISSING_CREDENTIAL
提供方没有可用凭据。回到“设置 → 模型”，重新保存 AIGOKEY API 密钥，并确认密钥没有被截断。
获取模型返回 401
检查 API 密钥是否正确、是否过期，以及 API 地址是否填写为 https://llm.aigokey.cn/v1。如果服务不支持 GET /models，请改用手动录入模型 ID。
提示 UNKNOWN_MODEL
当前会话选择的模型没有添加到 AIGOKEY 提供方中，或模型 ID 拼写不一致。补充准确的模型 ID 后，再新建会话重试。
地址和密钥正确，但请求仍被网关拒绝
如果 AIGOKEY 明确要求兼容字段格式，再在 $DSH_HOME/settings.yaml 中为 aigokey 路由补充 compat 配置。不要在没有明确需求时额外修改请求格式。
按需补充兼容性配置
只有在 AIGOKEY 明确要求这些请求格式时才添加。修改后请按 DeepSeek Harness 项目说明重新加载设置。
llm-pi-ai:
providers:
aigokey:
apiKeyEnv: AIGOKEY_API_KEY
api: openai-completions
baseURL: https://llm.aigokey.cn/v1
compat:
supportsDeveloperRole: false
maxTokensField: max_tokens
models:
- id: your-model-id配置检查清单
逐项确认后，AIGOKEY 就会出现在 DeepSeek Harness 的模型选择器中。
- Provider ID 为小写 aigokey
- 显示名称为 AIGOKEY
- API 地址为 https://llm.aigokey.cn/v1
- API 密钥格式为 sk-你的API密钥
- 已选择或手动添加至少一个模型
- 已保存配置，并用新会话发送测试消息