Gandi 3.0文档
官网 打开编辑器
功能文档

Gandi 3.0
每个功能怎么用

一个功能一篇，讲它是什么、在哪儿、怎么用，配真机截图。

文档里的每句话都来自源码，或者在编辑器里实际操作过。功能做了一半、与别处说法不符、或者暂时不可用的地方，文档里如实写出。每次上线改了什么，见 更新日志。

73 篇文档 · 16 个分组 · 全部配真机截图 · 更新日志

最近更新2026-10-01

全部更新日志 →

界面外壳8

面板与布局面板即窗口：停靠、分栏、浮窗贴边、标签页、最小化还原、布局存取与切换 顶栏左区文件菜单、作品名、场景切换胶囊、作品体积读数，以及右区的几颗按钮 顶栏面板开关中间的图标行、分组、拖动自定义顺序、放不下时的抽屉 平板上使用触屏操作对照：顶栏收起方式、长按菜单、双指缩放、拖动命中区、首次打开的布局 通知与对话框编辑器的反馈方式：通知、加载遮罩、崩溃兜底、右键菜单、命名与确认对话框、触屏行为 多人协作几个人同时编辑一个作品：什么会同步、看到别人、只撤自己、权限组、掉线（仅本地测试） 协作评论在协作里把评论钉在积木、造型、声音上，回复、@ 成员、标为已解决 反馈与建议提交问题、上传图片视频、留下联系方式，以及查看公开处理进度

设置与外观6

设置七页设置逐项说明：舞台比例与尺寸、语言、主题、积木栏位置、编译模式等 AI 服务商连接配置、模型与上下文长度、模型列表获取、Gandi2 配置导入导出与密钥边界 CLI 与本机 MCPAgent 读写打开的作品：CLI 启停、网站一次授权、连接状态与兼容 MCP 多语言界面、积木、扩展跟着语言走；缺翻译退回中文；怎么加一门语言 快捷键整张可改的键位表：布局、搜索、积木工作区、造型编辑器工具键；录制与冲突规则；不可修改的几条 主题11 套预设、主题工作室（配色 / 圆角 / 字体 / 背景图 / 音效 / 积木配色）、浮窗透明与毛玻璃

积木工作区8

积木栏独立面板 / 内置两种模式、可折叠分组、网格模式、搜索与拼音、宽积木横向滚动查看 积木页一个角色可以有多页脚本：新建、改名、切换、拖给别的角色 多编辑目标同页开多个工作区、各自跟着哪个角色哪一页、跨工作区拖积木与同步 代码小地图角上的脚本缩略总览，点击或拖动可定位；默认关，位置和大小可调 代码框把若干脚本圈起来命名、整体搬动、折叠收起；折叠会把积木从工作区卸下 工作区里的其它几件事大脚本装载反馈、积木片段存进资源库、把脚本复制给别的角色、缩放与平移 颜色选择器积木上的彩色圆点：十六进制、HSV 滑杆、色板与最近使用、从舞台吸管取色 补全的积木原版缺的基础积木：拉伸、图层、造型信息、饱和度与明度、声音暂停、跳出循环、右键、三元等

更快地写积木3

快捷添加积木工作区按中键，输入一句话生成一整串积木；拼音、简称、判断嵌套、候选与拖出 全局搜索Ctrl + F 跨角色跨场景找积木，拼音匹配、真积木渲染、一键跳转 查找替换Ctrl + H 成批替换积木上填的值、或者整块积木换整块积木，先列出再修改、跨角色、一步撤销

自制积木与数据4

自制积木新建对话框、参数类型、C 型积木、拖把手排序、颜色、积木栏分类、悬停说明、编辑定义后调用块保值 全局自制积木只有模块能定义、改定义同步到全作品、跳到定义、删除拦截，以及两处无法撤销的操作 可扩展参数积木上的 ➕➖：哪些积木有、展开后的形态、扩展作者怎么用 变量与列表新建时选作用域、改名、删除、云变量的实际支持情况、多场景下值的归属

注释与运行反馈2

注释工作区注释与积木注释、Markdown 存档、把积木片段拖进注释里保存 哪一段脚本正在跑运行中的脚本亮一圈黄边：何时亮起、为什么只亮当前角色的

角色与场景3

角色栏角色卡与文件夹、拖放分组、场景归属（跨场景角色、角标、右键菜单） 多场景一个作品分成多个场景，三档状态、角色归属、切换时面板怎么处理 场景积木切场景、跨场景广播、按需装入卸载、场景参数这几组积木

素材管理2

资源库作品级素材：树 / 网格 / 详情、条目与 md5 的关系、拖放取用 素材库从库里选造型、背景、声音、角色

造型编辑器2

造型编辑器无限画布的矢量 + 位图编辑器：工具、图层、变形、布尔运算、颜色、位图模式、导入导出 造型条与动画帧就是造型：加帧、播放、洋葱皮、补间、导出 WebM

声音与音乐5

声音编辑器波形编辑：录音、选区、剪切复制、八种效果、音量包络、频谱、渲染音频 编曲台多轨、片段、循环区、自动化包络：完成一段乐曲的编排 钢琴卷帘画音符、量化、音阶、描图纸、演奏曲线 混音台音量、声像、静音独奏、每轨效果链 乐器与音源乐器库、音色库按需下载、和弦与键盘面板，以及两处暂时用不了的入口

舞台与运行5

舞台绿旗与控制条、提问框、全屏、舞台尺寸与三种缩放模式 舞台上的监视器显示变量与列表、三种样式、滑杆、拖动与位置、右键菜单 运行时的保护与开关失控的「不刷新屏幕」循环不再卡死编辑器；编译模式开关 补帧帧之间补出中间位置：三档、按角色与文件夹配置、五块积木、容差 帧间隔「每秒 ()」让速度与帧率无关：帧间隔、实际帧率、0.1 秒上限

作品、文件与终端5

打开与保存作品打开 sb3、保存、新建、作品名，以及和 Gandi 2.0 作品的兼容 回收站删掉的角色、造型、声音先放这儿，能原样捡回来 还原点整个作品在某一刻的样子，一步回到那一刻；定时存、AI 改动前也存 代码文件JavaScript / Python / JSON / GLSL 文件，Monaco 编辑器，跟着作品存进 sb3 终端xterm，接管运行时日志的六个接口

调试工作台5

调试工作台打开方式、11 个页签总览、两个档位、性能录制怎么读 断点与单步下断点、命中现场、单步三种语义、条件与日志点、变量 / 广播 / 克隆断点 监视与仪表监视改值、渲染、内存、舞台仪表、外观 诊断规则与日志13 条规则各自什么时候报、怎么读结论卡片、日志页七类来源 问题编辑期静态检查：10 条规则、按角色分组、跳转到积木

扩展7

扩展安装方式、扩展库那一页、装上之后积木栏的变化、缺扩展的作品会怎样 给扩展的宿主接口Scratch.gandi 有哪些方法、积木的 compile 字段怎么写、示例扩展演示了什么 引擎物体、角色栏里的分节、装配编辑器、舞台叠加层与舞台编辑、场景设置 光照灯、材质、碰撞体软阴影、画面风格、泛光与调色；光照积木 粒子粒子编辑器：发射器、预览与时间轴、各模块参数、曲线与颜色；资源库里的粒子 物理刚体、碰撞体设置、物理世界、关节、液体与软体；物理积木 给扩展的引擎接口扩展怎么把分节、工具、叠加层、面板长进编辑器；三档写法

插件与平台面板6

插件内置与外部两种插件、在设置里开关、插件能改什么 选择特定积木三种手势：拉框、拖单块、点选加减 下拉可搜索给积木上的下拉菜单加一个搜索框 查找自制积木的定义从调用块跳到它的定义 积木输入框增强改积木参数输入框的行为 成就、排行榜、数据管理、云背包从 2.0 搬过来的四个面板，各自当前的完成度

性能（技术向）2

编辑器性能几万块积木的工作区如何保持流畅、47 MB 作品 5 秒打开、仍然慢的地方 运行时性能一万个克隆体、编译器与渲染器做了什么、可以关掉的开关