OtakuSolutions API Reference

💡 本教程视频同步发布于我们的 Bilibili 频道。如遇 YouTube 播放不畅，欢迎前往 Bilibili 观看，感谢您的支持与理解！

📺 Bilibili 频道：https://space.bilibili.com/3706990259865792

一句总结：即使是因工作室流程规定必须在 Namespace Off 状态下工作的美术人员，也能通过这个自动魔法功能在后台智能代理执行安全的 Replace，不会发生其他角色节点被删除等灾难性事故。

1. Namespace Off 工作流所潜藏的致命威胁

最理想、最安全的 Fast-Ref 工作流，是始终开启命名空间（角色名:骨骼名 结构）进行工作。
然而，由于公司特殊引擎导出器脚本的限制，许多工作室不得不在完全关闭 Namespace 并同时启用 Unpack 的状态下工作。

在此状态下，若场景中同时存在多个角色，由于没有 Namespace 前缀，所有骨骼名称完全相同（root、L_Thigh 等）。此时尝试仅替换其中一个角色的绑定，会发生什么？
- Max 引擎会将另一个同名角色的节点误认为替换目标。
- 替换过程中，本来老实待着的无辜的其他角色节点会被整体删除或相互缠绕，发生灾难性的合并事故。

正因如此，旧版本为了安全，只要有任何 Namespace 关闭就会完全阻止 Replace 并弹出警告对话框，强制停止美术人员的操作。

2. 逃离手动地狱："Smart Switch" 的诞生

每次修改绑定时，美术人员都需要手动：
1. 将 Namespace Activate On 切换为开启（切换为安全打包模式）
2. 执行 Replace 完成绑定替换
3. 替换完成后再恢复为 Namespace Off、Unpack On

手动重复这三步不仅极为繁琐，途中只要漏掉一步就会导致整个场景报废。Smart Switch（智能切换）将这整个过程自动化了。

3. Smart Switch 在后台代理执行的流程

只需在 Options 菜单中勾选 Smart Switch 选项，工具便会自动执行以下神奇的序列：

[检测到 Replace/Reload 命令] ──► 1. 临时启用 Namespace On（安全虚拟壳隔离）
                                               │
                                               ▼
                                     2. 安全执行 1:1 映射 Replace（其他角色零干扰）
                                               │
                                               ▼
                                     3. 替换成功后，完美恢复原有的 Namespace Off / Unpack On
                                               │
                                               ▼
[美术人员查看工作界面] ──► Namespace 依然为 Off，图层也完美恢复为原始状态！

得益于这个智能序列，美术人员无需关心后台发生了什么，只需专注于自己的扁平工作界面结构，即可自由更新绑定。

4. 即使选项关闭也能生效的实务安全提示

如果在 Options 菜单中忘记开启 Smart Switch，并试图 Replace 一个危险的 Namespace Off 槽位，会怎样？
不是无条件阻止操作，而是智能弹出一个对话框：

「当前设置存在风险。是否为此次替换临时启用 Smart Switch 助手？」

选择 Yes 后，Smart Switch 将仅对该次替换安全地在后台代理运行并解决问题。

💡 体感说明：Smart Switch 启动后，内部会额外运行一轮命名空间临时分配、节点隔离、安全恢复序列，因此可能比普通的直接替换略微多花一点时间。 这是完美保护场景安全的精密计算步骤，请放心再等待 3~4 秒即可。