English · 日本語 · 下载 · 文档

从分层 PSD 自动生成 Live2D 模型，并在同一个桌面工作区里完成修形、绑定、动画、物理与导出。

PSD2Live 读取图层名称识别部件，自动生成网格、变形器层级、头身与五官参数、基础动作和物理。生成结果不是终点：你可以在画布上继续修形、切分网格、绘制贴图、搭建骨骼、编辑动作曲线，最后导出为 Cubism Editor 可继续编辑的 .cmo3，或可直接交付运行时的 .moc3 文件族。

_{上图为示例 PSD 导入后未经手工修改的自动生成结果，由头部与身体角度参数驱动。}

骨骼：自动推断骨架，拖动末端即可 IK 摆姿	物理：直接牵动摆锤，响应曲线实时更新

在 Releases 下载最新版本：

Linux 原生预览不支持无 XWayland 的纯 Wayland、aarch64 和 musl（如 Alpine），这些环境会自动回退到内置渲染。详见 Cubism Native 预览。

1. 导入 PSD：文件 → 导入 PSD…（Ctrl+Shift+O），或把 PSD 拖进窗口。导入后打开「开始」界面：用「最小 / 默认 / 完整」快捷选项设定模型预设（默认包含宽松服装模拟），并勾选含多个独立部件（如左右腿）、需要按网格拆分的图层。之后可从「工具 → 开始界面…」再次打开。
2. 核对识别结果：在「图层」表格中检查每层的部件类型、侧别与差分设置，识别错的直接改。
3. 预览与修改：切到「预览」工作区检查动作和物理，再按需在编辑、绑定、动画、物理工作区中修改。
4. 保存与导出：Ctrl+S 保存 .psd2live 工程；Ctrl+G 打开导出设置，输出 .cmo3 和 / 或 .moc3 文件族。

第一次使用，请打开「帮助 → 教程…」（F1）。 程序内教程会高亮对应控件并按你当前的快捷键提示操作，分为零基础（18 课）和 Cubism 经验者（13 课）两条路线。操作速查是它的文字版。

自动生成的质量主要取决于 PSD 分层。最重要的几条：

• 眼白、瞳孔、上睫毛分层，瞳孔保留被眼皮遮住的部分；
• 提供张嘴素材（或分出上牙、下牙、舌头）；
• 前发与后发分开，被遮挡的区域留出余量；
• 身体基本正立，图层效果与文字事先栅格化。

完整命名表与分层建议见 PSD 素材与命名。未识别的图层会保留，可在界面中手动指定类型。

导出目标可选 Cubism 3.0 – 5.0（默认 5.0），不支持的功能会按目标版本降级并在报告中提示。导出成功不等于在所有运行时中效果一致，正式交付前请在目标编辑器和运行环境中检查；支持范围见运行时与导出边界。

内置渲染无需任何官方 SDK；Cubism Native 预览是可选项，用于对照官方运行时的渲染与物理。

1. 保持 PSD2Live 运行，打开 工具 → MCP → MCP 连接与安装…。
2. 复制与你的宿主对应的配置。支持 Streamable HTTP 的宿主直接连接；只支持 Stdio 的宿主使用仓库根目录的 mcp_proxy.py。
3. 让 Agent 先调用 inspect 读取工程，再进行编辑。所有写操作进入同一份历史，可在界面中撤销。

接口说明与调用示例见 MCP 使用与接口。MCP 本身不生成图片，新增素材需要宿主具备图像生成能力。工具可调用不代表复杂建模任务已经可靠，能力实测记录了真实任务的成功与失败样本。

需要 JDK 21，Gradle 使用仓库自带的 Wrapper。

./gradlew run                      # 启动 GUI（Windows：.\gradlew.bat run 或 run-gui.bat）
./gradlew run --args="--input examples/tml/psd-input/tml.psd --output build/example-output"   # 命令行直接生成模型
./gradlew test                     # 运行测试
./gradlew packageDistributionForCurrentOS   # 打当前平台安装包

源码构建默认使用内置渲染，官方 Cubism SDK 需自行取得并单独构建桥接库。完整 CLI 参数、打包方式与原生预览构建见开发与命令行。

全部文档见文档目录，示例 PSD 与输出见 examples。

欢迎提交 Issue、可复现的 PSD、文档修正与代码改进。

• 报告问题：附上版本、操作系统、复现步骤、预期与实际效果，以及日志面板中的相关记录。
• 提交代码：先运行与改动相关的测试（./gradlew test）；新的编辑功能需要能随工程保存并在重开后重放，见开发与命令行。
• Agent 案例：请同时记录宿主、模型、返工次数与消耗，格式见能力实测。

代码以 GPL-3.0 发布，第三方组件见 THIRD_PARTY_NOTICES.md，示例素材的使用条件见各自说明。

PSD2Live 是独立项目，与 Live2D Inc. 无隶属或赞助关系。本仓库不包含、也不分发 Live2D Cubism SDK 的专有组件；Live2D 和 Cubism 是 Live2D Inc. 的商标。