Free Buddy Skills

---

title: "Free Buddy Skills" summary: "一键配置 opencode.ai 免费 AI 模型到 WorkBuddy,无需 API Key" read_when: - 用户需要配置免费 AI 模型 - 用户提到"免费模型"、"opencode"、"free model"

---

Free Buddy Skills

自动检测和配置 opencode.ai 的免费 AI 模型到 WorkBuddy。

触发词

当用户说以下内容时,使用此技能:

"帮我配置 opencode.ai 的免费模型"

"配置免费模型"

"添加 opencode 模型"

"免费 AI 模型"

"更新免费模型"

"free model"

"opencode.ai"

功能

1. 查询免费模型: 从 opencode.ai 获取最新的免费模型列表 2. 自动配置: 将免费模型添加到 ~/.workbuddy/models.json 3. 定期更新: 保持模型配置的时效性

权限说明

无需 API Key: 使用公开的 "public" 作为 API Key

无需认证: opencode.ai 免费模型无需登录

仅本地操作: 只读取和写入本地的 ~/.workbuddy/models.json

快速使用

用户只需发送一句话:

首次配置: > "帮我配置 opencode.ai 的免费模型"

WorkBuddy 会自动: 1. 查询最新的免费模型列表 2. 添加到 ~/.workbuddy/models.json 3. 验证配置是否可用

更新模型: > "更新免费模型"

WorkBuddy 会自动: 1. 查询最新的免费模型列表 2. 对比现有配置 3. 添加新模型,跳过已存在的

使用流程

方法 1: 使用 Python 脚本 (推荐)

# 所有平台通用 (macOS / Linux / Windows)
python3 update-free-models.py
或
python update-free-models.py

方法 2: 手动配置

#### 步骤 1: 查询可用免费模型

curl -sS https://opencode.ai/zen/v1/models | jq '.data[].id' | grep -i free

#### 步骤 2: 获取模型详细信息

curl -sS https://opencode.ai/zen/v1/models | jq '.data[] | select(.id | contains("free"))'

#### 步骤 3: 读取现有配置

读取 ~/.workbuddy/models.json (macOS/Linux) 或 %USERPROFILE%\.workbuddy\models.json (Windows) 检查是否已存在相同模型。

#### 步骤 4: 添加或更新模型配置

为每个免费模型添加以下配置:

{
  "id": "模型ID",
  "name": "模型显示名称",
  "vendor": "OpenCode AI",
  "url": "https://opencode.ai/zen/v1/chat/completions",
  "apiKey": "使用 public (无需真实密钥)",
  "maxInputTokens": 262144,
  "supportsToolCall": true,
  "supportsImages": false,
  "supportsReasoning": true
}

步骤 5: 验证配置

使用 read_file 工具读取 ~/.workbuddy/models.json 确认配置已正确添加。

当前免费模型列表

| 模型 ID | 名称 | 工具调用 | 图像 | 推理 | |---------|------|----------|------|------| | minimax-m2.5-free | MiniMax M2.5 Free | ✅ | ❌ | ✅ | | trinity-large-preview-free | Trinity Large Preview Free | ✅ | ✅ | ✅ | | nemotron-3-super-free | Nemotron-3 Super Free | ✅ | ✅ | ✅ |

配置保存位置

macOS/Linux: ~/.workbuddy/models.json

Windows: %USERPROFILE%\.workbuddy\models.json (即 C:\Users\你的用户名\.workbuddy\models.json)

跨平台: $HOME/.workbuddy/models.json (Git Bash/WSL 下通用)

注意事项

1. opencode.ai 的免费模型使用 "public" 作为 API Key 2. 所有免费模型共享同一个端点: https://opencode.ai/zen/v1/chat/completions 3. 脚本需要用户确认后才会修改配置文件 4. 非交互模式下运行将跳过自动添加,需手动确认