Zum Hauptinhalt springen
L

dsh-quiet-windows

lllwh-00ffff/dsh-quiet-windows

Launch and drive Windows GUI apps entirely off-screen, so the agent reads and clicks through UI Automation while the user's desktop and keyboard focus stay untouched.

Installation

dsh plugin --profile web add github:lllwh-00ffff/dsh-quiet-windows

README

dsh-quiet-windows

让 agent 在屏幕上「看不见的地方」启动并操作 Windows 图形界面。

窗口从创建起就停在所有显示器之外,agent 用 UI Automation 读控件、点控件,用 PrintWindow 截图——不吃遮挡、不怕离屏,并尽量避免抢键盘焦点。

工具

工具作用
quiet_launch屏幕外启动程序,返回 hwnd;只传 url 时自动挑浏览器离屏打开网页
quiet_windows列出所有可见顶层窗口(含屏幕上开着的)、显示器布局与 DPI
quiet_park把已经开着的窗口挪到屏幕外(不激活、不改大小),接管用户自己的程序
quiet_shot截图(窗口在屏幕外或完全被遮挡都拿得到)
quiet_tree读 UI Automation 控件树
quiet_act按控件执行 invoke / set / select / toggle / expand
quiet_close收尾关闭;共享进程的窗口不会被强杀

hwnd 不要求来自 quiet_launch:quiet_windows 列出的任何窗口,或者你自己用别的方式找到的句柄,都可以直接交给 quiet_shot / quiet_tree / quiet_act。屏幕上已经开着的窗口先 quiet_park 挪走,再操作。

安装

plugin_manager install_bundle  target: "<tgz 的绝对路径>"

装完重启 DSH,新会话即可在工具列表里看到 quiet_*。

依赖

  • Windows 10/11
  • Python 3,且装有 pywin32、uiautomation、comtypes、Pillow (插件会自动探测解释器;DSH 自带的运行时 Python 没有 pywin32,不能直接用)

测试

python -m unittest discover -s tests -p "test_*.py"   # 不碰桌面
node --test tests/tools.test.mjs                       # 不碰桌面
python tests/regress_browser.py --run                  # 会真的拉起浏览器

限制

  • 只走控件模式:坐标点击在屏幕外不可用。
  • 少数应用在屏幕外停止绘制,此时截图会报 looks_blank。
  • 焦点是「尽量避免并自动恢复」,不是零干扰保证。
  • 仅 Windows。

详细说明与设计取舍见 docs/DETAIL.md。

Ähnliche Plugins