Turn layered PSDs into editable Live2D models — automatic rigging, mesh/deformer generation, physics, animation, and .cmo3/ .moc3 export.

PSD2Live – 开源 2D 角色绑定与动画套件

功能简介（白话说明）

将分层的 Photoshop 文件（PSD）转换为动画化的 2D 角色 – 工具会读取图层层级、创建网格、创建骨骼、物理效果和一组默认动作（闲置、眨眼、点头、头发摆动等）。
所有操作都在桌面编辑器中进行，您可以在其中微调网格、编辑骨骼、绘制、设置物理效果，并在时间轴上制作动画。
当您满意时，项目可以导出为多种格式：
- Live2D Cubism 文件（.moc3/.cmo3），可用于 Cubism Editor、VTube Studio、游戏等。
- 开源 Rust 运行时（p2lrt），可从 C/C++、.NET、Unity、Godot、Android 调用，或通过 WebAssembly 直接在浏览器中运行。
- 视频或图像序列、Spine/DragonBones/glTF（实验性）以及纯 PSD 快照。

适用对象

用户类型	PSD2Live 提供的功能
完全初学者	遵循 PSD 图层的命名约定，点击导入 → 预设，几分钟内即可获得一个可以闲置、眨眼、点头并具有头发物理效果的角色 – 准备好供 VTube Studio 或网页使用。
AI 辅助工作流爱好者	本地 MCP 服务提供超过 180 个命令，AI 代理（Claude、Codex 等）可以调用这些命令来读取或修改项目，并具有完整的撤销历史。
经验丰富的绑定师	自动生成网格、骨骼链、面部参数和物理效果，然后您可以手动编辑；所有编辑都存储为可重放的命令，因此重新生成不会丢失您的工作。
仅限开源的用户	编辑器和 Rust 运行时均采用 GPL-3.0 / MIT 许可，编辑或预览不依赖 Live2D 的专有 SDK。
需要超越 Cubism 的功能	内置 2D 布料与头发模拟、IK、自动骨架生成 – 导出时会烘焙到 Cubism 兼容文件中。
集成到您自己的应用	使用 `p2lrt` 运行时（C ABI、.NET、Android、WebAssembly、Godot 4 节点）直接加载导出的 `.p2lrt` 模型。

主要组件

模块	主要功能
自动生成	检测中文/英文/日文/韩文图层名称，创建自适应网格、头部-身体变形链、面部参数、默认动作、头发/布料物理效果。
画布编辑器	七种交互模式（选择、变形、编辑、模拟、骨骼、绘制、预览）。工具包括扭曲/旋转笔刷、网格拓扑编辑、图层分割/合并、粘合。
骨架与模拟	自动生成的骨架，具有 FK/IK、XPBD 布料与头发模拟，导出时全部烘焙到原生 Cubism 结构中。
动画与物理	时间轴、关键帧、曲线、可视化钟摆编辑器，评估与 Cubism Native Framework 相符。
纹理处理	纹理图集打包、每层密度、可选的 2×/4× 放大。
编译与导出	一个中立的 IR 被编译到每个目标；损失报告显示哪些内容必须烘焙或丢弃。
p2lrt 运行时	开源 Rust 引擎：C ABI、软件渲染器、WebAssembly 播放器、Godot 4 节点、.NET/Android 绑定。保证每个姿势的评估与编辑器一致。
代理（MCP）服务	本地 HTTP 服务（`http://127.0.0.1:23871/mcp`）提供丰富的 API，供代理查询工作区、列出操作并应用原子编辑。

与 Live2D Cubism 的兼容性

无依赖 – 编辑器无需 Cubism SDK 即可运行。
兼容性等级：
1. 无损 – Cubism 已支持的功能（网格、参数、物理、动作）。
2. 烘焙 – Cubism 缺少的功能（IK、布料模拟、摆动生成）会烘焙到关键形状或参数中。
3. 仅运行时 – 未来功能（动态光照、风格化渲染）仅开源运行时可使用。
导出的 .moc3/.cmo3 文件包含烘焙数据，因此生成的模型可在 Cubism Editor、VTube Studio 等中使用。

快速入门（快速步骤）

导入 PSD，通过 文件 → 导入 → 从 PSD（或拖放）。选择预设（最小 / 默认 / 完整），并可选择分割共享网格的图层。
检查表格中自动检测的图层类型，并修正任何错误。
预览生成的动作和物理效果；切换到其他工作区以微调网格、骨骼、动画或纹理。
保存项目为 .psd2live（捕获原始 PSD、设置和完整编辑历史）。
导出使用 Ctrl+G 导出至 Cubism（.moc3/.cmo3）或使用 文件 → 导出为 导出为其他格式（Web、Godot、视频等）。

平台与安装

Windows 10/11（x64 与 ARM64） – 便携式 ZIP 或安装程序，内含 Java 运行时和可选的 ffmpeg。
Linux（x86_64 与 arm64） – .deb 或 tar.gz，需要 X11/GLX（XWayland 可用）。目前没有 macOS 原生包 – 安装 JDK 21 后从源码运行。
运行时 – 如果存在最新的 Rust 工具链，则自动构建 Rust p2lrt 库；否则会下载预构建的二进制文件。

从源码构建

# 运行 GUI（Gradle wrapper）
./gradlew run
# CLI：直接从 PSD 生成模型
./gradlew run --args="--input examples/tml/psd-input/tml.psd --output build/example-output"
# 导出为其他格式，例如 GIF
./gradlew run --args="export model.psd2live --target gif --set clip=Nod"
# 测试与打包
./gradlew test
./gradlew packageDistributionForCurrentOS

需要 JDK 21；Rust 为可选，但构建原生运行时需要。

许可

应用程序与 Cubism 相关导出代码 – GPL-3.0。
中立 IR、编译框架和 Rust 运行时 – MIT，因此可以独立重用。

PSD2Live 是独立项目，与 Live2D Inc. 无关。

tsunehimatoi/psd2live