必须完成权限确认、客户端版本校验、api凭证绑定与默认策略设置四步闭环操作，缺一不可；低版本客户端或未开通白名单的账号将始终无法显示混元选项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在WorkBuddy中稳定使用腾讯混元模型，必须完成权限确认、客户端版本校验、API凭证绑定与默认策略设置四步闭环操作，缺一不可；低版本客户端或未开通白名单的账号将始终无法显示混元选项。
确认账号权限与客户端版本
这一步决定你能否看到混元选项，不是可选步骤。WorkBuddy对混元的支持有硬性门槛：账号需已开通混元调用白名单，且客户端必须为v2.3.0或更高版本。
打开WorkBuddy → 点击右上角头像 → 进入「设置」→ 查看「关于」页底部版本号；若显示v2.2.9或更低，请立即卸载并从官网下载最新安装包重新安装。
返回「账户与安全」页 → 检查是否已完成实名认证并勾选「AI模型服务协议」；两项任一缺失，系统会静默屏蔽混元入口，不会报错也不会提示。
【关键前提】若「AI模型管理」中仍无“混元(HunYuan)”字样，请联系企业管理员在腾讯云控制台开通hunyuan-pro或hunyuan-lite的API白名单权限——个人账号无法自助开通。
手动切换至混元模型（单次会话）
适用于临时调用混元处理中文长文本、合同解析或PPT生成等强语义任务，切换后本对话所有后续消息均由混元响应。
进入任意聊天窗口 → 点击输入框上方当前模型图标（如显示Qwen或GLM）→ 在弹出列表中滑动查找并点击“混元(HunYuan)- 2.5T”或“混元(Hy3)”。
注意：Hy3是2026年7月6日发布的正式版模型，限时免费至7月22日，现已被系统自动替换为长期可用的hunyuan-hy3标识；若列表中仅见2.5T而无Hy3，说明你的配置尚未加载最新模型索引，需执行下一步刷新。
发送一条测试消息（例如“请用三句话总结《民法典》第584条”）→ 观察响应开头是否含【混元解析】字样，且无Qwen风格话术残留。
PHP中文网提供Qwen-1.0.2.6 MacOS官方客户端下载，专为苹果电脑优化的阿里通义千问桌面应用。本版本深度适配Mac系统，支持本地高效运行与多模态交互，集成超长上下文处理、AI写作、代码生成及智能体构建等核心功能。通过官方渠道下载，确保安全稳定，助您实现智能办公与创作升级。
设为全局默认并启用智能匹配
避免每次对话重复选择，让WorkBuddy在中文场景下自动调用混元，尤其适合日常办公高频用户。
第一步：进入「设置」→「AI模型偏好」→「默认对话模型」下拉菜单 → 选择“混元(HunYuan)- 2.5T”或“混元(Hy3)”。
第二步：滚动至「高级选项」区域 → 开启「自动匹配中文场景启用混元」开关 → 此时系统将根据输入语言、关键词（如“合同”“发票”“PPT”“公文”）自动触发混元，无需手动切换。
第三步：关闭并完全退出WorkBuddy应用（包括后台进程）→ 重新启动 → 首次对话即生效。
【易错点】若重启后仍调用Qwen，检查是否遗漏了第一步中的下拉选择——仅开启开关不选模型，系统默认仍走原默认模型。
通过URL参数强制调用Hy3（网页版专用）
适用于嵌入内部系统或调试接口的场景，绕过UI限制直接指定模型，对桌面端无效。
在浏览器地址栏当前WorkBuddy网页URL末尾添加?model=hunyuan-hy3 → 回车加载。
验证方式：页面左下角状态栏应显示“当前模型：hunyuan-hy3”，且任意输入均返回Hy3专属响应头。
注意：该参数仅在首次加载时生效，刷新页面后需重新添加；不可与?model=xxx其他模型共存，否则将导致400错误。
