DeepSeek Harness macOS 桌面端：全屏点检查更新后黑屏与窗口消失的排查

DeepSeek Harness（DSH）桌面端在 macOS 上有一个特别值得记住的坑：原生全屏状态下点「检查更新…」并确认，主窗口会整屏变黑、甚至彻底消失，只能退出进程重开；如果窗口是在独立空间里全屏，消失后连 Dock 与切换器都找不回来，「关于」菜单走同一条路径也会触发。 诊断已经比较明确：更新提示是一个透明的无边框子窗口**，确认后被销毁；而父窗口采用毛玻璃加透明背景的组合，销毁之后没有触发父窗口重绘，于是画面停在黑屏；同时子窗口没有声明「不可全屏」（该属性默认为允许），会触发一次系统空间过渡，把主窗口留在原来的空间——这正好解释了「标准全屏变黑但还能点」与「独立空间里彻底消失」两种不同表现（#9312、#9035）。

DeepSeek Harness 现象与判据：两种表现、一条成因

一句话结论：同一个弹窗子窗口在销毁后缺少父窗口重绘，叠加一次不必要的空间过渡，就产生了「黑屏」与「窗口消失」两种表现。 两种现象的对照如下（#9312、#9035）：

DeepSeek Harness 三步确认

1. 确认触发路径：必须经过「全屏 → 点检查更新（或关于）→ 确认」这三步；后台自动检查不走这个弹窗，因此不会触发（#9312）。
2. 确认黑屏仍可交互：在黑屏上点击侧栏位置，如果有响应，说明是渲染层问题而非崩溃——这条判据能避免你误以为是进程挂了（#9312）。
3. 确认「关于」也复现：用它交叉验证同一条路径，能直接锁定到该弹窗实现而不是更新逻辑（#9312）。

DeepSeek Harness 一行级修复方向与用户侧规避

一句话结论：修复的核心是两点——给该子窗口声明「不可全屏」，并保证子窗口销毁后父窗口重绘一次。 据讨论中的核对，第一条是一行级改动，并已在官方某一版本上验证过（#9312）。

修复方向：

1. 给透明覆盖层窗口设置「不可全屏」，避免触发空间过渡（#9312）。
2. 子窗口销毁后强制父窗口重绘一次（毛玻璃 + 透明背景的组合尤其需要）（#9312）。
3. 版本提示：讨论指出相关文件在最新版本与主干上逐字节一致，即尚未修（#9312）。

用户侧规避清单（按推荐度排序）：

1. 全屏状态下不要点「检查更新」与「关于」——这是最省事的做法（#9312）。
2. 需要手动检查时，先退出全屏、恢复成普通窗口再点（#9312）。
3. 保留后台自动检查：它不走该弹窗，是安全路径（#9312）。
4. 已经黑屏/消失时：退出进程重开。别反复点 Dock 图标试图唤醒，讨论里的现场表明独立空间下没有正常恢复入口（#9035）。

DSH插件 排查注意事项

这条问题的排查成本很低，因为判据几乎一眼可辨：只有 macOS 全屏 + 走弹窗路径才复现。 六条要点：

1. 「全屏才复现」是第一条判据，非全屏点更新完全正常（#9312）。
2. 「黑屏但仍可点」= 渲染问题，不是崩溃（#9312）。
3. 「窗口消失」与「黑屏」是同一成因的两种程度，别当成两个 bug（#9035）。
4. 「关于」能复现这条交叉验证很有价值，建议先做（#9312）。
5. 后台自动检查是安全路径，可作为临时替代方案（#9312）。
6. 修复状态如实：讨论明确指出相关实现与主干逐字节一致，即未修；一条可行修复（声明不可全屏）已被其他用户验证过，但未合入，所以当下的处置是「避开全屏点更新」而非「等更新修好」。

桌面端这类「只在特定窗口状态复现」的问题，排查时很容易怀疑是插件影响了窗口渲染。若想把插件这一层先排掉，与其在各处手敲命令，不如用 DSH Plugin Hub 这类可视化插件市场：已安装列表、装卸历史与系统日志集中在一个面板里。

来源：Discussion #9312、Discussion #9035。