Windows 键盘连点 / 定时按键小工具 —— 连点 · 定时序列 · 多配置页 · 前台窗口匹配锁定
用 Python + PyQt6 编写。连点按键与按键序列都可以按下即录入(不用手写键名),自带全局热键与紧急停止。v1.3.0 起界面重做为现代风:左侧工作区导航 + 白色卡片内容区,布局参考清风输入法设置页;状态胶囊、键帽式按键、自绘图标、空状态引导,并保留浅色 / 深色双主题。
🔒 纯本地程序:不联网、不上传任何数据、不需要账号或密钥。 📦 绿色便携:提供单文件 exe 与便携目录 zip 两种形态,配置就写在程序旁边的
clicker_config.json,整个文件夹拷到别的电脑也不丢。
- 最新 Release
- 推荐
KeyClicker-portable.zip(解压整个文件夹后运行);需要单文件时用KeyClicker.exe - 代码签名:Windows 二进制使用 SignPath Foundation 提供的免费开源代码签名(申请审核中;通过后 Release 资产会签名)
- 隐私:程序不联网、不收集数据,详见 PRIVACY.md
v1.3.0 左:深色主题 · 右:浅色主题(一键切换并记忆,首次运行跟随系统)
| 使用 | 深入 |
|---|---|
| 下载 · 功能特性 · 快速开始 · 使用说明 | 配置文件位置 · 常见问题(FAQ) |
| 连点模式 · 定时序列 · 前台窗口匹配锁定 | 从源码打包 exe · 发布 Release · 测试 · 项目结构 |
| 浅色 / 深色主题 · 多配置页 · 全局热键 · 性能 | 更新日志 · 免责声明 · 许可证 |
- 按固定间隔持续发送指定按键,间隔下限 16 ms(理论上限约 62.5 次/秒,实测约 59 次/秒)
- 支持组合键:
ctrl+f9、ctrl+shift+a、alt+1… - 「● 录入」按钮:按下键盘上任意按键(或组合键)即可录入,Esc 取消录入
- 实时显示已发送次数,可随时暂停 / 继续 / 停止
- 设定「分 + 秒」倒计时,到点后按顺序依次发送一串按键(如
f5 → 1 → 2 → enter) - 序列中每一步都支持组合键,步骤之间可设置间隔(下限 16 ms)
- 支持循环触发,显示本次剩余时间与已触发次数
- 序列编辑器支持「● 开始录入」逐个按键录入,也支持手动输入 / 逗号分隔批量输入
- 「按键序列」整块用强调色底托起,浅色与深色主题下都能一眼看清这块是序列设置
- 每个任务都可以设置「仅在指定窗口处于前台时才生效」,避免切到别的窗口后误按键
- 匹配方式三种:包含(默认,窗口标题包含关键词即可)、精确(标题完全一致)、正则(
re.search语法,大小写不敏感) - 关键词留空即不限制;非法正则表达式会在添加任务时给出中文提示,不会被接受
- 「抓取当前窗口」按钮:点击后有 3 秒倒数(按钮显示「3 秒…」),倒数结束再抓取当前前台窗口标题,并在状态栏提示抓到的是什么程序的窗口
- 抓取时会拒绝记录本程序自己的窗口——如果不是在倒数期间切到目标窗口,会弹出中文提示而不是填进一个没用的标题
- 关键词输入框是可编辑下拉框:点开即列出当前所有可见窗口标题,直接选一个即可,也可以自己手输关键词
- 下拉框只列看得见的窗口:被程序挪到屏幕外"藏"起来的隐藏窗口(截图工具、输入法之类,比如 Snipaste 的「自定义截屏」)会被自动过滤掉,不会变成噪声条目
- 任务运行中如果当前前台窗口不匹配:连点照常走节拍但一个键都不发、次数不增长;定时任务倒计时照常走但到点不触发,任务行上会显示「窗口不匹配」提示
- 布局参考清风输入法设置页:左侧品牌 / 导航栏 + 右侧内容区,选中项浅蓝底 + 左侧蓝条;白色卡片铺在浅蓝灰画布上
- 卡片与控件:10px 卡片圆角、1px 浅边框、卡片标题左侧蓝色竖条;表单行左标签 / 右控件的设置页排布
- 语义化配色:蓝色主操作;「全部停止」改为描边红;类型徽章 / 状态胶囊使用软色底
- 响应式:920×640 最小窗口下也不横向溢出;长按键序列显示为「前几步 + 共 N 步」摘要(完整内容在 tooltip),长窗口标题按宽度省略
- 自绘图标:任务行的播放 / 暂停 / 停止 / 删除用 QPainter 绘制,不依赖系统字体是否带
▶/■/✕字形,缺字体的精简系统也不会出现方框 - 空状态:没有任务时显示 logo + 引导文案,不再是屏幕中央一行灰字
- 字体只设一次:改用应用级字体(不再用 QSS
*选择器给每个控件单独设置),中文按钮与状态文字不落到等宽字体 - 侧栏「偏好」里的「切换到浅色 / 深色」一键换肤并保存;首次运行跟随 Windows 系统主题
- 主题由主题字典 + 动态生成样式表实现,控件不写死颜色;样式表按主题缓存,换肤即时且完整
- 任务类型、配置页、窗口匹配等下拉框都有悬停高亮、中文提示与圆角弹层;当前项右侧带圆润对勾,下拉箭头自绘
- 输入框 / 下拉框有 hover / focus 反馈,点窗口空白处自动失焦;状态栏常驻「本地运行 · 不联网」与热键提示
- 视觉与布局参考 清风输入法 设置页,没有复用其代码;深色主题为同构设计
- 多套互不干扰的独立配置页,可新增 / 重命名 / 删除
- 任何改动自动保存,配置写入采用「临时文件 + 原子替换」,断电或崩溃不会写坏配置
- 兼容旧版本配置文件(旧版顶层数组格式、未知字段、缺失的新字段都会被安全处理)
| 热键 | 作用 |
|---|---|
Ctrl + ` |
开始 / 停止当前页的全部任务 |
F6 |
紧急停止:停止所有页面的全部任务 |
正在录入按键时,全局热键会自动暂时失效——这样你才能把
F6本身录成连点键。
- 换肤:样式表按主题缓存(生成约 0.002ms,旧实现约 0.065ms),只重设主窗口这一棵子树;实测整窗换肤约 12ms(本机 9.9~12.1ms)
- 自适应轮询:空闲时 1 秒/次(旧版固定 250ms/次),有任务运行 / 暂停 / 窗口阻塞时切到 100ms/次;窗口隐藏或最小化时完全不刷新
- 配置写入防抖:连续改参数只在停手 250ms 后落盘一次,仍使用「临时文件 + 原子替换」;关闭窗口时强制 flush,不丢配置
- 紧急停止不排队:F6 / 全部停止改为「先通知全部任务、再逐个收尾」,不再一个任务最多等 0.8 秒
- 窗口枚举更省:枚举窗口时虚拟屏幕尺寸只取一次(旧版每个窗口 4 次 Win32 调用);窗口列表没变时下拉框直接复用条目,不重建模型
- 定时序列只解析一次:启动时缓存解析后的键名,循环触发不再反复切分字符串
- 连点跑满节拍:最小间隔 16ms,实测约 59 次/秒(理论上限 62.5);节拍 ≥ 40ms 时按住时长仍是 20ms,手感与旧版一致
- 节拍不漂移:任务按固定节拍推进,并开启 1ms 计时精度
- 打开 Releases 页面
- 优先下载
KeyClicker-portable.zip:解压整个文件夹后运行其中的KeyClicker.exe - 需要单文件时再下载
KeyClicker.exe;同页有对应的.sha256校验文件 - 双击运行(建议右键 → 以管理员身份运行,见下方 FAQ)
| 产物 | 大小 | 特点 |
|---|---|---|
KeyClicker-portable.zip |
约 27 MiB | 目录版,启动时不解包到 %TEMP%;单文件版报 Could not create temporary directory! 时用这个 |
KeyClicker.exe |
约 26 MiB | 单文件绿色版,解压/启动时会先释放到临时目录 |
两种形态都无需安装 Python,配置默认保存在 程序同目录的 clicker_config.json,方便随身携带(详见下方「配置文件位置」)。
pip install -r requirements.txt
python keyclicker.py要求 Python 3.9+(开发环境为 Python 3.14)。这条路径使用 Python 官方签名的解释器启动,不会触发本程序的 SmartScreen 提示,适合不想签名的自用场景。
- 连点:点击按键输入框旁的「● 录入」→ 按下想连点的按键(或组合键)→ 设置间隔(毫秒)→ 需要时填写窗口匹配关键词 → 点「添加到任务列表」。
- 定时序列:点「点击设置序列」→ 用「● 开始录入」逐个按下按键,或在输入框手动输入(支持
ctrl+f9, 1, enter这种逗号分隔写法)→ 回到面板设置分 / 秒与间隔 → 点「添加到任务列表」。 - 窗口锁定:在添加任务卡片的「仅在前台窗口匹配时生效」一行填写关键词、选择匹配方式;不确定当前窗口标题时点「抓取当前窗口」自动填入。留空表示不限制。
- 多套配置:顶部操作栏「+ 新建配置页」新增,「重命名」「删除页」管理页面,改动自动保存。
- 主题与选项:侧栏「偏好」里的「切换到浅色 / 深色」切换主题;「配置目录」「关于」也在侧栏直接打开。
- 按键名写法:使用
keyboard库的规范名,常见别名会自动转换 ——win/super/cmd→windows,control→ctrl,pgup→page up,ins→insert,prtscn→print screen。无法识别的键名会给出中文提示,不会静默失败。
v1.2.4 起默认就是便携模式:配置存在程序自己旁边,换电脑连同 exe 一起拷走就不会丢。
| 顺序 | 位置 | 什么时候用 |
|---|---|---|
| 1 | 环境变量 KEYCLICKER_CONFIG 指定的路径 |
你手动指定了就用它(优先级最高) |
| 2 | 程序目录下已有的 clicker_config.json |
已经在用便携配置,继续用这个 |
| 3 | 程序目录 clicker_config.json |
默认。程序目录可写时(绿色版 / 解压即用)就用它 |
| 4 | %APPDATA%\KeyClicker\config.json |
只在程序目录不可写时兜底(例如装在 C:\Program Files 下) |
「程序目录」指 exe 所在目录(源码运行时是脚本目录)。
- 换电脑:把 exe 和同目录的
clicker_config.json一起拷过去,任务、序列、主题全都在 - 从旧版本升级:如果便携位置还没有配置,程序会自动把
%APPDATA%里的旧配置复制过来,不会出现"任务全没了"(只复制不删除,旧文件仍保留) - 不写注册表、不写系统目录;配置写入采用「临时文件 + 原子替换」,断电或崩溃不会写坏配置
- 程序目录只读时自动退回
%APPDATA%,不会因为写不进去而报错或丢配置
侧栏「配置目录」可以直接打开配置所在文件夹,一眼看到配置到底存在哪。
Q:为什么在游戏里按键没反应?
A:以管理员身份运行本程序;另外部分游戏使用 DirectInput / 内核级输入,会忽略 keybd_event 级别的模拟输入,这类游戏需要驱动级方案,本工具无法绕过。
Q:录入了却没反应 / 提示"启动键盘钩子失败"?
A:keyboard 库的全局钩子需要足够权限,请右键「以管理员身份运行」。此时仍可在输入框手动输入键名。
Q:运行单文件 exe 提示 "Could not create temporary directory!"?
A:这是 PyInstaller 单文件版把自身解包到 %TEMP% 时失败,不是程序里的字典 / 配置错误。优先改用 Release 里的 KeyClicker-portable.zip(目录版启动时不解包到临时目录)。如果坚持单文件版,检查 %TEMP% / %TMP% 是否存在、磁盘空间是否足够、Windows 安全中心是否拦截了临时目录写入,或把 exe 换到 C:\KeyClicker\ 再试。
Q:为什么旧版不弹 SmartScreen,新版却弹?
A:SmartScreen 按文件哈希 + 下载信誉评估,不是按项目名。旧版 exe 同样未签名(v1.2.4 实测 NotSigned,已有 257 次下载),不弹通常是因为旧文件已积累信誉、你本机已经放行过,或下载方式没有带上 Mark-of-the-Web。任何重新构建都会改变哈希,新文件从零开始评估,所以这不是本次 UI 改动引入的 bug。仅用于你确认过的本地文件可以右键属性 → 解除锁定,或执行 Unblock-File .\KeyClicker.exe 去掉 MOTW;面向用户发布仍应走签名。
Q:Windows 提示 "Windows 已保护你的电脑" / SmartScreen? A:这是未签名程序的信誉提示,不等于杀毒报毒。SmartScreen 只认签名与下载信誉,改代码、换打包格式、加版本资源都无法消除。 临时继续:确认来源和 SHA-256 后点「更多信息 → 仍要运行」。想长期改善:签名能让发布者身份稳定,但 OV / EV 首次下载仍可能提示,信誉需要积累(微软 2024 年起不再把 EV 当作即时绕过);官方唯一保证无提示的是 Microsoft Store(MSIX,商店重新签名),或者改用源码运行。仓库的 Release 工作流已内置 PFX 签名支持,配置见 docs/RELEASING.md。
Q:Windows Defender / 杀毒软件报毒? A:PyInstaller 产物被启发式误报很常见,键盘钩子类工具更容易触发。优先用目录版、核对 SHA-256、从源码构建,或向 Microsoft 提交误报;不要把关闭杀软作为长期方案。
Q:配置文件在哪?会写入系统目录吗?
A:v1.2.4 起默认就在程序自己旁边(clicker_config.json),不写注册表、不写系统目录;程序目录只读时才退回 %APPDATA%\KeyClicker\config.json。详见上方「配置文件位置」。
Q:设了窗口匹配,任务显示"窗口不匹配"怎么办? A:说明当前前台窗口标题没有命中你填的关键词。可以点「抓取当前窗口」重新获取准确标题,或改用「包含」模式只填标题里的一段关键词;「精确」模式要求标题完全一致。窗口下拉框里只列看得见的窗口,被程序挪到屏幕外"藏"起来的隐藏窗口不会出现在里面。
Q:间隔设到最小的 16ms,为什么达不到 62.5 次/秒? A:16ms 对应理论上的 62.5 次/秒,剩下的差值是按键注入本身的开销,实测约 59 次/秒。另外间隔 ≥ 40ms 时按键会保持按住 20ms(和旧版手感一致),只有间隔更短时按住时长才自动缩短(下限 10ms),所以最小间隔也能真的跑满。
Q:能连点鼠标吗?
A:不能。本工具只发送键盘按键(含 ctrl+f9 这类组合键),鼠标连点不在功能范围内。
Q:换台电脑后任务全没了?
A:v1.2.4 起配置默认就在 exe 同目录的 clicker_config.json,把 exe 和它一起拷过去即可;如果你是从旧版本升级过来的,程序会自动把 %APPDATA% 里的旧配置复制到便携位置并在状态栏提示。详见上方「配置文件位置」。
Q:热键没生效?
A:Ctrl+` 可能被其他软件占用,或程序权限不足(需与目标窗口同级或更高权限)。
Q:会记录我的按键历史吗? A:不会。键盘钩子只在点击「录入」期间临时开启、录入完成立即卸载,按键不落盘、不外发;程序本身也不联网。
pip install pyinstaller PyQt6 keyboard
python -m PyInstaller KeyClicker.spec单文件产物为 dist/KeyClicker.exe;目录版产物为 dist/KeyClicker/KeyClicker.exe(不写临时目录,受限环境推荐)。也可以直接运行 build.bat,它会依次构建两种形态。
# 目录版(onedir,推荐随 Release 一起分发)
python -m PyInstaller --noconfirm --workpath build-portable --distpath dist KeyClicker-portable.spec提示:打包后的 exe 可以放在任意目录运行,配置默认写在 exe 同目录的
clicker_config.json(便携),换电脑连 exe 一起拷走即可;只有 exe 所在目录不可写时才退回%APPDATA%\KeyClicker\。
不需要任何 API Key / PAT / 密码。 推送 v* tag 后,GitHub Actions 会使用 GitHub 自动签发的 GITHUB_TOKEN 完成测试、打包和 Release:
| 用途 | Secret 名称 | 是否必需 |
|---|---|---|
| 创建 GitHub Release | GITHUB_TOKEN |
自动提供,无需配置 |
| 可选 Windows 代码签名 | WINDOWS_CERT_PFX_BASE64 / WINDOWS_CERT_PASSWORD |
否(工作流已内置;配置后自动签名) |
git tag -a v1.3.0 -m "KeyClicker v1.3.0"
git push origin v1.3.0工作流会校验 tag 与 keyclicker.__version__ 一致,同时上传 KeyClicker.exe、KeyClicker-portable.zip 及各自的 SHA-256 校验文件,并自动生成 Release Notes。配置了上面两个签名 Secret 时,会在打包 zip / 计算哈希前自动签名并校验;没有证书则跳过,SmartScreen 仍可能出现。详细步骤、签名方式与安全红线见 docs/RELEASING.md。
python -m unittest discover -s tests -v共 143 个用例,覆盖:按键名解析与校验、连点/定时任务的启停与节拍、按住时长随节拍自适应(且保证塞得进节拍)、前台窗口匹配(包含/精确/正则/空关键词/非法正则/大小写)、窗口锁定下不下发按键、主题生成与切换持久化、换肤只重设主窗口(不再重算整个应用)、配置文件路径优先级(环境变量 / 便携优先 / 只读兜底 / 旧配置自动迁移)、配置往返与旧格式兼容、按键录入器(组合键、长按去重、Esc 取消、修饰键忽略)、界面构建与热键行为、界面细节(序列区配色令牌、「点击设置序列」字重与前景色、下拉框悬停样式、窗口下拉框行为、点空白处失焦、图标加载)、窗口下拉框的屏幕外隐藏窗口过滤(多显示器 / 部分可见 / 拿不到屏幕尺寸时不误杀)、源码中不许出现抢前台调用、圆角下拉与自绘箭头(像素级断言)、列表项选中高亮与对勾、下拉弹层圆角卡片(四角透明像素断言)、序列区实线边框、状态栏常驻热键提示、窗口抓取倒数与自我保护、v1.3.0 的 QSS 缓存与主题令牌、自适应轮询、防抖保存、自绘图标按钮、空状态与头部 logo、长序列摘要与宽度省略。测试使用 Qt 的 offscreen 平台,无需显示器,也不会读写真实的用户配置目录。
keyclicker.py 主程序(单文件,约 3440 行)
KeyClicker.spec 单文件 exe 打包配置
KeyClicker-portable.spec 便携目录版(onedir)打包配置
version_info.txt Windows 文件属性里的产品名 / 版本资源
logo.png / logo.ico 程序图标(打包进 exe,作为窗口与任务栏图标)
docs/logo.svg Logo 源文件(矢量)
docs/screenshot.png 界面截图(深色主题,1280×860)
docs/screenshot-light.png 界面截图(浅色主题,1280×860)
docs/RELEASING.md 发布流程(无需密钥)/ 可选代码签名
tools/make_screenshots.py 生成 README 截图(临时配置,不碰本机配置)
tests/test_keyclicker.py 单元测试(143 个用例,标准库 unittest)
requirements.txt 运行依赖
build.bat 一键打包脚本
PRIVACY.md 隐私政策(不联网 / 不收集数据)
SECURITY.md 安全与隐私说明
.github/workflows/ci.yml CI:push / PR 跑 143 个测试
.github/workflows/release.yml tag 发布:测试 → 打包 → GitHub Release
- 界面重做(清风设置页风格):左侧品牌 / 工作区导航 + 右侧内容区,选中项浅蓝底 + 左侧蓝条;白色卡片铺在浅蓝灰画布上,卡片标题带蓝色竖条;任务行加入类型徽章、状态胶囊、左侧状态色条与悬浮反馈;空列表改为 logo + 引导文案
- 响应式:长按键序列显示「前几步 + 共 N 步」摘要,完整序列放 tooltip;键帽与长窗口标题按可用宽度省略,920×640 最小窗口也不横向溢出
- 修复:任务行里的
▶ / ■ / ✕图标依赖系统字体回退,精简系统或缺字形时会变成方框——改为 QPainter 自绘图标按钮,深浅主题下都清晰 - 修复:键帽标签被竖向布局拉成整行长条——限制为内容宽度;徽章 / 状态胶囊固定 24px 高,不再被拉成整行色块
- 性能:样式表按主题缓存(缓存命中时生成 ~0.002ms),应用字体只设置一次(去掉 QSS
*选择器逐控件设置);换肤实测约 12ms - 性能:自适应轮询——空闲 1 秒/次、运行中 100ms/次,窗口隐藏 / 最小化时不刷新(旧版固定 250ms/次)
- 性能:配置写入防抖 250ms,关闭窗口强制 flush;连续改参数不再每一下都立即落盘
- 性能:F6 / 全部停止改为批量通知再收尾,不再一个任务等 0.8 秒;停止超时从 0.8s 收到 0.25s
- 性能:窗口枚举时虚拟屏幕尺寸只取一次(旧版每个窗口 4 次 Win32 调用);窗口下拉列表不变时复用条目;定时序列启动时只解析一次键名
- 发布:新增 GitHub Actions CI 与 tag 触发的 Release 工作流,使用自动
GITHUB_TOKEN,不需要任何 API Key / PAT;同时构建单文件 exe 与 onedir 便携目录 zip,上传两者及各自 SHA-256;详见 docs/RELEASING.md - 签名:Release 工作流增加可选 PFX 代码签名(两个 Secret),在打包 zip / 计算哈希前签名并校验两个 exe;签名失败会阻断发布,未配置则自动跳过。SmartScreen 只能靠签名 / 信誉或 Microsoft Store 渠道改善,不能靠改代码解决;Store 是官方唯一保证无提示的路径
- 修复(打包):单文件版在受限环境 / 安全软件下可能报
Could not create temporary directory!——新增KeyClicker-portable.spec,目录版运行时不再解包到%TEMP%;两种 exe 都写入 Windows 版本资源(产品名 / 版本可查) - 文档:README 截图更新为 v1.3.0(1280×860),新增发布说明、安全说明与截图生成脚本
- 测试:新增 11 个用例(QSS 缓存与主题令牌、自绘图标、任务行图标状态、自适应轮询、防抖保存、空状态、头部 logo、长序列摘要 / 按钮 / 任务行),测试总数 132 → 143
- 修复:配置不再是"换台电脑就丢"——v1.2.4 起默认写成便携配置,存在 exe 旁边的
clicker_config.json,连 exe 一起拷走配置就在(以前要手动放portable.flag才便携,等于默认不可携带)。程序目录只读时(如装在C:\Program Files)自动退回%APPDATA%;从旧版本升级时会自动把%APPDATA%里的旧配置复制过来并在状态栏提示,不会"任务全没了"(只复制不删除) - 修复:窗口下拉框里会混进看不见的窗口——有些程序(截图工具、输入法、Qt 隐藏窗口)把窗口挪到屏幕外"藏"起来,此时它依然是"可见且有标题"的窗口,于是跑到下拉框里变成噪声条目(例如 Snipaste 的常驻窗口标题就叫「自定义截屏」)。现在枚举窗口时会跳过与所有显示器都没有交集的窗口:这种窗口永远不可能成为前台窗口,过滤掉对「前台窗口匹配」没有任何影响(拿不到屏幕尺寸时不过滤,宁多列不误杀)
- 修复:「点击设置序列」文字发虚——原因是在「微软雅黑 UI」上 600/700 会落到真正的 Bold(该字体只有 Regular / Light / Bold 三档),13px 中文一加粗笔画就发糊。改为统一的界面字体 + 字重 500(实际回落 Regular),未设置序列时文字改用最实的前景色,不再靠浅色压浅底
- 说明:按键生效方式只有「前台窗口匹配」这一种,程序任何时候都不会去抢前台、不会切走你正在用的窗口
- 性能:切换主题不再卡一下——原先每次换肤都让 Qt 重算整个应用的样式表(实测 100
120ms),现在只重设主窗口(对话框、下拉弹层、右键菜单、提示气泡都是主窗口的后代,选择器结构相同,视觉结果完全一致),实测 **3544ms**(首次换肤 34.8ms);启动时那份应用级样式表会在首次换肤时先清掉,避免两份样式表叠加重算 - 性能:连点速度不再被固定的「按住 20ms」卡住——按住时长改为跟着节拍走(节拍 ≥ 40ms 时仍是 20ms,手感不变;节拍更短时才缩短,下限 10ms,保证 100Hz 轮询的程序也认),界面允许的最小间隔 16ms 实测从 48 次/秒提升到 59 次/秒(2 秒 96 次 → 119 次,理论上限 62.5 次/秒);定时序列的间隔同理
- 优化:新增 24 个回归用例(便携配置优先级与只读兜底、旧配置迁移只复制不覆盖、屏幕外窗口过滤、序列按钮字重与前景色、源码中不许出现抢前台调用、按住时长随节拍自适应且塞得进节拍、换肤只重设主窗口),测试总数 108 → 132
- 修复:下拉弹层外圈仍有突兀的直角方框(浅色主题下是白色底板 + 灰色方框,深色主题下框虽暗但仍可见)——弹层容器改为自绘圆角卡片:拦截容器自身的绘制事件,用抗锯齿画一张与主题一致的 9px 圆角卡片,圆角以外的像素保持透明,四角是真正的弧线,方角与方框彻底消失
- 修复:弹层圆角在部分情况下失效(Qt 会重建弹出容器)——每次展开前重新确认弹层外观,反复开关下拉都保持圆角
- 优化:列表背景改透明、由圆角卡片统一托底,长列表的滚动箭头不受影响,仍正常显示
- 优化:新增 7 个回归用例(弹层四角透明像素断言、卡面颜色跟随主题、容器半透明与过滤器挂载、反复展开不失效、过滤器只接管绘制事件、绘制异常回退、滚动箭头仍可见),测试总数 101 → 108
- 修复:深色主题下「按键设置序列」区域几乎看不出边框——序列区与「点击设置序列」按钮改为实线强调色边框(浅色
#54aeff/ 深色#388bfd),底色保留,两种主题下边界都清晰可见,同时界面中不再有任何虚线框 - 优化:所有下拉框(任务类型 / 配置页 / 窗口匹配)彻底圆角化:弹出列表改为无边框 + 半透明的圆角浮层,列表项选中改为圆角高亮块,当前项右侧显示圆润对勾,不再出现 PyQt 默认的直角方框
- 修复:下拉按钮(小三角)在浅色 / 深色下都看不清——改为自绘圆角箭头,悬停 / 展开 / 聚焦时变强调色,并压掉系统默认箭头与弹出容器的方角背景
- 优化:复选框 / 单选框指示器改为圆角并统一配色(选中填充强调色,悬停描边反馈)
- 修复:底部快捷键提示会被临时状态消息顶掉——热键提示改为状态栏常驻控件,临时消息不再覆盖它,并反映实际注册结果(失败时提示以管理员身份运行)
- 修复:抓取前台窗口容易抓到本程序自己的窗口——新增 3 秒倒数(按钮显示「3 秒…」),倒数结束后抓取,并拒绝写入本程序自身的窗口,状态栏同时显示抓到的进程名
- 优化:下拉框去掉「〇 连点」里的假单选圈;窗口下拉框、配置页下拉框统一为同一套圆角风格
- 优化:新增 17 个界面回归用例(圆角弹层、箭头像素、选中高亮像素、序列区实线边框、常驻提示、倒数抓取与自我保护),测试总数 84 → 101
- 新增:软件图标——矢量 Logo(
docs/logo.svg,键帽 + 连续触发弧线,GitHub Primer 蓝渐变),并导出logo.png/logo.ico作为窗口与任务栏图标 - 新增:窗口匹配关键词改为可编辑下拉框,点开即列出当前所有可见窗口标题(自动过滤隐藏窗口、输入法窗口与本程序自身),选中即填,也支持继续手输
- 新增:点窗口空白处自动让输入框 / 下拉框失去焦点,不再残留聚焦外框
- 修复:浅色主题下「按键序列」区域与卡片底色相同、看不出边界的问题——序列区改为独立的强调色底 + 边框(浅色淡蓝、深色深蓝),整体成块托起
- 修复:「点击设置序列」「已连点 N 次」「等待按键…」等中文文字误用等宽字体(Consolas 无中文,回退字体不统一)导致的违和感,统一改回界面字体
- 修复:下拉框(任务类型 / 配置页 / 窗口匹配)没有鼠标悬停反馈,且浅色主题下可编辑下拉会出现"框中框"与残留聚焦边框
- 优化:下拉框补齐悬停高亮、中文工具提示与手型光标;未填充状态的「点击设置序列」按钮也有明确的悬停反馈
- 优化:新增 12 个界面细节回归用例(序列区配色令牌、样式表规则、窗口下拉框行为、点空白失焦、图标加载),测试总数 72 → 84
- 新增:前台窗口匹配锁定——可为每个任务设置「仅在指定窗口处于前台时才生效」,支持包含 / 精确 / 正则三种匹配方式,并可一键「抓取当前窗口」
- 新增:浅色 / 深色双主题(GitHub Primer 配色),顶部一键切换并记住选择;首次运行跟随系统主题
- 新增:配置默认写入
%APPDATA%\KeyClicker\config.json,程序目录不再产生任何新文件;支持便携模式(portable.flag或程序目录已有clicker_config.json)与环境变量KEYCLICKER_CONFIG - 新增:「选项」菜单(打开配置目录 / 关于),「关于」中显示版本、配置路径、热键与"纯本地程序,不联网"说明
- 新增:
timeBeginPeriod(1)提升计时精度,退出时自动恢复 - 优化:UI 全面重做为 GitHub Primer 风格(1px 边框、圆角、字重层次、页头与状态栏分隔线)
- 优化:样式改为「动态属性 + 样式表属性选择器」,主题切换只需重新应用一次样式表
- 优化:轮询刷新只在数值真正变化时才更新控件,减少无谓重绘
- 优化:打包配置裁剪(排除用不到的 Qt 插件与翻译文件、标准库冗余模块,并开启字节码优化),单文件体积 37.1 MiB → 25.8 MiB(-30%);实测冷启动约 1.3 s → 1.15 s(其中程序自身初始化只需约 0.2 s,其余是单文件自解压)
- 优化:窗口标题匹配采用轻量 Win32 调用(仅在任务发送按键前读取一次),不额外开线程
- 优化:新增按键任务时校验正则表达式,非法时给出中文提示
- 新增:连点模式按键录入(「● 录入」按钮,按下即录入,支持组合键)
- 新增:
F6全局紧急停止;录入期间自动屏蔽全局热键 - 修复:按键序列录制时组合键丢失修饰键——Windows 钩子返回的是带方向的键名(
left ctrl/left shift/left windows),旧代码只判断ctrl/shift,导致Ctrl+F5只能录到f5;现在统一交由keyboard.get_hotkey_name()归一化 - 修复:长按按键触发系统自动重复,序列被同一个键刷屏
- 修复:定时任务暂停后恢复会立刻触发一次
- 修复:重复点击「开始」可能残留两个连点线程同时发键
- 修复:重命名 / 删除配置页后界面跳回第一页
- 修复:全局热键回调在钩子线程内直接操作 Qt 控件,偶发崩溃(改为信号转主线程)
- 修复:配置写入非原子,异常退出可能损坏配置文件
- 修复:打包为 exe 后配置写到临时解压目录,重启即丢失
- 修复:缺少依赖时直接抛异常退出,改为弹窗提示安装命令
- 优化:连点与定时改为固定节拍推进,长时间运行不累积漂移
- 优化:按键名校验与中文错误提示,替代静默失败
- 优化:状态栏热键提示、页面切换与轮询刷新更省资源
- 首个版本:PyQt6 重构版(连点 + 定时序列 + 多配置页)
本工具仅用于自动化重复性操作(如办公软件批量录入、测试环境模拟按键)。请遵守目标软件 / 游戏的服务条款,因使用本工具产生的一切后果由使用者自行承担。

