监视、渲染、内存与舞台仪表

调试面板里有几页不用录制也能看，它们读的是当前的现场：变量现在是多少、画面上有多少 东西要画、内存占了多少、帧率有没有掉。

监视：变量和列表#

「监视」页列出当前角色能看到的所有变量和列表：它自己的，加上舞台的（会标「全局」）。 每 250 毫秒刷新一次，值一变就闪一下。

最上面是角色下拉、「跟随」和搜索框：

• 角色下拉选看谁的变量，舞台也在里面。
• 跟随勾上之后，在角色面板里选中谁，这里就切到谁；手动选过角色之后它会自动取消。
• 搜索框既过滤变量名，也过滤展开着的列表里的项。

每行两端各有按钮：

直接改#

变量的值是一个输入框，点进去修改，回车或者点别处生效，按 Esc 放弃。未编辑时它跟随作品 的实时值；进入编辑之后停止跟随，输入的内容不会被后台刷新覆盖。

看起来是数字的会存成数字（007 这种带前导零的当文本）。

超过 2000 字的值只能查看，不能修改：只显示前 160 个字加总字数（写成「1.2 万字」这样）。 作品里的变量常常存着几 MB 的存档码或者 base64 图片，整条放进输入框会让浏览器标签页崩溃， 所以这里直接截断。

列表#

点名字前面那个三角，或者点右边的「N 项」，把列表展开。展开之后是虚拟滚动，只绘制看得见的 那二十来行，几千上万项的列表也不卡。

底部写着一共多少项，右边可以「跳到第 N 项」。列表里的每一格也能直接改。

搜索框在列表展开时会过滤项，找不到会显示「N 项里没有含『xxx』的」。大列表最多找一万个 匹配。

渲染：画面为什么慢#

「渲染」页列出画面这一侧的压力来源：有多少东西要画、有没有超大的图、哪些角色在用特效。

顶上一行摘要：

下面可能出现两张提示卡：

• 有位图造型比舞台还大：按 100% 显示时占的面积超过舞台 1.5 倍的位图。每帧都要把整张图 缩小了画，图越大越慢。矢量造型不计入，它是按显示尺寸光栅化的。
• 正在用特效的角色：列出谁在用哪些特效。「颜色」「鱼眼」「漩涡」「像素化」「马赛克」 要走额外的着色器，数量多会变慢；「虚像」「亮度」开销很小。最多列 8 个。

最后是「最大的造型」表，按像素面积排，最多 12 行。「占舞台」那一列是这张图按 100% 显示时 相对舞台面积的倍数，位图超过 1.5 倍才标红。点一行选中那个角色。

这一页每秒刷新一次。

内存：用了多少、用在哪#

最上面是 JS 堆内存和它的走势曲线（最近 120 个采样，一秒一个）。这个数只有 Chrome 系的 浏览器提供，别的浏览器这一栏会写「这个浏览器不给看」，其余的数照常显示。

下面八个数：角色、克隆体、线程、积木、变量、列表项（和列表个数）、造型素材、声音素材。 积木数只统计原型角色，克隆体和原型共用一套积木。

三种情况会出现提示卡：

最后是「最大的列表」：项数 100 以上的前八个，带项数和字符数。字符数在列表超过五万项时是 抽样估算的。点一行会跳到「监视」页并把那张列表展开。

舞台仪表#

只想知道当前卡不卡、不打算打开整个面板时，用舞台角上那块小面板。

它显示实时帧率、每帧毫秒、当前线程数（暂停时写「已暂停」），加一条最近 120 帧的小柱图， 虚线是一帧的预算（跟着作品的帧率走）。帧率低于 24 或者每帧超过预算会变红。柱子按耗时上色：绿、 黄、红。

开关在「外观」页。设置记在浏览器里，关掉调试面板之后仪表仍然在，下次打开编辑器也在。 仪表开着时探针自动保持在「轻」档（只记帧和线程，开销可以忽略）；关掉时，如果面板不在 录制，探针随之关闭。

外观：工作区上的标记#

「恢复默认」把颜色和强度都还原（热度橙红、停下的积木黄、断点粉红、强度 1.0×，两个开关都 打开）。这些设置记在浏览器里，换作品也保留。

录制文件#

面板里没有单独的「文件」页。录制文件（.gtrace）的导出、导入和「记为基线」这三颗 按钮在「概览」页最下面，用法见调试工作台里的「保存与对比」。

细节#

• 「渲染」和「内存」这两页读的是渲染器和 VM 的内部数据。这两个包升级、字段改名时，这里会 最先失效：表现是那一页空着，不会报错，也不影响别的页。
• 「监视」页改变量是直接写进 VM 的，和在舞台上拖监视器滑杆是同一件事，会立刻影响正在运行 的脚本。
• 舞台仪表贴在舞台画面的左上角，会遮住那一小块，截图之前需要关掉。

相关#

• 调试工作台 —— 面板总览、性能录制、.gtrace 与基线
• 断点与单步 —— 「被改时停」和暂停现场里的变量表
• 诊断规则与日志 —— 「记录变化」写到哪里