AI 助手
MotioForge Studio 内置一个对话式助手，可以回答有关软件使用、硬件配置和故障排除的问题。 助手了解全部文档，并能自动读取当前会话的日志，针对错误给出有上下文的解答。
如何打开助手
- 在 MotioForge Studio 的任意窗口中按 F2。
- 在帮助窗口（F1）中点击询问 AI按钮。
- 使用菜单帮助 → 询问 AI。
它能回答什么
- 如何配置域、端口或元素。
- 如何在时间轴上创建和编辑动画。
- 某条错误或警告消息的含义。
- 如何解决连接或播放问题。
- 关于系统可能用途的想法和建议。
注意：助手只回答与 MotioForge Studio 和机电动画（animatronics）相关的问题。
它不提供编程、源代码或与本系统无关话题的帮助。
可用的后端
助手支持两种 AI 引擎，可在首选项 → AI 助手中选择：
| 后端 | 费用 | 要求 | 隐私 |
|---|---|---|---|
| Ollama（本地） | 免费 | 在电脑上安装 Ollama 并下载模型（约 2–4 GB） | 数据不会离开本地网络 |
| Claude API（Anthropic） | 由用户承担（每次会话仅需不到一分钱） | Anthropic 账户和个人 API 密钥 | 数据会发送到 Anthropic 服务器 |
注意：如果在 Claude API 密钥字段中填写了密钥，无论选择哪个后端，
MotioForge Studio 都会自动使用 Claude。
配置 Ollama（免费、本地）
Ollama 是一个开源程序，可以直接在你的计算机上运行 AI 模型， 无需互联网连接，也没有任何费用。
1 — 安装
- 访问
https://ollama.com并点击 Download。 - 选择适合你操作系统的安装包：
- Windows — 下载
OllamaSetup.exe并运行安装程序。安装完成后，可以在「开始」菜单和系统托盘中找到 Ollama。 - macOS — 下载
.zip文件，解压后将应用拖到应用程序文件夹。首次启动时可能会要求允许运行第三方软件。 - Linux — 打开终端并粘贴：
curl -fsSL https://ollama.com/install.sh | sh
- Windows — 下载
硬件要求：Ollama 可以在任何至少有 8 GB 可用内存的现代电脑上运行。
配备 Nvidia 或 AMD 独立显卡时，几秒钟内即可得到回答。
没有独立显卡（仅 CPU）时，每次回答可能需要 1 到 5 分钟，即使是高性能电脑也是如此。
如果无法接受这么长的等待时间，请使用 Claude API（见下文）：
无论硬件如何，都能在 5–15 秒内得到回答，费用可以忽略不计。
2 — 下载模型
安装后出现的「Launch」窗口与 MotioForge Studio 无关。
它显示的是在浏览器中运行的 Ollama 独立应用（例如 Claude Code、Codex、Hermes…）。
直接关闭即可，然后继续下面的步骤。
打开终端（Windows 上的「命令提示符」，macOS/Linux 上的「终端」）， 使用以下命令之一下载模型：
| 命令 | 大小 | 适用情况 |
|---|---|---|
ollama pull llama3.2 | 约 2 GB | 质量和速度较为均衡。推荐入门使用。 |
ollama pull mistral | 约 4 GB | 回答更详细、更准确。 |
ollama pull phi3 | 约 2 GB | 非常轻量，适合内存较少的电脑。 |
下载需要几分钟，具体取决于网络速度。下载完成后， 模型保存在本地，无需再次下载。
3 — 启动 Ollama
使用 MotioForge Studio 助手之前，Ollama 必须处于运行状态。
- Windows：安装后，Ollama 会随 Windows 自动启动。 如果没有运行，请在「开始」菜单中搜索 Ollama 并启动它。 系统托盘（时钟旁边）会出现一个图标。
- macOS：从「应用程序」文件夹中打开 Ollama。菜单栏中会出现图标。
- Linux：在终端中输入：
ollama serve
保持终端打开，或将 Ollama 作为系统服务启动。
要确认 Ollama 是否在运行，请打开浏览器并访问
http://localhost:11434。如果看到 Ollama is running，说明一切正常。
4 — 在 MotioForge Studio 中配置
- 打开首选项 → AI 助手。
- 选择 Ollama（本地 / 免费）作为后端。
- Ollama 地址保持默认值
http://localhost:11434（只有当 Ollama 运行在网络中的另一台计算机上时才需要修改）。 - 在 Ollama 模型中选择或输入已下载模型的名称，例如
llama3.2。 - 点击确定，然后按 F2 打开助手。
配置 Claude API（回答质量更高）
Claude 是由 Anthropic 开发的 AI 模型。与本地模型相比，它的回答准确得多、也更贴合上下文， 在分析错误日志时尤其明显。该服务需要付费，但一般使用的费用可以忽略不计。
1 — 创建 Anthropic 账户
- 访问
https://console.anthropic.com并注册。 - 在 Billing 部分添加付款方式并充值 （即使只充 5–10 欧元，也足够正常使用好几个月）。
2 — 生成 API 密钥
- 在 Anthropic 控制台中打开 API Keys 部分。
- 点击 Create Key，为密钥命名（例如
MotioForge）并复制其值。 - 请将密钥保存在安全的地方：关闭页面后将无法再次查看。
3 — 在 MotioForge Studio 中配置
- 打开首选项 → AI 助手。
- 选择 Claude API（Anthropic）作为后端。
- 将 API 密钥粘贴到 Claude API 密钥字段中。
- 选择模型：
- Claude Haiku — 快速、经济（每个问题约 0.001 欧元）。推荐日常使用。
- Claude Sonnet — 质量更高，日志分析更深入（每个问题约 0.01 欧元）。
- 点击确定，然后按 F2 打开助手。
使用 Claude Haiku 进行 10 个问题的会话，费用低于 0.01 欧元；
使用 Claude Sonnet 则低于 0.10 欧元。费用取决于回答的长度以及上下文中包含的日志行数。
自动读取日志
当首选项中的包含的日志行数大于 0 时，MotioForge Studio 会自动将日志文件的最后几行 附加到发送给 AI 的上下文中。这样就能针对会话中的实际错误给出有上下文的回答：
- 「为什么端口连接不上？」— AI 会读取确切的错误消息。
- 「这条警告是什么意思？」— AI 会解读日志内容。
- 「播放总是停在同一个位置，为什么？」— AI 会分析事件顺序。
包含的行数可以在首选项中配置（默认：80 行；0 = 禁用）。
隐私和安全
- Ollama：不会向外部服务器发送任何数据。所有内容都保留在用户的电脑上。
- Claude API：问题内容、文档和日志行会发送到 Anthropic 服务器。请勿在问题中包含个人数据或机密信息。
- API 密钥：密钥保存在用户的首选项文件中。请勿与他人共享该文件。