WorkBuddy怎么配置AI模型

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

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

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

模型选择

　　WorkBuddy 提供三档模型模式，按任务复杂度选择：

模式	适用场景	特点
快速模式	简单、明确的任务，例如日常问答、格式转换、小段代码修改、文案润色	响应最快，消耗最低
均衡模式	绝大多数任务，例如写文档、分析数据、多文件代码改动	效果和速度兼顾，不确定选哪档时用它
极致模式	复杂任务，例如跨模块重构、多步骤推理、需要反复验证的分析	响应稍慢，消耗更高，但复杂任务下结果更稳定

思考强度

　　对应模型在给出答案前的推理投入，可选等级取决于模型自身支持的档位。

　　强度越高，模型会做更多的分析和自我检查，适合逻辑链条长、容易出错的任务；强度越低，模型倾向直接作答，响应更快。思考强度已默认选择适合绝大多数任务的强度，一般无需单独调整。

上下文窗口

　　默认 200K，适用于绝大多数任务。

　　上下文越长，token 就越多。每一轮对话都会把当前上下文完整发送给模型，上下文越大，单轮消耗的积分就越多。因此窗口并非越大越好——开到 1M 不会让模型变聪明，只会让每轮消耗成倍增加。

　　建议保持默认 200K，绝大多数场景都够用。只有在处理超长文档、或需要模型完整记住大量历史内容时，才需要调大。

Max 模式

　　关闭 Max 模式时，系统会在合适的时机自动触发上下文压缩，减少长对话中重复传输的上下文，降低积分消耗。

　　开启 Max 模式，则全程完整保留上下文、不做压缩，细节一点不丢，代价是长对话的积分消耗明显更快。

　　建议保持关闭，仅在需要超长上下文时再开启。

内置模型

企业版说明

　　企业管理员在后台禁用的模型，会在客户端的模型选择器中同步隐藏或置灰（含 auto），无法选择。若发现模型无法选择，请联系企业管理员确认该模型的启用状态。

模型名称	简介	可用功能
Hy4 preview	混元新一代模型	√ 图片输入 √ 思考模式
Hy3	混元思考模型，具有增强的推理能力	√ 图片输入 √ 思考模式
GLM-5.3	GLM 新一代模型，支持 1M 上下文窗口	√ 图片输入 √ 思考模式
GLM-5.3-Flash	GLM 新一代模型的快速版本	√ 思考模式
GLM-5.2	1M 上下文，擅长长程任务	√ 图片输入 √ 思考模式
GLM-5.1	能力均衡，适合日常使用	√ 推理模型
GLM-5v-Turbo	原生多模态模型	√ 图片输入 √ 推理模型
MiniMax-M3	原生多模态，擅长代码、智能体任务	√ 图片输入 √ 推理模型
MiniMax-m2.7	能力均衡，适合日常使用，性价比高	√ 图片输入 √ 推理模型
Kimi-K3	擅长处理复杂的长程自主任务，前端开发能力突出，同时在知识工作与科研推理上表现出色	√ 图片输入 √ 推理模型
Kimi-K2.7-Code	多模态模型，面向编程场景优化	√ 图片输入 √ 推理模型
Kimi-K2.6	多模态模型，适合日常任务	√ 图片输入 √ 推理模型
Deepseek-V4-Flash	DeepSeek 旗舰模型，支持 1M 上下文窗口，速度优先	√ 思考模式
Deepseek-V4-Pro	DeepSeek 旗舰模型，支持 1M 上下文窗口	√ 思考模式

自定义模型

　　模型列表：已配置的自定义模型以列表形式展示，每条记录显示模型名称与供应商图标。

　　添加 / 编辑 / 删除：支持通过弹窗操作完成全部增删改流程。

　　对话入口联动：对话界面的模型选择器展示自定义模型分组，并支持快捷跳转到配置界面进行编辑。

　　在设置页模型中可以通过图形界面管理自定义模型，无需操作配置文件：

　　配置在保存后自动持久化，选择标准供应商时，工具调用、图片输入等能力标记会自动写入，无需手动配置。

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

提供商接入

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

Token Plan

　　如果您已经购买了腾讯云 Token Plan 套餐，可将套餐支持的模型添加到自定义模型配置中。

　　第一步：在添加模型页面，根据您购买的套餐类型，选择对应的供应商，可选择如下：

　　腾讯云 Token Plan / Token Plan 企业版专业套餐

　　腾讯云 Token Plan / Token Plan 企业版轻享套餐

　　腾讯云 Token Plan / 通用 Token Plan（个人版）

　　腾讯云 Token Plan / Hy Token Plan（个人版）

　　第二步：填入套餐对应的 API Key。

安全提示

　　请勿将 API Key 分享给他人。API Key 关联您的账户与套餐额度，泄露可能导致他人盗用您的配额、产生额外费用或造成数据安全风险。

　　请确认供应商可信。接入第三方模型前，建议阅读该模型服务方的服务协议与隐私政策，确保其符合您对数据安全与合规的要求。

　　第三步：选择套餐支持的模型，不同套餐的可用模型不一样。

Coding Plan

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

自定义API

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

本地部署

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

适用场景：

　　1. 数据隐私 / 内网合规：代码与对话内容不出本机，适合金融、政企、敏感项目场景。

　　2. 零成本试用：不用消耗 Token、不用付费 API Key，把硬件当算力。

　　3. 离线可用：飞机上、内网开发机、没网的环境也能用 WorkBuddy。

自定义

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

自定义协议

　　当模型服务使用非标准 URL 路径（如经过网关或代理层封装）时，可在高级配置中开启自定义协议开关。开启后 WorkBuddy将直接按填写的 URL 发起请求，跳过路径校验与自动补全。

状态	行为
关闭（默认）	使用标准 /chat/completions 路径，自动校验并补全接口地址
开启	直接使用用户填写的接口地址发起请求，跳过路径校验与自动补全逻辑

信息收集与使用

　　本地文件读写：读写 workbuddy/models.json（模型配置）。

　　API Key 存储：仅本地保存，WorkBuddy 不向云端上传。

　　对话内容流向：由 WorkBuddy 转发至自定义模型，由该模型按其规则处理。

积分消耗说明

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

第三方共享

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

使用建议

　　自定义模型由第三方独立运营，其可用性、稳定性、安全性、合规性与生成结果请关注该第三方的服务状态与公告。

　　使用过程中可能持续触发模型调用，建议密切关注您在第三方的账户费用，避免出现超出预期的支出。

　　API Key 是访问您第三方模型账号的关键凭据，请妥善保管，避免在共享环境中填写或导出；不再使用时建议在 models.json 中清理。