jingyingruodi/dsh-headless-display ↗★ 0
dsh-headless-display
提供隔离的无头虚拟X display环境。 为Agent提供无窗口干扰的虚拟桌面环境，适合Linux系统下的自动化任务。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:jingyingruodi/dsh-headless-display说明文档
阅读完整 README ↗配置
在 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 个坑。