> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CodeBuddy / WorkBuddy

> 将 CodeBuddy 和 WorkBuddy 连接到 EvoLink.AI

## 概述

CodeBuddy 和 WorkBuddy 是腾讯云推出的 AI 工具，支持通过 `models.json` 配置文件接入自定义 AI 模型。
通过将它们与 **EvoLink API** 进行配置集成，您可以直接使用 EvoLink 提供的各类 AI 模型能力。

<Note>
  CodeBuddy 和 WorkBuddy 使用相同的配置方式，本文档同时适用于两者。
</Note>

## 使用前准备

### 获取 EvoLink API Key

* 登录 [EvoLink 控制台](https://evolink.ai/dashboard)
* 在控制台中找到 API Keys，点击"创建新Key"按钮，然后复制生成的 Key
* API Key 通常以 `sk-` 开头，请妥善保存

## 配置步骤

### 1. 打开配置文件

**CodeBuddy：** `~/.codebuddy/models.json`

**WorkBuddy：** `~/.workbuddy/models.json`

### 2. 添加 Evolink 模型配置

编辑 `models.json` 文件，添加以下配置：

<Note>
  目前仅支持 OpenAI SDK 格式的模型接入。
</Note>

```json theme={null}
{
  "models": [
    {
      "id": "evolink/auto",
      "name": "Evolink Auto (智能路由)",
      "vendor": "Evolink",
      "apiKey": "sk-your-api-key-here",
      "url": "https://direct.evolink.ai/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "gpt-5.4",
      "name": "Evolink GPT-5.4",
      "vendor": "OpenAI",
      "apiKey": "sk-your-api-key-here",
      "url": "https://direct.evolink.ai/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "doubao-seed-2.0-mini",
      "name": "Evolink Doubao Seed 2.0 Mini",
      "vendor": "ByteDance",
      "apiKey": "sk-your-api-key-here",
      "url": "https://direct.evolink.ai/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    }
  ]
}
```

<Warning>
  请将 `sk-your-api-key-here` 替换为您的实际 EvoLink API Key。
</Warning>

### 更多可用模型

除了上述示例，您还可以添加以下模型（配置格式相同，name 字段添加 "Evolink " 前缀）：

**GPT 系列：**

* `gpt-5.2` - Evolink GPT-5.2
* `gpt-5.1` - Evolink GPT-5.1
* `gpt-5.1-chat` - Evolink GPT-5.1 Chat
* `gpt-5.1-thinking` - Evolink GPT-5.1 Thinking

**Gemini 系列：**

* `gemini-2.5-pro` - Evolink Gemini 2.5 Pro
* `gemini-2.5-flash` - Evolink Gemini 2.5 Flash
* `gemini-3-pro-preview` - Evolink Gemini 3.0 Pro
* `gemini-3-flash-preview` - Evolink Gemini 3.0 Flash

**Doubao Seed 2.0 系列：**

* `doubao-seed-2.0-pro` - Evolink Doubao Seed 2.0 Pro
* `doubao-seed-2.0-lite` - Evolink Doubao Seed 2.0 Lite
* `doubao-seed-2.0-code` - Evolink Doubao Seed 2.0 Code

**Kimi K2 系列：**

* `kimi-k2-thinking` - Evolink Kimi K2 Thinking
* `kimi-k2-thinking-turbo` - Evolink Kimi K2 Thinking Turbo

### 3. 保存并重启

保存配置文件后，工具会自动检测配置变更并重载（1秒防抖延迟）。

配置完成后，您可以在模型选择下拉列表中看到所有配置的 Evolink 模型：

<img src="https://mintcdn.com/muyutechnology/Ibsxv__oZ58z38Zo/images/integration-guide/codebuddy-workbuddy-switch-model.png?fit=max&auto=format&n=Ibsxv__oZ58z38Zo&q=85&s=322e21d805183bc4cecfc72eafd6e3c8" alt="切换模型" width="1799" height="1196" data-path="images/integration-guide/codebuddy-workbuddy-switch-model.png" />

## 使用 Evolink Auto 智能路由

### 什么是 Evolink Auto？

Evolink Auto 是智能模型路由功能，系统会根据您的请求内容自动选择最合适的 AI 模型。

### 核心优势

* **智能匹配**：自动分析请求内容，选择最适合的模型处理
* **成本优化**：在保证质量的前提下，优先选择性价比高的模型
* **负载均衡**：自动在多个模型间分配请求，提高系统稳定性
* **透明可见**：响应中返回实际使用的模型名称

### 使用方法

在模型选择下拉列表中，选择 "Evolink Auto (智能路由)" 即可。

## 限制可用模型列表

如果您只想在下拉列表中显示特定模型，可以使用 `availableModels` 字段：

```json theme={null}
{
  "models": [
    // ... 模型配置
  ],
  "availableModels": [
    "evolink/auto",
    "gpt-5.4",
    "doubao-seed-2.0-mini"
  ]
}
```

## 常见问题

### 1. 配置文件在哪里？

**CodeBuddy：**

* macOS/Linux：`~/.codebuddy/models.json`
* Windows：`C:\Users\<用户名>\.codebuddy\models.json`

**WorkBuddy：**

* macOS/Linux：`~/.workbuddy/models.json`
* Windows：`C:\Users\<用户名>\.workbuddy\models.json`

### 2. 支持项目级配置吗？

支持。除了用户级配置，还可以在项目根目录创建配置文件：

**CodeBuddy：** `<项目根目录>/.codebuddy/models.json`

**WorkBuddy：** `<项目根目录>/.workbuddy/models.json`

<Note>
  项目级配置优先级高于用户级配置。建议在用户级配置全局模型，在项目级配置项目特定模型。
</Note>

### 3. 配置不生效怎么办？

1. 检查 JSON 格式是否正确（可使用 JSON 验证工具）
2. 确认 API Key 是否正确
3. 尝试重启应用

### 4. 支持哪些模型？

EvoLink 支持 OpenAI、Anthropic、Google 等多家厂商的模型。详见 [模型列表](https://evolink.ai/models)。

### 5. API Key 安全吗？

API Key 存储在本地配置文件中，不会上传到云端。建议设置文件权限，防止他人访问。

## 相关链接

* [EvoLink 控制台](https://evolink.ai/dashboard)
* [CodeBuddy 官方文档](https://www.codebuddy.cn/docs)
* [EvoLink API 文档](/docs/cn/api-manual)