Skip to content

fix(startup): 后台准备图标并消除首次显示的尺寸跳变 - #251

Merged
Kuddev merged 11 commits into
Kuddev:mainfrom
JoyElliot:startup-first-frame
Sep 27, 2026
Merged

Kuddev merged 11 commits into
Kuddev:mainfrom
JoyElliot:startup-first-frame

Conversation

@JoyElliot

@JoyElliot JoyElliot commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor

Result / 用户结果

修复 Windows 正常启动时先出现透明空窗口、随后跳变到终端目标尺寸的问题。创建 HWND 前计算首屏尺寸,PNG 图标解码与缩放放到后台;首次呈现完成后再显示窗口,首屏无需等待图标。

Design / 设计边界

  • 复用原有字体测量、116×30 终端布局与工作区尺寸限制;创建后仍核对实际 DPI,保留非 Windows / DPI 预检失败时的原回退路径。
  • 保留原 PNG、着色、缩放及像素处理,相同主题纹理共享结果。图标就绪前使用固定宽度字形,DPI 切换时保留旧图直到新图就绪。
  • 每个工作区拥有唯一的前台发布任务。替换请求或销毁工作区时取消该任务,同时通知后台在图片之间停止解码;后台只返回图片。前台重置与回填串行执行,使用任务所有权隔离旧结果,不再另加重复代次状态。
  • 首帧适配仅作用于原本需要显示并聚焦的 Windows 窗口:离开 GPUI 借用后同步发送首次 WM_PAINT,然后经 GPUI 激活窗口。静默启动、后台窗口和 Quick Terminal 保留原路径,无固定等待时间或持续轮询。
  • 当前设计与生命周期依据见 architecture/notes/nebula_app/gpui_shell/workspace/2026-09-22-nonblocking-first-frame.md。

Evidence / 验证依据

  • cargo test -p nebula --bin pebrel --features gpui-test-support gpui_shell::workspace::logos:: --locked --offline -- --test-threads=1:3 项通过,覆盖像素一致性、协作取消,以及后台已完成但前台回填仍在排队时替换请求。保留的请求作为正常回填对照。
  • 2026-09-26 同步上游 main (3ad289e / 1.9.1) 后重新编译并通过 31 项应用回归:原有 22 项启动/设置/相关功能回归、5 项本地化与标签控件交集回归,以及 4 项真实 Acrylic 原生测试。新版 CI 合同测试 58 项通过、1 项按平台条件跳过。上游已合入 Acrylic PR fix(windows): 使用 Acrylic 控制器改善边缘模糊并保持失焦效果 #250;本 PR 相对新基线仍为原来的 17 个启动相关文件,本地化与后台图标逻辑无冲突合并。
  • 架构、平台 cfg、提交范围命名检查、git diff --check 和 cargo fmt --all -- --check --config newline_style=Auto 通过,未增加预算或排除目录。
  • 此前 Windows 150% DPI、隔离配置的三次组合 Debug 原生启动:进程到可见约 0.60–0.95 s,目标窗口线程累计 CPU 0.52–0.59 s;首次完整截图已有 UI,采样到的 HWND 尺寸始终为 1938×1103。图标工作仍在后台运行;这些数字不是整机负载或跨硬件/Release 性能保证。本次任务所有权精简由上述调度回归覆盖,未重新测量原生启动耗时。
  • Windows 开窗动画保留;HWND 可见事件不等于所有动画像素完成。macOS/Linux 原生外观、其他 DPI/多屏、Quick Terminal 交互尚未在本次原生探针中覆盖,完整跨平台测试未在本地重跑。

Required Review / 必须确认

  • 遵循 CONTRIBUTING.md、docs/architecture.md 和 docs/project-constraints.md。
  • 按职责划分图标准备、窗口几何和平台呈现,没有增加第二套行为权威。
  • 架构检查以 3ad289e3e2a793d57cc3fc7614c7a127e1e92e97 为基线通过,未提高预算或新增排除项。
  • 成功、取消和旧结果隔离有测试,平台与视觉验收限制已说明。
  • 无新增用户界面文案或持久化格式。
  • 无治理规则变更。

供上游审查启动呈现与取消边界。

@Kuddev Kuddev left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

感谢修复。已按 head 0e4df465499cc7a8e6cf2f00c1e5cb979ada9da6 完成代码审核,本轮未确认阻塞性缺陷。

重点核验:

  • 图标后台任务只返回像素,前台发布由 Workspace 持有,替换/销毁取消旧任务;fallback 与正式图标保留相同槽位宽度。
  • 首窗大小区分基础字体与终端 zoom,并在创建后使用真实窗口 metrics/scale 校正;没有把预查询当成唯一权威。
  • 对照 pinned GPUI 7c662384 的 Windows 后端,确认 WM_PAINT -> handle_paint_msg -> draw_window 接到帧绘制/呈现;调用前已退出 App/Window borrow,随后通过 GPUI activation 消费 placement。
  • silent/background/Quick Terminal 不进入这条首次显示延后路径。

DPI 查询与当前 GPUI 使用同一 monitor API;Microsoft 文档对 per-monitor-aware 调用有适用性提示,但本 PR 已保留真实窗口度量回退,因此本轮没有把“API 提示”误判为已复现的尺寸回归。

验证边界:已检查当前 head 的 CI 结果与现有回归测试;本轮没有另外重跑真实窗口的多显示器/DPI、macOS/Linux 首帧验收。设计记录中的原生测量属于贡献者提供的证据,不扩展为所有机器的保证。合并前请同步当前 main 并让合并后的必需检查重新通过。

@Kuddev Kuddev left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

????? head f32100e17a99f76f356cb04a23b284fec09ed2e7???? Bug ????????????????????????????????????????????????????

?????????? 5f795a77?????????? main?? #248?????????????????????????????????????????????? #250/#248 ?????

????????startup_geometry 3 ??workspace::logos::tests 3 ??startup::first_frame::tests 1 ???????architecture?????????????diff ??????????? 481/481??????????????????

????????????/?? DPI ?????????????????????????????? head ? 10 ??? CI ????????

@Kuddev Kuddev left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

已复核更新后的 head c3e6a7a81a1705626e8b86f4189aa92c61369c41:仅正常同步 main 中 #305 的更新对话框修复,启动修复代码与已审核、通过定向测试的版本保持不变。此前十项 CI 已通过,但主分支更新触发严格同步要求,因此重新执行全部必需检查,不绕过门禁。

保留之前的审核结论及真实窗口/混合 DPI 验证边界;最终十项检查通过后合并。

@Kuddev
Kuddev merged commit 1274319 into Kuddev:main Sep 27, 2026
11 checks passed
@JoyElliot
JoyElliot deleted the startup-first-frame branch September 27, 2026 10:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants