DeepSeek Harness

在 DeepSeek Harness 中把 SupaNexus 加为自定义 OpenAI 兼容提供方：一把 Key 可用整份目录，不限于 DeepSeek。

1. 领取 SupaNexus API Key

登录开发者控制台，进入项目 → API Keys，创建 Key 并立即复制（仅展示一次）。同一把项目 Key 可用于 OpenAI 兼容与 Anthropic 兼容客户端。

2. 安装 DeepSeek Harness

按官方开发者预览安装，并钉住已验证的版本——预览仍可能有破坏性变更。自带的 DeepSeek 目录卡片会直连 DeepSeek 官方 API；要走 SupaNexus 必须添加自定义提供方。

3. 添加自定义提供方

打开设置 → 模型 → 添加自定义提供方。设置小写 Provider ID（如 supanexus，对会话与凭据永久生效）。Base URL：SupaNexus 接入点 + /v1。API 协议：OpenAI Chat Completions（openai-completions）。粘贴项目 API Key。

Provider ID: supanexus
Base URL: <BASE_URL>/v1
API: openai-completions
API Key: sk-snx-...

4. 添加型号（或拉取目录）

添加如 deepseek/deepseek-v4-pro、deepseek/deepseek-v4-flash，或使用「获取可用模型」（GET /v1/models）。Qwen、Kimi、GLM 等其它 Public API ID 同样可用，不限于 DeepSeek。

Recommended:
deepseek/deepseek-v4-pro    # flagship / agents
deepseek/deepseek-v4-flash  # latency / cost

5. 可选：编辑 settings.yaml

表单未暴露的字段可编辑 $DSH_HOME/settings.yaml 后重启。密钥放在环境变量（如 SUPANEXUS_API_KEY），不要写进 YAML。

llm-pi-ai:
  providers:
    supanexus:
      apiKeyEnv: SUPANEXUS_API_KEY
      api: openai-completions
      baseURL: "<BASE_URL>/v1"
      models:
        - id: deepseek/deepseek-v4-pro
        - id: deepseek/deepseek-v4-flash

6. 选用目录型号 ID

型号 ID 以 SupaNexus 模型市场或 GET /v1/models 为准（例如 deepseek/deepseek-chat、anthropic/claude-3-5-sonnet）。不要套用其它网关的自创 slug。

7. 验证并冒烟测试

保存后，在 Harness 中选中 SupaNexus 型号并发一条短提示。到开发者控制台确认用量。只有在确实要直连 DeepSeek 官方 API 时，才使用官方 DeepSeek 目录卡片。

8. 排障

仍走 DeepSeek 云：当前用的是自带 DeepSeek 卡片——请改用自定义提供方。401 / Host 错误：Base URL 必须含 /v1。型号缺失：ID 须出现在 GET /v1/models。全新 Harness 接入优先 Chat Completions；仅当其余工具已统一走 Anthropic 时，再考虑 Messages。

接入说明 →