PSD2Live
从分层 PSD 自动生成 Live2D 模型，并在同一个桌面工作区里完成修形、绑定、动画、物理与导出。
PSD2Live 读取图层名称识别部件，自动生成网格、变形器层级、头身与五官参数、基础动作和物理。生成结果不是终点：你可以在画布上继续修形、切分网格、绘制贴图、搭建骨骼、编辑动作曲线，最后导出为 Cubism Editor 可继续编辑的 .cmo3，或可直接交付运行时的 .moc3 文件族。
上图为示例 PSD 导入后未经手工修改的自动生成结果，由头部与身体角度参数驱动。
功能
| 领域 | 能力 |
|---|---|
| 自动生成 | 中 / 英 / 日图层名识别，成对部件自动拆分，自适应网格，头身变形器链，眼口开合、视线与眉毛参数，待机 / 眨眼 / 点头 / 摇头动作，前后发与果冻眼物理 |
| 画布编辑 | 选择 / 变形 / 编辑 / 绘画四种模式；形变笔刷、网格细分与切割、Warp / Rotation 创建、Glue、变形路径（实验性） |
| 骨骼 | 自动推断四肢、尾巴、翅膀骨架，FK / IK 摆姿；导出时烘焙为 Cubism 原生的变形器、参数与修正关键形，不依赖本程序运行 |
| 摇摆与物理 | 左右 / 上下摇摆自动生成及对应摆锤；可视化摆锤编辑、响应曲线、链式物理，求值与 Cubism Native Framework 对齐 |
| 素材与差分 | 导入透明图片并放置；开关差分与多选一差分；图层绘制与修边；可选 2× / 4× 纹理高清化 |
| 动画 | 时间轴、关键帧与曲线编辑，实时预览；骨架可用时追加下蹲、挥手、欢呼等预设动作 |
| 工程 | 单文件 .psd2live 工程，分支式历史，多标签页，编辑 / 网格 / 绑定 / 动画 / 预览 / 物理六种工作区预设，明暗主题，Photoshop / Blender / Cubism 快捷键预设 |
| Agent | 本地带认证的 MCP 服务，21 个公开工具，覆盖观察、形状、素材、参数、物理、导出与历史 |
 |  |
| 骨骼：自动推断骨架，拖动末端即可 IK 摆姿 | 物理：直接牵动摆锤，响应曲线实时更新 |
下载
在 Releases 下载最新版本：
| 平台 | 安装包 | 说明 |
|---|---|---|
| Windows 10 / 11 x64 | 便携版 ZIP、EXE、MSI | 自带 Java 运行时，解压或安装后直接运行 |
| Linux x86_64 | Deb | 自带运行时与 Cubism 原生预览，需要 X11 / GLX（XWayland 可用） |
| 其他 | 从源码运行 | 安装 JDK 21，见从源码构建 |
Linux 原生预览不支持无 XWayland 的纯 Wayland、aarch64 和 musl（如 Alpine），这些环境会自动回退到内置渲染。详见 Cubism Native 预览。
快速开始
- 导入 PSD：文件 → 导入 PSD…（
Ctrl+Shift+O），或把 PSD 拖进窗口。若检测到同一图层含多个独立部件（如左右腿），会提示按网格拆分。 - 核对识别结果：在「图层」表格中检查每层的部件类型、侧别与差分设置，识别错的直接改。
- 预览与修改：切到「预览」工作区检查动作和物理，再按需在编辑、绑定、动画、物理工作区中修改。
- 保存与导出：
Ctrl+S保存.psd2live工程；Ctrl+G打开导出设置，输出.cmo3和 / 或.moc3文件族。
第一次使用，请打开「帮助 → 教程…」（F1）。 程序内教程会高亮对应控件并按你当前的快捷键提示操作，分为零基础（17 课）和 Cubism 经验者（12 课）两条路线。操作速查是它的文字版。
准备素材
自动生成的质量主要取决于 PSD 分层。最重要的几条：
- 眼白、瞳孔、上睫毛分层，瞳孔保留被眼皮遮住的部分；
- 提供张嘴素材（或分出上牙、下牙、舌头）；
- 前发与后发分开，被遮挡的区域留出余量；
- 身体基本正立，图层效果与文字事先栅格化。
完整命名表与分层建议见 PSD 素材与命名。未识别的图层会保留，可在界面中手动指定类型。
输出文件
| 文件 | 用途 |
|---|---|
.psd2live | 本程序工程：原始 PSD、素材、设置、全部编辑与历史分支。继续工作请保存它 |
.cmo3 | Cubism Editor 模型工程，用于在官方编辑器中检查与精修 |
.model3.json + .moc3 + 纹理、物理、动作等 | 运行时模型文件族，需一起交付，从 .model3.json 加载 |
.psd2live.json | 导出诊断报告，不能代替工程 |
导出目标可选 Cubism 3.0 – 5.0（默认 5.0），不支持的功能会按目标版本降级并在报告中提示。导出成功不等于在所有运行时中效果一致，正式交付前请在目标编辑器和运行环境中检查；支持范围见运行时与导出边界。
内置渲染无需任何官方 SDK；Cubism Native 预览是可选项，用于对照官方运行时的渲染与物理。
连接 Agent（MCP）
- 保持 PSD2Live 运行，打开 工具 → MCP → MCP 连接与安装…。
- 复制与你的宿主对应的配置。支持 Streamable HTTP 的宿主直接连接；只支持 Stdio 的宿主使用仓库根目录的
mcp_proxy.py。 - 让 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 素材与命名 · 变形器与参数 |
| 骨骼与姿态 · 摇摆生成 · 物理 | 工程格式 · 运行时与导出边界 |
| 纹理高清化 · 变形路径 | MCP 使用与接口 · 开发与命令行 |
全部文档见文档目录，示例 PSD 与输出见 examples。
参与贡献
欢迎提交 Issue、可复现的 PSD、文档修正与代码改进。
- 报告问题：附上版本、操作系统、复现步骤、预期与实际效果，以及日志面板中的相关记录。
- 提交代码：先运行与改动相关的测试（
./gradlew test）；新的编辑功能需要能随工程保存并在重开后重放，见开发与命令行。 - Agent 案例：请同时记录宿主、模型、返工次数与消耗，格式见能力实测。
许可
代码以 GPL-3.0 发布，第三方组件见 THIRD_PARTY_NOTICES.md，示例素材的使用条件见各自说明。
PSD2Live 是独立项目，与 Live2D Inc. 无隶属或赞助关系。本仓库不包含、也不分发 Live2D Cubism SDK 的专有组件；Live2D 和 Cubism 是 Live2D Inc. 的商标。