WorkBuddy不提供全局模型切换，而是按MCP工具注册时绑定的模型ID自动路由，如hunyuan_chat绑定hunyuan-lite则文本对话自动调用该模型，修改配置后需重启MCP Server服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在CherryStudio、OpenWebUI或WorkBuddy等客户端中完成混元API配置后，必须手动指定具体模型ID才能调用成功，因为混元不提供默认模型路由，直接使用未声明的模型名会导致404错误或“model not found”响应。
确认可用模型列表
打开腾讯云混元大模型控制台 → 进入「产品文档」→ 查找「支持的模型列表」页面。当前（2026年9月）稳定可用的公开模型包括：【hunyuan-lite】、【hunyuan-standard】、【hunyuan-pro】、【hunyuan-hy3】。Hy3为预览版，需单独开通权限；lite与standard已全量开放。
注意：模型ID区分大小写，且不能添加空格或下划线变体，例如 hunyuan_lite 或 HunYuan-Lite 均无效。
CherryStudio中选择模型
方法一：通过模型下拉菜单切换
配置完API密钥后 → 点击左侧「助手」标签页 → 在输入框上方找到模型选择器 → 点击下拉箭头 → 从列表中选择目标模型（如 hunyuan-standard）。
方法二：手动编辑模型ID（适用于新增模型未显示时）
点击左下角「设置」→ 进入「模型服务」→ 找到已添加的混元条目 → 点击右侧「编辑」图标 → 将「模型ID」字段改为准确值（如 hunyuan-pro）→ 保存 → 返回对话页刷新页面。
这一步操作起来很简单，直接把文件拖进去就行。但若编辑后仍无法调用，请检查是否在「分组名称」中误填了空格或中文字符——该字段仅用于界面归类，不影响调用，但填错可能触发前端校验异常。
OpenWebUI中绑定模型
第一步：进入模型管理界面
点击左下角用户头像 → 「设置」→ 左侧菜单选「模型」→ 右侧点击「+ 添加模型」。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
第二步：填写模型参数
「名称」填自定义标识（如“混元专业版”）→ 「上下文长度」建议填256000（对应Hy3）或32768（对应standard）→ 「模型路径」留空 → 「基础URL」填 https://api.hunyuan.cloud.tencent.com/v1/ → 「模型ID」填准确值（如 hunyuan-hy3）→ 点击保存。
第三步：设为默认或手动切换
返回「新对话」页 → 点击右上角模型下拉框 → 选择刚添加的模型名称 → 后续所有新对话将默认使用该模型。
如果没看到刚添加的模型，请强制刷新浏览器缓存（Ctrl+F5），OpenWebUI不会自动轮询新增模型列表。
WorkBuddy中按任务类型选模型
WorkBuddy不提供全局模型切换开关，而是根据MCP工具注册时绑定的模型ID自动路由。
例如：你在MCP Server脚本中为 hunyuan_chat 工具指定模型为 hunyuan-lite，为 hunyuan_image 工具指定模型为 hunyuan-hy3，那么发起文本对话时自动走lite，生图请求则强制走hy3。
这种设计避免了人工误选——你不需要记住哪个模型适合什么任务，只要确保MCP Server启动时加载的配置正确即可。
关键点在于：修改MCP Server的Python脚本后，必须重启服务进程，WorkBuddy不会热重载模型配置。
