腾讯混元接入
这篇解决什么
混元平台字符串怎么填、默认打哪个 TokenHub 地址。读完能对上 AiPlatformEnum.HUN_YUAN = "HunYuan"，以及工厂会读密钥 url。
默认端口 48080。开启见 AI 功能设计。
示意图：包装类复用 DeepSeek 客户端。url 空则用类里的默认 Base URL。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 密钥 | @RequestMapping("/ai/api-key") | ruoyi-office/yudao-module-ai/.../controller/admin/model/AiApiKeyController.java |
| 工厂 | buildHunYuanChatModel(apiKey, url) | AiModelFactoryImpl |
| 包装 | BASE_URL / COMPLETE_PATH | HunYuanChatModel |
| 选项 | DeepSeekChatOptions | AiUtils.buildChatOptions |
| 管理端 | 密钥、模型页 | ruoyi-office-vben/apps/web-antd/src/views/ai/model/ |
官方菜单：密钥 2761，模型 2767。没有「混元」独立菜单。
默认地址 https://tokenhub.tencentmaas.com，补全路径 /v1/chat/completions。类里默认模型名 hy3-preview，以腾讯云 TokenHub 当前可点名为准。
/ai/image/draw 没有 HunYuan 分支。不要建 type=2 的混元绘画行指望能出图。
字段
| 名称 | 说明 | 仓库路径 |
|---|---|---|
platform | 必须是 HunYuan | AiApiKeyDO / AiModelDO |
apiKey / url | 密钥；url 可选 | AiApiKeyDO |
model | 如 hy3-preview | AiModelDO |
不是 Hunyuan 也不是 Tencent
枚举值是 HunYuan。填错大小写会校验失败。
和 DeepSeek 只是客户端复用
platform 必须是 HunYuan 才会进 buildHunYuanChatModel。YAML 开关是 yudao.ai.hunyuan.enable。
按本仓库 DO 生成的 ER。
配置与操作
走 API 密钥（2761）建 platform=HunYuan。工厂会读密钥 url，空则用默认 TokenHub 地址。再在 模型配置 建对话行。
YAML yudao.ai.hunyuan.enable 只控制装配，真正密钥仍在库表。开启见 AI 功能设计。
本系统截图：AI 大模型 → 控制台 → API 密钥。各厂商共用这一页，用 platform 区分。
本系统截图：控制台 → 模型配置。keyId 必须指向同平台密钥。
