desktop-control

🖥️ Windows桌面自动化全能助手

OpenClaw官方出品的Windows桌面自动化工具,通过PowerShell脚本实现窗口管理、输入模拟、进程控制等核心功能,大幅提升本地操作效率。

收藏
1.5k
安装
466
版本
v1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

desktop-control 是一套面向 Windows 平台的桌面自动化控制技能,通过 5 个独立的 PowerShell 脚本模块实现完整的本地应用操控能力。用户可通过自然语言指令调用 app-control.ps1 管理应用窗口(启动、关闭、聚焦、移动、分屏),使用 input-sim.ps1 模拟键盘鼠标输入,借助 vscode-control.ps1 深度集成 VSCode 开发环境,利用 process-manager.ps1 监控系统进程并执行管理操作,以及通过 screen-info.ps1 获取屏幕信息、截图和剪贴板内容。所有脚本均需通过 -ExecutionPolicy Bypass 参数执行,并严格遵循 SKILL_DIR 路径规范。

显著优点

该技能的最大优势在于功能覆盖全面且高度集成,将分散的 Windows 系统操作整合为统一的脚本接口,显著降低了自动化门槛。VSCode 专属控制模块对开发者极为友好,支持行号跳转、差异对比、扩展管理等高级功能。窗口分屏(Snap)和坐标级鼠标控制让多任务布局变得精准可控。此外,脚本设计遵循最小权限原则,截图和剪贴板操作均限定在本地文件系统,无网络外传风险。文档中的安全规则设计体现了作者的风险意识,对关闭窗口、终止进程等敏感操作设置了明确的前置确认要求。

潜在缺点与局限性

作为 Windows 专属方案,该技能无法跨平台使用,限制了其在混合环境中的应用场景。PowerShell 执行策略的 Bypass 要求可能触发企业安全策略的拦截。输入模拟依赖窗口聚焦状态,若目标应用响应延迟或存在多窗口架构,可能出现输入错位。部分系统级进程操作需要管理员权限,脚本对此仅作提示而非自动提权,用户体验存在断点。此外,脚本以 .ps1.txt 形式分发,用户需手动重命名和部署,增加了初始化复杂度。

适合的目标群体

该技能特别适合以下用户:Windows 平台开发者(尤其是 VSCode 重度用户)、需要批量处理窗口布局的运营和测试人员、追求工作流自动化的效率极客,以及构建本地 RPA(机器人流程自动化)的技术团队。对于需要频繁在多个应用间切换、执行重复性输入操作或监控特定进程状态的场景,该技能能显著减少手动干预。

使用风险

主要风险集中在进程终止和输入模拟两大功能。Stop-Process 的强制终止可能导致数据丢失,尽管文档要求用户确认,但自动化场景下仍可能因误判造成损失。键盘模拟若在未正确聚焦的窗口执行,可能将敏感输入发送至错误应用。长期运行大量输入模拟可能触发部分应用的风控机制。此外,PowerShell 脚本的执行依赖本地环境配置,ExecutionPolicy 调整可能带来额外的攻击面暴露。建议用户在关键操作前启用系统还原点,并在隔离环境中充分测试自动化流程。

安全解读

核心用法

desktop-control 是一套 Windows 平台专用的桌面自动化工具集,通过 5 组 PowerShell 脚本实现全方位系统操控:

窗口管理(app-control.ps1):启动/关闭/聚焦应用、调整窗口位置与大小、支持分屏贴靠(snap),兼容标题模糊匹配与 PID 精准定位。

输入模拟(input-sim.ps1):模拟键盘输入文本、组合快捷键(Ctrl+S、Alt+Tab 等)、特殊功能键,以及鼠标点击、移动、滚轮操作。执行前需先聚焦目标窗口。

VSCode 深度集成(vscode-control.ps1):通过 code CLI 打开文件/文件夹、跳转指定行、对比文件差异、管理扩展插件、触发命令面板及内部命令。

进程管控(process-manager.ps1):列出/筛选进程、查看详细信息、启动新进程、终止异常进程(需用户确认)。

系统信息(screen-info.ps1):枚举显示器参数、获取当前活动窗口详情、截取屏幕/特定窗口截图、读写剪贴板内容。

显著优点

  • 完全本地化:无任何外部网络调用,数据零外泄,隐私风险极低
  • 功能完整:覆盖从窗口管理到 IDE 控制的完整自动化链路
  • 安全透明:PowerShell 源码清晰可读,无混淆、无动态代码加载
  • 文档规范:内置多重安全提示(关闭前确认、终止前确认、剪贴板覆盖警告)
  • 零依赖:纯 Win32 API 与 .NET Framework 调用,无第三方库

潜在缺点与局限

  • 平台受限:仅支持 Windows,macOS/Linux 用户无法使用
  • PowerShell 执行策略:需使用 -ExecutionPolicy Bypass,企业环境可能被组策略限制
  • T3 来源等级:个人开发者维护,长期维护与更新稳定性存疑
  • 权限要求:部分系统级操作需管理员权限,未明确区分提示
  • 窗口识别精度:依赖窗口标题模糊匹配,同名窗口可能误操作

适合人群

  • 需要批量自动化 Windows 工作流的高级用户与开发者
  • 希望通过 AI 助手远程操控本地桌面环境的效率追求者
  • 对隐私敏感、拒绝云端方案的企业内网环境用户
  • VSCode 重度使用者,需自动化代码导航与项目管理

常规风险

  • 输入误发:未正确聚焦窗口时,键盘/鼠标模拟可能作用于错误目标
  • 进程误杀:虽要求用户确认,但快速操作中可能疏忽导致数据丢失
  • 剪贴板覆盖:读写剪贴板未提供历史恢复机制,存在内容丢失风险
  • 脚本注入:若用户参数未过滤直接拼接,理论上存在命令注入可能(需验证实际脚本)
  • 执行策略绕过:长期使用 Bypass 模式可能降低整体安全警觉性

desktop-control 内容

scripts文件夹
手动下载zip · 15.7 kB
app-control.ps1.txttext/plain
请选择文件