dsh-headless-display

在 KDE、GNOME 等 Wayland 桌面上，Agent 很难安静地做 GUI 自动化：焦点外的输入往往无效，抓屏受限，程序一跑就会抢焦点、占满屏，直接打扰用户。本插件的思路是另起一个与用户会话完全隔离的虚拟显示，把自动化全部关在里面，默认桌面上不出现任何窗口。

默认优先 headless：有 sway 时用私有 headless sway 加 Xwayland，兼顾静默与 GPU（适合 Proton、Vulkan 等 3D）；否则退回 Xvfb，适合轻量 2D 与纯 X11 程序。需要亲眼看到或亲手操作时，不必换后端，用面板或工具的「打开真实窗口」即可通过本机回环 VNC 弹出查看器，关掉仍回到静默，里面的程序无需重启。

插件为 Agent 提供十个工具（含环境自检）：启停隔离 display、在其中执行命令、截图、列窗口、注入键鼠，以及弹出/收起真实窗口。DSH Web 侧栏还提供实时画面、点击与文本输入；同时暴露 HTTP API，方便脚本与面板共用同一套能力。代码对 display 归属与 Wayland 环境做了硬约束，尽量避免误连用户桌面。

适合需要让 Agent 在 Linux 上跑 GUI 测试、桌面自动化、或隔离环境里启动游戏/图形应用的工作流；若你既要零打扰又要 3D/GPU，应优先 sway 后端，纯 2D 场景用 Xvfb 更轻。