# 操作速查

[文档目录](../../README.md) · [English](../../en/guide/USER_GUIDE.md) · [日本語](../../ja/guide/USER_GUIDE.md)

先打开 **帮助 → 教程…**（`F1`）。交互教程会高亮控件、切换到相关面板，并按你当前的快捷键提示操作；本文是它的文字版，用于回看，不逐个讲解按钮。

## 最短流程

导入 PSD（`Ctrl+Shift+O`）→ 检查图层分类与预览 → 按需编辑 → 保存工程（`Ctrl+S`）→ 导出（`Ctrl+G`）。已有 `.psd2live` 用 `Ctrl+O` 打开。

已有 Cubism 模型可在 **文件 → CMO3 导入** 中选择：**替换导入** 按 ID 替换文件中的对象并加入新对象，保留文件中未出现的内容；**全新导入** 清空当前模型后导入，模型内容仅来自该 CMO3。两种方式均不自动生成预设，导入的参数、关键形、变形器、贴图和物理可随工程保存。

## 工作区

界面由顶部的工作区标签组成，每个标签有自己的画布与面板布局。点标签栏右侧的 **+** 新建工作区，可选七种预设或空白布局，右侧会预览布局与用途：

![新建工作区菜单](../../imgs/workspace-presets.webp)

| 预设 | 用途 |
| --- | --- |
| 编辑 | 一块编辑画布，处理变形器、关键形和骨骼，属性面板齐全 |
| 网格 | 层级树、编辑画布与网格面板，编辑网格拓扑 |
| 绑定 | 编辑画布与实时预览并排，参数面板常驻 |
| 动画 | 动作列表、预览画布与动画编辑器 |
| 预览 | 大尺寸预览，只保留动作列表 |
| 物理 | 预览画布加参数与物理面板，边牵动模型边调整 |
| 历史 | 只有历史树和它的操作列表，浏览与切换历史 |
| 空白 | 空的停靠区，从 **窗口** 菜单添加需要的画布和面板 |

**重置布局** 恢复当前工作区的预设布局。

## 按交互教程学习

教程目录共有 19 个主题：零基础路线包含下列 18 课；有 Cubism 经验的路线会先读一章术语对照，再跳过部分入门课。除「基础流程」外，各章在没有打开模型时会先要求导入 PSD 或打开工程。

| 课 | 主题 | 操作要点 |
| --- | --- | --- |
| 1 | 基础流程 | 导入分层 PSD，检查预览、图层预设和模型预设，再选择导出格式；贴图图集在导出窗口中设置。 |
| 2 | 工作区导览 | 编辑页改模型，预览页看效果，历史页切版本；每个画布标签页独立保存镜头和视图开关。 |
| 3 | 层级树与模式条 | 在树中选择、搜索或改父级；透明图片可拖入树中，放置确认后成为图层。绘制顺序决定遮挡，父级决定继承形变。 |
| 4 | 图层类型与差分 | 「预设」使用部件算法；「开关差分」用一个参数控制有无；「切换差分」用同一参数及不同关联 ID 实现多选一。 |
| 5 | 参数与关键形 | 拖滑块或 XY 控件检查姿态；右键参数键标记吸附。先确定目标参数值，再编辑关键形。 |
| 6 | 选择模式 | 选择对象，利用框选、套索和树画布联动定位；只选对象，不修改几何。 |
| 7 | 创建变形器 | 选目标 → 树右键添加父级或子级变形器 → 调整放置预览 → 确认。 |
| 8 | 变形模式 | 调整当前姿态的控制点、整体变换或形变笔刷；注意当前 L1 / L2 编辑层级。 |
| 9 | 编辑模式 | 修改网格拓扑，例如细分、连接、切割与删除；完成后复查参数姿态。 |
| 10 | 绘画模式 | 先选图层，再用画笔、橡皮、填充等修像素；会话内独立撤销，完成后应用或放弃。 |
| 11 | 检视面板 | 根据所选对象修改名称、归属、遮罩、绘制顺序、透明度与颜色等属性。 |
| 12 | 工具细节 | 调整当前工具的半径、硬度、强度、形状等；右键菜单也随模式和工具变化。 |
| 13 | 骨骼绑定与编辑 | 在骨骼模式中新建、挤出、复制、镜像骨骼，批量绑定画元，用 FK/IK 摆姿态，绘制与清理蒙皮权重并保存姿态；在面板配置参数采样容差与关键形上限。导出时烘焙为 Cubism 参数、变形器与关键形。 |
| 14 | 动画与动作编辑器 | 用各预设的调节项调整生成动作；在时间线上编辑参数轨道与关键帧，支持自动插帧、默认贝塞尔缓动、轨道关键帧标记与多画布姿态共享。 |
| 15 | 物理画布调试 | 设置输入、摆锤与输出，用范围和实测最大值校准输出倍率。 |
| 16 | 布料与头发模拟 | 在模型预设「物理与模拟」中生成头发与服装模拟（没有时先生成），了解头发三种模式与服装选项；再在模拟面板查看物理体，在模拟模式绘制并理解固定点、刚度、保形、质量、阻尼权重，设置胶水、材质预设与数值、输入输出和烘焙选项，烘焙为参数、关键形与 Cubism 摆锤；只有烘焙结果会导出。 |
| 17 | 工程与历史 | 保存 `.psd2live`，在紧凑历史树中搜索节点、高亮分支或双击快速检出；支持独立「历史」工作区预设。 |
| 18 | 贴图高清化 | 配置本地后端，选择 2× / 4×；检查边缘、半透明部件和导出结果。 |

## 容易混淆的概念

头发与服装模拟的分步截图见[模拟图文教程](SIMULATION_TUTORIAL.md)，包含固定点权重调整、烘焙和导出效果检查。

- **保存与导出**：保存保留工作区和历史；导出生成目标软件使用的模型文件。`.psd2live.json` 是报告，不是工程。
- **关键形与关键帧**：参数键上的关键形属于建模，键之间会插值出模型形状；关键帧位于动画时间线，记录某个时刻的参数值。
- **变形与编辑**：变形改变形状；编辑改变控制网格的结构。绘画修改像素，采用独立的应用 / 放弃会话。

### 前后分层：让一个图层穿过另一个部件

分步截图见[前后分层图文教程](DEPTH_SPLIT.md)：从选择衣领与脖子，到创建前后层、橡皮擦修边和检查效果。

例如领子只有一层，却需要形成「后领子 → 脖子 → 前领子」的遮挡：在层级树中右键领子，选择 **前后分层…**，将「穿插对象」设为脖子。弹窗按从前到后的顺序预览三层，点击 **创建并擦除** 即可。

程序保留原层作为后层，并复制出有独立贴图的前层；自动设置绘制顺序、复制网格与变形数据，再用胶水将每个对应顶点黏合，前层完全跟随原层。创建完成后会选中前层并进入绘画橡皮擦，擦掉其中的后领子部分，再点击 **应用**。该前层的绘画会自动保留原网格与变形，不弹出重新生成网格的选择。绘画笔画可独立撤销，整个分层操作也进入工程历史。当前支持从 PSD 或图片生成的模型。

也可以多选领子和一个或多个穿插对象，直接右键领子，选择 **将「领子」前后分层**。只复制右键点击的一个 ArtMesh，其余选中对象全部位于前后层之间，保持彼此的绘制顺序，直接生成并进入橡皮擦。右键已经选中的对象会保留多选。在画布的选择模式中，右键菜单也提供此操作，菜单名称明确显示当前要拆分的 ArtMesh。
- **显隐与差分**：树中的临时独显、图层静态显隐用于编辑检查；需要随参数切换时，设置差分或不透明度关键形。

## 常用快捷键

以下为默认（Photoshop 风格）键位。**设置**中可切换为 Blender 或 Cubism 风格预设，也可逐项自定义；**帮助 → 快捷键…** 显示当前绑定。

| 操作 | 默认键位 |
| --- | --- |
| 打开工程 / 导入 PSD | `Ctrl+O` / `Ctrl+Shift+O` |
| 保存 / 另存为 | `Ctrl+S` / `Ctrl+Shift+S` |
| 撤销 / 重做 | `Ctrl+Z` / `Ctrl+Shift+Z` 或 `Ctrl+Y` |
| 导出模型 / 导出 PSD | `Ctrl+G` / `Ctrl+Shift+E` |
| 重新分析 PSD | `Ctrl+R` |
| 纹理高清化 | `Ctrl+U` |
| 教程 | `F1` |
| 缩放 / 平移画布 | 滚轮 / 中键拖动或空格 + 左键 |
| 适配所选对象 / 重置镜头 | `F` / `Home` 或 `0` |
| 临时选择 / 快速预览切换 | 按住 `Z`，松开恢复 / 反引号键（Esc 下方） |
| 确认 / 取消当前操作 | `Enter` / `Esc`，具体以当前工具提示为准 |

## 检查与排错

| 现象 | 先检查 |
| --- | --- |
| 部件动作不对或没有动作 | [图层命名](../spec/PSD_LAYER_SPEC.md)与「图层」表格中的类型、侧别；遮罩与父级 |
| 静态姿态正常，运动时穿帮 | 在动画或物理面板中播放检查；单个静态姿态不能代表完整运动 |
| 面板不见了 | 「窗口」菜单中的面板开关，或右上角「重置布局」 |
| 画布上看不到模型 | 先适配画布（`F` / `Home`），再检查图层显隐 |
| 导出失败或提示降级 | 日志面板与导出报告 `.psd2live.json`，以及导出目标版本 |

提交问题时请附版本、操作系统、复现步骤及相关素材。

进一步阅读：[画布编辑](CANVAS_EDITOR.md) · [变形路径](DEFORM_PATHS.md) · [骨骼与姿态](SKELETON.md) · [物理](PHYSICS.md) · [高清化](TEXTURE_UPSCALE.md) · [SDK](CUBISM_SDK_SETUP.md) · [Agent / MCP](../agent/MCP_AUTHORING.md) · [构建与 CLI](DEVELOPMENT.md)。

Cubism 术语与流程对照参考 Live2D 官方的 [Cubism 基础教程](https://docs.live2d.com/zh-CHS/cubism-editor-tutorials/top/)、[参数](https://docs.live2d.com/zh-CHS/cubism-editor-manual/parameter/)、[融合变形](https://docs.live2d.com/zh-CHS/cubism-editor-manual/blend-shape/)与[嵌入数据导出](https://docs.live2d.com/zh-CHS/cubism-editor-manual/export-moc3-motion3-files/)。PSD2Live 的界面与制作辅助不等同于 Cubism Editor，具体操作仍以本程序内教程为准。

维护依据：[交互教程定义](../../../src/main/kotlin/io/github/psd2live/ui/tutorial/InteractiveTutorial.kt)、[中文教程文案](../../../src/main/resources/i18n/Messages_zh_CN.properties)、[快捷键注册表](../../../src/main/kotlin/io/github/psd2live/ui/state/ShortcutRegistry.kt)。