安装¶
Octo Transform Sync 是 一份许可证下的三个工具 — 一个 Harmony 窗口、一个 Blender add-on，以及一个 Maya shelf 工具。只安装你真正使用的应用；OTS 从不要求三个都装。
系统要求¶
| 版本 | 说明 | |
|---|---|---|
| Toon Boom Harmony | 21 Premium 或更高 | 需要系统中安装 Python 3.9 并加入 PATH。Essentials 和 Advanced 没有 Python 脚本功能 |
| Blender | 4.2 或更高 | 使用 Blender 自带的 Python |
| Autodesk Maya | 2022 或更高 | 使用 Maya 自带的 Python |
每个宿主都自带 Qt/PySide，而 OTS 引擎除了 Python 标准库之外不导入任何东西 — 所以 没有任何需要额外安装的包。支持 Windows 和 macOS。
Octo Tools Installer¶
整个 Octo Tools 产品线 只有一个安装程序。下载一次，勾选你购买的产品 — 这里是 Octo Transform Sync — 再勾选要部署到的应用，然后按 Install。
| 平台 | 你要运行的东西 |
|---|---|
| Windows | Octo-Tools-Installer.exe |
| macOS | Install Octo Tools.command |
macOS 版是脚本，不是签名过的 app
Install Octo Tools.command 是一个普通的 shell 脚本，运行的 Python 代码与 Windows 版完全相同 — 没有 .app，没有代码签名，也没有公证（notarization）。双击即可运行。如果 macOS 拒绝执行，先给它加一次可执行权限：
chmod +x "Install Octo Tools.command"
窗口分为三个部分：
- Detected hosts — 在这台机器上找到的 Harmony、Blender 和 Maya 安装路径。
- Products — 每个产品一行，每个应用一个复选框。默认不勾选任何项；请在你使用的宿主下勾选 Octo Transform Sync。若该应用未被检测到，复选框会被禁用。
- Licence key (optional) — 每个产品行一个输入框。可以留空，稍后在应用中激活。
每个被勾选的目标都会部署到它的原生位置，并且安装程序会把自己写入的内容准确记录在一份 卸载清单 中。
安装就这些。下面几节描述的是安装程序为每个宿主所做的事情 — 只有当你更愿意手动部署，或者你所在的机器被锁定、无法运行安装程序时，才需要按它们操作。
一次激活覆盖该产品的所有宿主
授权是 按产品 计的。激活一次 Octo Transform Sync，就覆盖了这台机器上的 Harmony、Blender 和 Maya — 你不需要激活三次。其他 Octo Tools 产品各有自己的授权和密钥；一个密钥绝不会解锁整个产品线。
管理员权限¶
Octo Transform Sync 完全 按用户 安装，不需要提权。只有当 Octo Skip Nodes 也被勾选时，安装程序才会要求管理员权限，因为该产品需要在 Harmony 自身的安装目录中注册键盘快捷键。
卸载¶
勾选 Octo Transform Sync 那一行，然后按 Uninstall。卸载是按产品进行且精确的：安装程序只移除它为 Octo Transform Sync 记录过的路径 — 位于共享文件夹（例如 Harmony 的 script-icons）中的文件是逐个记录的 — 因此机器上其他 Octo 工具不受影响。
各目标落在何处¶
| 目标 | 形态 | 位置 |
|---|---|---|
| Harmony | OctoTransformSync.js 散放在 scripts 根目录，旁边是 octoTransformSync/ 包目录以及共享的 script-icons/ 文件夹 |
Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/ |
| Blender | octo_transform_sync/ add-on 文件夹 |
Windows %APPDATA%\Blender Foundation\Blender\<version>\extensions\user_default\ · macOS ~/Library/Application Support/Blender/<version>/extensions/user_default/（4.2+；更旧的 Blender 使用 scripts/addons/） |
| Maya | octo_transform_sync/ 以及一个 octo_transform_sync.mod 模块文件 |
Windows ~/Documents/maya/modules/ · macOS ~/Library/Preferences/Autodesk/maya/modules/（与版本无关） |
手动 — Harmony¶
Harmony 只注册 scripts 根目录 中的 .js 文件，绝不会去子文件夹里找，而这个 .js 会从一个名字恰好为 octoTransformSync 的同级文件夹加载它的 Python。所以布局是：
| 平台 | 位置 |
|---|---|
| Windows | %APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\<version>-scripts\ |
| macOS | ~/Library/Preferences/Toon Boom Animation/Toon Boom Harmony Premium/<version>-scripts/ |
在那个文件夹里，把 OctoTransformSync.js 散放在根目录，把 harmony/ 的其余内容以及 ots_core/、ots_ui/ 放进 octoTransformSync/ 文件夹，再把 harmony/script-icons/ 合并进已有的 script-icons/ 文件夹（千万不要替换它 — 它属于所有 Toon Boom 脚本，不只是我们的）。
重启 Harmony，然后从 Scripts 工具栏运行 OctoTransformSync 脚本。窗口会浮在 Harmony 上方并保持在那里；在它已经打开时再次启动，只会把它提到最前。
Harmony 明确需要 Python 3.9
Harmony 通过 PATH 上的系统 Python 3.9 来启动用户脚本。3.10 或更新的解释器会被静默忽略 — 脚本干脆就不运行，也不报错。请安装 64 位的 Python 3.9，并勾选 Add Python to PATH。这一点适用于所有 Octo Tools 产品，不只是 OTS。
手动 — Blender¶
把 blender/ 文件夹打包成 zip，然后作为 add-on 安装：
- Edit → Preferences → Add-ons → Install from Disk
- 选中那个 zip，然后在列表中启用 Octo Transform Sync。
- 用 N 打开 3D 视图侧边栏，并选择 OTS 标签页。
一切都发生在那个侧边栏面板里 — 没有单独的窗口。
手动 — Maya¶
最省事的办法 — 拖放。 把 OTS 文件夹里的 maya/install_maya.py 拖进 Maya 的 viewport（3D 区域，不是 Script Editor）。安装程序会：
- 把 OTS 加进 Maya 的 Python 路径，并通过在你的
userSetup.py中追加一段带保护的代码块来 让它永久生效（重复运行不会重复添加这段代码）。 - 在你当前的 shelf 上添加一个 OTS 按钮。
- 保存 shelf 并立刻打开窗口。
之后随时点击那个 shelf 按钮即可。
Script Editor — 手动方式。 在一个 Python 标签页中：
import sys; sys.path.insert(0, r"C:\path\to\octo_transform_sync\maya")
import launch_transform_sync_maya as ots
ots.install_shelf() # one-time: adds the "OTS" shelf button
ots.main() # opens the window
install_shelf() 是幂等的 — 如果任意一个 shelf 上已经存在 OTS 按钮，它会就地更新而不是再加一个。
试用与你的许可证¶
第一次启动时，OTS 会开始一段 30 天试用，所有功能全部解锁。窗口底部的横幅会倒数天数，并在最后三天变红。
许可证保存在一个 共享的、与应用无关的文件夹 中，所以在一个宿主中激活就会解锁这台机器上的其他宿主 — 你不需要激活三次。它解锁的只有 Octo Transform Sync；其他 Octo Tools 产品单独授权。
参见 许可证与激活。