DeepSeek Harness Linux 桌面端：添加工作区无反应、图标消失与名称字面显示

DeepSeek Harness（DSH）在 Linux 桌面端的几个问题，成因高度一致：按桌面环境规范读取信息这一步没做全——目录选择器后端在启动时被一次性定死（原生对话框不浮现时没有回退）、环境变量的空值没有按规范当成默认、桌面条目的转义没有按规范解码。于是你会看到三种完全不像一件事的症状：点「添加工作区」完全没反应（无弹窗、无报错）；把数据目录变量设成空字符串后所有文件关联应用与图标都不见了**；某些应用的名称带着反斜杠显示、图标查不到而消失（#8835、#8926、#8980）。

DeepSeek Harness 添加工作区无反应：选择器后端选错了且没有回退

一句话结论：选择器后端在启动时一次性采样并选定原生方案；原生对话框一旦不浮现，选择请求就永远处于等待，界面把「正在进行」当成真、之后所有点击被静默忽略，而且没有运行期回退到内置浏览方案。 症状是「点添加工作区完全没反应，没有弹窗也没有报错」（#8835）。

DeepSeek Harness 三步判据：先分清「没调用」与「调了没浮现」

1. 直接跑一次选择器程序（在终端里执行目录选择命令，例如 zenity 的目录选择）。能弹 → 调用没问题，问题在应用内的呈现/焦点；不能弹 → 问题在桌面环境或程序本身。 这一步能把范围缩掉一半（#8835）。
2. 确认启动时环境：讨论中指出的选定条件是「Wayland + 系统里有选择器程序 + 存在显示相关变量」，满足即会选原生方案——所以「同机换会话类型就正常」并不矛盾（#8835）。
3. 区分「没反应」与「点了但没动」：如果按钮点击后有短暂状态变化（例如变灰），说明进入了等待；完全无变化则更可能是点了但被忽略（#8835）。

DSH插件 两条规避

1. 把选择器固定成内置浏览版：在 profile 补丁里固定使用浏览方案，避开原生对话框（#8835）。
2. 以不带显示变量的方式启动（例如去掉 WAYLAND_DISPLAY 与 DISPLAY 后以 web 形态运行）：

env -u WAYLAND_DISPLAY -u DISPLAY dsh web
#   预期：选择器不再尝试原生方案，添加工作区可用

（#8835）

3. 上游诉求（两条）：运行期降级（原生失败就自动切浏览器方案）+ 显式开关（让用户能直接指定后端）（#8835）。

DeepSeek Harness 空值 XDG 变量把处理器与图标全藏了

一句话结论：读取默认值时用的是「仅当值为未定义才取默认」的写法，而空字符串不属于未定义——空值被当成有效值使用，搜索路径全空，处理器与图标一个都找不到。而桌面规范要求这两种情况都应取默认值**。** 症状是文件关联应用列表为空、图标路由 404（#8926）。

DeepSeek Harness 三步确认与处置

1. 确认变量确实是空值（而不是未设置）：

env | grep -E '^XDG_DATA_(HOME|DIRS)='
#   预期：看到形如 XDG_DATA_HOME= 的空值输出

如果这里显示空值，而 unset 掉之后就恢复正常，即为本条（#8926）。

2. 临时规避：把变量取消设置（而不是留空），让它回到默认值（#8926）。
3. 修法：把「未定义才取默认」改成「空值也取默认」——报告者提供了对应的生产补丁并做了多版本验证（#8926）。
4. 注意影响面：同一个解析器也被「用某应用打开」的图标路由复用，所以修好之后图标与处理器应一起恢复（#8926）。

DeepSeek Harness 名称带反斜杠、图标消失：桌面条目的转义没解码

一句话结论：桌面条目文件里名称与图标字段允许使用反斜杠转义（如 \s、\n、\t、\r 与 \\），而读取器只做简单切分与去空白、没有解码，于是字面值被直接拿去查找名称与图标，查不到就显示为空。 症状是名称显示成 Localized\sViewer 这类形态、图标消失（#8980）。

DeepSeek Harness 四步确认与处置

1. 确认桌面条目里确实含转义：检查对应 .desktop 文件里的名称/图标字段（例如本地化名称字段），预期能看到反斜杠序列（#8980）。
2. 确认同一文件的名称能正常显示（无转义的那些），说明是转义处理而非文件不可读（#8980）。
3. 修法：对名称与图标这几个字段做一次转义解码；注意不要动可执行文件相关字段（讨论中明确指出该限制，避免破坏命令解析）（#8980）。
4. 验证：重开应用列表，预期名称显示为可读文本、图标正常出现（#8980）。

DSH插件 排查注意事项

这三个问题的共同排查入口是「先看环境与桌面文件的实际内容，再看应用有没有按规范解读」。 七条要点：

1. 「没反应」先分清「没调用」与「调了没浮现」，终端直跑选择器是最快一步（#8835）。
2. 后端在启动时定死是根因之一：换会话类型就正常，说明采样时机是关键（#8835）。
3. 「等待永不返回 + 繁忙标记常真」= 后续点击被静默忽略（#8835）。
4. 空值 ≠ 未设置：这两个在规范里含义相同，但实现里常常被区别对待（#8926）。
5. 同一个解析器被多个功能复用：修好一处，图标与处理器会一起恢复（#8926）。
6. 转义解码要限定字段：名称与图标要解，可执行相关字段不要动（#8980）。
7. 修复状态如实：三条在讨论所指版本里都未修；空值那条报告者给出了已验证的生产补丁但未合入，另两条的修法方向也只有提案，因此当下可用的是「固定浏览器方案 / 去掉显示变量启动 / 取消设置变量」这类规避。

Linux 桌面端的这类问题，排查时常常需要先确认「这个环境里到底挂了哪些插件、有没有插件替换了系统交互」。与其在各处手敲命令，不如用 DSH Plugin Hub 这类可视化插件市场：已安装列表、装卸历史与系统日志集中在一个面板里。

来源：Discussion #8835、Discussion #8926、Discussion #8980。