Azhe0306/dsh-connectors

desktop-connector

Windows 桌面控制连接器:通过 10 个工具截屏(含被遮挡与半出屏窗口)、枚举与置顶窗口、移动/点击/拖拽/滚轮鼠标、发送组合键与任意中文文字。基于 koffi FFI:无需编译器、不每次起子进程,自带 GDI 截图与 PNG 编码。

도구 및 기능

@azhe0306/dsh-desktop-connector

让 agent 真正操控这台 Windows 电脑:看得见(截屏)也动得了(鼠标、键盘)。

  • 用 koffi 直接调 Win32(user32 / gdi32):无编译器、无每次调用的子进程。
  • 自带 GDI 截图 + PNG 编码(zlib + 手写 chunk),不需要任何图像库。
  • PrintWindow 优先:被遮挡或半出屏的窗口也能截;现代窗口画出空白时自动改用屏幕拷贝。
  • 后台进程置顶被拒的问题用 AttachThreadInput 解决。

安装

dsh plugin --profile web add github:Azhe0306/dsh-connectors#path:/packages/desktop-connector

工具:desktop_screen_info、desktop_windows_list、desktop_screen_shot、desktop_window_focus、 desktop_mouse_move、desktop_mouse_click、desktop_mouse_drag、desktop_mouse_scroll、 desktop_key_press、desktop_type_text。

Windows 专用(os: ["win32"])。desktop_key_press / desktop_type_text 可以带 window 参数: 给了就先置顶并确认成功,失败就拒绝执行——不会盲打到你没预期的窗口。

安全

这组工具会真实操作你的鼠标键盘。先 desktop_screen_shot 看清屏幕再动手;不要用它操作支付、删除确认这类高风险窗口。

MIT