Skip to content

Repository files navigation

点击助手 ClickHelper

by 羽学 QQ:1242509682


📖 项目简介

点击助手是一款 Windows 桌面自动化辅助工具,集成了鼠标点击模拟键盘按键控制图像与文字识别点击宏录制与回放定时任务等丰富功能。程序基于 .NET 10.0 和 Windows Forms 开发,界面清爽,支持托盘常驻及单实例运行。


🎯 v1.0.6 更新亮点

本次更新重点聚焦于交互易用性功能完整性,并对热键系统进行了彻底重构。

🔥 核心改进

改进项 v1.0.5 v1.0.6
热键设置 下拉框选择(显示枚举名,不友好) 组合键录制器 + 友好显示(F1、Ctrl+S 等)
进度反馈 仅有播放进度 新增动态进度条(坐标表和宏播放循环进度)
OCR参数 固定参数 可配置化(阈值、批大小、缩放边长等),每个坐标独立保存
定时功能 手动标志干扰定时接管 修复定时启动/停止逻辑,手动/定时互不干扰
图像匹配 匹配失败直接跳过 支持回退到坐标点击(若坐标有效)
瞄准提示 新增“显示瞄准”复选框,点击时显示红色瞄准标志
截图添加坐标 OCR 参数丢失 修复截图后 OCR 参数保存
界面布局 复选框分散 “自动最小化”与“显示瞄准”合并到同一行

✨ 新增与优化

  • 全新热键控件(HotKeyBox):每个热键旁配有“改”按钮,点击后全屏录制组合键(支持 Ctrl/Shift/Alt + 任意键),显示为 Ctrl+SF1 等友好格式,彻底告别 D0 等难懂代码。
  • 统一热键管理(HotKeyManager):集中管理所有全局热键,支持动态更新和注销,代码更健壮。
  • 动态进度条:执行坐标列表或宏播放时,状态栏上方显示当前循环进度(0~100%),循环结束自动归零。
  • OCR 识别参数可配置:在坐标编辑器的“文字识别”选项卡中,点击“OCR参数”可调节检测阈值、文本框阈值、扩张比例、识别阈值、批大小、线程数、缩放边长、得分模式、使用膨胀等参数,并保存到每个坐标项中。
  • 识别前弹窗确认:截图预览或图片预览时,按 B 键识别文字前会弹出参数配置窗口,确认后执行。
  • 瞄准标志:主界面增加“显示瞄准”复选框(与“自动最小化”同行),开启后每次坐标点击(非后台模式)会在点击位置显示红色十字瞄准(支持 DPI 缩放),便于观察点击位置。
  • 图像匹配失败回退:若坐标项启用图像匹配但未找到模板,且 X/Y 坐标非零,则自动回退到坐标点击,避免任务完全跳过。
  • 定时功能优化:启用定时时自动重置手动标志,定时周期结束后进度条归零。

✨ 主要功能

✦ 点击核心

  • 四种点击类型:鼠标点击、键盘按键、文本输入、组合键。
  • UIA(UI Automation)支持:不移动鼠标对桌面控件执行点击。
  • 坐标增强:支持坐标重选,(0,0) 自动使用当前鼠标位置。

✦ 图像与文字识别点击

  • OpenCvSharp 模板匹配:高效图像识别,CPU 占用低。
  • OCR 文字识别:集成 RapidOCRSharpOnnx(PP-OCRv6),识别屏幕文字并执行点击。
  • 图片预览增强:滚轮缩放、双击还原、右键识别文字/复制/另存为/复制 Base64。

✦ 宏录制与回放

  • 捕获鼠标移动、点击、滚轮、键盘按键(含组合键)。
  • 宏以 .txt 文本格式存储,支持手工编辑。
  • 内置宏管理器:新建、保存、加载、删除、编辑、拖拽排序、一键转位置列表。

✦ 定时任务

  • 日期模式(指定起止时间)和 计时模式(设定运行时长)。
  • 执行目标可选:位置列表宏播放
  • 独立热键(默认 F8)一键启用/停用定时。

✦ 位置列表(坐标管理)

  • 支持鼠标点击、键盘按键、文本输入、组合键四种类型。
  • 独立设置按键、修饰键(Ctrl/Shift/Alt)、操作模式(单击/按下/弹起)、延迟时间。
  • 列表支持添加、删除、上移/下移、复制、编辑,变动自动保存。

✦ 循环与间隔控制

  • 循环次数:-1 无限,正整数为轮数,0 不执行。
  • 间隔时间:自定义每次操作之间的延迟(1ms ~ 30分钟)。
  • “批量执行”模式:一次性执行所有位置,而非逐个循环。

✦ 热键体系(v1.0.6 全新升级)

所有热键均采用组合键录制器,支持 Ctrl/Shift/Alt + 任意键,显示友好名称。

功能 默认热键 说明
启动/停止点击 F9 可自定义
记录坐标 Alt + S 快速记录当前鼠标位置
宏录制 F6 开始/停止录制
宏播放 F7 播放/停止宏
截图 Alt + A 框选区域生成图像模板
定时切换 F8 启用/停用定时任务

✦ 截图与图像匹配

  • 按下截图热键进入全屏选区模式,左键拖拽选择区域,按 Enter 确认。
  • 截图自动转为图像模板,弹出编辑器调整参数。
  • 通过 OpenCvSharp 高效匹配,实现基于图像的智能点击。

✦ OCR 文字识别

  • 截图模式下按 B 键,对框选区域进行 OCR 识别,结果可复制。
  • 首次使用需下载模型及依赖,程序自动引导。
  • 主窗口状态栏显示 OCR 就绪状态。

✦ 配置管理

  • 主配置保存在 Config.json 中(位置列表、热键、间隔、循环、定时等)。
  • 支持“保存配置”和“加载配置”,便于切换不同场景。

✦ 界面与交互优化

  • 自定义标题栏,支持拖拽移动,圆角窗口(半径16px),渐变背景。
  • 状态栏实时显示运行状态、鼠标坐标、OCR 状态。
  • 托盘常驻,双击恢复主窗口,右键退出程序。
  • 自动最小化:勾选后启动点击/录制/播放时自动隐藏至托盘。

🚀 快速使用指南

1. 基础点击

  1. 打开“坐标管理”窗口,添加坐标(可手动或“重选”拾取)。
  2. 设置循环次数和间隔。
  3. 按“启动”或热键(默认 F9)开始执行。

2. 图像点击

  1. 在坐标编辑器中勾选“图像识别” → 重新截图或加载图片。
  2. 调整匹配阈值(0~1)。
  3. 可选:勾选“文字点击”并填入目标文字,实现 OCR 辅助点击。
  4. 保存后执行即可。

3. 宏录制与回放

  1. 打开宏管理器,点击“录制”或按 F6。
  2. 执行操作后再次点击“停录”或按 F6。
  3. 自动生成新宏,在管理器中可编辑、播放(F7)或转换为位置列表。

4. 定时任务

  1. 点击“定时管理”,选择日期/计时模式,设置时间参数。
  2. 选择执行目标(位置列表或指定宏)。
  3. 按定时热键(默认 F8)启用,再次按则停用。

📁 文件说明

路径 说明
Config.json 主配置文件(位于 exe 同级目录)
Macros/ 宏文件存储目录(.txt 格式)
inference/ OCR 模型文件夹(需自行下载PP-OCRv6,含 det.onnx + rec.onnx
Log/ 异常日志(按日期分文件)
OcrCache/ 文字识别缓存(JSON 格式,相同图片秒级响应)

⚠️ 注意事项

  • 本工具仅供合法自动化操作,请遵守相关软件使用协议。
  • 管理员权限:宏录制和全局热键部分系统需要以管理员身份运行。
  • 项目仅支持 x64 平台编译。
  • 初始化依赖:程序启动时自动检测依赖,若缺失会引导下载,完成后需重启程序生效。
  • OCR 模型下载(约 142 MB):
  • OpenCvSharp 依赖下载(约 81.3 MB):

📦 版本信息

  • 当前版本:v1.0.6
  • 开发环境:Visual Studio 2022 + .NET 10.0-windows
  • 依赖库
    • Newtonsoft.Json (13.0.3)
    • RapidOCRSharpOnnx (1.2.2)
    • Microsoft.ML.OnnxRuntime (1.27.0)
    • OpenCvSharp4 (4.13.0.20260528)
    • OpenCvSharp4.runtime.win (4.13.0.20260528)
    • FlaUI.UIA3 (5.0.0)

📧 联系作者

如有问题或建议,请联系 羽学 QQ:1242509682


感谢使用!

About

点击助手是一款 Windows 桌面自动化辅助工具,主要用于模拟鼠标点击和键盘按键操作。用户可自定义位置列表(含坐标、操作类型、按键模式)、循环次数、执行间隔,并支持定时任务、热键控制、脚本保存与加载等功能,适用于游戏辅助、办公自动化等场景。 程序基于 .NET 10.0 和 Windows Forms 开发,界面简洁,占用资源少,支持托盘隐藏运行。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages