jafewff/dsh-vdesktop ↗★ 1

dsh-vdesktop

Run GUI apps on an invisible Win32 virtual desktop: an LLM agent drives them via vdesk_* tools, while you watch and take over with real mouse clicks from the DSH (DeepSeek Harness) web GUI panel. 适合需要让Agent在后台虚拟桌面操作GUI软件,并能实时接管的用户。

Package
dsh-vdesktop
Compatibility
Unverified
Version
0.2.0
License
MIT
Last updated
Sep 29, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:jafewff/dsh-vdesktop

使用

面板(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_mousemove / click / double_click / right_click / middle_click / drag / scroll
vdesk_keyboardtype / press / hotkey(支持中文、emoji 与组合键)
vdesk_type向目标窗口写入整段文本
vdesk_read_text读取目标窗口文本(优先 Edit 子窗)
vdesk_save_file把窗口文本保存到文件