参考：键盘快捷键与手势
本节列出 StitchKit 编辑器中实际定义的键盘快捷键和触控（平板）手势。快捷键要生效，编辑器画布（canvas）必须处于焦点状态：先在画布上单击一次，再按键。当您正在文本框或输入框（例如“添加文字”的文字输入框）中打字时，单字母快捷键会被特意禁用；也就是说，输入“s”时不会打开 3D 预览。
提示 — 应用内随时都能查看最新的快捷键卡片：在画布上单击后按 ? 键，或点击右下角的帮助（?）按钮，即可打开“快捷键”卡片。
Windows Ctrl 与 macOS Cmd 的区别
所有带修饰键（modifier）的快捷键，在 Windows 上使用 Ctrl，在 macOS 上使用 Cmd (⌘)；两者在代码中视为等效。“Shift”在两个平台上相同（macOS 上为 ⇧）。下方对照表列出了最常用的操作在两个平台上的按键。
| 操作 | Windows | macOS |
|---|---|---|
| 命令面板 / AI（“StitchPilot”） | Ctrl+K | ⌘K |
| 撤销（Undo） | Ctrl+Z | ⌘Z |
| 重做（Redo） | Ctrl+Shift+Z | ⌘⇧Z |
| 保存（快速） | Ctrl+S | ⌘S |
| 另存为（“Save As”） | Ctrl+Shift+S | ⌘⇧S |
| 自由绘制（“Pencil”） | Ctrl+P | ⌘P |
| 矩形绘制 | Ctrl+R | ⌘R |
| 椭圆绘制 | Ctrl+E | ⌘E |
| 文字 /“添加文字”面板 | Ctrl+T | ⌘T |
| “字母组合”面板 | Ctrl+M | ⌘M |
| 假缝框（“Basting”） | Ctrl+B | ⌘B |
| 默认值（“Defaults”） | Ctrl+, | ⌘, |
| Basic ↔ Advanced 模式 | Ctrl+Shift+A | ⌘⇧A |
| 快捷键卡片（“Shortcuts”） | Ctrl+/ | ⌘/ |
Windows — 所有带修饰键的快捷键都使用 Ctrl 键。例如撤销用 Ctrl+Z，打开命令面板用 Ctrl+K。
macOS — 相同的快捷键改用 Cmd (⌘)。有些与 macOS 系统自身快捷键冲突的按键（例如 ⌘H = 隐藏应用），编辑器特意保留给操作系统处理。
工具选择（无修饰键的按键）
以下按键单独使用（无需修饰键）即可生效。仅在焦点不在文本输入框内时有效。
| 按键 | 操作 |
|---|---|
| V | 选择工具（“Select”） |
| Space（空格） | 平移 / 抓手工具（“Hand”）——画布拖动模式 |
| R | 将选中内容旋转 90° |
| Shift+X | 水平镜像（“Mirror X”） |
| Shift+Y | 垂直镜像（“Mirror Y”） |
| Delete / Backspace | 删除选中的针迹 |
| Enter | 完成贝塞尔（“Digitize”）路径 |
| Esc | 打开的面板 / 活动工具 / 选择 → 关闭最上层 |
注意 — Space 键不是按住生效，而是单击一次即切换到抓手（平移）工具。要返回选择工具，请按 V。此外，无论当前选中哪个工具，鼠标中键（滚轮键）始终执行平移。
视图与叠加层按键（无修饰键）
| 按键 | 操作 |
|---|---|
| 0 | 适合窗口（“Fit to view”）——重置视图 |
| + / = | 放大 |
| - / _ | 缩小 |
| G | 显示/隐藏网格（“Grid”） |
| F | 显示/隐藏密度叠加层（“Density”） |
| H | 显示/隐藏绣框边框（“Hoop frame”） |
| Shift+H | 预览被隐藏/将被移除的针迹 |
| P | 显示/隐藏落针点（“Needle points”） |
| J | 显示/隐藏跳针（“Jump stitches”） |
| N | 显示/隐藏针迹编号（“Stitch numbers”） |
| X | 全屏十字准线（“Crosshair”） |
| S | 3D / 真实感预览（“3D Preview”） |
注意 — 有些按键的含义会随修饰键而改变。单独按 P 打开落针点；Ctrl/⌘+P 则打开自由绘制（pencil）工具。同样，单独按 R 是旋转，Ctrl/⌘+R 打开矩形工具；单独按 S 是 3D 预览，Ctrl/⌘+S 是保存。一些与文件相关的操作（例如导入 /“快速转换”）仅列在应用内的 Shortcuts 卡片中；要查看最新列表，请按 ? 打开该卡片。
平板 / 触控手势
StitchKit 画布支持触控和触控笔（stylus）输入。以下手势适用于平板和 iPad。
- Pinch（双指捏合/张开） — 放大 / 缩小。缩放以画布中心为基准，并限制在 %5–%800 范围内。
- 双指拖动 — 平移画布。在触控板上双指滑动也可用作缩放。
- 抓手工具（“Hand”）配合单指拖动 — 用 Space 或从工具栏选中抓手工具后，单指拖动即可平移。
- 用触控笔 / stylus 绘制 — 当某个绘制工具（Pencil、Rectangle、Ellipse、Digitize）处于激活状态时，用触控笔直接在画布上绘制。为了在快速移动时也不丢失笔迹，画布会在整个绘制过程中捕获指针（pointer）。
- 长按（long-press） — 可辅助上下文/对象选择；具体行为随当前工具而变，如果不确定，请使用工具栏中的选择工具（V）。
平板 — 您最常用的两个手势是 pinch = 缩放 和 双指 = 平移。用触控笔进行精确绘制前，请先确认已选中某个绘制工具；否则手指/触控笔的动作可能被识别为选择或平移。
提示 — 绘制时如果觉得落点位置不对，请先按 0（适合窗口）重置视图，再重新尝试。重置画布也会刷新坐标映射。