Gridvana 使用指南

启动 Gridvana 后使用 ⌘N（或菜单「创建画布」）新建项目，画布宽高可在 1 到 4096 之间自由设置；点击「创建画布」后即可在网格上直接绘制。

应用会自动保存进度：异常退出后，下次启动会提示恢复未保存的项目（也可手动丢弃）。项目以 .gvn 格式保存，包含 RGBA 像素数据与完整的图层/帧结构。

• 选择（按住空格临时切换为平移画布）
• 魔棒选择：按连通区域选取像素
• 按颜色选择：选中画布中同色的像素
• 画笔、橡皮擦、油漆桶、拾色器
• 形状工具：矩形 / 空心矩形 / 圆形 / 空心圆 / 线条

颜色面板同时提供前景色与背景色（可一键交换），并记录「使用过的颜色」与绘制历史，方便连续取用。

支持绘画、背景、参考和组四种图层类型。图层可设置父组、可见性、锁定、不透明度，以及 Normal、Multiply、Screen、Overlay 混合模式；组图层用于组织内容，本身不包含 Cel。

时间轴中的 Cel 可多选、拖动、复制、粘贴、删除、链接和取消链接；链接适合在多个帧位共享内容。洋葱皮可限制到活动图层，Sprite Sheet 可导出可见图层、全部图层或活动图层。

时间轴可新增、复制、删除和拖动帧，并为每帧设置毫秒时长。使用「+ 标签」命名帧段；标签支持正向、反向与 Ping-Pong 播放，也可拖动调整范围。

洋葱皮可分别设置前后帧数量、整体不透明度、前帧 / 后帧着色，并限制到活动图层。实时预览面板可以显示、隐藏和拖动。

• 框选、魔棒与按颜色选择都支持组合：Shift 添加、Option 减去、Shift+Option 取交集
• 拖动选区本体进行移动；使用画布上的角点缩放，旋转手柄按 90° 步进旋转
• ⌘X / ⌘C / ⌘V / ⌘D：剪切、复制、浮动粘贴、创建副本
• ⇧H / ⇧V / ⇧R / ⇧L：水平翻转、垂直翻转、顺时针 / 逆时针旋转
• ⌘A 全选、⌘⇧I 反选；Delete 删除选中像素；方向键逐像素移动

粘贴内容在取消选择前保持浮动，移动或变换不会破坏下面的像素。方形网格的画布菜单还提供「裁到选区」「裁去透明边」与「画布尺寸…」。

• PNG 序列：每帧一张 PNG；单帧项目直接生成一张 PNG
• 动画 GIF：保留每帧时长；活动标签决定导出范围与播放顺序
• Sprite Sheet + JSON：选择全部帧或活动标签，以及可见、全部或活动图层
• Sprite Sheet 高级选项：横向 / 纵向 / 固定行列、1×–16× 倍率、透明边裁切、空帧策略、Extrude 与 Array / Hash JSON

导出面板会预估 Sprite Sheet 尺寸并显示帧缩略图；最终同时写出 PNG 图集和包含帧矩形、时长及标签的 JSON。参考图层不会进入普通 PNG 与 GIF 导出。

在「设置 → AI Agent」中启用面板，选择 Codex 或 Claude，并配置可执行命令及可选的 profile、模型或推理强度，即可在应用内启动交互式终端。是否跳过 Agent 权限询问由「默认允许」控制。

嵌入式 MCP 服务随 Gridvana 启动，只监听本机回环地址。Agent 可读取项目摘要、当前选区、活动帧 PNG 与编辑操作 schema；写入流程为开始会话、预览、应用、提交或回滚。一次只允许一个写会话，若会话外发生项目修改，后续写入会返回版本冲突。

预览与应用只修改会话工作副本，提交后才替换当前项目并进入共享撤销历史。MCP 工具的用户授权由 Codex 或 Claude 在各自终端中处理。

常用快捷键如下；若与系统快捷键冲突，可在 macOS「系统设置 → 键盘」中调整。

项目文件为 .gvn 格式（schema V6），保存 RGBA 像素与图层、帧、标签等完整结构；支持自动保存与崩溃恢复。

应用每 30 秒写入恢复文件；异常退出后，下次启动可选择恢复或丢弃。设置面板提供语言与地区、AI Agent 与 MCP 服务配置，状态栏显示项目保存与 MCP 状态。