dsh-headless-display

隔离的 headless 虚拟 X display：默认桌面上零窗口、零干扰；面板里可实时查看与操作，按需弹出真实窗口。给 Agent 9 个工具 + HTTP API。为Agent提供无窗口干扰的虚拟桌面环境，适合Linux系统下的自动化任务。

パッケージ

dsh-headless-display

互換性

未検証

バージョン

1.1.1

ライセンス

MIT

最終更新

2026/10/11

在 cordis.patch.yml 的 config 里改（安装后也可在 DSH 的插件页配置）：

键	默认	说明
`backend`	`xvfb`	`xvfb`＝纯 headless（桌面零窗口）；`xephyr`＝在桌面上开可见窗口
`parentDisplay`	`$DISPLAY` 或 `:1`	承载 Xephyr 窗口的桌面 display（仅 `backend: xephyr` 需要）
`xauthority`	自动探测	X 授权文件
`defaultSize`	`1280x720`	默认分辨率
`displayRange`	`[9, 20]`	可用的 display 编号区间
`stateDir`	`~/.dsh-headless-display`	记录已启动 display 的目录
`vncPortBase`	`5900`	弹出真实窗口时 x11vnc 的起始端口（只监听回环）
`xephyrPath` / `xvfbPath` / `x11vncPath` / `viewerPath` / `xdotoolPath` / `importPath`	按名字在 PATH 查找	自定义可执行文件路径

⚠️ parentDisplay 与 xauthority 建议显式配置 —— 见下面第 3 个坑。

dsh-headless-display

インストール