跳转到主要内容

概述

CodeBuddy 和 WorkBuddy 是腾讯云推出的 AI 工具,支持通过 models.json 配置文件接入自定义 AI 模型。 通过将它们与 EvoLink API 进行配置集成,您可以直接使用 EvoLink 提供的各类 AI 模型能力。
CodeBuddy 和 WorkBuddy 使用相同的配置方式,本文档同时适用于两者。

使用前准备

  • 登录 EvoLink 控制台
  • 在控制台中找到 API Keys,点击”创建新Key”按钮,然后复制生成的 Key
  • API Key 通常以 sk- 开头,请妥善保存

配置步骤

1. 打开配置文件

CodeBuddy: ~/.codebuddy/models.json WorkBuddy: ~/.workbuddy/models.json 编辑 models.json 文件,添加以下配置:
目前仅支持 OpenAI SDK 格式的模型接入。
{
  "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
    }
  ]
}
请将 sk-your-api-key-here 替换为您的实际 EvoLink API Key。

更多可用模型

除了上述示例,您还可以添加以下模型(配置格式相同,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 模型: 切换模型 Evolink Auto 是智能模型路由功能,系统会根据您的请求内容自动选择最合适的 AI 模型。

核心优势

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

使用方法

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

限制可用模型列表

如果您只想在下拉列表中显示特定模型,可以使用 availableModels 字段:
{
  "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
项目级配置优先级高于用户级配置。建议在用户级配置全局模型,在项目级配置项目特定模型。

3. 配置不生效怎么办?

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

4. 支持哪些模型?

EvoLink 支持 OpenAI、Anthropic、Google 等多家厂商的模型。详见 模型列表

5. API Key 安全吗?

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

相关链接