（2545期）Handsfree Windows Control – Windows 桌面与浏览器自动化 CLI 工具

Windows 桌面与浏览器自动化 CLI 工具 通过本地 CLI 工具实现 Windows 桌面应用与浏览器自动化，支持 UIA 控件发现与 Playwright 网页操控，适合需要录制回放混合工作流的技术用户。 使用说明 核心用法 Handsfree Windows Control 是一套基于 CLI 的 Windows 自动化解决方案，整合两大技术栈： 桌面应用自动化：基于 Microsoft UI Automation (UIA) API，支持通过控件名称、类型等属性精准定位元素，无需依赖屏幕坐标。 浏览器自动化：基于 Playwright，支持 Chromium 内核的网页操控，自动保存登录会话与 Cookie。 首次使用需运行 python scripts/setup.py 自动安装依赖（约 200MB 浏览器二进制文件），支持自定义安装路径与跳过浏览器安装。 典型工作流 桌面应用：hf start 启动应用 → hf tree 或 hf inspect 发现控件 → hf click/type 执行操作浏览器：hf browser-open 打开页面 → hf browser-snapshot 检查结构 → hf browser-click/type 交互 → hf browser-screenshot 验证混合宏：通过 YAML 文件串联桌面与浏览器步骤，用 hf run 批量回放 显著优点 透明可控：所有安装路径、持久化数据（浏览器配置、会话状态）均明确文档化，卸载命令完整提供 结构化发现：强制要求先执行 tree/inspect/browser-snapshot 再操作，避免基于坐标的脆弱脚本 混合场景支持：单一 YAML 宏可无缝衔接桌面应用与网页操作，适合企业级端到端测试 会话持久化：浏览器登录状态自动保存，减少重复认证 潜在局限与风险 | 维度 | 说明 ||------|------|| 平台锁定 | 仅支持 Windows，依赖 PowerShell 执行环境 || 权限要求 | UIA 操作需应用窗口可见且未最小化，部分安全软件可能拦截 || 维护状态 | 依赖 handsfree-windows 开源仓库（公开只读），版本更新依赖社区 || 浏览器体积 | Chromium 二进制约 800MB，首次下载耗时 || 凭证安全 | 明确禁止脚本输入密码，需人工介入登录环节，设计合理但降低全自动化程度 | 适合人群 QA 工程师：构建跨桌面-网页的端到端测试套件 高级用户：自动化重复性办公流程（报表生成、数据录入） 开发者：调试 UIA 控件树结构或 Playwright 选择器 常规风险 破坏性操作：delete/submit/send 等命令强制要求人工确认，误触风险可控 隐私泄露：浏览器配置文件含敏感 Cookie，需妥善保护 ~/.handsfree-windows/browser-profiles/ 目录 依赖漂移：Playwright 与 Chromium 版本绑定，系统更新后可能出现兼容性断裂 原始说明 Guide skill for controlling native Windows apps (UIA) and web browsers (Playwright) via the handsfree-windows CLI. Use when you need to automate or test desk...