模型配置

模型配置是 WorkBuddy AI 的模型管理入口，让您可以根据任务需要选择模型，或接入自己的模型服务。自定义模型支持通过界面添加、编辑和删除，无需手动编辑配置文件。

不同模型支持的文本处理、推理、图片输入和工具调用能力可能不同。接入前，请确认模型及服务接口满足任务要求。

自动模式

选择 自动（Auto） 后，模型服务会按其路由策略分配处理请求的模型，让您可以减少手动选择具体型号的步骤。

自动模式不代表所有已添加的自定义模型都会参与选择。需要指定某个模型时，请在对话中的模型选择器里手动选择。

内置模型

您可以在对话的模型选择器中查看当前账号可用的内置模型。具体型号及可用范围可能随产品版本、账号权益和服务配置调整。

选择时，建议关注任务实际需要的能力：

任务需要	关注的模型能力
问答、写作与资料整理	文本处理能力及可接受的上下文长度
截图分析、图表理解	图片输入能力，并结合任务验证识别效果
文件处理、工具操作	工具调用能力，以及相关技能和服务是否可用
多步骤分析	推理能力，并根据结果判断是否适合当前任务

图片输入不等于图片生成

支持图片输入，表示模型可以接收图片进行理解，并不代表它能生成或编辑图片。同一厂商不同型号的能力也可能不同，不应仅根据厂商名称判断。

自定义模型

在桌面端进入 头像 > 系统设置 > 模型，可以管理自己的模型服务配置：

• 模型列表：查看已保存的模型名称及提供商信息。

• 添加 / 编辑 / 删除：通过表单维护配置，删除时需确认。

• 测试连接：检查接口是否能够响应，便于排查地址、密钥或模型名称问题。

• 在对话中选择：保存后，在对话的模型选择器中选择对应自定义模型。

保存配置不等于连接成功，也不会自动将所有会话切换到新模型。建议先测试连接，再用简单任务验证需要的能力。

配置保存位置

默认用户级配置文件为 ~/.workbuddy-ai/models.json；Windows 下位于 %USERPROFILE%\.workbuddy-ai\models.json。若调整过用户配置目录，请以模型设置页显示的路径为准。

日常管理可直接通过界面完成，无需手动修改该文件。请勿将包含 API Key 的配置文件上传到公开仓库或用于公开分享。

接入方式

提供商接入

选择提供商后，界面会按预设填写接口地址、模型选项或默认能力信息。不同提供商的表单要求不同，部分需要手动填写模型名称；请根据已开通的服务补充 API Key 等必填信息。

提供商预设只用于简化配置，不代表对应套餐已开通，也不代表其全部模型都是 WorkBuddy AI 的内置模型。

• Token Plan

  选择与已开通方案对应的腾讯云 Token Plan 选项，再选择模型并填写该方案要求的 API Key。

  

  不同方案的模型范围、额度和使用条件可能不同。请使用与所选方案匹配的凭据，并参考提供方的服务说明；不应将普通 WorkBuddy AI 登录状态视为已获得该方案的调用权限。

  

• Coding Plan

  提供商预设中包含腾讯云、智谱和 Kimi 的 Coding Plan 接入选项。使用前，请先确认已开通相应服务，并按所选方案填写接口所需的凭据与模型信息。

  

• 自定义 API

  您可以通过提供商预设接入支持的 API 服务，例如 OpenAI、DeepSeek、智谱等。预设可减少手动填写内容，但仍需核对接口地址、模型名称和访问权限。

  

接口兼容要求

当前自定义模型接入使用 OpenAI 兼容的 Chat Completions API。请确认服务的请求、响应及所需工具调用格式兼容，不能只凭接口可以返回文本，就判断它适用于所有 WorkBuddy AI 任务。

本地部署

Ollama 可在本机运行模型，并提供 OpenAI 兼容接口，供 WorkBuddy AI 连接。使用本地推理前，需要先安装 Ollama、下载所需模型，并保持本地服务运行。

在提供商中选择 Ollama，填写已安装模型的准确名称。默认接口地址为：

http://localhost:11434/v1/chat/completions

Ollama 的本机接入预设无需填写 API Key。请根据所选模型的实际能力配置图片输入、工具调用等选项，再测试连接。

适合考虑本地模型的情况：

1. 希望在本机运行并测试模型，而不是把模型推理交给远程服务。

2. 已具备足够的内存、存储空间和计算资源，希望自行选择与管理模型。

3. 希望评估本地模型在特定文本处理或工具调用任务中的效果。

本地推理的边界

请确认使用的是本地下载的模型，而非通过 Ollama 调用云端模型。本地推理会占用电脑资源，并不等于零成本，也不保证 WorkBuddy AI 的所有功能都能离线使用。

联网搜索、外部连接器或其他在线服务仍可能访问网络。因此，接入本地模型不等于整个任务的数据不会离开电脑，也不能据此保证满足特定合规要求。

自定义

如果模型服务不在预设列表中，可选择 自定义 / Custom，填写服务提供方给出的接口地址、API Key 和模型名称，并核对相关能力选项。

模型名称应填写接口接受的参数值，而不是自行起的展示名称。保存后，先测试连接；若失败，请检查地址、密钥、模型访问权限和账户额度。

能力与高级配置

部分提供商的能力标记随所选模型自动填写；支持手动配置的提供商则会显示相应选项。请按服务实际支持情况填写，而不是将全部能力勾选为开启。

配置项	说明
工具调用	表示模型及接口支持工具调用，是许多执行类任务的必要条件
图片输入	表示模型及接口能够接收图片，不代表具备图片生成能力
推理模式	按模型支持情况配置；不同服务可能采用不同的控制方式
最大输入 / 输出 Token	按模型和服务限制设置；填写更大的数值不会扩大模型真实容量
思考强度	仅在模型及配置入口支持时使用，不应填写服务不接受的档位

连接成功不等于能力全部验证通过

测试连接用于初步检查接口响应。图片理解、工具调用和较长输入等能力，还需使用相应任务单独验证；测试请求也可能产生服务调用用量。

自定义协议

部分提供商的高级配置中提供 自定义协议 开关，用于控制是否自动补全接口路径。一般情况下无需开启；仅在服务提供方要求使用特定完整地址时，再按其说明设置。

状态	行为
关闭（默认）	对自定义模型地址进行规范化，确保路径末尾包含一个 /chat/completions；不会自动补齐提供方要求的所有其他路径段
开启	请求使用填写的完整接口地址，不再自动追加 /chat/completions

例如，服务的完整地址如果是 https://api.example.com/v1/chat/completions，关闭开关时可以填写包含 /v1 的基础地址，也可以填写完整地址。若提供方使用其他路径，应按其官方说明配置。

自定义协议只改变地址处理方式，不是任意 API 协议转换器。 开启后，服务仍需满足当前自定义模型接入所要求的请求与响应格式，也不会绕过身份认证或权限限制。