Keel v0.5.1 English GitHub

测试

界面测试大部分不需要开窗口:ui/internal/uitest 测试工具通过 Gio 真实的输入路由送入点击、按键、文字,组件走的代码和真实窗口完全一样。go test -race ./... 在本机跑完大约 10 秒。

Linux 缩放与窗口尺寸(本地,2026-11-10)

本机 Linux amd64 / Hyprland 的显示器为 3840×2160、显示缩放 125%, GNOME 字体缩放为 1.6364。原生协议日志确认 preferred_scale 为 150, viewport 目标使用逻辑坐标,1600×1000 窗口对应 2000×1250 缓冲区。 提交显式 xdg 几何前,同一测试窗口可能以最小尺寸 560×460 打开。 程序 resize 还暴露了帧合并丢失 surface 刷新标记的问题,现有回归测试 保证该标记不会被后续动画帧覆盖。

原生 scaling 场景执行 20 次 resize 并严格核对实际尺寸、检查滚动位置、 保存尺寸及重新打开。本机 EGL 和 Vulkan(noopengl)均通过,已有真实 窗口生命周期测试也通过。单测覆盖 100/125/150/200% 显示密度、独立字体 缩放、半像素舍入、整数回退、无边框标题栏高度与状态文件往返。专项 race 和 vet 通过;Linux amd64/arm64、Windows 无 cgo 构建通过。已检查原生 Workspace 截图。

完整测试仍有已有的 fontscan、输入文字对齐、hover/status 布局和 EGL 像素测试失败。旧 giocgo 构建因本机缺少 Vulkan 开发头文件而无法验证;禁用 Vulkan 后, 又遇到旧 cgo listener 指针类型的编译错误。 本机验证命令使用 -gcflags=all=-goversion=go1.27.3 绕过工具链版本标识不一致。

这是尚未发布的本地改动。合成器报告分数比例前,首帧可能使用整数输出比例; AutoSize 可能在映射后调整一次。平铺/窗口管理器策略可以覆盖尺寸请求。 其他分数比例、跨显示器切换和真实输入法候选框定位只有单测或代码层面的 覆盖,尚未在本机完成相应原生验收。不声称提升端到端帧率或内存表现。

Linux 默认绑定选择(本地,2026-11-10)

Linux 桌面现在无需标签即可选择 purego,开启 CGO 时也一样。 TestLinuxDefaultBindings 检查 amd64/arm64 的源码选择、giocgo 回退, 以及 purego / 禁用 CGO 的优先级。CI 在无 cgo 运行时任务中增加了 开启 CGO 的源码选择检查。

本机 Linux amd64 的全模块构建、vet、绑定专项测试、真实窗口生命周期测试、 Linux/Windows 无 cgo 构建及带 purego、nox11、nowayland、novulkan 的 hello 构建通过。本机 Go 工具链版本字符串不一致,验证编译使用了 -gcflags=all=-goversion=go1.27.3;这不是 Keel 所需的构建选项。 完整测试未通过:fontscan、输入文字对齐、hover/status 布局和 EGL 像素测试失败。 显式指定 purego 也能复现 EGL 失败。这是尚未发布的源码选择改动, 不代表已验证不同 Linux 硬件上的 GPU / 输入法一致性。

动画集成,2026-11-06(工作分支)

动画改动尚未包含在 v0.4.2 中。真实窗口检查已覆盖位姿、布局尺寸变化、完整塑形簇 的文字重排和数字滚动,并从 640×400dp 缩放到 720×460dp,像素倍率为 2×。每段动画 持续 600ms,观察 1.2 秒。同一个程序、同一内容交替运行三轮:开启保留绘制,以及 使用 -full 每帧重建视图。

每段提交 37–38 次布局回调;保留绘制每段只执行 1 次 Render,完整重建则为 37–38 次。六次运行在静止三秒内均为 0 次额外布局回调。这验证了绘制复用和静止 调度,不代表屏幕实际呈现帧率,也不能据此声称进程 CPU 为零;延迟内存回收仍可能 在不绘制的情况下运行。

小型真实窗口,MiB 完整重建中位数(范围) 保留绘制中位数(范围)
最后两秒采样的物理内存 46.09(45.16–46.39) 45.49(45.44–46.31)
内核记录的进程生命周期峰值 108.50(108.38–112.52) 108.14(107.92–112.30)

两组范围重叠,未证明总内存有明显下降。主机为 Apple M4、darwin/arm64、 Go 1.27.3、CGO_ENABLED=0,使用相同的去符号、trimpath 构建,通过 proc_pid_rusage v4 约每 50ms 采样。屏幕保持解锁,测试串行进行,期间没有并行 构建或测试。不强制 GC,保留默认空闲回收。三秒静止观察短于完整组件库的二十秒 恢复阶段。

测试入口为 ui/window/testdata/pose,原始采样和阶段日志位于 work/motion-integration/motion-{full,retained}-*.{log,json}。文字测试还通过真实 无窗口 GPU 比较起点、中途打断、保留/完整绘制以及静止后的像素,覆盖中文、组合音标、 颜色范围和 emoji,并验证空字符串完成退场、离屏及省略声明后释放旧字形。这些检查 不能替代真实窗口的滚动、拖拽和进退场交互,也不能替代共享元素加入后的最终验证。

共享元素与真实窗口交互

后续共享布局版本给原生窗口测试增加了缩略图展开、返回两段动画,各为 600ms 补间,观察 1.2 秒。六段动画的 TestRealWindows/./testdata/pose 已通过, 覆盖保留绘制、窗口缩放和静止三秒检查(native-shared.log)。这是动画验证, 不更新前面的内存测量结果。

Components 中通过真实鼠标操作验证了变换后卡片的点击、横向拖拽吸附至 240dp 再返回 0dp、滚动、数字与文字变化、图标图片替换、缩略图展开返回、列表替换重排、 宽度变化,以及对话框关闭、重开和 Esc。快速松手曾让弹簧过度越界;现已在直接 拖拽相同的弹性边界处吸收向外速度,极高速度回归测试和真实鼠标复测均通过。 这些观察不等同于屏幕实际呈现帧率。

共享布局测试覆盖跨父容器中断、旋转短路径、弹簧速度连续、目标容器裁剪、 点击与锚定几何、窗口缩放、像素密度、减少动态效果和状态回收。保留绘制与完整 绘制的像素逐字节一致;缩放前后等价圆角路径的衔接和中断对照,允许边缘量化 造成的单通道最多 2 级差异。

后续 Fly 版本通过了七段原生动画测试,新增祖先处于 Inert 状态时子元素 继续飞行的场景(native-fly-final.log)。更新后的 Components 通过真实鼠标 验证了图片飞出滚动容器并点击返回。像素与输入测试覆盖越过祖先裁剪和透明度、 保留自身透明度与局部主题、锚定浮层跟随,以及后续模态浮层仍位于飞行元素上方。 飞出对话框矩形的子元素仍可点击,不会误关对话框;真正的外部点击仍会关闭。 Inert 飞行继续移动和淡出,但不接受输入,也不暴露到自动化和平台辅助功能。

相同 Components 场景对照

在解锁的真实窗口中,交替运行三轮 v0.4.2(d4d26d0)与动画集成检查点。两者显示 相同组件库,当前版仅在这次对照中移除了新增 Motion 演示注册项,以保持内容一致。 窗口为 1200×860dp / 2400×1720 像素,依次运行首页默认动画、600 次确认完成的滚动 更新、20 次缩放、八次页面访问、20 秒静止和恢复滚动。六次滚动阶段均完成 601 次 布局回调,构建和采样条件与上文相同,全部串行执行。

MiB v0.4.2 中位数(范围) 动画检查点中位数(范围)
启动采样峰值 151.88 (151.77–152.41) 151.97 (136.02–152.11)
首页动画采样峰值 152.50 (152.35–152.66) 152.24 (136.53–152.28)
连续滚动采样峰值 161.44 (161.33–161.60) 161.50 (161.16–161.95)
缩放采样峰值 172.99 (172.06–180.02) 172.42 (172.03–179.94)
页面切换采样峰值 174.13 (173.80–175.75) 173.86 (173.67–174.22)
空闲物理内存 68.14 (68.11–68.74) 67.99 (67.97–72.51)
内核生命周期峰值 184.35 (180.75–184.41) 184.39 (184.35–184.61)

总内存没有明显下降。 当前版第三轮在静止阶段有八次布局回调,其他五轮均为一次, 最终空闲读数也更高;该轮仍保留在结果中。额外诊断重跑只有一次不含待处理输入的 静止回调,空闲物理内存为 67.67 MiB,未复现也未解释前一轮异常。不能据此认定已 修复泄漏,也不能剔除异常样本。

整个流程中最大的布局回调,基线为 15.78–19.39ms,当前检查点为 19.84–20.56ms; 启动阶段最大值分别为 15.49–16.67ms、15.32–20.16ms,恢复滚动至布局完成分别为 13.92–14.45ms、14.73–16.30ms。这些 CPU 时间不代表首帧实际呈现延迟或屏幕帧率。 页面切换最大值偏高和单次空闲活动仍需检查。

相同场景的去符号可执行文件为 20,153,666 与 20,325,282 字节,增加 171,616 字节 (0.85%)。这排除了新增演示,不是打包后应用的体积。上述原生窗口、内存和体积采样 早于后续文字退出时钟修正,剩余能力完成后仍须最终复测。源码哈希和原始数据位于 work/motion-integration/。首次基线构建的覆盖路径使用 /tmp,而 Go 解析为 /private/tmp,导致运行了普通入口;该次已在 excluded-overlay-path/ 中明确 作废。修正后的构建验证了测试入口与提交号。

后续外观与文字检查补上基础颜色、圆角、边框宽度和透明度插值,以及跨父容器的 Text 衔接。GPU 测试覆盖不同宽高比、字号变化、中途反向、保留帧与完整绘制一致、 结束后的像素一致,并发现和修正了倒数缩放矩阵引起的坐标精度损失。七段真实窗口 测试已包含这些属性和 Inert 状态的共享文字,运行通过(native-shared-look.log)。 重新构建的 Components 实际窗口中,圆角图片与标题一同展开,点击已移动的标题后 一起返回。这些是动画验证结果,没有更新前面的内存测量。

最终集成检查在 darwin/arm64、Go 1.27.3 下通过:全量默认测试、无 cgo 全量测试、 全量竞态检查、go vet、Windows 无 cgo 交叉构建和 Linux native/CLI vet。 组件流程通过 800 张矩阵图片、100 个无头场景和九组交互检查。日志位于 work/motion-integration/final-*.log 和 component-final/summary.json。 这些检查不代表已验证 Windows 或 Linux 的原生窗口运行。

渐变、自动文字匹配与滚动绑定,2026-11-07

工作分支已支持共享元素的渐变和 Elevation 阴影插值、通过 MatchText 按相对路径 匹配后代 Text,以及通过 ScrollBinding 将时间线绑定到滚动容器。检查的 MyGo 实现已有显式文字标识和手动滚动采样;后两项是 Keel 的便捷接口,不能据此声称 MyGo 原有能力此前缺失。

GPU 测试覆盖渐变和阴影衔接、中途反向、保留帧与完整绘制一致。缩放渐变测试发现了 Gio 未正确应用绘制变换的问题,已改为使用逆绘制变换采样,并增加 Gio 仿射变换与 无窗口像素测试。文字测试覆盖嵌套父容器、缓存子元素、独立作用域和回收;横向与 纵向滚动测试验证内容范围变化、指定区间以及静止后不再重复请求帧。

Go 1.27.3 下,全量默认和无 cgo 测试、竞态检查、vet、Windows 无 cgo 构建及 Linux native/CLI vet 均通过。更新后的七段真实窗口测试通过,覆盖缩放、Inert 文字容器和 静止三秒。证据位于 work/motion-integration/followup-*.log。组件复测通过 800 张 矩阵图片、100 个无头场景和九组交互检查(component-followup/summary.json)。 两份演示动图由 Keel 实际 GPU 渲染并控制时钟生成,不是桌面录屏或帧率证据。改动尚未发布;按中间尺寸 重新排版文字、任意多重或内阴影仍不在本次实现范围内,不能称为完整对齐 MyGo。 本次检查没有更新前面的内存测量。

Components 内嵌字体内存,2026-11-06(本地)

三组交替运行的真实窗口对比中,完整组件库交互后的空闲物理内存中位数从 75.55 降到 67.27 MiB(−11.0%)。本次基线已包含下文的文字缓存和字体回收 改动,新增修改尚未发布。这不能证明动画和滚动期间的总内存也有普遍下降。

输入框内嵌标签使用的临时字体此前没有提供原生字体数据和名称表,导致整个 编辑器退回 Go 排版,额外加载系统字体索引和字体表,而普通文字已经使用 CoreText。本次补充不可变的 SFNT 数据、Unicode 名称记录和不含字形名称的 post 表。PostScript 名称由字体度量和字符映射生成,确保不同编辑器中宽度 不同的标签保留独立字体身份。字体只属于各自的排版器,不向系统全局注册。 其他平台以及原生排版不可用时,仍可使用 Go 排版。

测试主机为 Apple M4、darwin/arm64、Go 1.27.3,使用 CGO_ENABLED=0 和相同的 去符号构建,屏幕解锁,窗口保持前台。每次打开完整 Components,窗口为 1200×860dp / 2400×1720 像素,保留默认 Button 页的动画;随后执行 600 次等待 布局确认的 VirtualList 滚动,在 1040×760dp 与 1200×860dp 之间缩放 20 次, 依次访问 Input、Table、TextView、Button、Table、Input、TextView、VirtualList, 空闲 20 秒后恢复滚动。基线滚动阶段记录 601–602 次布局回调,新版为 601 次。串行测量期间不 运行编译、测试或分析器,夹具不强制 GC,框架默认空闲回收保持开启。 proc_pid_rusage v4 提供物理内存和内核记录的进程峰值,名义采样间隔为 50ms, 空闲值取恢复操作前最后三秒的均值。

指标,MiB 修改前中位数(范围) 修改后中位数(范围)
空闲物理内存 75.55(73.89–75.94) 67.27(66.97–68.08)
内核记录的进程峰值 187.95(187.08–189.77) 184.63(179.89–184.64)
启动阶段采样峰值 135.35(135.17–135.85) 152.05(135.45–152.35)
首页动画采样峰值 136.17(136.17–136.80) 152.11(136.28–152.70)
滚动采样峰值 161.25(161.03–161.45) 161.69(161.33–161.75)
缩放采样峰值 172.63(163.70–180.03) 171.97(171.86–184.61)
页面切换采样峰值 182.56(181.69–184.38) 174.17(173.89–175.03)

本组测试复现了 8.28 MiB 的空闲下降。进程峰值中位数仅降 1.8%;滚动没有变化, 缩放范围重叠。启动和首页动画范围也重叠,而且进入 Input 前尚未执行修改路径, 不能把这两项中位数的差异算作本次收益。独立诊断观察到 drawable 数量造成的 约 16 MiB 台阶变化,仍有未解释的驱动内存。未获得可复现收益的窗口层试验已舍弃。

页面切换时最长布局回调由 34.79–54.64ms 降到 16.07–22.05ms;启动最长布局 分别为 16.32–20.07ms 和 15.56–16.62ms,恢复请求到布局完成分别为 13.76–15.83ms 和 11.45–14.63ms。这些是 CPU/布局耗时,不是画面呈现延迟或 端到端帧率;原生字体首次初始化仍有首帧延迟成本。 新增回归覆盖原生字体身份、基本区和增补区私用字符、1×/2× 宽度、换行及光标选择, 现有输入测试覆盖中文组合输入、撤销和保留引用原文。串行采样原始数据与本地 场景 overlay 位于 work/components-total/。

验收通过默认构建的全量测试与 vet、无 cgo 全量测试、Windows 无 cgo 全量构建、 Linux native/cmd vet,以及 99 个页面和九组真实窗口交互检查。首次全量 race 运行遇到已有图标分配次数断言失败;该项单独连续五次通过,随后全量 race 重跑 通过,未放宽断言。另在 Go 1.27.3 下复测 editorstyle、el、components 通过。 中英文输入页截图已人工核对,未宣称原生与 Go 排版逐像素相同。

早期试验误将 Go 1.27.3 基线与默认 Go 1.27.1 新版比较,已排除,不计入上述 结果。最终三组 matched-* 试验均为 Go 1.27.3;脚本启动前校验构建信息并保存 每次记录。原始数据及汇总为 work/components-total/matched-summary.json。

文字缓存与原生字体回收,2026-11-06(本地)

保留的改动降低了长文本场景的总物理内存:三轮交替实测,空闲从 105.96 降到 68.14 MiB,下降 35.7%;进程生命周期峰值从 193.60 降到 151.31 MiB,下降 21.8%。普通 Components 列表没有改善。这些是尚未发布的工作区修改,不能归入 已有版本的性能结果。

段落排版缓存新增估算字节预算:常规为 8 MiB,最近八个显式 shaper 帧使用的 排版最多保留 64 MiB,同时维持原有 1,000 条上限。Shaper.BeginFrame 保护 较大的可见工作集,避免每帧重复淘汰;未调用时使用常规预算。缓存的段落键复制 自己的字符串,避免短子串保留整篇输入文档。这参考了 MyGo 的字节预算方式, 换行和字形位置不变。

macOS 的 theme 改为同步借用原生字体。512 个对象的 LRU 回收未固定的、带字号 的字体,保留字体编号与精确描述符。只有描述符能恢复出 CFEqual 的字体时才 允许回收,其余字体继续固定保留。原有 GlyphNativeFont 对象仍保留到 shaper 销毁。描述符、稳定身份记录、既有的 256 条主字体缓存和固定字体不计入该 LRU 预算,因此这不是所有文字或原生内存的上限。

测试环境为 Apple M4、Go 1.27.3、CGO_ENABLED=0,前后采用相同的精简构建参数, 在解锁后的 2 倍缩放屏幕上串行运行真实窗口,不同时构建或跑其他测试。对照版 保留上一轮输入状态按需分配和空闲回收改动。通过 proc_pid_rusage v4 记录总 物理内存与内核累计峰值,名义采样间隔 50 ms,另有保持窗口前台的调用开销。 空闲取静默 12 秒后、恢复绘制前末三秒的均值。测试程序不强制 GC,Keel 既有的 默认空闲回收器保持启用。

长文本窗口包含 600 段约 2,000 字符的混合语言文本,初始为 800×600dp,即 1600×1200 像素;执行 600 次滚动更新、20 次 900×660dp 与 800×600dp 交替缩放、 480 次字号更新。每次滚动和字号更新都等待布局回调完成;各有效运行均实际执行 600 次滚动布局、481 次字号变化及复位布局。测试以 60 Hz 请求输入,框架帧率 没有改变。普通文字组件会把字号取整到像素,因此这一组字号更新本身不会触发 512 个字体的回收门槛。

长文本测量项,MiB 优化前中位数(范围) 优化后中位数(范围)
空闲总物理内存 105.96(103.63–107.64) 68.14(66.52–69.33)
内核记录的生命周期峰值 193.60(190.31–196.67) 151.31(151.16–151.67)
启动阶段采样峰值 105.02 105.02
滚动阶段采样峰值 169.19 131.70
窗口缩放阶段采样峰值 186.25 151.16
字号变化阶段采样峰值 193.31 140.78

仅启用文字缓存预算的对照组,三轮空闲中位数为 68.42 MiB、内核峰值中位数为 151.45 MiB,说明主要收益来自段落缓存。启动阶段最大布局回调耗时,优化前为 7.75–8.76 ms,优化后为 8.72–10.83 ms;字号变化阶段最大值分别达到 17.72 和 15.76 ms。空闲后从请求到恢复布局完成的中位数为 15.03 → 16.12 ms。这些结果 不证明延迟改善,也不等于上屏延迟或端到端帧率。

字体专项使用独立真实窗口,以“仅文字缓存预算”为对照,四个字体家族绘制同一段 中英文短文本,连续变换 640 个非整数像素字号,每次均等待布局完成,窗口同为 800×600dp。三轮交替结果如下:

字体专项测量项 仅文字缓存预算 加入字体回收
空闲总物理内存,MiB 中位数(范围) 218.78(218.72–219.92) 212.22(212.19–212.37)
内核生命周期峰值,MiB 中位数(范围) 310.30(302.86–313.50) 306.20(304.67–306.55)
切换结束后常驻的带字号字体对象 3,841 1,623

字体回收在该压力场景独立减少 6.56 MiB 空闲总内存,降幅 3.0%;峰值范围重叠, 不能认定有稳定峰值收益。1,623 个常驻对象包含 512 个可回收对象和 1,111 个固定 字体;3,841 个稳定身份仍全部有效。这不表示普通客户端会创建数千个字体,或能 获得相同收益。

既有 Components VirtualList 回归场景使用 680×860dp 窗口、600 次滚动请求、 40 次与 820×720dp 交替的缩放,最后空闲 12 秒。每版三轮,实际滚动布局为 598–599 次。空闲总物理内存为 53.65(52.93–55.11)→ 55.62(54.22–58.20)MiB, 内核峰值为 148.20(148.05–148.30)→ 148.88(139.58–149.14)MiB。该场景没有 可确认的收益:空闲中位数高 1.97 MiB,前后范围重叠,最终 Go 堆均约 5.4 MiB。 这些数据尚不能确定其余原生、驱动或进程内存差异的原因。

回归测试覆盖字节与条数上限、超大段落、可见工作集复用、子串所有权、排版与 字体都淘汰后的旧字形编号、旧接口对象生命周期和多余描述符释放。大量切换字号 前后的原生字形蒙版逐字节一致,覆盖英文、中文、阿拉伯文、Emoji、可变字重与 斜体,以及深浅两种文字颜色。默认与无 cgo 全量测试、定向竞态测试、vet、 Windows/Linux 无 cgo 构建和解锁状态下的 RealWindows 均通过。未降低分辨率、 限制帧率或增加逐帧 GC。

原始记录、二进制、源码覆盖配置、哈希和汇总 results.json 位于本地 work/text-memory/。锁屏、窗口被遮挡、绘制帧不足或与其他检查重叠的试跑均已 排除。阶段采样峰值不能替代内核生命周期峰值,布局完成也不代表 GPU 已上屏。 上述结果只适用于已测工作负载,不能外推到所有客户端。

空闲物理内存后续优化,2026-11-06(本地)

上一轮只减少分配,没有达到总内存目标。本轮将既有空闲回收器的对象门槛从 8 MiB 调整为 4 MiB,仍要求距上次回收后累计新增分配至少 8 MiB。 未归还空闲页的门槛仍为 8 MiB;静默 2 秒、至少间隔 5 秒、避开帧锁内工作、 静态窗口不周期回收等约束均保留。应用仍可关闭空闲回收。

沿用同一真实 VirtualList 工作负载和采样方法,与上一轮“仅减少分配”的工作树 比较。每个版本取三次无其他诊断竞争的运行,含一次最终源码构建确认:

测量项(MiB) 上一轮中位数(范围) 本轮中位数(范围)
空闲物理内存 55.17(54.85–55.20) 53.53(51.62–54.93)
内核记录的生命周期物理峰值 146.35(146.28–146.41) 146.66(137.56–146.85)
最终 Go 堆 7.34(7.28–7.69) 5.37(5.37–5.37)

本组空闲物理内存中位数减少 1.64 MiB(3.0%),范围仍有少量重叠,峰值未改善。 这不证明所有客户端场景或相对每个历史基线都有改善:更早的分配改动前曾在另一组 测量中得到 52.23 MiB 空闲中位数。测量程序没有强制 GC;默认回收器在本轮各 执行一次,对照组均未执行。尚未剖析空闲后恢复的首帧延迟。与画廊检查重叠的 试跑已排除。

按需解析 74 套 Chroma 配色的实验未获得明确物理内存收益,已连同复制资源和 API 改动撤回。保留的改动通过全量测试、loop/el/window 的 race、vet 及解锁后 完整 RealWindows 门禁。边界测试覆盖分配量和堆大小门槛,并验证不变状态 不会触发周期回收。改动仍在本地,尚未发布。

输入状态按需分配,2026-11-06(本地)

元素仅在需要输入框时分配文本编辑状态;编辑器和元数据共用一次分配,地址保持 稳定。按钮、带 ID 的虚拟列表行和滚动容器只保留通用状态。渲染、字体选择、 缓冲和回收策略没有改变。

相对 9545628,Apple M4、Go 1.27.1,三次基准:

测量项 优化前 优化后
普通元素状态结构体 2,392 B 1,888 B
普通状态实际堆分配(含分配器取整) 2,688 B 2,048 B
输入状态与编辑器实际堆分配 4,480 B 4,352 B
60 行中每次替换 3 行的分配 12,832 B/次 10,912 B/次
同一行更新基准的分配次数 74 次/更新 74 次/更新
Components VirtualList 滚动分配中位数 92,017 B/帧 90,112 B/帧
VirtualList 滚动 CPU 耗时中位数 148.38 µs/帧 150.74 µs/帧

实际场景分配降幅为 2.1%,不能套用合成基准的 15%。CPU 耗时未改善。这些数据 来自布局和输入路由基准,没有 GPU 呈现,不代表物理内存或端到端帧率。

最初锁屏时的真实窗口只绘制了 1 帧,该次数据已排除。解锁后进行了三组交替 对比:实际 Components VirtualList 窗口为 680×860dp(2×),程序化滚动 10 秒, 在 820×720dp 和 680×860dp 间缩放 10 秒,再空闲 12 秒。前后均实际绘制约 598 个滚动帧和 60 个缩放帧。与其他诊断重叠的首轮试跑不计入结果。 Go/GPU 回收策略保持默认,测量程序没有强制 GC。每 50ms 采集物理内存, 空闲值取末尾 3 秒。三次中位数如下,单位 MiB:

真实窗口测量项 优化前 优化后
内核记录的生命周期物理峰值 146.69 146.38
空闲物理内存 52.23 55.76
滚动 10 秒的 Go 累计分配 66.57 65.51
缩放 10 秒的 Go 累计分配 4.79 4.72

没有建立物理峰值明显改善的证据,观察到的空闲内存反而增加。默认空闲回收 的次数中位数从 1 次变为 0 次,可能影响空闲结果,但这不证明因果关系。 本轮收益属于减少分配,不能称为客户端总内存下降。原生窗口和无窗口模式的 99 个场景交互检查均通过。改动仍在本地,尚未发布。

回归测试检查普通元素不分配编辑状态、输入框重绘时地址稳定,以及移除输入框 后状态从存储中删除。792 张固定时间 GPU 截图逐字节一致,Windows/Linux 无 cgo 交叉构建通过。现有输入、文档、IME、选择、剪贴板、撤销和禁用状态测试 通过,有无 cgo 的全量测试、vet 和相关 race 测试通过。

无窗口生命周期诊断

桌面锁定或没有原生窗口的会话中可运行:

KEEL_MEMORY_REPORT=/tmp/keel-memory.json KEEL_MEMORY_ROUNDS=120 go test ./examples/components -run '^TestComponentMemoryLifecycle$' -count=1
KEEL_MEMORY_REPORT=/tmp/keel-memory-gpu.json KEEL_MEMORY_GPU=1 go test ./examples/components -run '^TestComponentMemoryLifecycle$' -count=1

每轮在 VirtualList、Table、Input、TextView 中创建并关闭 20 个窗口,执行列表 滚动和两种尺寸,随后采集 GC 后的 Go 内存。GPU 模式还在两种尺寸下为每个 场景渲染截图。末尾空闲 6 秒后再次采集;KEEL_MEMORY_PROFILE=1 可输出堆 剖析文件。强制 GC 仅用于这项可选诊断,不能证明空闲物理内存。 测试通过只说明操作完成,不代表没有泄漏;仍需检查对象保留曲线。

桌面锁定时,无窗口画廊的 99 个场景通过检查。随后延长生命周期测试,前后 版本各完成 8,000 次窗口创建、销毁。约 4,000 次后均趋于稳定:末尾 100 轮 保留堆范围分别为 19.06–19.37 MiB 和 19.09–19.42 MiB,空闲后的最终 Go 堆 均约 19.22 MiB,goroutine 数均为 2。先前 2,400 次测试不足以观察到平台期; 采样中的增长主要集中在有容量上限的 CoreText 字形缓存。这说明该有限工作负载 中未见继续线性增长,不代表所有组件都不存在泄漏。

另一次 GPU 生命周期测试,前后版本各完成 140 个窗口及两种尺寸下共 56 次 截图,最终保留 Go 堆约 4.69 MiB。这不是 GPU 或驱动物理内存测量。 新增诊断通过单独的 race 检查;解锁后原生画廊检查、原生缩放专项测试均通过, 没有重跑完整原生窗口门禁。详细本地结果位于 work/components-memory/。

Components 按需依赖,本地后续改动

保留 Components 全部 99 个场景,按演示内容选择可选依赖:使用 ui/highlight/golang 显示 Go、模板和纯文本;图片来自本地或 data URL, 移除 ui/netimage 导入。框架原有的全语言 ui/highlight 和 HTTP 图片模块 仍可使用。当前演示的未知语言显示为无颜色文本,自动识别范围限于所选规则, 也不启用 HTTP 图片 URL。需要全部语言和远程图片的应用不能直接获得同等收益。

Go 1.27.1,CGO_ENABLED=0、GOWORK=off,构建参数 -trimpath -buildvcs=false -ldflags="-s -w"。前后使用同一工作树(含下文的 原生装饰拆分);基线通过 Go overlay 恢复先前的两个导入。以下为可执行文件大小:

平台 优化前(MiB) 优化后(MiB) 减少
macOS arm64 24.54 19.04 22.4%
Windows amd64 25.76 20.01 22.3%
Linux amd64 26.33 20.63 21.7%

macOS 单独移除未使用的 HTTP 图片导入节省 2.98 MiB,再选择 Go 规则节省 2.52 MiB。本轮没有修改渲染器、字体、组件、分辨率或帧率,未测得或宣称物理 内存收益。改动仅在本地,尚未发布。

固定时间的 792 张截图逐字节一致,99 个真实窗口场景及画廊交互检查通过。 初次未固定时间时有 72 张动画截图不同,固定时间重跑后差异消失。 高亮对比测试覆盖受支持语言、模板、不完整代码、Unicode 和多种配色;依赖测试 防止 Components 再次引入 net/http 或完整 Chroma 语言注册表。 有无 cgo 的全量测试、vet、相关包 race 测试、Components 桌面跨平台构建和 WebAssembly 构建通过。这不代表上一轮记录的四项原生窗口门禁失败已解决; 本轮未重跑该门禁。

原生窗口依赖拆分,本地后续改动

相对 19b3db8,macOS、Windows 的 gio/app 不再编译 Gio 自绘备用标题栏。 系统标题栏保留;Linux 等其他平台保留原有备用实现。Keel 组件的字体功能没有删减。 Go 1.27.1,CGO_ENABLED=0、GOWORK=off,参数为 -trimpath -buildvcs=false -ldflags="-s -w";下表为可执行文件 MiB:

客户端 macOS arm64 优化前 → 后 Windows amd64 优化前 → 后
空 Gio 窗口(事件循环和帧提交,无文字) 6.718 → 3.364 6.499 → 2.998
空 Keel 窗口 9.220 → 9.220 9.083 → 9.075
Hello 10.473 → 10.457 10.723 → 10.715

约 50% 的降幅只属于裸 Gio 客户端,不能套用到 Hello。Keel 仍需要自身的文字、 主题依赖。Linux 保留备用标题栏,这几个客户端因拆分增加 4–8 KiB。此前提出的 Hello 再降 30% 目标尚未达到,本轮也不声称 GUI 内存减少。

noopengl 现在同时排除 GPU 注册和 EGL/WebGL 无窗口上下文。此前虽然排除了 app 上下文,GPU 后端仍会被链接。macOS 下,改动后的空 Gio 客户端加此标签为 3.139 MiB,Hello 为 10.312 MiB。仅在有其他可用后端(如 Metal)时使用;它不会 替代 WebGL。普通构建继续保留 OpenGL。删除备用字体和关闭开发工具仅做了本地 overlay 测量,没有落入本次改动。

默认和无 cgo 全量测试、race、vet、Windows/Linux 全模块交叉构建、WebAssembly 构建、通过主机 overlay 执行的备用标题栏测试,以及 Metal 空闲/缩放检查均通过。 组件矩阵 792 张 PNG 逐字节一致,99 个组件场景通过交互检查。工作流的对比步骤 最初缺少基线元数据,之后独立完整比较了已有图片,没有为此重新渲染。

当前主机的完整 RealWindows 门禁未通过:无障碍点击、文字缓存重绘/缩放、 玻璃以及缩放探针在两种后端下失败。在未包含本次改动的 19b3db8 上复现了 相同四项失败。这些问题仍未解决,Metal 单项检查通过不能替代完整门禁。 Windows/Linux 未做运行验证。

包体依赖测量,2026-11-05

相对主分支 1759621,本次尚未发布的本地改动将 native X11/DBus 实现限制在 Linux,并默认使用 UTF-8 SVG 解析。-tags keel_legacy_svg 恢复上游旧字符集 解码。字体回退、渲染器选择和自动化功能保持不变。

主机为 darwin/arm64,Go 1.27.1。各目标统一使用 CGO_ENABLED=0、GOWORK=off 和 -trimpath -buildvcs=false -ldflags="-s -w"。下表为可执行文件的 MiB, 不代表安装包或运行内存。native 探针导入 native/permission,将命令行参数 传给 Granted(默认 -1,不发起原生权限请求);其等待选项用于另行采样内存。

目标 Hello 优化前 → 后 Components 优化前 → 后 native 探针优化前 → 后
macOS arm64 11.25 → 10.47 25.87 → 24.54 3.29 → 2.31
Windows amd64 11.50 → 10.72 26.78 → 25.77 2.34 → 2.16
Linux amd64 14.11 → 13.31 27.11 → 26.33 2.87 → 2.87

macOS 默认 cgo 后端下,Hello 从 11.09 降至 10.32 MiB,Components 从 25.48 降至 24.18 MiB,native 探针从 3.29 降至 2.30 MiB。Linux 保留实际使用的 原生协议。这些结果不能证明 GUI 物理内存减少,也不代表 Windows/Linux 运行验证。

默认和无 cgo 全量测试、vet、race 测试以及 Windows/Linux 无 cgo 全模块构建 通过。解析器测试在 1×、2× 下与上游逐像素比较;旧编码标签测试覆盖 Big5、GBK、 Shift-JIS 和 Windows-1252。native 协议单元测试通过仅测试使用的构建约束 overlay 在 macOS 执行通过,Linux 协议测试二进制也交叉编译通过。依赖测试检查桌面目标 选择,并阻止旧字符集表进入默认 kit 构建。

首轮 792 张矩阵截图中有 12 张深色 1× 图片不同。对每个受影响场景及宽度进行 三轮交错、独立进程复测,均一致;随后完整矩阵复测的 792 张 PNG 逐字节一致。 首轮差异未复现。真实窗口组件库通过全部 99 个场景和交互检查,没有为消除首轮 截图差异修改渲染器。

桌面无 CGO 编译门禁

GOOS=windows GOARCH=amd64 bash scripts/check-desktop-cgo-free.sh
GOOS=linux GOARCH=arm64 bash scripts/check-desktop-cgo-free.sh native

默认 all 模式先检查 native 能力,再检查包含 Keel Gio 和 go-text 的完整模块。脚本关闭 CGO 和 workspace,发现依赖包错误、选中的 CgoFiles 或构建错误即失败。native 模式仅检查 native/*,不能视为桌面 UI 支持验收。 六目标 CI 矩阵在每次 push/PR 检查 native 能力及完整 Windows 构建。完整 macOS/Linux 门禁仍待迁移,可通过 workflow 的 full 参数执行;不使用静默容忍失败。将 CC/CXX 设为不存在的路径可防止意外调用 C 编译器,但不能代替隔离的无编译器/头文件发布验证。 编译通过不等于运行、IME、原生 GPU、打包或性能验收;详见桌面交付设计。

Ubuntu 的 distribution job 在脚手架测试前安装 Linux 图形开发库。TestNewProjectCompiles 对生成的 GUI 项目执行宿主平台 vet;Linux 上会开启 cgo,仍需要 Gio 的 Wayland、X11、xkbcommon、EGL/GLES 和 Vulkan 头文件。独立的 compile 矩阵继续关闭 cgo,并将 C/C++ 编译器路径设为不存在的文件。

python3 scripts/check-module-release.py 把工作区打包成本地模块代理中的测试用 Keel 发布,用 keel new 创建只 require Keel 的应用,确认其 Gio 和 go-text 包来自 Keel 模块(而非上游 gioui.org 或 go-text),编译外部自定义组件,并从该发布 go install CLI。它检查默认、离线、本地生成及含空格路径,无 CGO 打包 Windows amd64/arm64 和 WebAssembly;macOS 上还用现有 CGO 后端运行打包后的应用 ID/启动参数探针。外部依赖使用当前配置的 Go 代理;合成发布由本地代理提供,使用全新模块缓存并关闭 workspace。

测试应用

ui/window/windowtest 在内存中绘制窗口,并像人一样操作它:按元素的可见文字和角色。不打开原生窗口,所以测试能在 CI 中运行,也随 go test ./... 一起运行。

func TestGreeting(t *testing.T) {
    app := windowtest.New(t, window.Options{Content: el.Root(newApp())})
    app.Click("Name")      // 标签为 Name 的输入框
    app.Type("Ada")
    app.Click("Say hello")
    app.Want("Hello, Ada!")
}
方法 作用
windowtest.New(t, opts) 在本测试期间于内存中打开窗口;opts 未设置尺寸时为 800×600 dp
app.Click(text) 点击名称或值与 text 最匹配的元素:完全匹配优先于部分匹配,控件优先于普通文字
app.Type(s)、app.Press("enter") 向获得焦点的输入框输入;发送按键组合("tab"、"mod+a")
app.Scroll(text, dy) 在元素上滚动滚轮
app.Want(text)、app.WantNot(text)、app.Has(text) 检查可见内容
app.Find(text)、app.Elements() 读取角色、值、勾选与选中状态和边界
app.Resize(w, h)、app.Screenshot() 改变尺寸;用 GPU 渲染 PNG

每次查询和操作都会先渲染,执行已经交给 core.Update 的函数,所以已完成的 goroutine 的结果可见。查找失败时会列出可见元素。元素就是 Agent 通过 keel-mcp 看到的内容,角色见 Agent 端到端测试。减少动画处于开启状态,不会截到动画中途。window.OpenHeadless 提供同样的操作,以返回错误代替测试失败。

交互测试

ui/ 下的模块都可以引用它(它在 internal 里,外部项目引用不到):

func TestInputSubmit(t *testing.T) {
    var got string
    f := Input("").OnSubmit(func(s string) { got = s })   // 在 package kit 里
    h := uitest.New(el.Root(f)) // 布局一帧
    h.Click(20, 10)      // 点击获得焦点
    h.Type("你好")        // 输入文字
    h.Key("⏎", 0)        // 回车
    if got != "你好" {
        t.Fatalf("OnSubmit saw %q", got)
    }
}
函数 作用
uitest.New(w) 把组件放在左上角 (0,0) 布局一帧
uitest.NewFunc(fn) 用任意帧函数,比如 window 包的测试用 w.layout 带上根视图和快捷键
h.Click(x, y) 在 (x, y) 按下并松开左键,然后画一帧
h.Key(name, mods) 按下并松开一个键,然后画一帧。name 是 Gio 的键名:字母大写 "A",回车 "⏎",也可以用 key.NameReturn 等常量
h.Type(s) 向有焦点的输入框插入文字,然后画一帧
h.Frame() 执行 core.Update 队列并画一帧

坐标规则:测试视口是 400×300,1dp = 1 像素。uitest.New 不带根视图,组件从 (0,0) 开始;用窗口布局测试时,内容从 (24,24) 开始。

每个 h.Click 等操作后面自带一帧,但回调修改了状态、要看重绘结果时,多调一次 h.Frame()。

模块边界测试

internal/deps 检查每个模块只引用了允许的包(见架构 · 模块):

  • 下层模块引用了上层(比如 el 引用 kit),同层互相引用,或者 native/* 引用了 ui、Gio,测试失败;
  • 新增了模块目录却没在允许表里登记,测试失败。

它随 go test ./... 一起运行。

什么该测

  • 回调触发次数:点一次触发一次,禁用时不触发。
  • 回调参数:OnChange 收到的是新值。
  • 程序调用和用户操作的区别:SetValue 不触发 OnChange,打字会触发。
  • 解析类函数(快捷键字符串):合法输入和每一种非法输入。
  • native 包:参数校验路径(不需要权限,也不会真的动鼠标)。

Agent 端到端测试

cmd/keel-mcp 让 Agent 通过 MCP 驱动应用:读元素、点击、输入、滚动、截图。应用在内存里渲染,不弹窗口。用法见 Agent 端到端测试。

仓库里有两层相关测试,都随 go test ./... 运行:

  • ui/window/automation_test.go:进程内测试自动化模式本身,包括滚动、Tab 移动焦点、回调里关闭窗口、禁用和勾选状态的报告。
  • cmd/keel-mcp/main_test.go:以 MCP 客户端身份启动 keel-mcp,把 multiwindow 示例完整走一遍,并测试连接用户自己启动的应用(attach)。改了协议、工具或组件的语义信息后,它会第一个失败。

截图对比

覆盖表解码与图标回调复用(本地后续优化)

磁盘索引在解码时就复用相同字符覆盖表,不再先分配重复切片。去重表只属于一次读取,命中哈希后完整比较页号和位图;解码结果不引用复用的记录缓冲。命名实例元数据仍独立,版本 7 缓存继续有效。 IconView 只缓存一个不可变的渲染器与颜色快照,更换缓存不会修改旧元素捕获的颜色;复制视图会建立自己的渲染器。元素句柄和 Context.Cache 生命周期不变。参照的是本地 mygo 保留图标栅格回调的做法,不借用帧 scratch,也不改 Keel 的指针 API。

go test ./typesetting/fontscan -run 'Test(IndexDecode|RuneSetDecode)'
go test ./ui/kit -run 'TestIcon(RenderReuses|CachedElement)'
go test ./typesetting/fontscan -run '^$' -bench BenchmarkFontIndexDeserialize -benchmem -count=3
go test ./ui/kit -run '^$' -bench 'Benchmark(IconRender|RetainedIconFrame)' -benchmem -count=3

Apple M4、Go 1.27.1,以 main afe213c 为基线,各跑三次 500ms,取中位数:64 文件、每文件四字体、512 页共享覆盖表的合成索引,分配从 4,959,613 B / 888 次降到 259,418 B / 633 次,CPU 时间 2.01ms → 1.48ms。 所有覆盖表都不同时,去重表带来代价:4,959,578 → 4,996,580 B、886 → 899 次,2.05ms → 2.29ms;不能只报告共享场景的收益。 稳定保留的 IconView.Render 从 944 B / 3 次降到 920 B / 2 次;每次新建视图从 992 B / 4 次降到 984 B / 4 次。这些数字包含独立元素、节点,不只是回调,完整帧仍非零分配。 792 张固定时间 GPU 截图全部逐字节一致。短基准中三个场景的字节回退,在交错的五轮独立进程复测中未持续复现。微基准不能证明真实窗口 footprint、峰值或 FPS 改善。

相同卡片客户端以 main afe213c、尚未发布的本地后续优化、最新本地 mygo fefd36a5 各跑三轮独立进程,交错顺序。窗口为 800×600dp、原生 2×(1600×1200px),保留已有 v7 字体索引。滚动、缩放各 10 秒,空闲 12 秒;每 100ms 采样,启动为 50ms,空闲取最后三秒。仅测试客户端关闭空闲主动回收,与 mygo 对齐;GOGC/GOMEMLIMIT 和库默认值不变。强制 GC 全部为零,profile、截图另开进程。

原生窗口三轮中位数 改前 本地后续优化 Mygo
启动 TotalAlloc / MiB 26.74 21.62 20.03
启动 HeapSys / MiB 27.22 19.25 23.22
滚动分配 / MiB/s 4.88 4.07 45.33
滚动分配次数 / 绘制调用 693 93 2,568
滚动 GC 次数 7 6 38
缩放分配 / MiB/s 2.33 1.93 15.30
缩放 GC 次数 3 3 12
空闲末三秒 footprint / MiB 58.80 57.24 73.30
内核全程峰值 / MiB 159.10 164.06 163.67

峰值未改善:改前 157.86–162.45 MiB、改后 158.10–165.38 MiB,全部进程在缩放时达到峰值,中位数观察值升高约 5 MiB。三轮范围重叠,空闲小幅差异也不是已确认收益。单轮启动 GC 可能在分配减少后反而增加。Mygo 的无障碍工作显著影响分配速度;这不是框架排名或端到端 FPS,也不能证明 controls 分类峰值改善。独立 profile 中 IconView.Render 滚动自分配为零采样,指针 frameHandles 仍占约 57% 采样字节;启动 RuneSet 解码采样约 1 MiB,而非原来的约 6 MiB。采样和 GC 统计滞后使 profile 总量不能替代阶段实际分配或物理存活内存。

绘制分配后续优化(2026-10-15)

本地后续改动保留颜色指针 API 和元素生命周期。Material 标签改用新增的颜色值布局方法,可选中文本自己保存颜色。anchors 在绘制开始时 clear,Render 仍能通过 LastSize 读取上一帧;超过 4,096 项的 map 在下一次绘制时丢弃。描边只有连续两帧出现才准入缓存,候选表只存哈希;正式条目不借用可变 Ops 或描边 scratch。参考本地 mygo 的有界 scratch 和清理边界,不改其对应的公开句柄 API。本次不改 drawable、分辨率、GC 或默认空闲回收。

99 个场景分别启动进程,每个场景测三次、每次 50 个预热后帧。合计从 1,402,961 降到 1,086,720 B/帧,分配次数从 11,144 降到 9,876,没有场景退步。它只测布局和操作生成,不含 GPU 执行。普通 Material 标签从 128 B、1 次降到零;可选中标签从 133 B、2 次降到 5 B、1 次。512 个 anchors 从 111,288 B、17 次降到零。792 张定时 GPU 截图逐字节一致。

真实 controls 对 main 3b88f26、字体+描边(af8d7dd + b45e325,现已合入 main 6ab9dae)、本地后续优化各跑五轮,交错顺序,每轮新进程。窗口 800×600 像素、原生 1×;滚动、缩放各 10 秒,随后停止输入 12 秒。controls 最后一阶段仍有动画,不能称为静态空闲。

controls,五轮中位数 原 main 字体+描边 本地后续优化
启动 TotalAlloc / MiB 245.54 131.75 123.01
滚动分配 / MiB/s 22.88 14.40 10.51
滚动 GC 次数 9 6 4
缩放分配 / MiB/s 86.80 39.53 28.41
缩放 GC 次数 32 14 10
无输入最后 3 秒 footprint / MiB 162.38 162.33 162.47
内核进程峰值 / MiB 187.39 175.72 188.36

峰值范围分别为 180.60–193.42、170.08–187.38、175.70–209.03 MiB。后续优化降低了垃圾,未降低物理峰值:中位数反而高于单独的字体+描边版本。本轮后续优化五个进程均在首次滚动时定下峰值,不在缩放时;原 main 五个进程均在启动时定峰。客户端和自然 GC 时机不同,不能沿用上轮“缩放定峰”解释所有场景。

现有分类快照中,三个 controls 版本均约为 51 MiB unmapped graphics、8.3 MiB IOAccelerator graphics、5.7 MiB IOSurface。启动末 Untagged 中位数约为 70→87→98 MiB,无输入时回到约 73–74 MiB。Untagged 不等于 Go 堆;但本地后续优化第 1 轮的 gctrace 显示,3.501 秒时堆涨到 101 MB 才自然 GC(goal 107 MB),回收后存活量 29 MB。这不支持把峰值变化全部归给 GPU,也不能据此认定泄漏。分类工具有取整,快照不一定刚好捕捉到短暂峰值。

footprint 每 100ms 采样,启动每 50ms,单列内核进程峰值。所有正式阶段 forced GC 为零;仅测试客户端关闭 Keel 空闲主动回收以匹配 mygo,GOGC/GOMEMLIMIT 未设置。正式轮次不同时构建、跑测试、剖析或额外采分类;使用已有字体索引。字体、描边现已合入主线,不归功于某个已发布版本;本轮后续改动仍只在本地。

相同 600 张卡片的客户端对各版本交错跑三轮,包含本地 mygo 7e868828,forced GC 同样全部为零:

卡片,三轮中位数 字体+描边 本地后续优化 本地 mygo
启动 TotalAlloc / MiB 26.65 26.58 19.20
启动末 footprint / MiB 47.13 47.66 54.52
滚动 footprint / MiB 105.17 103.31 124.91
缩放 footprint / MiB 107.47 107.63 126.25
空闲最后 3 秒 footprint / MiB 50.10 50.19 63.88
内核进程峰值 / MiB 115.97 115.83 131.33
滚动分配 / MiB/s 4.91 4.88 45.21
缩放分配 / MiB/s 2.29 2.42 15.42
滚动 / 缩放 GC 次数 7 / 3 7 / 3 38 / 12

卡片客户端各进程均在缩放时定峰。两版 Keel 的峰值范围重叠:114.42–116.08 与 115.56–116.74 MiB。卡片很少涉及本轮 controls 热点,缩放分配速率没有改善;相同每秒 20 次尺寸请求下,实际帧事件数仍有波动,不能当作端到端 FPS。本机 mygo 的 macOS accessibility 工作显著影响分配量,不据此给框架做普遍排名。

独立进程按 64 KiB 采样的 allocs profile 中,LabelStyle 自身分配和 strokeCache.put 已不再是热点。controls 缩放样本约 36% 来自文字 shaping 与 toGioGlyphs;卡片滚动约 57% 是 frameHandles。controls 滚动中的 writeVertCache 占 15.18 MiB,但只有四次采样到的扩容,不是每帧泄漏。profile 记账可能滞后自然 GC 约两个周期,阶段总量以 MemStats 差值为准,占比只作近似。

另跑的一对帧统计诊断不混入正式内存数据:首帧布局+提交 124.67→141.49ms,去掉前 20 帧后 P95 为 8.56→7.57ms。首帧停顿仍在,单对进程不能证明端到端 FPS 或稳定的首帧变化。两帧准入可能让新稳定的几何计算两次,哈希碰撞也可能阻止准入;这是命中率和 CPU 的代价,不是借用不安全内存的捷径。

字体启动分配检查(2026-10-15)

字体初始化和索引基准单独运行:

go test ./typesetting/font -run '^$' -bench BenchmarkGlyfInitialization -benchmem -benchtime=500ms -count=3
go test ./typesetting/fontscan -run '^$' -bench 'BenchmarkFontIndex(RecordRead|Serialize)' -benchmem -benchtime=200ms -count=3

Apple M4、darwin/arm64、Go 1.27.1,三个独立样本的中位数:

操作 改前字节 改后字节 改前分配次数 改后分配次数
Go Regular glyf 初始化 191,033 30,720 2,125 2
读取 3,143,610 字节索引记录 8,388,283 3,178,546 17 3
编码 64 个合成文件,各含四组 512 页字符覆盖 28,489,518 6,009,804 293 278

字体文件未变化时跳过索引序列化;冷启动或更新时保留版本 7 格式,逐文件流式编码。测试对照旧解析器的字形头、可变字体点数、轮廓及度量;畸形记录模糊测试检查校验结果一致。792 张固定时钟组件截图与 main 逐字节一致。

解锁后的原生对比使用相同的 600 张非虚拟化卡片,800×600 实际像素、原生 1×,各版本交错启动三个新进程。基线为 main 3b88f26;本地优化构建通过 Go overlay 合用字体补丁 af8d7dd 和描边补丁 b45e325。测量时尚未发布;之后已分别通过 PR #35、#36 合入主线,不归功于某个已发布版本。字体索引已存在。本地 mygo 为 7e868828。

原生指标,三轮中位数 Keel 改前 本地优化构建 本地 mygo
启动 TotalAlloc / MiB 95.38 26.65 19.17
启动 GC 次数 10 5 4
启动 HeapSys / MiB 83.22 27.22 23.22
全程内核进程峰值 / MiB 115.36 115.55 132.41

启动分配下降 72.1%,但物理峰值没有下降证据。Keel 三轮内核峰值范围重叠:改前 114.75–124.24,改后 112.70–115.58 MiB。启动阶段内核峰值中位数为 106.86 → 106.00 MiB,后续缩放仍会推高全程峰值。HeapSys 包含已交还系统的页,不是物理 footprint。卡片滚动仍约 4.91 MiB/s,GC 为 6 → 7;启动分配减少不等于每个阶段 GC 都减少。

每个进程依次测启动/加载、10 秒滚动、10 秒连续缩放和 12 秒空闲。物理 footprint 每 100ms 采样(启动每 50ms),与内核累计峰值分开记录;空闲值取最后三秒。全部阶段 forced GC 为零。只在测试客户端关闭 Keel 空闲主动回收以匹配 mygo,库默认值及 GOGC/GOMEMLIMIT 不改。锁屏试跑、profile 和截图进程均不计入这些中位数。原生滚动、缩放流程完成,没有无响应超时。

另起开启帧统计的单轮诊断,首帧布局加提交耗时为 104.00 → 60.89ms,优化后仍有首帧停顿。这不是首次实际呈现延迟、三轮耗时中位数或端到端 FPS。

改了主题、间距、字体后,渲染前后截图,确认只有预期的地方变了:

go run ./examples/hello -screenshot /tmp/before.png
# 修改代码
go run ./examples/hello -screenshot /tmp/after.png
cmp /tmp/before.png /tmp/after.png && echo 完全一致

纯重构应该输出"完全一致"。截图由 GPU 离屏渲染,同一台机器上结果稳定;不同机器、不同系统字体下像素可能不同,不要把截图提交成跨机器的基准文件。

真实窗口测试

有些 bug 只在真实窗口里出现,比如多窗口之间的死锁。ui/window/desktop_test.go 在子进程里运行 ui/window/testdata/raise:打开两个窗口,在界面代码里(持有帧锁)调用 Raise、Close,15 秒内没走完就判定为死锁。

KEEL_DESKTOP=1 go test -run RealWindows ./ui/window

这组测试也覆盖窗口首次居中、立即关闭后重开。多显示器切换、各平台窗口管理器和系统偏好变化仍需手动验证。

macOS 上,TestRealWindowsResize 分别打开普通窗口和磨砂玻璃窗口,各执行 60 次 Gio 尺寸请求,再保持窗口中心不动,通过原生 frame 改变尺寸 60 次。 随后通过 ToggleMaximize 执行 4 次原生最大化/还原,等 AppKit 的缩放结束帧 完成后再检查尺寸固定的滚动。测试检查 NSView 采用 duringViewResize 重绘和 topLeft 内容放置策略,让 AppKit 在动画各步重绘,而非缩放缓存画面。 它分别记录内容图层的 anchorPoint 和 gravity,检查模型图层 X/Y 缩放值 始终为 1,并检查图层采用不拉伸的左上锚定(按 contentsAreFlipped 选择 gravity)、drawable 尺寸等于图层 bounds × backing scale,以及玻璃 窗口缩放帧在主线程启用 presentsWithTransaction 提交。每个窗口还通过程序 连续改变 60 次文字滚动位置。尺寸不变的帧保持异步提交,包括空闲 drawable 回收后的恢复;静态窗口必须停止绘帧。 探针在回收后采样两秒,报告进程空闲 CPU。 600ms 超时用于发现卡顿,不代表显示 FPS。这些属性和调度检查没有读取合成器 的中间帧或系统动画使用的整窗快照;还需拖动缩放、最大化和还原 examples/hello 和 examples/glass,确认文字没有 变形、锚点正确,并在 GPU 完成后检查空闲 CPU。修复位于 ui/window,没有 新增 cgo,也没有修改 Gio。

默认跳过,因为它会在屏幕上弹出窗口,而且需要图形界面环境。改动 ui/window、ui/internal/loop 里和窗口、锁相关的代码后必须跑一次。新增窗口方法时,把它加进 testdata/raise 的步骤里。

需要手动验证的部分

无界面测试覆盖不到这些,改动相关代码后手动跑一遍:

场景 怎么验证
真实窗口的打开、关闭、置前 go run ./examples/components -section multiwindow -lang zh-CN,点"打开设置窗口"两次,应该只有一个设置窗口
最后一个窗口关闭后退出 关掉所有窗口,终端里进程应结束
窗口快捷键 在主窗口按 ⌘+,
全局快捷键 go run ./examples/components -section hotkey -lang zh-CN,打开预览并启用快捷键,切到其他应用按 macOS 的 Cmd+Shift+K 或其他平台的 Ctrl+Shift+K,计数增加
后台 core.Update hotkey 示例里的时钟每秒走
权限、截图、合成输入 需要授权,按 原生能力 的说明手动测
中文输入法 在输入框里用拼音输入,候选框位置正确,上屏后内容正确

全组件截图矩阵

go run ./examples/components -matrix /tmp/keel-component-matrix
# 单个组件:窄窗口、1×、深色
go run ./examples/components -section button -width 320 -scale 1 -theme dark -screenshot /tmp/button.png

矩阵按已注册的每个组件生成浅 / 深色、320 / 680dp 宽、1× / 2× 共八张首帧截图,并输出可浏览的 index.html。每个案例重新构造组件,避免上一个案例的布局缓存影响结果。大图通过索引中的图片链接打开;截图只包含当前视口,滚动后的内容和浮层仍需交互测试。

window.Screenshot 保持默认 2×;需要其他缩放时用 ScreenshotAtScale。尺寸以 dp 表示,PNG 尺寸按缩放四舍五入到物理像素。非法尺寸或缩放返回错误。

组件示例中的固定展示宽度必须同时设置 MaxW(el.Full);否则测试到的是被裁掉的宽画布,而非组件的窄布局。并列操作用 Wrap,保留需要验证横向滚动的内容宽度。Sidebar 示例在 600dp 以下初始折叠,仍可手动展开;Dock 的多列工作区需要足够宽度,不把 320dp 截图当成手机布局承诺。

cmd/keel-mcp 的示例级回归包括:订单筛选、详情和删除、新建订单纯键盘流程;聊天流式输出、代码/表格和中断;设置页主题、搜索和语言切换;Dock 移动面板、切换后保留输入、菜单 Esc 与关闭面板。TestOrdersKeyboardOnly 不点击控件,从 Mod+N 开始用 Tab、方向键、Space、Enter 完成保存。

托盘与驻留回归

go test -race ./native/tray ./ui/internal/loop 检查菜单快照、旧事件、串行回调、关闭后丢弃排队回调,以及没有窗口时更新仍执行。Linux 的 SNI/DBusMenu 协议测试使用纯 Go 的序列化与菜单模型,不要求桌面会话。

KEEL_DESKTOP=1 go test -run RealWindows ./ui/window
go run ./examples/tray -smoke

真实窗口用例从无窗口启动,关闭最后一个窗口后重新打开,再检查退出回调。托盘 smoke 额外创建、更新和移除系统图标。菜单实际点击、明暗外观、高 DPI、Windows Explorer 重启和 Linux Host 重启需要分别在对应桌面上验证;跨平台编译不代表运行验收。

菜单回归覆盖图标快照、非法更新的原子性、启用/禁用模板缓存(预热后图标布局零分配)、固定时间的动画进度、减弱动画和结束后的帧调度。Agent 测试检查菜单项标签、禁用/勾选状态、操作路由和控制器取消。Windows 目标平台测试验证位图挂载、预乘像素、保持宽高比的透明填充,以及替换/失败时的资源释放;交叉编译测试不代表已执行。macOS 测试创建真实 AppKit 图片和弹出菜单跟踪循环。

python3 scripts/check-components.py --offline --desktop --only checks interactive

一键组件验证

python3 scripts/check-components.py
# 离线运行:依赖和 Go 工具链须已缓存。
python3 scripts/check-components.py --offline
# CI 不显示原生窗口;仍需 GPU 后端和图形开发库。
python3 scripts/check-components.py --offline --headless

标准流程串行执行:脚本回归测试、格式检查、vet、全仓库 Go 测试、race、Windows 无 CGO 构建、Linux native/CLI vet;随后运行独立进程的全组件和大数据基准、固定时间的完整 GPU 截图矩阵;最后启动 go run ./examples/components,遍历实际注册的全部场景并验证下面的交互。--desktop 还会在检查阶段运行真实窗口生命周期测试,包含 macOS 菜单图片替换和两种原生取消模式;同时运行 macOS 原生托盘测试及 examples/tray -smoke。桌面托盘 smoke 需要可用的通知区域 / SNI Host。需要 Python 3 和 Go;Python 部分只使用标准库。macOS 需要 Xcode 命令行工具;Linux 仍需 Gio 图形开发库和可用的图形/显示后端。

默认产物保存在新的 work/component-checks/<时间戳>/:summary.json、由 Go 注册表导出的 manifest.json、各命令日志、原始基准和中位数 benchmarks.csv、matrix/index.html,以及交互报告和截图。失败立即停止并返回非零退出码;已有内容的结果目录不会被覆盖。每个基准场景启动独立进程,检查、GPU 渲染和交互不会与性能测量并行。

# 只跑指定阶段;默认每个示例场景测量 3 次,每次 200ms。
python3 scripts/check-components.py --only benchmarks --count 3 --benchtime 1s
python3 scripts/check-components.py --only matrix interactive --offline
# 同机先保存基线,再修改代码并比较。
python3 scripts/check-components.py --output work/component-baseline
python3 scripts/check-components.py --baseline work/component-baseline
# 快速验证流程能否跑通;1x 样本不能证明性能收益。
python3 scripts/check-components.py --offline --count 1 --benchtime 1x --large-benchtime 1x

--baseline 要求场景集合一致,矩阵 PNG 变化会失败,并生成 comparison.csv(百分比为正表示回退)。基准百分比供评审使用,不自动设置耗时或分配门槛。比较时保持机器、字体、Go 版本和基准参数一致。截图时间通过生成的 Go overlay 固定,不修改生产代码。视觉变化符合预期时,应评审后建立新基线。

交互检查覆盖复选框及禁用状态、开关、中文及多行输入、弹窗保存/Escape/重开、搜索和万条选项多选、十万项虚拟列表、表格排序和滚动、日历键盘跳过禁用周日、日期选择器重开后的选中状态,以及应用菜单图标、禁用项、操作路由和 Escape 关闭。日历读取当前展示的日期,不硬编码月份。自动化操作的是 Gio 的影子输入路由;默认应用同时显示原生窗口,--headless 隐藏原生窗口。两种模式均不能验证系统输入法候选框或原生鼠标事件投递,GPU 呈现延迟和动画性能需要单独 profile。

--offline 禁用 Go 模块、VCS 和工具链下载,未缓存的依赖会明确报错。它不会让截图变成无 CGO 构建,也不会禁用示例自身的可选网络图片请求。

全组件帧分配基准

组件示例的基准自动遍历全部注册场景,覆盖控件、输入、浮层、导航、图表和虚拟化内容:

go test ./examples/components -run '^$' -bench '^BenchmarkComponentFrame$' -benchmem -benchtime=200ms
# 单独测一个场景;第二段表达式也加首尾锚点,避免匹配名称后缀。
go test ./examples/components -run '^$' -bench '^BenchmarkComponentFrame$/^calendar$' -benchmem -benchtime=1s -count=3
go test ./ui/kit -run '^$' -bench '^BenchmarkTableFrame300k$' -benchmem -benchtime=1s -count=3
go test ./ui/kit -run '^$' -bench '^BenchmarkCodeEditorPlainLargeFileFrame$' -benchmem -benchtime=1s -count=3

BenchmarkComponentFrame 在 680×1040dp、1× 缩放下预热场景,使用真实 Gio 输入路由并固定动画时间。它测量 CPU 布局和输入注册,不包含 GPU 提交或后台更新投递。关闭浮层的静态帧不能代表打开菜单、弹窗、滚动、输入或动画的延迟;交互回归和 GPU 截图矩阵需要同时验证。

稳态帧分配次数是回归指标。普通测试在预热三帧后检查组件示例中的 label(35)、list(250)、button(260)、calendar(1,050)、table(550)、input(500)六个分配上限。上限是防回退门禁,不是性能目标;每次分配优化仍要用基准同时比较前后的字节数和次数。

设置 KEEL_FRAME_STATS=all 可记录每个原生窗口帧的布局、提交耗时,以及该时段进程的分配次数、字节数和完成的 GC 轮数。KEEL_FRAME_STATS=1 只记录超过 8ms 的帧;其他非负数字表示毫秒阈值。正常运行时不要设置:读取 runtime metrics 本身是诊断开销。分配计数覆盖这一帧期间的整个进程,并发后台工作也可能计入。

比较时,用同一份基准代码分别构建基线和修改后的测试程序,每个场景启动独立进程。可选的高亮、图片加载会影响同进程中后续场景的分配计数。可以用 Go overlay 选择原始生产代码,无需撤销工作区修改。普通编辑器基准不设置语言;已有的大文件高亮基准仍包含整文件后台高亮。

绘制路径分配检查,2026-10-15

路径坐标系描边缓存使用独立的渲染器基准:

go test ./gio/gpu -run '^$' -bench 'Benchmark(Rotating|Changing)StrokeVertices' -benchmem -benchtime=500ms -count=3

Apple M4、darwin/arm64、Go 1.27.1,三个独立样本的中位数:

三次曲线描边顶点生成 改前耗时 改后耗时 字节:改前 → 改后 分配次数:改前 → 改后
相同路径,仅旋转变换 17.88 µs 5.29 µs 42,648 → 0 103 → 0
路径内容变化 18.53 µs 16.44 µs 42,939 → 8,232 103 → 2

第一项已预热缓冲;第二项每帧改变控制点,包含缓存未命中和独立所有权的复制。scratch 不与缓存曲线或 Ops 共用可写数组。缓存最多保留 128 组轮廓及 1 MiB 路径/曲线数据,淘汰未使用项,超大路径不缓存;渲染器清理或释放时丢弃全部缓存。斜切、反射等仿射变换的顶点和边界与原算法完全一致。旋转、圆角祖先裁剪和透明度下的冷热 GPU 像素一致;792 张固定时钟组件截图与 main 逐字节一致。

微基准只测 CPU 顶点生成,不代表整帧或 FPS。解锁后的原生对比使用实际 controls 分类,800×600 像素、原生 1×,各版本交错启动三个新进程。main 3b88f26 为基线;优化二进制通过 overlay 合用本地字体补丁 af8d7dd 与描边补丁 b45e325。测量时尚未发布,之后已通过 PR #35、#36 合入主线。

原生 controls 阶段 改前 MiB/s 改后 MiB/s GC 改前 → 改后
10 秒滚动及组件动画 22.91 14.41 9 → 5
10 秒连续缩放 86.17 39.55 32 → 14
12 秒停止输入,动画继续 23.11 14.50 10 → 6

这不是静态空闲 CPU 检查,也不是与 mygo gallery 的同内容对比。原生滚动、缩放流程完成,没有无响应超时;该客户端没有帧计数器,不据此判断 FPS 或输入延迟。全部阶段 forced GC 为零;只在测试客户端关闭空闲主动回收,以匹配 mygo。着色器、drawable 数量、库的 GC 和回收默认值不变。

分配改善,物理内存没有改善证据:滚动 footprint 中位数为 157.45 → 159.86 MiB,缩放为 160.99 → 161.22 MiB。内核全程峰值中位数上升到 183.58 → 190.85 MiB;三轮范围重叠,为 176.45–194.60 → 173.08–200.31 MiB。报告保留这个观测代价。

另起不强制 GC 的 profile 显示,滚动剩余样本中 LabelStyle 约占 13.3%、anchors 插入约占 9.3%;缩放时文字 shaping 加 Gio 字形转换约占 28%,新缓存的独立所有权复制约占 15.8%。尺寸持续变化的路径仍需研究缓存准入或缓冲复用,不能改成不安全地借用 scratch。profile 账目可能滞后约两个 GC 周期,比例只用于定位,样本总量不是精确阶段字节量。

BenchmarkCategoryFrame 使用实际 -section 分类组合,窗口为 1360×1720 像素(680×860dp,2×),接入真实输入路由,动画时间按 60 Hz 推进。 每个分类单独启动进程测量,期间不运行其他基准:

go test ./examples/components -run '^$' -bench '^BenchmarkCategoryFrame$/^controls$' -benchmem -benchtime=1s -count=3

Apple M4、darwin/arm64、Go 1.27.1 上,每个分类运行三轮,每轮一秒, 稳态帧中位数如下。基线已包含节点 arena;两个二进制使用相同基准。 修改版增加有界图标缓存、借用字形缓冲,并保留状态标记与主题示例的视图对象。

分类 修改前 B/帧 修改后 B/帧 修改前分配次数/帧 修改后分配次数/帧
controls 334,888 152,289 2,169 2,050
inputs 484,933 183,947 2,176 2,021
overlays 175,744 38,832 558 487
data 726,864 599,584 3,262 3,191
shell 384,267 94,172 1,339 1,182

该基准只测 CPU 布局和绘制指令生成,不包含 GPU 执行、原生窗口 footprint、 滚动延迟或端到端帧率;没有修改 GC 和 drawable 策略。图标缓存以有界保留 换取更少的栅格化和上传:每个图标最多八种样式、1 MiB 像素,超大当前图片只保留自身。

设置 KEEL_STATE_STATS=1,按根节点与帧记录状态新增、淘汰数量,附带前八个 新增元素的 ID、角色和名称。固定的根节点编号可区分根节点重建和元素 key 不稳定。 日志仅按需启用,不请求重绘;新增可见行本来就会创建状态,不能仅凭新增计数判断错误。 这次追踪发现 controls 的状态标记和主题示例分别在每个预热帧替换 21、4 个状态, 原因都是在渲染时创建以指针标识身份的视图。保留视图对象后,后续追踪中不再出现这两处 状态替换,主题示例的输入状态也能跨渲染保留。

后续分配优化,2026-10-15

Apple M4、darwin/arm64、Go 1.27.1 上,以完成节点 arena 后的代码为基线,99 个组件场景的分配字节和次数全部进一步下降。逐场景降幅中位数分别为 42.2% 和 44.2%,不加权的场景平均分配从 57,243 降到 35,420 字节/帧。每个场景独立进程运行三次、每次 200ms;前后都没有调整 GC 参数。这些归档测量使用了当时工作区的三 drawable 和关闭空闲回收实验;两项策略都不属于 arena PR,Metal 保持 main 的策略,空闲堆回收仍默认开启。

场景 分配字节/帧,前 → 后 分配次数/帧,前 → 后
Label 9,808 → 3,336 51 → 26
Button 106,583 → 64,989 463 → 202
Calendar 413,218 → 190,688 2,344 → 842
Table 149,992 → 79,336 817 → 424
List 58,464 → 29,848 374 → 200
Input 178,293 → 122,612 806 → 400

本轮把可选样式值内联,只有实际执行回调时才分配私有绘制样式,按需缩小独立句柄批次,复用帧内测量条目和编辑器 filter,并按不可变内容缓存文档映射。按钮只在有界缓存中共享纯数值样式函数,不缓存用户回调或帧 Context;日历每个月共用一个禁用样式函数。样式仍区分未设置与显式透明色、正常字重、零偏移;回调副本和指针句柄都不会在后续帧覆盖复用。

30 万行表格滚动基准,前后各三次、每次 300ms:368,397 → 297,361 字节/帧,1,622 → 1,197 次/帧,布局耗时中位数 525µs → 506µs。组件布局耗时的逐场景改善中位数为 5.0%,小幅变化仍受主机负载影响。初次短测中 Bubble 和大文件普通编辑器的耗时回退,前后各五次、每次 1s 后未复现:中位数分别为 57.2µs → 55.0µs、2.50ms → 2.33ms。这些 CPU 帧数据不能证明端到端帧率、物理内存、GPU 内存或启动延迟。兼容现有指针 API 仍需分配新的校验句柄,文字塑形、组件创建和用户回调也仍有分配,并未达到零分配。

第一轮截图发现局部 Themed 子树的默认文字色回退:内联值提前捕获了全局颜色。修复后,默认色在绘制时解析,显式透明色仍保留,并补了 root 级回归。此后 792 张矩阵截图逐字节一致,99 个场景导航和交互组全部通过;原生窗口生命周期、空闲恢复和连续 60 次缩放检查也通过。新增测试还覆盖零值样式继承、回调副本身份、旧指针句柄、哈希冲突、文字引用释放、编辑器内容及对象模式变化。arena 不新增强制 GC,也不调整空闲回收阈值。

节点 arena 测量,2026-10-15

Apple M4、darwin/arm64、Go 1.27.1 上,99 个组件场景的稳态帧分配字节数和次数全部下降。每个场景独立进程运行三次,每次 200ms;基线已经包含语义 op 直接写入、焦点 filter、单元格 ID 和可见列缓存。arena 带来的逐场景降幅中位数为:字节数 42.4%,次数 37.7%;不加权的场景平均分配从 106,662 降到 57,243 字节/帧。

场景 分配字节/帧,前 → 后 分配次数/帧,前 → 后
Button 181,059 → 106,583 699 → 463
Calendar 918,307 → 413,218 3,861 → 2,344
Table 558,217 → 149,992 2,056 → 817
List 162,097 → 58,464 679 → 374
Input 218,070 → 178,293 935 → 806

30 万行表格滚动基准,前后各运行三次、每次 300ms:分配从 1,121,028 降到 368,397 字节/帧,次数从 3,930 降到 1,622,布局耗时中位数为 590µs → 525µs。Radio 和 Button 在短基准中的耗时回退,延长到前后各五次、每次 1s 后未复现:中位数分别为 30.7µs → 29.8µs、152.6µs → 147.6µs。小幅耗时变化仍受主机负载影响。

792 张 GPU 矩阵截图逐字节一致,组件库 smoke 通过全部 99 个场景导航及输入、浮层、列表、表格、日历交互。arena 回归覆盖槽位复用前后的旧句柄、同帧重建、root 归属、缓存逃逸、废弃节点引用清理、一次性 root 和嵌套 root。预热后只构建 101 个节点,最多分配六批小句柄;完整组件帧仍有样式、回调和文字处理分配。这些 CPU 帧数据不代表原生窗口物理内存、GPU 内存或启动延迟。

原生窗口检查(RealWindows、TestMetalIdleWindow、TestMetalResizeWindow)也通过:三次空闲恢复耗时 28.8~31.8ms,60 次原生缩放最慢 27.4ms。这些检查不测量端到端帧率。

更早的分配测量,2026-10-13

2026-10-13,在 darwin/arm64、Apple M5 Pro 上,99 个场景的每帧分配字节数和分配次数均下降。逐场景降幅的中位数分别为 8.7% 和 16.2%(每个场景独立进程运行三次,每次 200ms)。短测试中出现耗时回退的五个场景,延长到五次、每次 1s 后未复现稳定回退。小幅耗时差异仍受主机负载影响;这些数据是同机观察值,不是跨机器性能门槛。

场景 分配字节/帧,前 → 后 分配次数/帧,前 → 后
Calendar 1,139,345 → 959,473 7,085 → 5,184
Form 92,141 → 82,192 467 → 348
Chart 292,385 → 267,760 1,445 → 1,229
Tree 118,003 → 104,320 644 → 520
VirtualList 142,285 → 111,931 645 → 452
MessageScroller 1,057,741 → 682,160 2,385 → 1,590

大数据场景单独运行三次、每次 1s。表格前后使用相同的 CPU/内存 profile 参数;普通编辑器前后均不启用 profile:

场景 耗时/帧,前 → 后 分配字节/帧,前 → 后 分配次数/帧,前 → 后
30 万行表格滚动 702µs → 608µs 1,515,575 → 1,138,768 6,524 → 4,522
20 万行普通编辑器移动光标 2,594µs → 2,319µs 540,302 → 250,920 1,745 → 1,077

公共路径的改动包括:仅缓存节点分配布局 memo,仅输入框创建 Gio 编辑器,跳过未使用的快捷键和浮层索引,共享不可变快捷键祖先路径,小容器的布局子列表使用栈空间,构建子列表时一次预留容量,状态 ID 哈希不再拼接字符串。状态哈希保持原有身份兼容。组件自动 ID 和日历日期 ID 直接写入字节缓冲,保持原有格式;微基准中前者从 43ns 降到 19ns,后者从 94ns、3 次分配降到 43ns、1 次分配。编辑器复用字形临时缓冲,最多保留 4,096 个字形;超大行的缓冲不保留。

回归覆盖缓存节点的宽度、DPI、继承字体变化,兄弟动作作用域,无处理器的快捷键提示,稳定的编辑器焦点地址和中文输入。792 张 GPU 矩阵截图与基线逐字节一致;前后均通过测试专用 overlay 固定截图时间。实际运行 go run ./examples/components,还验证了全部 99 个场景的导航、输入、复选框和开关状态、弹窗焦点/保存/重开、万条选项搜索、十万项虚拟列表滚动和表格排序,并检查日历跳过禁用日期的键盘导航和日期选择器重开后的选中状态。示例分类检查防止注册组件遗漏在侧栏之外。

原生毛玻璃除了透明 GPU 像素,还需要检查系统合成结果。在 macOS 14.4+ 上运行 KEEL_DESKTOP=1 go test -tags keelnativeqa -run TestNativeMaterialComposition ./ui/window:用例把自己的红蓝参考背景和毛玻璃窗口一起捕获,再断言两侧颜色都能透出。捕获使用 ScreenCaptureKit 的当前进程内容接口,不申请录屏权限。过滤器保留系统桌面层,否则窗口背后的材质会被截成灰色;其他应用的内容窗口被排除,图片只保存测试窗口所在区域。