常见问题

关于 MotioForge Studio 最常见问题的快速解答。

入门

问：开始使用需要哪些基本步骤？

答：1. 创建一个域（启动窗口）。2. 配置端口（COM）。 3. 添加元素（舵机、开关、音频）。4. 打开主编辑器并创建第一个动画。 详情请参阅快速入门。

问：MotioForge Studio 把我的项目保存在哪里？

答：保存在域文件夹中，可在启动窗口的设置 → 路径...菜单中配置。 默认位置是 %LOCALAPPDATA%\ARES\domains。每个域都是一个包含 JSON 文件的子文件夹。

问：可以和别人共享项目吗？

答：可以。将整个域文件夹复制到 U 盘或云存储（OneDrive、Google Drive 等）。 对方把它放到自己的域文件夹中，MotioForge Studio 就能读取。音频路径是相对路径， 因此在不同的计算机上也能使用（前提是音频文件在同一个文件夹中）。

时间轴和动画

问：如何更改时间轴的播放速度？

答：没有全局的「播放速度」。速度是按每个舵机片段定义的（0–100）。 如需整体加快，请选中所有片段，点击鼠标右键，并在各个片段中降低速度值。

问：如何创建连续重复的动画？

答：打开动画属性（在启动窗口中选择动画后点击「编辑」）， 勾选连续循环播放。开始播放后，动画会一直重复，直到你停止它。

问：动画的最长时长是多少？

答：理论上没有限制。时长由时间上最靠后的片段决定。 可以创建长达数小时的动画，文件仍然很小（只是 JSON 数据）。

问：可以把动画从一个域复制到另一个域吗？

答：界面中不能直接操作。请打开域文件夹，将动画从 domain/animations/<id>/ 复制到另一个域，然后重新启动 MotioForge Studio。

问：「随机延迟启动」有什么用？

答：随机延迟启动是一项动画属性，它会在播放开始前加入一个随机延迟。 启用后，所有片段都会整体向后推移一个随机时间。这可以让动作显得自然、不机械。 例如眨眼：与其每隔正好 5 秒眨一次眼，不如为动画设置随机延迟（例如 4–6 秒）， 这样每次动画开始时，动作都显得自然、逼真。 可在动画属性中设置此选项。

管理片段

问：如何在时间轴上插入片段？

答：1. 按住 Shift。2. 在目标轨道上点击并水平拖动。 3. 松开鼠标：片段即被创建。开始拖动时的垂直高度决定舵机的起始位置 （高 = 高位置，低 = 低位置）。详情请参阅时间轴。

问：如何移动一个或多个片段？

答：1. 单击片段将其选中。2. 如需同时选择多个片段： 按 Ctrl+单击将更多片段加入选择。3. 在已选中的片段上点击并拖动， 即可一起移动所有选中的片段。如果拖动的是片段的左端或右端，则会调整片段大小。

问：如何修改片段的属性？

答：1. 单击片段将其选中（或直接双击片段）。2. 打开工具栏中的片段菜单。 3. 选择片段属性…。详细编辑器会打开，可以根据片段类型（舵机、音频、开关）修改角度位置、速度、 加速度曲线、时长、运动类型等参数。

问：如何更改片段的时长和结束位置？

答：两种方法：1. 在时间轴上图形化操作：拖动左端（更改开始时间）或右端（更改结束时间）。 片段的高度表示角度位置。 2. 用数值输入：选中片段后打开片段 → 片段属性…，可以输入精确的时间（开始/结束，ms）和位置（0–180°）。

问：如何让音频片段通过音量控制一个舵机？

答：MotioForge Studio 可以自动完成：1. 双击音频片段，打开音频片段编辑器。 2. 启用将舵机链接到音量并选择舵机（例如嘴巴舵机）。3. 设置最小和最大音量。 4. 按生成舵机片段：系统会根据音频音量生成该舵机的片段。 只要链接存在，该舵机轨道就处于锁定状态。

问：如何让音频片段按频率控制多个舵机/开关？

答：在音频片段编辑器的频率绑定部分， 为每个频段（低音、中音、高音）关联一个舵机，并设置截止频率（Hz）。启用独占后， 每个时刻只有占主导地位的频段驱动其舵机。然后按生成舵机片段。 同一个舵机不能同时绑定到音量和某个频段。

端口和连接

问：我看不到所连接的 COM 端口，怎么办？

答：1. 确认设备已开机并通过 USB 连接。 2. 打开「设备管理器」（Windows），查看分配的 COM 编号。 3. 在 MotioForge Studio 中选中域，打开端口选项卡，在串行设备字段中填入该 COM。 4. 如果仍然不行，请下载该设备的驱动程序。

问：端口已连接，但 MotioForge Studio 看不到它，为什么？

答：可能缺少 USB 驱动或驱动已损坏。请在「设备管理器」中查看设备旁边是否有黄色感叹号。 如果有，请从制造商网站下载正确的驱动程序。

问：可以连接多个不同的设备吗？

答：可以。在 MotioForge Studio 中配置多个端口（每个设备一个）。 在元素中，将每个舵机/开关分配到正确的端口。播放时， MotioForge Studio 会同时与所有端口通信。

问：端口控制台中的错误是什么意思？

答：按 Ctrl+Shift+C 打开端口控制台，查看实时消息。 如需解读具体的错误消息，请参阅故障排除。

元素（舵机、开关、音频）

问：SERVO_BUS 和 SERVO_PWM 有什么区别？

答：SERVO_BUS 是串行数字舵机（例如 Waveshare ST3215），串接在同一条总线上， 每个都有不同的地址（ID），可以控制位置、速度和加速度。 SERVO_PWM 是由 PWM 信号驱动的模拟舵机，可以接在控制板的专用引脚上， 也可以接在 PCA9685 扩展板（I2C，每个模块最多 16 个舵机）的通道上。

问：可以使用普通舵机（非「机电动画专用」）吗？

答：可以。舵机就是舵机。MotioForge Studio 可以驱动任何舵机在 0–180° 范围内运动。 区别在于如何使用它来制作逼真、同步的动画。

问：如何为动画添加音频文件？

答：1. 在时间轴上创建一条 SOUND 轨道。2. 创建一个音频片段（Shift + 拖动）。 3. 打开片段编辑器并选择文件（.wav、.mp3、.ogg）。4. 文件应放在 domain/audio/ 中，或指定完整路径。

问：音频文件无法播放，为什么？

答：1. 保存的路径下是否存在该文件？请检查 domain/audio/。 2. 格式是否受支持？仅支持 WAV、MP3、OGG。其他格式（AIFF、WMA 等）请先转换为 WAV。 3. Windows 的默认音频设备是否已启用？请在 Windows →「设置」→「声音」中检查。

AI 助手

问：如何打开 AI 助手？

答：在 MotioForge Studio 的任意窗口中按 F2，或使用菜单帮助 → 询问 AI。

问：应该使用哪个 Ollama 模型？

答：取决于你的计算机资源：

• tinyllama（约 600 MB）— 最轻量，适合内存少于 8 GB 的电脑。
• phi3（约 2 GB）— 较为均衡，适合 8–12 GB 内存。
• llama3.2（约 2 GB）— 推荐入门使用。
• mistral（约 4 GB）— 回答更详细，需要 12 GB 以上的可用内存。

问：Ollama 让整台电脑卡住了，怎么办？

答：你使用的模型太大了。请换用更轻量的模型（见上文）。 如果连 tinyllama 也会卡住，说明 Ollama 可能不适合你的硬件。 请改用 Claude API 后端（首选项 → AI 助手）。

问：Claude API 是免费的吗？

答：不是，按使用量付费，但费用很低。 一次 10 个问题的典型会话费用低于 0.01 欧元。登录 console.anthropic.com 可以设置每月的消费上限。

问：AI 助手能访问我的项目文件吗？

答：不能。它只读取：官方文档、日志的最后几行（错误信息） 以及你的问题。出于隐私考虑，不会共享任何项目文件。

问：可以把我的 Anthropic API 密钥分享给别人吗？

答：不可以！API 密钥是个人专用的。任何拿到它的人都可以消耗你的额度。 如果已经分享过，请立即在 console.anthropic.com → API Keys 中停用它。

播放和运行

问：图形化时间轴上的动画制作是如何进行的？

答：MotioForge Studio 的动画制作基于直观的图形化时间轴，无需编写代码或处理复杂的电子表格。工作流程类似视频剪辑或音乐制作软件，但操作的不是画面帧或音符，而是真实的角度位置和硬件命令。具体工作方式如下：
电机轨道：在一个动画中，系统里配置的每个舵机都会显示为一条专用的水平轨道。
绘制片段：在轨道上拖动鼠标即可直接绘制片段。片段参数定义运动：片段的高度表示电机的角度位置（旋转角度），宽度决定运动持续时间。
编辑和精度：可以添加任意数量的片段，并逐个修改、复制和微调，以获得所需的动作效果。该系统可精确控制每个部件的位置、速度和加速度。
多通道同步：时间轴可以同时协调数十个舵机。除电机外，还可以同步加入 LED 灯、继电器、气动执行器或开关等数字输出，以及协调的音频文件，并可根据语音或音乐自动生成口型动作（lip-sync）。
实时执行：即时预览是一项关键功能。按下播放键后，软件会实时向硬件发送命令，无需中间编译步骤，就能立即看到角色或物体的动作。可以随时停止播放，并把播放头（playhead）移动到时间轴上的任意位置继续微调动画。

问：如何停止动画的播放？

答：按停止动画（Shift+F5），或点击主编辑器工具栏中的停止按钮。 如果动画处于连续循环播放中，按停止即可中断。

问：播放过程中可以调整舵机吗？

答：不可以。播放期间，舵机会严格按照编排的片段运动。 请先停止播放，修改片段后再重新开始。

问：播放与音频同步吗？

答：同步。播放包含音频片段的动画时，时间与音频播放保持同步。 可以利用这一点让舵机与对白或音乐同步。

问：可以让动画连续循环播放吗？

答：可以。在动画属性中可以设置动画只运行一次、由外部触发， 或连续循环播放。这适用于需要无人值守、重复运动的场景，例如商店橱窗中的装饰品或主题公园中的机电动画角色。 在时间轴上制作时，也可以反复播放以微调动作，直到达到理想效果。

问：如何通过外部命令启动动画？

答：在 MotioForge Studio 中，通过外部命令启动动画是系统提供的一种执行模式，用于实现交互式或自动化装置。根据使用场景，可以通过不同方式完成：
触发器类型：可以通过手动触发器（在软件中按键）或软件触发器启动序列。
自动化和传感器：在主题公园等场景中，例如可以通过连接的传感器，在游客经过时自动启动动画。
交互式输入：在密室逃脱等场景中，道具可以直接响应参与者的操作，例如转动机械钥匙，或其他由软件逻辑管理的物理触发器。
远程控制：动画也可以由操作员远程控制。
配置方法：该设置在硬件域中创建动画时定义（工作流程的第 2 步）。在这一阶段，可以决定该动画只执行一次、保持连续循环，或等待外部触发后再启动。

性能和故障排除

问：加载大型域时 MotioForge Studio 很慢，如何加快？

答：1. 确认域位于本地磁盘上（而不是云端）。 2. 关闭其他程序以释放内存。 3. 如果片段数量非常多（超过 10000 个），请将其拆分为两个较小的域。 4. 将 MotioForge Studio 更新到最新版本。

问：如何备份项目？

答：将域文件夹（例如 ARES/my_domain/）复制到 U 盘、云存储（OneDrive、Google Drive）或外部硬盘。MotioForge Studio 的启动窗口中也提供备份功能。

问：可以从备份中恢复项目吗？

答：可以。如果备份是通过启动窗口的备份菜单创建的，请使用备份 → 还原备份...。 也可以将备份中的域文件夹复制到域文件夹（设置 → 路径...）中： MotioForge Studio 会自动识别。

问：项目文件损坏了怎么办？

答：1. 关闭 MotioForge Studio。2. 从备份中恢复。3. 如果没有备份，请联系技术支持。 如果了解文件结构，也可以手动编辑 JSON 文件。

语言和设置

问：如何更改 MotioForge Studio 的语言？

答：打开首选项 → 语言，选择意大利语、英语或中文，然后重新启动 MotioForge Studio。

问：如何更改主题（颜色）？

答：打开首选项 → 主题，从可用主题中选择（蓝色、深色等）。

问：在哪里可以找到用于诊断错误的日志文件？

答：日志位于 %LOCALAPPDATA%\ARES\logs\ares.log。用文本编辑器打开即可查看错误消息， 也可以使用日志 → 复制/导出日志文件夹...菜单将其发送给技术支持。 AI 助手（F2）会自动读取日志的最后几行。

许可证和发行

问：BETA 和生产版有什么区别？

答：BETA — 带有到期日的免费版本（用于测试和评估），无需许可证。 生产版 — 面向最终用户、需要有效许可证的版本。许可证包含用户邮箱、自定义到期日和可选的硬件绑定。

问：「硬件绑定」是什么意思？

答：如果许可证带有硬件绑定，它只能在生成许可证的那台计算机上使用。 绑定信息包括邮箱 + 硬件指纹 + 版本。在其他计算机上使用时，会出现「许可证绑定到其他计算机」错误。 这可以防止未经授权复制到其他电脑。如果你在多台计算机上工作，可以申请不带绑定的许可证。

问：许可证什么时候到期？

答：许可证有明确的到期日（例如：2027-06-30）。可在首选项 → 🔐 许可证中查看。 许可证到期后，MotioForge Studio 将无法启动，并显示「许可证已过期」消息。请在到期前续期。

问：如何续期许可证？

答：1. 打开首选项 → 🔐 许可证，点击「📧 向支持申请许可证」。 2. 填写邮箱和付款信息。3. 你会通过邮件收到新的许可证。 4. 将新许可证粘贴到首选项 → 🔐 许可证中，并点击「✓ 验证许可证」。完成！✅

问：收到「许可证绑定到其他计算机」错误怎么办？

答：你的许可证绑定在另一台计算机上（硬件绑定）。可选方案： 1. 在生成许可证的原计算机上使用 MotioForge Studio。 2. 联系技术支持，申请不带硬件绑定的许可证（适用于多台计算机）。 3. 为这台计算机申请新的许可证。

问：技术支持生成许可证需要多长时间？

答：技术支持会在 24 小时内答复。核实付款后，许可证会生成并通过邮件发送。 如果可以通过银行转账附言追踪付款，处理会更快。

问：如何查看 MotioForge Studio 的版本？

答：打开帮助 → 关于。可以看到构建版本和 Beta 到期日期。 申请许可证时需要提供版本号。

DEIMOS 固件

问：如何更新 DEIMOS 控制板的固件？

答：用 USB 连接控制板，在启动窗口中打开 DEIMOS → 加载 DEIMOS 固件， 选择程序包和端口，然后点击上传。整个过程需要 30–60 秒。上传期间请勿关闭电脑。

问：固件无法上传，怎么办？

答：1. 确认控制板已连接并通电。 2. 检查在上传对话框中选择的 COM 端口是否正确（如果刚刚连接，请点击刷新）。 3. 再试一次。如果仍然不行，请重启控制板。