安装¶
系统要求¶
- Toon Boom Harmony 21 Premium 或更高版本（已在 21、22、24、25 上测试）。
- Harmony Premium —— Essentials 和 Advanced 不支持 Python 脚本。
- 操作系统中已安装 Python 3.9（Harmony 通过它来启动用户脚本 —— 与其他所有 Octo Tools 产品的要求相同）。如果 ORC 已经能在你的机器上运行， 那你就已经准备好了。
Python 设置¶
Harmony 内嵌了自己的 Qt/PySide 运行时，但会通过系统 PATH 上一个独立的 Python 3.9 解释器来启动用户脚本。
Python 版本要求严格
Harmony 只加载 Python 3.9。3.10、3.11、3.12 以及更新的版本都会被 静默忽略。如果你安装了多个 Python 版本，为保险起见，请在 PATH 上只保留 3.9。
- 从 python.org 下载 Python 3.9.13（64 位）。
- 运行安装程序，并勾选 "Add Python 3.9 to PATH"。
-
在 PowerShell 中验证：
python --version预期结果：
Python 3.9.13
- 从 python.org 下载 Python 3.9.13。
- 运行安装程序。
-
在 Terminal 中验证：
python3 --version
Octo Tools Installer¶
整个 Octo Tools 产品线 只有一个安装程序。下载一次，勾选你购买的产品 —— 这里是 Octo Skip Nodes —— 再勾选要部署到的应用，然后按 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 安装路径。 Octo Skip Nodes 只面向 Harmony，因此只有它的 Harmony 复选框可用。
- Products —— 每个产品一行，每个应用一个复选框。默认不勾选任何项；请在 Harmony 下勾选 Octo Skip Nodes。
- Licence key (optional) —— 每个产品行一个输入框。可以留空，稍后在应用中激活。
每个被勾选的目标都会部署到它的原生位置，并且安装程序会把自己写入的内容准确记录在 一份 卸载清单 中。
授权是按产品计的
激活 Octo Skip Nodes 会覆盖该产品在这台机器上支持的所有 DCC。其他 Octo Tools 产品各有自己的授权和密钥 —— 一个密钥绝不会解锁整个产品线。
Octo Skip Nodes 必须以管理员身份安装¶
先关闭 Toon Boom Harmony，然后以提权方式运行安装程序 —— 在 Windows 上，
右键点击它并选择 Run as administrator；在 macOS 上，安装程序会询问是否
一并安装 Octo Skip Nodes，若回答是则使用 sudo。
Octo Skip Nodes 是产品线中 唯一 需要提权的产品：它会把键盘快捷键注册到
Harmony 安装目录的 resources/shortcuts.xml 中（位于 Program Files 下，
macOS 上则在 .app 包内部），并在动手之前先在原文件旁写入一份 .octobak 备份。
即使你拒绝提权，也不会有东西悄悄坏掉
Octo Skip Nodes 的脚本依然会安装，工具依然可以从 Script Editor 运行 —— 只是缺少键盘快捷键，而安装程序会明确说明这一点。想要快捷键时，再以提权方式 重新运行即可。在 Harmony 更新或重装后也请重新运行 —— 安装目录中的快捷键文件会被重置。
安装程序为 Octo Skip Nodes 做了什么¶
- 将工具复制到 Harmony 的脚本文件夹 ——
octoSkipNodes/文件夹（Python 包）， 外加散放在 scripts 根目录的OctoSkipNodes.js入口（一个微型启动器； 所有逻辑都在 Python 中）。 - 注册键盘快捷键到当前安装的
resources/shortcuts.xml（位于 General 类别下，因此在 Camera、Timeline 和 Node 视图中都能使用），并释放原生的 B / Shift+B（Select Parent / Child Skipping Effects）。注册前会先写入一份.octobak备份。
卸载¶
勾选 Octo Skip Nodes 那一行，然后按 Uninstall。卸载是按产品进行且精确的：
安装程序只移除它为 Octo Skip Nodes 记录过的路径 —— 包括从 .octobak 还原
shortcuts.xml —— 因此机器上其他 Octo 工具不受影响。
各目标落在何处¶
| 目标 | 形态 | 位置 |
|---|---|---|
| Harmony 脚本目录 | OctoSkipNodes.js 散放在 scripts 根目录，旁边是 octoSkipNodes/ 包目录 |
Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/ |
| Harmony 安装目录 | 向 resources/shortcuts.xml 添加四条记录，并附带 .octobak 备份 |
Windows C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony <version>\resources\ · macOS 位于 /Applications/Toon Boom Harmony <version>/ 内部 |
Harmony 只注册 scripts 根目录中的脚本
OctoSkipNodes.js 必须 散放 在 <version>-scripts/ 中，绝不能放进
子文件夹，而 Python 包必须位于一个名字恰好为 octoSkipNodes 的文件夹里 ——
那正是 .js 解析出的名字。
手动安装¶
在无法运行安装程序的受限机器上，请手动部署 —— 上面的布局就是全部约定。 在 Harmony 关闭的情况下：
- 把
OctoSkipNodes.js复制到<version>-scripts/，把 Python 包复制到<version>-scripts/octoSkipNodes/。 - 启动 Harmony 并从 Script Editor 运行
OctoSkipNodes.js—— 即使没有注册任何快捷键，工具也能从那里工作。 - 也可以自己在 Edit → Keyboard Shortcuts → General 中绑定这四个动作。
默认快捷键¶
| Key | Action |
|---|---|
| B | 向上跳过（到父节点） |
| Shift+B | 向下跳过（到子节点） |
| Ctrl+Alt+B | 向上跳转到下一个 + 节点 |
| Ctrl+Alt+Shift+B | 向下跳转到上一个 + 节点 |
随时可在 Edit → Keyboard Shortcuts → General 中更改它们 —— 查找 Octo Skip Up / Down 和 Octo Jump Up / Down。
故障排除¶
| Symptom | Fix |
|---|---|
| Harmony 更新后快捷键失效 | 以管理员身份重新运行安装程序（安装目录中的快捷键文件被重置了）。 |
| 安装程序提示 "Python not found" | 安装 Python 3.9（见上文）并再次运行。 |
| 工具栏按钮有效，但 B / Shift+B 无反应 | 安装程序未以管理员身份运行，或安装时 Harmony 处于打开状态。关闭 Harmony 并以管理员身份再次运行。 |
| 你想恢复旧的原生 B 行为 | 在安装程序中卸载 Octo Skip Nodes，或从安装程序创建的 .octobak 备份中还原 resources/shortcuts.xml。 |