Z-Mint AIZ-Mint AI
Sign Up

CodeBuddy WorkBuddy

配置 Tencent CodeBuddy WorkBuddy，通过 Z-Mint AI 进行请求路由。

概述

CodeBuddy 和 WorkBuddy 是 Tencent Cloud 推出的 AI 工具，支持通过 models.json 配置文件接入自定义 AI 模型。将其与 Z-Mint AI API 集成后，即可直接调用 Z-Mint AI 提供的多种 AI 模型能力。

CodeBuddy 与 WorkBuddy 的配置方式相同，本文档同时适用于两者。

前置条件

获取 Z-Mint AI API Key

  • 登录 Z-Mint AI 控制台
  • 在控制台中找到 API Keys，点击「创建新密钥」按钮，复制生成的密钥
  • API Key 通常以 sk- 开头，请妥善保管

配置步骤

1. 打开配置文件

CodeBuddy： ~/.codebuddy/models.json WorkBuddy： ~/.workbuddy/models.json

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

目前仅支持 OpenAI SDK 格式的 API 接入。

{
  "models": [
    {
      "id": "zmint/auto",
      "name": "Evolink Auto (Smart Routing)",
      "vendor": "Evolink",
      "apiKey": "sk-your-api-key-here",
      "url": "https://aigc.zhengmi.org/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://aigc.zhengmi.org/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://aigc.zhengmi.org/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": true
    }
  ]
}

请将 sk-your-api-key-here 替换为你实际的 Z-Mint AI 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 (Smart Routing)」即可。

限定可用模型列表

如果你只想在下拉框中展示特定模型，可以使用 availableModels 字段：

{
  "models": [
    // ... 模型配置
  ],
  "availableModels": [
    "zmint/auto",
    "gpt-5.4",
    "doubao-seed-2.0-mini"
  ]
}

常见问题

1. 配置文件在哪里？

CodeBuddy：

  • macOS/Linux：~/.codebuddy/models.json
  • Windows：C:\Users\<username>\.codebuddy\models.json

WorkBuddy：

  • macOS/Linux：~/.workbuddy/models.json
  • Windows：C:\Users\<username>\.workbuddy\models.json

2. 是否支持项目级配置？

支持。除用户级配置外，你还可以在项目根目录创建配置文件：CodeBuddy： <project-root>/.codebuddy/models.json WorkBuddy： <project-root>/.workbuddy/models.json

项目级配置的优先级高于用户级配置。建议在用户级配置全局模型，在项目级配置项目专属模型。

3. 配置不生效怎么办？

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

4. 支持哪些模型？

Z-Mint AI 支持 OpenAI、Anthropic、Google 等厂商的模型。详见 模型列表。

5. API Key 安全吗？

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

相关链接