WorkBuddy 模型选择、设置与验收

一句话结论

选择适合的 AI 模型、配置全局设置项

本章概述

选择适合的 AI 模型、配置全局设置项

---

模型配置

模型配置 产品内置主流大模型，覆盖推理、多模态及图像处理能力，并支持自定义模型。自定义模型可通过可视化界面配置，支持添加、编辑和删除模型，无需手动编辑配置文件。

概述

模型配置允许您自行接入第三方大模型作为 WorkBuddy 调用底座。配置参数（含 API Key）仅保存在本地 workbuddy/models.json 中，不上传云端。

使用时，WorkBuddy 仅作为通信链路，将您的输入直接转发至所配置的第三方模型，输出由该模型直接返回；除为完成请求、必要传输、安全审计、故障排查、依法留存所必需外，WorkBuddy 不读取、不存储相关内容。

模型选择

自动模式(Auto)

自动模式(Auto)启用后，WorkBuddy将根据任务自动选择适合的模型。

内置模型

模型名称简介可用功能Auto平衡效果与速度√ 图片输入Hy3 preview混元思考模型，具有增强的推理能力√ 图片输入 √ 推理模型GLM-5.0能力均衡，适合日常使用√ 图片输入 √ 推理模型GLM-5.0-Turbo面向Agent场景进行了深度优化√ 图片输入 √ 推理模型GLM-5v-Turbo原生多模态模型√ 图片输入 √ 推理模型GLM-4.7能力均衡，适合日常使用√ 图片输入 √ 推理模型MiniMax-M2.7能力均衡，适合日常使用√ 图片输入 √ 推理模型MiniMax-M2.5能力均衡，适合日常使用√ 图片输入 √ 推理模型Kimi-K2.5多模态模型，适合日常任务√ 图片输入 √ 推理模型DeepSeek-V3.2能力均衡，适合日常使用√ 图片输入 √ 推理模型Hunyuan-2.0-Thinking能力均衡，适合日常使用√ 推理模型GLM-5.1能力均衡，适合日常使用√ 图片输入 √ 推理模型Kimi-K2.6多模态模型，适合日常任务√ 图片输入 √ 推理模型

自定义模型

• 模型列表：已配置的自定义模型以列表形式展示，每条记录显示模型名称与供应商图标。
• 添加 / 编辑 / 删除 ：支持通过弹窗操作完成全部增删改流程。
• 对话入口联动 ：对话界面的模型选择器展示自定义模型分组，并支持快捷跳转到配置界面进行编辑。

自定义模型管理

在设置页模型 中可以通过图形界面管理自定义模型，无需操作配置文件： 配置在保存后自动持久化，选择标准供应商时，工具调用、图片输入等能力标记会自动写入，无需手动配置。

TIP
已通过 ~/.codebuddy/models.json 配置的自定义模型在界面升级后仍可正常使用，并可通过 UI 界面查看、编辑或删除，无需再直接操作配置文件。

接入方式

提供商接入

从提供商列表中选择或选择自定义API后，URL、模型列表、能力标记（工具调用、图片输入、推理模式等）会自动填充，仅需补全 API Key 即可保存使用，全程无需手动修改任何配置文件。

• Token Plan

「腾讯云 Token Plan」专为AI 编程和 WorkBuddy 场景 打造，提供面向个人、企业多种类型的订阅套餐，兼容混元、MiniMax、Kimi、GLM 等主流大模型，满足从个人开发到企业规模化 AI 应用的需求。

如果您已经购买了腾讯云 Token Plan 套餐，可将套餐支持的模型添加到自定义模型配置中。 第一步：在添加模型页面，根据您购买的套餐类型，选择对应的供应商，可选择如下：

• 腾讯云 Token Plan / Token Plan 企业版专业套餐
• 腾讯云 Token Plan / Token Plan 企业版轻享套餐
• 腾讯云 Token Plan / 通用 Token Plan（个人版）
• 腾讯云 Token Plan / Hy Token Plan（个人版） 第二步：填入套餐对应的 API Key。不同套餐的 API Key 可查看如下指引获取：
• 「Token Plan 企业版专业套餐 API Key 获取指引」
• 「Token Plan 企业版轻享套餐 API Key 获取指引」
• 「通用 Token Plan（个人版）API Key 获取指引」
• 「Hy Token Plan（个人版）API Key 获取指引」 第三步：选择套餐支持的模型，不同套餐的可用模型不一样。

以下截图以通用 Token Plan（个人版）套餐：GLM-5 模型为例。 - Coding Plan

Coding Plan是为 AI Coding 场景推出的专属订阅套餐，支持接入腾讯云Coding Plan、智谱Coding Plan和Kimi Coding Plan。 - 自定义API

内置了主流厂商的预设入口，可一键完成接入：

本地部署

Ollama 是一个开源的本地大模型运行工具，安装后通过一行命令即可拉取并运行开源模型。Ollama 启动后会在本地监听 HTTP 端口（默认 11434），并自动提供兼容 OpenAI 协议的接口供WorkBuddy对接。

适用场景：

• 数据隐私 / 内网合规：代码与对话内容不出本机，适合金融、政企、敏感项目场景。
• 零成本试用：不用消耗 Token、不用付费 API Key，把硬件当算力。
• 离线可用：飞机上、内网开发机、没网的环境也能用 WorkBuddy。

自定义

如果你的模型服务不在上方列表中，可选择自定义/Custom ，手动填写 URL、API Key 与模型名接入。

自定义协议

当模型服务使用非标准 URL 路径（如经过网关或代理层封装）时，可在高级配置中开启自定义协议 开关。开启后 WorkBuddy将直接按填写的 URL 发起请求，跳过路径校验与自动补全。 状态行为关闭（默认）使用标准 /chat/completions 路径，自动校验并补全接口地址开启直接使用用户填写的接口地址发起请求，跳过路径校验与自动补全逻辑

注意事项与重点提示

信息收集与使用

• 本地文件读写：读写 workbuddy/models.json（模型配置）。
• API Key 存储：仅本地保存，WorkBuddy 不向云端上传。
• 对话内容流向：由 WorkBuddy 转发至自定义模型，由该模型按其规则处理。

积分消耗说明

• 自定义模型产生的全部费用（Token、订阅等）由您向第三方支付 。

第三方共享

WorkBuddy 仅作通信链路，输入内容直达第三方模型；具体处理规则按您与该第三方的协议执行

免责声明

请确保模型来源合法；接入前建议先阅读该模型服务方的协议与隐私政策 。

使用建议

• 自定义模型由第三方独立运营，其可用性、稳定性、安全性、合规性与生成结果请关注该第三方的服务状态与公告 。
• 使用过程中可能持续触发模型调用，建议密切关注您在第三方的账户费用 ，避免出现超出预期的支出。
• API Key 是访问您第三方模型账号的关键凭据，请妥善保管 ，避免在共享环境中填写或导出；不再使用时建议在 models.json 中清理。
• 若接入存在违法违规风险，依据用户协议 §8.3.2，WorkBuddy 可能中止、限制或禁止该模型的接入。

声明

本节说明，构成「服务协议」和「隐私保护」指引的组成部分，具有同等法律效力。 如有不一致之处，以前述协议原文为准。

系统设置

系统设置 个性化设置WorkBuddy 的语言显示、字体大小和显示模式，入口为头像-设置-系统设置 。

语言

支持切换中文（简体） 和 English 。

字体大小

显示模式

简洁模式

开启后将简化对话界面显示，隐藏部分装饰性元素，折叠对话中工具调用等过程信息。

TIP
默认开启简洁模式

非高风险自动安装

上传 Skill 后仍会显示安全检测过程；

• 非高风险自动继续安装
• 高风险始终需要手动确认

防休眠

开启后你的电脑系统将不会进入休眠，方便手机远程操控、自动化任务持续进行。

选模型不是比参数，而是比固定任务的稳定性

Auto 适合边界清楚的日常整理、文档生成和表格处理；当任务对推理深度、图片识别、长文本或特定中文表现有明确要求时，再考虑手动指定模型。模型宣传页上的能力标签，只能说明理论支持，不能替代真实任务验收。

更换模型后的最小验收

选一个已经知道正确结果的小任务，比较新旧模型的三项表现：输出格式是否一致、关键结论是否偏移、工具和文件操作是否成功。换模型、Skill 或连接器后，都应该重新做一次小范围验收。

读取失败时，可以按“先换支持对应文件类型的模型，再检查 Skill，最后排查材料是否损坏或加密”的顺序定位。反复换模型仍卡在同一步，通常说明问题在任务边界、目录或流程，而不在模型本身。

第三方模型接入时，还要单独确认 API Key 保存位置、数据会流向哪个服务以及该服务的协议边界。

---

原文信息

• 整理自：WorkBuddy 官方文档