[Bug][Desktop][macOS] 全屏下「检查更新…」确认后黑屏 / 窗口消失 —— 已定位到 vibrancy + 透明覆盖层（汇总 #8224、#9035）

[xinnian999]

这条是把 #8224、#9035 两条已有报告合并汇总的版本（两条都在 General 且目前 0 回复）。如果维护者更希望在原帖里跟进，我可以把这条关掉，不另占版面。

影响面

macOS 桌面端，窗口处于原生全屏时：菜单栏 →「检查更新…」→ 结果弹窗点「确认」→ 主窗口整屏变黑或整个消失，都必须退出进程重开才能恢复。按步骤必现。

同一个弹窗路径也被「关于 DeepSeek Harness」使用（showAbout → ordinaryMessageBox → updateDialog.show），所以那一项同样会触发。

环境（三个数据点）

报告	版本	Electron / Chromium	OS	机型	表现
#8224	0.2.0-rc.1	—	macOS	—	整屏黑，无法恢复
#9035	0.2.0-rc.2	Electron 44.0.0	macOS 27.0.1	MacBook Air (Mac17,3) / M5	窗口直接消失（全屏 + 独立 Space）
本条	0.2.0-rc.2（官方构建）	Electron 44.0.0 / Chrome 152.0.7977.54	macOS 26.3	MacBook Pro (MacBookPro17,1) / M1 / 16 GB / arm64	整屏黑，但仍响应点击

复现步骤

1. 主窗口进入原生全屏（绿灯 / ⌃⌘F）
2. 菜单栏 →「检查更新…」
3. 等「正在检查更新…」结束，弹出结果弹窗
4. 点确认
5. → 主窗口黑屏（或消失），不自行恢复

关键观察

黑屏之后窗口仍然响应点击（按钮、拖选都有反应），说明渲染进程活着、主进程没有 hang，坏掉的是合成 / 重绘这一层，而不是进程卡死。这大概也解释了三条报告为什么表现不同：画面还在但全黑，或窗口整个不显示 —— 区别只在于当时所处的全屏 / Space 状态，根因是同一个。

根因线索（公开源码，行号按 master；dsh-v0.2.1-alpha.2 相同）

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）。它只跟随父窗口的 move / resize，没有全屏相关处理。
4. 点确认后：apps/desktop/src/update-dialog.ts 先向渲染进程发 changed: null 隐藏卡片，150 ms 后 destroy() 该窗口。
5. 销毁路径之后没有任何强制父窗口重绘 / 重建 backing 的动作（仓库里搜不到 invalidate 之类的调用）。

「毛玻璃父窗口 + 全透明背景 + 运行期反复 setVibrancy / setBackgroundColor + 销毁一个透明子窗口」这套组合在 macOS 上很容易让父窗口的 surface 丢掉重绘。

可能的修法方向（供维护者判断）

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

未修复确认

dsh-v0.2.1-alpha.2（2026-10-09，官方最新发布）中的 apps/desktop/src/main.ts、update-overlay.ts、update-dialog.ts 与 master 逐字节一致；update-overlay.ts 最后改动 2026-09-23、update-dialog.ts 最后改动 2026-09-24，均早于首条报告（2026-09-29）。升级到最新版无法规避。

修复前的规避方式

全屏下不要点「检查更新…」和「关于 DeepSeek Harness」。后台自动更新检查不走这套弹窗（updateSchedule.check 不创建覆盖层），不受影响。

---

相关报告：#8224 #9035

[JuniorSNy]

我也出现了一样的问题，在全屏下点击更新的覆盖层被销毁之后，屏幕上显示的是桌面壁纸；而窗口本体的变量还在渲染 —— isVisible() === true、document.visibilityState === 'hidden'、onscreen === false，且不会自行恢复。Chromium 也一直在正常渲染：capturePage() 在销毁前 / 中 / 后返回的帧逐字节完全相同。

触发条件：update-overlay.ts 创建覆盖层时没有设 fullscreenable，于是取默认值 true → NSWindowCollectionBehaviorFullScreenPrimary → macOS 确实把覆盖层自己全屏化了（child.isFullScreen === true），从而强制发生一次 Space 过渡，并把 App 的主窗口留在原来的 Space 上。

修法 —— apps/desktop/src/update-overlay.ts:28 加一行：

diff

•  fullscreenable: false,
  

已在官方 0.2.0-rc.2 构建上验证：全屏 → 「检查更新…」→ 点确认 → 窗口正常保留。main.ts 里 PolicyAuth 那个登录窗口是同样的「带 parent 的子窗口」形状，建议一并补。这与 Electron 自己针对 electron#39614 / #39620 的回归测试断言一致。同一条修法预计也能覆盖本条报告的「黑屏」表现，不过我只确定性复现出了「窗口整个消失」的问题。

[fengmvp1984]

确认 +1，补一个数据点：

• 版本 0.2.0-rc.2（nightly 渠道），macOS 26.3.1（build 25D771280a），MacBook Pro / Apple Silicon (arm64)
• 原生全屏 → 菜单「Check for Updates…」→ 点弹窗按钮关闭 → 整个全屏 Space 变黑，必现；普通窗口模式完全正常
• 与楼主「黑屏后仍响应点击」不同：我这边整个 Space 黑掉且点不到任何 UI，只能退出重开——与 [Bug] macOS 桌面版：原生全屏下点「检查更新…」，在弹窗点确认后整屏变黑且无法恢复 #8224 的表现一致，支持「同一根因、不同表现」的判断
• 未测：Esc 关闭路径、黑屏后 ⌃⌘F 能否退出全屏（当时直接重启了）。需要的话我可以补测

[ybl2020]

同环境复现 +1，并补一份本机打包件的复核结论。

环境

项	值
App	DeepSeek Harness Desktop 0.2.0-rc.2（官方构建，CFBundleVersion 0.2.0-rc.2）
OS	macOS 27.0.1（Build 26A434）

复现（与楼主步骤一致，100% 必现）

1. 主窗口进入原生全屏
2. 鼠标顶到屏幕左上角唤出菜单栏 →「检查更新…」
3. 等「正在检查更新…」结束、结果弹窗出现
4. 点确认
5. → 主窗口不可见且无法切回：点 Dock 图标、⌘Tab 都回不来，只能退出进程重开

表现更接近 #9035：不是「黑屏但点击仍有反应」，而是整个窗口回不来，所以支持楼主「同一根因、不同表现」的判断。

本机打包件复核（0.2.0-rc.2 官方构建，非源码分支）

直接解包 /Applications/DeepSeek Harness.app/Contents/Resources/app.asar：

• lib/main.js 中更新覆盖层的 BrowserWindow 选项逐项为 parent, modal:(darwin 下为 false), show:false, frame:false, transparent:true, ...parent.getContentBounds(), resizable:false, minimizable:false, maximizable:false, skipTaskbar:true, hasShadow:false, title, webPreferences —— 确实没有 fullscreenable，即默认 true。
• 整个 lib/main.js 里 fullscreenable 只出现 1 次，位于 welcomeWindowOptions()（欢迎窗口，值为 false）。也就是说同一份代码里欢迎窗口显式关掉了，更新弹窗这条路径漏了。
• 全包共 4 处 new BrowserWindow：欢迎窗（显式 false）、PolicyAuth 登录窗（带 parent，未设 fullscreenable）、更新覆盖层（带 parent + transparent，未设 fullscreenable）、主窗口。除主窗口外那两个「带 parent 的子窗口」都没设，按 @JuniorSNy 的建议建议一并补上；不过 PolicyAuth 是普通带边框、不透明窗口，形状与覆盖层并不完全相同，这里仅作提示。

上游仍未修（补充验证）

dsh-v0.2.0-rc.2、dsh-v0.2.1-alpha.2 至 dsh-v0.2.1-alpha.5、以及 master 的 apps/desktop/src/update-overlay.ts 中均无 fullscreenable，仓库内也没有相关 PR。因此升级到当前最新版（0.2.1-alpha.5，2026-10-16 发布）无法规避，与本帖「未修复确认」的结论一致。

规避方式

全屏下不要点「检查更新…」和「关于 DeepSeek Harness」（两者共用 ordinaryMessageBox → updateDialog.show 路径）；需要检查更新请先 ⌃⌘F 退出全屏。后台自动检查不走覆盖层，不受影响。

支持 @JuniorSNy 在楼上给出的 fullscreenable: false 修法。