Persona 可以连接 Live2D Cubism Editor 的外部应用程序集成（External Application Integration）接口，将当前舞台上 Live2D 模型的实时参数值流式传入 Cubism Editor 中打开的同一模型。制作师因此可以在 Editor 的物理窗口中观察真实追踪数据驱动下的物理模拟与变形器效果，无需反复导出。
前置条件
- Live2D Cubism Editor 5.1 或更高版本（FREE 与 PRO 版本均支持）
- 在 Editor 中通过 文件 › 外部应用程序集成设置 启用集成服务端
首次连接时，Editor 会弹出授权确认对话框。授权后 Persona 会记住凭据令牌，后续连接不再弹出。
设置
进入 Persona 的 设置 面板，展开 Cubism Editor 区块。配置项如下：
| 选项 | 说明 |
|---|---|
| 启用 | 开启或关闭与 Cubism Editor 的连接 |
| 地址 | 运行 Cubism Editor 的计算机地址。默认 127.0.0.1（本机） |
| 端口 | Cubism Editor 集成服务端口。默认 22033 |
| 发送参数 | 将主 Live2D 模型的参数实时流式传入 Editor 中打开的模型 |
| 包含物理输出 | 同时发送舞台上模型物理引擎驱动的参数值，而非将其留给 Editor 自身的物理预览进行模拟 |
| 仅物理窗口 | 仅在 Editor 的物理窗口处于前台时才发送参数 |
| 导出时重载 | 当 Editor 导出模型文件覆盖了舞台模型所加载的文件时，自动重载该模型 |
连接建立后，设置区顶部会显示状态行，标明当前正在向 Editor 传送参数的舞台模型名称及帧率。
模型匹配
舞台可能同时加载多个 Live2D 模型。Persona 会自动选择与 Editor 中打开的模型参数 ID 重合度最高的模型进行传送。当两个模型重合度相同时（例如由同一模板衍生），优先选择当前选中的模型，其次选择主模型。
Editor 会忽略其模型不具有的参数 ID，因此即使舞台模型与 Editor 模型的参数集不完全一致，共有的参数仍可正常同步。
导出时重载
开启导出时重载（默认开启）后，当 Cubism Editor 执行运行时导出，且导出路径与舞台上某个 Live2D 模型加载的 .moc3 或 .physics3.json 文件路径一致时，Persona 会自动就地重载该模型——模型保持在舞台上的同一位置与状态，仅刷新其数据文件。
对于制作师而言，工作流程非常简洁：将导出目录指定为 Persona 加载模型的源目录，之后每次在 Editor 中导出，舞台上的模型就会即时更新，无需手动操作。若导出的模型并未加载在舞台上，或导出路径指向另一份同名文件，则不会触发任何操作。
最后更新于 2026年10月21日