---
description: "通过 models.json 将 Workbuddy 接入在问 OpenAI 兼容端点。"
---

# 接入 Workbuddy

> Workbuddy 的模型配置在 `~/.workbuddy/models.json`（顶层数组，每个模型自带 `url` 与 `apiKey`）。以下配置接入在问的 gpt-5.6-luna / gpt-5.6-terra（OpenAI Chat Completions 兼容端点）。

## 配置步骤

### 1. 写入 `~/.workbuddy/models.json`

打开 `~/.workbuddy/models.json`，文件不存在则创建，写入以下内容（把 `你的在问APIKEY` 换成实际 Key）：

```json
[
  {
    "id": "gpt-5.6-luna",
    "name": "gpt-5.6-luna",
    "vendor": "Custom",
    "url": "https://oneapi.zaiwenai.com/v1/chat/completions",
    "apiKey": "你的在问APIKEY",
    "supportsToolCall": true,
    "supportsImages": true,
    "supportsReasoning": true,
    "useCustomProtocol": false,
    "reasoning": {
      "supportedEfforts": [
        "medium",
        "high",
        "xhigh"
      ],
      "canDisableThinking": false
    },
    "maxInputTokens": 262144,
    "maxOutputTokens": 32768
  },
  {
    "id": "gpt-5.6-terra",
    "name": "gpt-5.6-terra",
    "vendor": "Custom",
    "url": "https://oneapi.zaiwenai.com/v1/chat/completions",
    "apiKey": "你的在问APIKEY",
    "supportsToolCall": true,
    "supportsImages": true,
    "supportsReasoning": true,
    "useCustomProtocol": false,
    "reasoning": {
      "supportedEfforts": [
        "medium",
        "high",
        "xhigh"
      ],
      "canDisableThinking": false
    },
    "maxInputTokens": 262144,
    "maxOutputTokens": 32768
  }
]
```

如果该文件中已有其他模型的配置，请先备份，再手动合并数组（把上面两个对象追加进去），不要直接覆盖。

### 2. 验证

在 Workbuddy 中选择 `gpt-5.6-luna` 或 `gpt-5.6-terra` 即可开始使用。

::: tip 配置说明
- `url` 走 OpenAI Chat Completions 兼容端点（`/v1/chat/completions`），`vendor` 固定为 `Custom`
- `maxInputTokens = 262144`：与 Pi 一致配置为 256K，低于 OpenAI 短上下文计费阈值（272K），避免按长上下文倍率整体计费
- 推理档位：`supportedEfforts` 仅暴露 `medium` / `high` / `xhigh`，且不可关闭思考（`canDisableThinking: false`）
- 两个模型均开启 `supportsToolCall` / `supportsImages` / `supportsReasoning`
- 站内接入向导提供一键配置命令，会在覆盖前将已有文件备份为 `models.json.bak`
:::