Funscript 故障排除

设备动作偏晚或偏早

原因。每套设置在画面和设备之间都有一定延迟：Ultra 来自网络和 Autoblow 的云端，Intiface 设备来自电脑和蓝牙。为视频的另一个剪辑版本制作的脚本，也会整体偏移。

解决方法。调整 Offset。范围为 -5000 到 +5000 ms，步长 50 ms。如果设备感觉偏晚就调高；感觉偏早就调低。应用会为每个视频保存这个值（最多 200 个视频），再次打开该视频时自动恢复；没有保存值的视频沿用你上次使用的 Offset。所有设备共用一个 Offset，而不是每台设备各一个。

播放期间发生的事情因路径而异：

• Autoblow AI Ultra。应用在视频时间加上实测往返时间的一半处启动设备，然后每 1.5 到 5 秒检查一次设备的时钟。80–350 ms 的漂移会被逐步修正；超过 350 ms 时，会在视频当前位置重新启动设备。如果 Ultra 仍然出现漂移，暂停后再播放即可重新对齐。
• Intiface 设备。没有延迟测量，也没有漂移校正。脚本从每次播放或跳转开始按电脑的时钟运行，并按 Offset 平移。如果视频卡住或缓冲，设备会继续运动；暂停后再播放，或跳转一下，即可重新对齐。

如果只有某一段不准而其余都正常，那是那一段脚本的问题，而不是同步问题：在时间轴上选中该区间，使用 Shift ±20 ms。

Autoblow AI Ultra 连接不上

原因。应用只能通过 Autoblow 的云端连接 Ultra，从不经由你的本地网络直接连接。如果云端没有与你的设备令牌对应的活动会话，说明 Ultra 处于离线状态，或令牌有误。

解决方法。

1. 确认电脑和 Ultra 都能上网。在设备播放的整个过程中，两者都需要联网。
2. 让 Ultra 上线：按住按钮约 3 秒，在 LED 快速闪白光时松开，然后等待它变成浅蓝色。浅蓝色表示在线状态。
3. 检查你粘贴到应用中的设备令牌。它来自 Autoblow 的在线设置页面；如果 LED 已是浅蓝色但仍然失败，请到 fun.autoblow.com 核实令牌。
4. 重新连接，然后在播放前按 Send Script to Device。不这样做的话，应用会退回到粗略的位置指令，并显示 "Streaming positions (fallback mode)"。

如果连接成功后启动播放或动作失败，应用会显示正在重新连接，每 5 秒重试一次，并在设备恢复后将其重新对齐到视频。如果 Ultra 切换到内置模式或往复摆动模式，应用会提示你；重新发送脚本即可恢复同步。Autoblow AI Ultra 页面有完整的设置说明。这是我们唯一在真实硬件上测试过的设备。

找不到 Intiface 设备

原因。应用通过位于 ws://127.0.0.1:12345 的 Buttplug 服务器与设备通信。如果该地址没有服务在监听，应用会启动自带的 Intiface 引擎（版本 1.4.8），因此你不需要 Intiface Central。连接时最多扫描 12 秒。设备未开机、超出蓝牙范围，或比自带引擎更新，都不会出现。

解决方法。

• 在 Windows 中打开蓝牙，打开设备电源，扫描时让设备靠近电脑。如果设备在 12 秒内没有就绪，请重新连接。
• The Handy 只能通过 Intiface 以蓝牙方式使用。不支持它的 Wi-Fi 连接密钥模式，请将其设为蓝牙。
• 如果你自己运行了 Intiface Central，应用会使用它，而不是自带的引擎。我们尚未用 Intiface Central v3 检验过本应用；如果设备在 Central 中能找到而应用找不到，请关闭 Central，让应用启动自带的引擎。
• 在自带引擎（2023 年 11 月）之后发布的设备，它可能无法识别。

我们用模拟服务器和真实引擎上的模拟设备测试过 Intiface 路径，但没有在真实的蓝牙玩具上测试。详情见 Intiface 页面，The Handy 页面介绍了该设备。

脚本无法载入，或上下颠倒地播放

原因。文件不是有效的 JSON、没有 actions 列表，或以已发布应用无法读取的编码保存。2.121.1 版只读取 UTF-8，因此某些 Windows 工具带字节顺序标记（BOM）或以 UTF-16 保存的文件会被拒绝。它还会忽略 inverted 标志，所以标记为反向的脚本会上下颠倒地播放。

解决方法。把文件拖到 funscript 校验器上。它会指出问题，并且对于排序、重复时间和超出范围的位置，会给你一份修复后的副本。如果是编码问题，用文本编辑器打开文件，重新保存为纯 UTF-8。下一次更新（2.121.2）会读取字节顺序标记和 UTF-16，正确应用 inverted，并用通俗的话说明文件为什么无法使用。

还要检查文件名：要自动载入，脚本必须与视频同名（不含扩展名）并放在同一个文件夹中。否则请使用 Load Funscript…。格式参考列出了应用在载入时进行的每项修复。

动作太快，或行程被截短

原因。应用在把脚本发送到 Autoblow AI Ultra 之前，会将一份副本按该设备的速度配置进行适配。间隔比设备所能处理的更近的点会被合并，需要超出配置允许速度的行程会保留时间点但缩小幅度。在快速场景中，这表现为设备上的行程比时间轴上的短。保存的 .funscript 从不会被修改。

这些配置采用的是厂商公布的数据减去约 10%，而不是我们自己的测量值。Autoblow 的每秒 400 单位是刻意保守的默认值，因为 Autoblow 没有公布速度数据。

解决方法。

• 检查 Device model。在那里选择的配置会替代 Ultra 自己的配置，所以如果选着别的型号，限制就会不对。
• 如果某一段只是太过急促，在时间轴上选中它，使用 Soften 或 Smooth，然后重新发送脚本。
• 编辑和行程设置的更改，只有在你再次按 Send Script to Device 后才会到达 Ultra，因为它播放的是之前收到的那份副本。

在已发布的应用中，Intiface 上的往复式设备收到的脚本不经过这种适配；下一次更新会对 Intiface 设备同样应用这种适配以及你的行程设置。要按你自选的速度上限检查文件，请使用校验器的速度检查。

快速场景中行程太小

原因。这是生成器的一个已知弱点，并非你电脑的问题。主分析从不查看每一帧：对于 30 fps 的视频，在 Fast、Balanced 和 High 下分别每秒采样 7.5、10 或 15 次。动作很快时，这么稀疏的采样会漏掉行程的顶点和底点；在开发者对照手工脚本的测试中，生成的行程在快速场景中明显偏小。

解决方法。

• 在时间轴上选中快速区间，选择 Re-analyze。它会以完整帧率重新扫描这一区间，并把结果拼接进去。
• 或者选中后使用 Amplify，它会让区间内每个行程增大 15%。可重复使用以进一步放大。
• 用 High 生成，它每 2 帧采样一次，而不是每 3 帧。耗时会更长。

保存编辑过的生成脚本，会让应用学会你对每种场景类型偏好的行程幅度，并在之后的视频上应用。

画面中没有动作时设备仍在运动

原因。这是一个已知限制。生成器会让片头和片尾字幕保持静止，并把几乎静止的窗口拉平，但在视频内部，它可能在手工编写脚本的人会停下来的区间里继续生成行程。

解决方法。把它编辑掉。在时间轴上按住 Shift 拖过空闲区间，选择 Delete。删掉这些点后，设备会从区间前的点缓慢滑动到区间后的点；如果要完全停止，按住 Ctrl 单击，在区间两端各添加一个高度相同的点。然后保存；如果你使用的是 Ultra，再把脚本重新发送到设备。如果整个视频中分析一直跟错了对象，用 Set Motion Region… 画出要追踪的区域，然后重新生成。

如果视频几乎完全没有动作，应用会拒绝凭空编造脚本，并告诉你该视频看起来是静态的。

生成速度慢

原因。AI 模型（姿态和深度）只有在 NVIDIA 显卡上通过 CUDA 才能加速。在 AMD 或 Intel 显卡上，或 NVIDIA 显卡无法使用时，它们在处理器上运行，可以工作但慢得多。应用不会隐瞒这一点：它会报告实际使用的执行提供程序。光流始终在处理器上运行。

解决方法。

• 按 Check GPU（也可用 View → Check GPU…）。它会报告 PyTorch 和 ONNX Runtime 能否使用显卡；如果已安装姿态模型，还会报告姿态运行在哪个提供程序上，以及以每帧毫秒数计的速度自检结果。
• 把 Hardware 设为 Auto 或 GPU (CUDA)。Auto 会在 CUDA 可用时使用它。
• 使用 Balanced 而不是 High；在开发者对几部测试影片的测量中，High 耗时约为 1.5 倍，结果却差不多。Fast 更快，但识别出的行程明显更少。
• 在同一次会话中用相同的分析设置重新生成同一个视频，会复用已经完成的分析，因此几乎是瞬间完成；应用会把最近 3 个视频保留在内存中，直到你关闭它。

应用启动时直接关闭，没有任何提示

原因。最可能是缺少 VLC。应用通过已安装的 64 位 VLC 播放视频。安装程序会检查它，如果找不到，就从 videolan.org 下载 VLC 并静默安装。如果下载失败（例如安装时电脑离线），就会跳过 VLC，之后应用会在启动时不显示任何提示就关闭；原因只会写入它的日志文件。

解决方法。安装 64 位 VLC，或在电脑联网时重新运行 AutoScript Sync 安装程序，让它自己获取 VLC。然后重新启动应用。你的设置、模型和训练过的 AI 保存在 %USERPROFILE%\.autoscript_sync 中，重装后依然保留。

试用无法开始

原因。首次启动时试用不会自动开始，并且无法在离线状态下开始。许可证服务器会为每台电脑记录试用，所以需要连上它一次。

解决方法。连接互联网，打开应用，在激活窗口中点击 Start free 1-day trial。当天所有功能都会解锁。重新安装不会让已在该电脑上用过的试用重新开始。试用结束后，在同一窗口中输入许可证密钥（Help → License / Activation…）；密钥形如 ASYN-XXXX-XXXX-XXXX。下载页面提供安装程序，商店出售许可证，一次付费 £14.99。

延伸阅读

• 应用指南安装、激活、设备设置和质量报告，一步一步讲解。
• Autoblow AI Ultra 设置与同步如何连接、指示灯的含义，以及漂移校正的工作方式。
• 设备兼容性每类设备支持什么，以及测试到了什么程度。
• 应用如何读取脚本文件它对来自其他工具的文件进行的每一项修复。
• 学习中心全部四个参考页面。