# KeyGenie **Repository Path**: guudevening/key-genie ## Basic Information - **Project Name**: KeyGenie - **Description**: 桌面自动化工具,支持键盘鼠标操作步骤录制回放,项目代码通过AI生成 - **Primary Language**: Python - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-21 - **Last Updated**: 2026-07-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # KeyGenie 键灵 通过AI生成的一个 Windows 桌面自动化工具(类按键精灵):录制鼠标键盘操作生成脚本, 编辑后按循环次数与倍速回放。提供深色主题图形界面与命令行两种用法。 ## 功能特性 - **全局录制**:一键录制鼠标点击/滚动/拖动与键盘输入,自动合并连续字符、 识别双击与组合键,按真实间隔生成步骤延迟;两次操作间隔超过 3 秒时 自动插入相应时长的「等待」步骤;按住鼠标从 A 拖到 B 记为一条 「鼠标拖动」步骤(回放时按住按键还原拖动)。鼠标移动轨迹默认不记录, 可在设置中开启 - **六种步骤类型**:⏳ 等待、🖱 鼠标拖动 / 点击 / 滚动、⌨ 键盘按键、📝 文本输入 - **分列步骤列表**:序号 / 类型 / 属性 / 前延后延分列显示,拖拽排序、 勾选启用、复制、删除、右键插入、一键清空(二次确认) - **右侧属性栏实时编辑**:选中即改、改即生效;时间以秒为单位, 数值框带 +/- 微调按钮 - **灵活的节奏控制**:每个步骤独立的前延迟 / 随机前延 / 后延迟; 整体循环 1~10 次、0.5x~4x 倍速回放 - **三种文本输入**:明文 / 密码(Windows DPAPI 加密,明文绝不落盘)/ 表达式(回放时实时求值,如 `date(now()+1d, "yyyy-MM-dd")`) - **全局热键**:F9 录制、F10 回放、F12 紧急停止(可在设置中修改); 回放中把光标推到屏幕左上角可 fail-safe 急停 - **GUI + CLI 双模式**:无参数启动图形界面,带子命令走命令行 ## 运行环境 - Windows 10 / 11(密码加密依赖 Windows DPAPI) - Python 3.10+ - 依赖:PySide6、pynput(见 `requirements.txt`) ## 快速开始(源码运行) ```bat python -m venv .venv .venv\Scripts\activate pip install -r requirements.txt python -m keygenie ``` ## 打包 exe ```bat scripts\build_exe.bat rem 或:python scripts\build_exe.py (窗口模式,默认推荐) rem python scripts\build_exe.py --console (传统控制台模式,备用) ``` 产物为单文件 `dist\KeyGenie.exe`,附带示例脚本 `dist\scripts\demo.json`。 默认窗口模式**一个 exe 同时支持 GUI 与 CLI**:双击打开图形界面; 在终端中执行 `KeyGenie.exe run ...` / `KeyGenie.exe list` 时, 程序会自动附加到当前终端显示输出。 ## 命令行用法 ```bat keygenie run <脚本文件> [--loop N] [--speed X] [--silent] [--timeout SEC] keygenie list ``` - `--loop`:循环次数,0 为无限循环(默认取脚本设置) - `--speed`:速度倍率(默认取脚本设置) - `--silent`:静默模式,不打印进度 - `--timeout`:超时秒数,超时自动停止 - 回放期间可按 F12 紧急停止 退出码:`0` 成功 / `1` 参数或脚本错误 / `2` 回放被中止 / `3` 表达式求值失败。 ## 全局热键(默认) | 热键 | 功能 | | --- | --- | | F9 | 开始 / 停止录制 | | F10 | 回放 / 停止回放 | | F12 | 紧急停止一切录制与回放 | > 这三个控制热键本身不会被录入脚本,避免回放时注入的按键再次触发热键、 > 造成录制/回放状态错乱。 ## 脚本文件格式 脚本为 UTF-8 JSON(`"format": "keygenie-script", "version": 1`), 包含名称、设置(循环次数、速度等)与步骤数组,可用任意文本编辑器查看。 GUI 中通过「打开 / 另存为」读写本地任意路径。 **密码安全**:密码步骤在文件中只保存 DPAPI 密文(`dpapi-user-v1:...`), 密文与本机 + 当前 Windows 用户绑定,明文绝不落盘;解密只发生在回放瞬间的 内存中。脚本拷贝到其他机器或其他用户下,密码步骤将无法解密(保护特性)。 明文与表达式步骤不做加密,请勿在其中写入口令。 ## 项目结构 ``` keygenie/ ├── __main__.py # 入口:有参数走 CLI,无参数启动 GUI ├── cli.py # 命令行:run / list ├── core/ # 与界面无关的核心逻辑 │ ├── recorder.py # 全局录制(pynput) │ ├── player.py # 回放引擎(线程、倍速、急停) │ ├── steps.py # 步骤模型与 JSON 序列化/校验 │ ├── sender.py # 键鼠发送(SendInput) │ ├── expression.py # 表达式解析与求值(自研,不执行任意代码) │ ├── crypto_dpapi.py # DPAPI 加解密 │ └── ... # 热键 / CapsLock / 输入法布局 └── ui/ # PySide6 界面 ├── app.py # 入口、深色主题 QSS ├── main_window.py # 主窗口 ├── step_list.py # 分列步骤列表 ├── property_panel.py# 右侧属性栏 ├── step_editors.py # 各类型属性表单 └── assets/ # logo 与加减图标 tests/ # pytest 测试(90+,含离屏 GUI 冒烟) scripts/ # build_exe / generate_assets / demo.json ``` ## 开发 ```bat pip install -r requirements.txt python -m pytest tests/ # 运行全部测试 python scripts/generate_assets.py # 重新生成 logo 与图标资源 ``` ## 安全与合规提醒 本工具会模拟真实的键盘鼠标输入,请仅在你拥有或被明确授权的设备与 应用上使用,遵守目标软件的服务条款与相关法律法规。 ## 许可证 本项目以 [MIT License](LICENSE) 开源。