jingyingruodi/dsh-headless-display ↗★ 0

dsh-headless-display

提供隔离的无头虚拟X display环境。 为Agent提供无窗口干扰的虚拟桌面环境,适合Linux系统下的自动化任务。

套件
dsh-headless-display
相容性
待驗證
版本
1.1.1
授權
MIT
最近更新
2026年10月11日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:jingyingruodi/dsh-headless-display

配置

在 cordis.patch.yml 的 config 里改(安装后也可在 DSH 的插件页配置):

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

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