OpenCode 接入

推荐配置

OpenCode 使用 OpenAI-compatible Provider，网关地址带 /v1：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "hkgai": {
      "name": "HKGAI",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://test-new-api.hkchat.app/v1",
        "apiKey": "{env:HKGAI_API_KEY}"
      },
      "models": {
        "从 /v1/models 返回中选择": {
          "name": "HKGAI 模型"
        }
      }
    }
  }
}

不要把真实 Key 写进仓库。优先使用 OpenCode 的环境变量或凭据存储能力；如果桌面进程没有继承环境变量，先按内部设备管理流程注入，再重启 OpenCode。

选择模型

在 OpenCode 中执行 /models，选择 hkgai/<model-id>。Qwen 短回复建议关闭 thinking，或在调用模板中加入：

"chat_template_kwargs": {"enable_thinking": false}

排查顺序

1. 确认 baseURL 是 https://test-new-api.hkchat.app/v1。
2. 确认 Key 对该网关有效。
3. 确认模型 ID 来自 /v1/models。
4. 完全退出并重启 OpenCode Desktop。