[Bug] macOS 桌面版：原生全屏下点「检查更新…」，在弹窗点确认后整屏变黑且无法恢复

[realguan]

环境

• DeepSeek Harness Desktop 0.2.0-rc.1（官方构建）
• macOS，窗口处于原生全屏
• 入口：菜单栏 →「检查更新…」

复现步骤

1. 让主窗口进入原生全屏（绿灯 / ⌃⌘F）
2. 菜单栏 →「检查更新…」
3. 等「正在检查更新…」结束，弹出结果弹窗
4. 点弹窗上的确认按钮
5. → 整个屏幕变黑

实际结果

点确认后整屏变黑，且不会自行恢复：窗口不可见、无法继续操作，必须退出进程重新打开才能正常使用。

期望结果

弹窗关闭后回到全屏界面，不发生黑屏。

复现频率

按同样步骤每次都必现。

补充线索（未验证，供参考）

• 更新提示在 darwin 上不是 macOS 原生 sheet，而是一个覆盖父窗口内容区的 transparent: true 子窗口（apps/desktop/src/update-overlay.ts，调用处 nativeModal=false）；该窗口只跟随父窗口的 move/resize，没有全屏相关处理。
• 点确认后走 DesktopUpdateDialog.finish()（apps/desktop/src/update-dialog.ts）：先向渲染进程发 changed: null 隐藏卡片，150 ms 后再 destroy() 窗口。
• 黑屏一直持续到进程退出为止，看起来像是覆盖层/父窗口在原生全屏 Space 下没有重新合成回来。

[xinnian999]

同环境复现一条数据点，并补几条根因线索，供参考。

环境

项	值
App	DeepSeek Harness Desktop 0.2.0-rc.2（官方构建）
Electron / Chromium	Electron 44.0.0 / Chrome 152.0.7977.54
OS	macOS 26.3
机型	MacBook Pro (MacBookPro17,1) / Apple M1 / 16 GB / arm64

复现：与楼主完全一致。窗口处于原生全屏 → 菜单栏「检查更新…」→ 等「正在检查更新…」结束 → 弹窗给出结果 → 点确认 → 主窗口整屏变黑，必须退出进程重开。

一个补充现象：黑屏之后窗口仍然响应点击（点按钮、拖选都有反应，只是画面全黑）。也就是渲染进程活着、主进程没有 hang，坏掉的是合成/重绘这一层。这一点和 #9035 描述的「窗口直接消失」应该是同一根因的两种表现。

根因线索（公开源码，行号按当前 master）

1. 主窗口在 darwin 上是毛玻璃 + 全透明背景：apps/desktop/src/main.ts:224 vibrancy: 'sidebar'、:228 backgroundColor: '#00000000'。
2. 而且这两个值在运行期会被来回切：apps/desktop/src/main.ts:262-275 的 applyBackdrop()，在 minimize / hide 时执行 setVibrancy(null) + setBackgroundColor(chromeFallbackFill())（不透明兜底色），在 restore / show 时切回 setVibrancy('sidebar') + setBackgroundColor('#00000000')（全透明）。
3. 更新弹窗在 darwin 上不是原生 sheet，而是盖住父窗口内容区的透明无边框子窗口：apps/desktop/src/update-overlay.ts:27（transparent: true，调用处 nativeModal=false）；点确认后 apps/desktop/src/update-dialog.ts 先向渲染进程发 changed: null 隐藏卡片，150 ms 后 destroy() 该窗口。

「毛玻璃父窗口 + 全透明背景 + 运行期反复 setVibrancy / setBackgroundColor + 销毁一个透明子窗口」这套组合在 macOS 上很容易让父窗口的 surface 丢掉重绘；而销毁路径之后没有任何强制父窗口重绘/重建 backing 的动作（仓库里搜不到 invalidate 之类的调用）。这也解释了两个报告里措辞的差异：画面还在原处、只是全黑（本机），或者窗口整个不见（#9035，全屏 + 独立 Space）。

可能的修法方向（供维护者判断，不成熟）

• 覆盖层关闭后强制父窗口重绘：重新设置一次背景色、把 vibrancy 先置 null 再设回，或用极小的 bounds 抖动触发重排；
• darwin 上改回原生 sheet（nativeModal = true），或让覆盖层不再 transparent；
• 避免在运行期切换 vibrancy / 背景色（创建时定好，最小化态用别的方式处理）。

另外建议和 #9035 合并看：那条是同一根因在「全屏 + 独立 Space」下的另一种表现。

未修复确认：截至今天 master，update-overlay.ts 最后改动 2026-09-23、update-dialog.ts 最后改动 2026-09-24，都早于本报告；main.ts 中上述代码也未变动。