概述

本文档总结了如何通过 WorkBuddy 的 international-ai-deploy 技能来添加和管理自定义 AI 模型，特别是针对本地 Ollama 服务的配置。文档涵盖了完整的流程，从技能安装到模型配置文件的创建。

安装 international-ai-deploy 技能

方法1：通过 WorkBuddy 插件市场安装

1. 打开 WorkBuddy
2. 点击侧边栏"插件"
3. 点击"插件市场"+
4. 输入以下 URL：

   https://github.com/hangtiger/international-ai-deploy-skill
   

方法2：从 GitHub 安装

# 克隆仓库
git clone https://github.com/hangtiger/international-ai-deploy-skill.git

然后在 WorkBuddy 中导入本地技能。

方法3：直接从 GitHub下载源码压缩包（本人测试）

Code --> Download ZIP --> “international-ai-deploy-skill-master.zip”

解压后，选中WorkBuddy 左侧的“技能”菜单，然后点击右侧“+导入技能”来找到解压后的文件夹，导入本地技能。

配置自定义模型

1. 确认技能已安装

首先确认 international-ai-deploy 技能已经成功安装。检查文件路径：

C:\Users\ttyui\.workbuddy\skills\international-ai-deploy-skill-master

2. 使用技能添加模型

Ollama本地部署模型的方法请自行搜索，过程并不复杂，我当前选用的模型为：qwen3-coder:30b

在 WorkBuddy 中使用以下指令来配置模型：

添加自定义模型

3. 手动编辑 models.json 文件（推荐）

对于 Ollama 模型，我们推荐直接编辑 models.json 文件。其中配置文件的位置为：

C:\Users\ttyui\.workbuddy\models.json

注意：其中“ttyui”我的用户名，需替换成你自己的用户名。

4. 配置文件结构

确保你的 models.json 文件内容如下：

{
  "models": [
    {
      "id": "qwen3-coder:30b",
      "name": "Qwen3-Coder 30B (Ollama)",
      "vendor": "Ollama",
      "apiKey": "ollama",
      "url": "http://[自定义大模型的IP地址]:11434/v1/chat/completions",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "disabled": false
    }
  ]
}

5. 关键配置说明

配置项	作用
id	模型唯一标识符 (重要，必须与部署的模型名称严格一致)
name	显示名称
vendor	供应商（如 Ollama）
apiKey	API 密钥，对于自行部署的Ollama服务为空，或者随便写，如ollama
url	模型访问的 URL 地址
maxInputTokens	最大输入 token 数
maxOutputTokens	最大输出 token 数
disabled	是否禁用该模型

重要提示

models.json配置文件规则

1. 只添加 models[] 数组：不要添加 availableModels 字段
2. 内置模型与自定义模型并存：WorkBuddy 默认会自动处理内置模型的显示
3. 重启 WorkBuddy：修改配置后需要重启 WorkBuddy 使更改生效

验证配置

1. 重启 WorkBuddy
2. 在模型选择器中应该能看到：
   • 内置模型（如 Qwen 系列）
   • 新添加的自定义模型（Qwen3-Coder 30B (Ollama)）

故障排除

常见问题

1. 模型未显示

   • 检查 models.json 文件格式是否正确
   • 重启 WorkBuddy 应用

2. 连接错误

   • 检查 Ollama 服务是否正在运行
   • 验证 URL 地址是否正确
   • 确认网络连通性

3. 配置文件格式错误

   • 使用 JSON 验证工具检查语法
   • 确保所有字符串都使用双引号
   • 检查是否有多余的逗号

总结

通过以上步骤，你已经成功：

1. 安装了 international-ai-deploy 技能
2. 配置了自定义的 Ollama 模型
3. 实现了内置模型与自定义模型并列显示的效果（如下）

现在你可以愉快地在 WorkBuddy 中使用你的本地模型进行开发和测试了！