dsh-vdesktop
在Win32虚拟桌面运行并控制GUI应用 适合需要让Agent在后台虚拟桌面操作GUI软件,并能实时接管的用户。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:jafewff/dsh-vdesktop说明文档
阅读完整 README ↗使用
面板(VDesktopPanel)
- 选择 / 创建虚拟桌面,画面以低频轮询方式实时刷新;
- 画面上的点击就是真实输入:点标题栏 ×/最小化/最大化直接生效(标准窗口走
WM_NCHITTEST非客户区拦截,自绘窗口走postmessage);点任务栏按钮等价于激活 / 启动对应应用; - 面板上的光标是叠加层(经
X-Cursor-X/Y响应头跟随),不是烧进帧里的。
Agent 工具(vdesk_*)
| 工具 | 用途 |
|---|---|
vdesk_desktop_create | 创建虚拟桌面并启动一个 GUI 应用(返回桌面句柄 / PID / 顶层 HWND) |
vdesk_desktop_close | 关闭虚拟桌面并终止其上的进程 |
vdesk_desktop_list | 列出所有 dshv-* 虚拟桌面 |
vdesk_orphan_sweep | 清理孤儿虚拟桌面 |
vdesk_screenshot | 整桌截图落盘(jpg/png,可选质量) |
vdesk_zoom | 指定区域 1x–4x 放大截图 |
vdesk_click | 单点(left/right,客户区坐标) |
vdesk_mouse | move / click / double_click / right_click / middle_click / drag / scroll |
vdesk_keyboard | type / press / hotkey(支持中文、emoji 与组合键) |
vdesk_type | 向目标窗口写入整段文本 |
vdesk_read_text | 读取目标窗口文本(优先 Edit 子窗) |
vdesk_save_file | 把窗口文本保存到文件 |