Gandi 终端

一个终端窗口，浮在编辑器上。它有两个用途：查看作品和扩展输出的日志，以及用命令查询 作品的状态。

打开方式#

顶栏抽屉里的「Gandi 终端」（顶栏放不下的入口都收在「全部功能」里，见 顶栏）。它默认以浮窗打开，600 × 380，位置偏右下：终端是一个控制台， 浮动时随时可见，不需要占用一整栏。也可以让它停靠，拖进任何一格即可；停靠过之后，下次点这个 入口它会回到停靠的位置。

窗口本身是 xterm，几百 KB，按需加载。编辑器空闲时会提前下载并缓存，真正打开时无需等待。

日志从哪儿来#

终端面板一旦挂载，就接管运行时的日志出口：log / info / warn / error / clear / setColor 这六个接口。通过这套接口输出的内容（扩展写的日志、Gandi 终端扩展的 那几块积木）都打到这里，按级别用不同颜色区分：警告是黄色，出错是红色，普通消息不变色。

有几点需要说明：

• 面板关闭后接管随即解除。 终端没有打开时，这些日志走浏览器控制台（F12），不会缓存在 某处等待查看。窗口里的历史也不保留，关闭再打开是一个新的终端。
• 普通的 console.log 不会进来。 编辑器没有改写 console，扩展直接用 console.log 输出的内容仍在浏览器控制台。进入终端的只有走运行时那套日志接口的内容。
• 出错不会自动弹出终端，需要手动打开。作品无法运行、脚本无法编译、扩展无法安装这几类 问题，编辑器在调试面板的日志页里报告，见调试 · 诊断与日志。

命令#

提示符是 >，输入后回车执行。help（或者 h）列出全部命令：

? 和 ?? 查询的是舞台上的全局变量（角色私有的变量不在其中）。变量前面的 [V] 表示 变量，[L] 表示列表。查看角色私有的变量、查看几 MB 的长字符串、或者持续观察一个变量的变化， 用调试面板的监视页，见调试 · 监视与渲染。

e <命令> 把命令作为参数发给一个帽子积木事件，接收它的那块积木由 Gandi 终端扩展提供； 作品里没有装那个扩展、或者没有用那块积木接收时，执行后不会有任何反应。

trace 只过滤显示，不影响产生：调成 error 之后 info 级别的日志照常产生，只是不写入窗口。

相关#

• 调试工作台 —— 性能录制、断点、按类别筛选的日志页
• 扩展 —— 安装 Gandi 终端扩展
• 面板与布局 —— 浮窗、停靠