配置步骤与方法
33-AI 能力接入 · 2026-10-12 · 3.2 KB
从"打开设置"到"模型下拉里出现模型"，按本文走一遍就顺了。
本专题手工维护（2026-10-12 建）；⚠ 分项名与字段以应用当前版本为准（本页快照 2026-10-12）。
一、设置在哪、要动哪几项
入口：应用右上角 「设置」（齿轮） ⇒ 左侧分项列表。
与"接入 AI"相关的是这 4 项（其余项本文不涉及）：
| 分项 | 管什么 | 本卷用它做什么 |
|---|---|---|
| API Key 管理 | 集中管理所有服务商的 API Key / Base URL / WorkspaceId，并为每个 Key 提供占位符常量 | ★ 主战场：填文本模型与云模型服务的 Key ✓ |
| API 规则 | API 请求的统一规则 | ⚠ Key 与地址都统一到「API Key 管理」了 ⇒ 一般不用动 |
| WorkBuddy 云服务 | endpoint ＋ publishableKey | ★ 免 Key 路子：配完重启 ⇒ 多出「WorkBuddy 积分通道」（耗积分、不用自备 Key）✓ |
| 远程 ComfyUI | 远程实例地址 ＋ Music3 音乐服务地址（全局） | 只有要走云音乐模板时才用（那一项不是 Key）✓ |
二、路径 A：自备 Key（推荐先做这一步）
① 设置 → API Key 管理 → 「推荐 API Key」页签 → 新建 ✓
② 选一家服务商（下拉里是应用内置的清单，见 §四）✓
③ 填「API Key」（输入框是掩码显示；留空并失焦 = 删除这条）✓
④ 需要时补：
· 「Base URL」/「Base URL（备选）」—— 有的服务商要你自己填/改地址 ✓
· 「WorkspaceId」—— ⚠ **只有阿里云百炼**有这个附加项，不填会报占位符错误 ✓
· 「API 模式」—— 百炼有 native / compatible 两种，按你申请的通道选 ✓
⑤ 页顶「AI 咨询服务商」选成这一家 ⇒ 它成为**默认对话模型来源** ✓
⑥ 保存（离开输入框 / 点保存即可）✓
自建服务商（用自己的中转/自建网关）用同页的「自建 API Key」页签：可填中文名＋自己的 Base URL ＋ Key ✓
三、路径 B：WorkBuddy 云服务（免 Key，按积分）
① 设置 → WorkBuddy 云服务 ✓
② 填两项（云服务开通时给你）：
· endpoint —— 应用专属数据面地址（形如 https://<你的应用>.app.workbuddy.host）✓
· publishableKey —— 应用标识（形如 wbpk_…，**无敏感权限**）✓
③ 点「保存」→ ⚠ **重启应用**（配置在启动时读入 ⇒ 不重启不生效）✓
④ 重启后：模型下拉里会多出分组「**WorkBuddy 积分通道**」（免 API Key、消耗账号积分）✓
两条要知道的：
| 项 | 说明 |
|---|---|
| 状态行 | 保存后显示「● 已配置（重启后生效）」；没配则「○ 未配置 —— 该渠道不存在」✓ |
| 积分账本 | 该页能看"本机应用今天 / 本月消耗的积分" ✓ |
| 没配会怎样 | 该渠道整体不存在：模型下拉不显示、路由不命中 ⇒ ⛔ 不报错（静默降级）✓ |
四、内置服务商清单（16 家 · 下拉里照这个选）
APIMart · xAI（Grok） · 阿里云百炼 · OpenAI · 智谱 AI · 豆包（火山方舟） ·
DeepSeek · Gemini · MiniMax · 可灵 AI · Seedance（火山视频） · Seedream（火山图像） ·
Kimi（月之暗面） · Anthropic（Claude） · 即梦 · 自定义 API
⇒ 选哪家取决于你要用什么：想对话 ⇒ 任选一家对话模型；想跑云模板 ⇒ 见《能力提升与场景对照》§二的对照表 ✓
五、怎么验证配通了
⚠ 文本服务商没有"测试连接"按钮（那个按钮只在 ComfyUI 那边有）⇒ 验证就靠模型下拉：
| 看哪 | 通了的表现 |
|---|---|
| AI 助手面板顶部的模型下拉 | 能看到模型（按服务商分组）✓ 空 ⇒ 显示「（暂未接入，请到设置配置 API Key）」✓ |
| 导演台控制台（右上角模型下拉） | 出现模型；控制台会打印「✓ 已加载 N 个可对话文本模型（已过滤 M 个非文本模型）」✓ |
| 模板菜单 | 你要用的云模板在菜单里（缺 Key 的直接消失）✓ |
⚠ 模型清单有缓存（约 10 分钟）⇒ 刚配好没看到 ⇒ 重开一下助手面板再看 ✓
六、多服务商与切换
| 问题 | 答案 |
|---|---|
| 能同时配多家吗？ | ✅ 能：API Key 管理 是"每家一张卡"，互不覆盖 ✓ |
| 「AI 咨询服务商」是什么？ | 它是默认对话模型来源（不选 ⇒ 走内置默认那家）✓ |
| 实际用哪家由什么决定？ | 优先级：模型名能推断出的那家 → 本次指定的服务商 → 「AI 咨询服务商」 → 默认候选 ✓ |
| 切换影响什么？ | ⚠ AI 助手与导演台自主 AI 共用同一份选择 ⇒ 改一处，两处一起变 ✓ |
| 改完要重启吗？ | 路径 A（Key）不用；路径 B（积分通道）要 ✓ |
七、Key 存在哪、占位符是什么
| 项 | 说明 |
|---|---|
| 存在哪 | 你的用户数据目录下的 settings.json（应用自动管理；界面里只是掩码显示）✓ |
| ⚠ 是否加密 | 明文保存（界面的掩码只是显示层）⇒ ⛔ 别把这个文件发给别人 / 上传到任何仓库 ✓ |
| 占位符 | 模板里用形如 ${XXX_API_KEY} 的常量引用 Key ⇒ 提交时由应用统一替换 ⇒ 所以"Key 只需在设置里填一次" ✓ |
| WorkspaceId | 百炼的地址里含 ${WORKSPACE_ID} ⇒ 没填会明确报"占位符未配置" ✓ |
八、和相邻专题的分工
| 要做的事 | 去哪 |
|---|---|
| 接入外部 AI（本文：Key / 积分通道 / 云模型服务） | 本卷 ✓ |
| AI 助手怎么用（位置、工具、会话、中止） | 《AI 助手》卷 ✓ |
| ComfyUI 引擎（本地 / 远程 / 算力集群 / Music3 地址） | 《ComfyUI 本地部署》《云算力接入》两卷 ✓ |
| 外部客户端接入本应用（MCP） | 《MCP 指南》卷 ✓ |
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/ai_access/02-配置步骤与方法.md