基于 Python 3.10.9 的简易按键精灵项目，提供在 Windows 平台下的 GUI 自动化体验。

• 自定义开始/结束热键控制脚本执行
• 通过 GUI 维护自动化脚本，支持“匹配图片并点击”和“匹配图片按键”动作
• 设置全局动作间隔，执行时自动等待
• 支持循环执行脚本，可配置循环次数与循环间隔
• 支持脚本一键导入导出，便于备份与分享
• 运行状态提示，失败时弹窗提示原因
• 可通过 PyInstaller 打包为独立 exe，便于分发
• 应用自带图标 (logo.png) 并会在启动时自动请求管理员权限

• Windows 10/11
• Python 3.10.9

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

python app.py

1. 激活虚拟环境：

   .\env\Scripts\Activate.ps1

2. （首次）安装 PyInstaller：

   pip install pyinstaller

3. 准备图标文件：

   python -c "from PIL import Image; Image.open('logo.png').save('logo.ico')"

4. 执行打包命令：

   pyinstaller --onefile --noconsole --name key_sprite --paths src --icon logo.ico --add-data "logo.png;." app.py

   • --noconsole 会关闭控制台窗口；若需查看日志可移除。
   • --icon 指定程序图标；--add-data 将 logo.png 一并打包供界面使用。
   • --paths src 让 PyInstaller 能正确找到 key_sprite 包。
   • 输出文件位于 dist/key_sprite.exe，build/ 为临时目录，可在检查后删除。
   • 生成的 key_sprite.spec 保存了配置，可通过 pyinstaller key_sprite.spec 复用。
5. 测试与权限：
   • 建议在无 Python 环境的 Windows 机器上测试，确认截图、热键、导入导出等功能正常。
   • 应用启动时会自动检测并请求管理员权限，如被拒绝将直接退出。
6. 其他注意事项：
   • 如需自定义图标，可在命令中加入 --icon 路径\your_icon.ico。
   • 若出现库缺失提示，可在打包命令增加 --hidden-import 参数，或编辑 .spec 文件添加数据/依赖。
   • 打包后的 exe 可能被部分安全软件误报，必要时请进行数字签名或加入白名单。

1. 输入开始与结束热键，点击“应用热键”。
2. 利用“添加图像点击”或“添加图像按键”配置动作并设置参数，可通过“导出脚本”保存配置，“导入脚本”快速恢复。
3. 设定全局间隔、循环次数（0 为无限循环）和循环间隔后，使用热键或“立即开始”按钮启动脚本。
4. 执行过程中可通过结束热键或“停止运行”终止。

后续可在 key_sprite/automation 中扩展更多动作类型。