核心功能与用法
claw-windows-automator 是一款专为 Windows 环境打造的高容错桌面自动化引擎，通过统一 CLI 入口将 LLM 与底层系统操作无缝衔接。核心提供两大任务能力：
1. `cmd_task` —— 在指定目录自动唤起 CMD 并执行任意命令或 bat 脚本，内置失败重试与容错继续模式，适合项目初始化、批量部署、依赖安装等场景。
2. `github_download` —— 智能解析 GitHub 仓库 /releases/latest 页面，自动触发浏览器下载最新源码 ZIP，省去手动查找版本号的繁琐步骤。
所有任务均伴随全屏半透明 Overlay 实时进度提示，用户可通过鼠标左键单击强制终止任务，兼顾自动化效率与人工干预安全。脚本还会自动调用 Windows API 将输入法切换为英文，避免中文输入法干扰命令执行。
显著优点
- 可视化安全保障：Overlay 提示 + 鼠标一键停止，解决传统自动化"黑箱运行、无法中断"的痛点
- 零配置开箱即用：纯 Python 实现，仅需系统自带 python/python3，无需额外依赖安装
- 高容错设计：
continue_on_error模式确保单点失败不阻断整体流程 - 输入法智能处理：自动切换英文输入，消除中文环境下 CMD 命令被意外转换的隐患
潜在局限与风险
- Windows 独占：仅支持 Windows 平台，macOS/Linux 用户无法使用
- GUI 依赖：Overlay 与 pyautogui 操作需要图形界面，远程无头服务器场景受限
- 浏览器自动化限制：GitHub 下载依赖本地浏览器触发，若浏览器未安装或网络受限可能失败
- 权限问题：部分 CMD 操作需要管理员权限，普通用户可能遭遇 UAC 拦截
适合人群
Windows 开发者、运维工程师、需要批量初始化项目或频繁从 GitHub 拉取最新版的技术用户，尤其适合追求"看得见、停得了"安全自动化体验的场景。
常规风险提示
- 执行未知来源的 bat 脚本或命令前需确认安全性
- 自动下载的 GitHub 包建议校验哈希或签名
- 高权限命令建议在隔离环境或虚拟机中先行测试