智能点击助手使用手册

第 1 章 认识智能点击助手

智能点击助手是一款 Android 屏幕自动化工具：把你在某个应用里的操作「录」一遍，就能把它变成可反复运行的任务，自动点击、滑动、输入，甚至定时执行。它靠系统无障碍服务和屏幕上的悬浮球工作，无需 root，也不修改任何应用。

1.1 智能点击助手是什么

简单说，它的工作方式是「录一次，跑无数次」：

1. 录制：开始录制后去目标应用正常操作一次，点击、长按、滑动、输入都会被记录，点击处还会自动截图存成图片模板。
2. 编辑：录制的操作变成一个个步骤（节点），可调整顺序和参数，也可插入延时、循环、判断等逻辑。
3. 运行：在任意时刻重新执行这套步骤，可手动启动，也可设定时任务自动触发。

1.2 能力地图

1.3 版本演进简表

App 经历多次迭代，以下是对使用体验影响最大的几个版本（当前版本 v2.4）：

1.4 数据与隐私

• 所有数据仅存储在本地，不上传云端：任务、模板、日志都保存在手机本机，App 不联网上传任何内容。
• 无障碍服务仅用于模拟点击与录制，不会读取聊天、照片等私人内容；悬浮窗权限用于显示悬浮球、回放标记等界面元素。
• 请勿在支付、密码等敏感页面使用本工具：自动化点击可能造成误操作，涉及资金或隐私的操作务必人工确认。
• 首次启动会弹出「隐私与服务说明」，同意后才能继续使用；不同意则退出。
• 删除任务不可恢复，重要任务建议定期导出备份（见第 8 章）。

第 2 章 安装与权限设置

本章介绍安装、首次启动与四项权限的开启方法。安装只需几分钟，权限是录制和运行任务的基础，建议按顺序一次配齐。

2.1 安装 App

将 APK 文件传到手机（微信、QQ、网盘均可），点击安装。系统提示「未知来源」时允许安装即可，普通 APK 安装无需其他特殊操作。

MIUI（小米/红米）用户注意：安装完成后，建议到「设置 → 应用设置 → 应用管理 → 智能点击助手 → 省电策略」选择「无限制」，防止系统后台回收导致任务无法执行。

2.2 首次启动

首次打开 App 会弹出「隐私与服务说明」弹窗，包含本地存储、无障碍模拟点击、勿在支付/密码页使用、悬浮窗用途、误操作提示等 5 条说明。

• 点「同意并继续」→ 进入主界面，可正常使用。
• 点「退出」→ 直接关闭 App；不同意则无法使用。

2.3 四项权限逐一开启

进入主界面后，「权限状态」卡片显示四项权限（未开启黄色、已开启绿色）。按顺序逐行操作：

2.4 截屏授权失败排查

授权失败时，卡片会以红字显示失败原因（可直接截图反馈）。点「诊断」→ App 抓帧自测 → 弹窗显示结果：成功显示「授权成功 WxH」与帧质量提示（全黑/全白可能是防截屏保护），诊断图已存相册 smartclick_diag.png；失败则列出原因与建议。

MIUI 设备按以下顺序排查：

1. 在最近任务中下拉 App 锁定（锁后台）
2. 省电策略设为「无限制」
3. 检查「特殊权限 → 屏幕录制」是否被关闭
4. 关闭其他录屏/投屏工具
5. 重新授权（点「立即授权」）

授权成功后 Toast 提示「截屏授权成功，可开始录制/识图」；若之前有待运行任务（含识图节点）被挂起，会自动继续运行。

2.5 授权联动关系

2.6 常见坑

• MIUI 后台回收无障碍服务：App 退到后台后服务可能被系统回收，任务无法执行。运行任务时请保持 App 前台。
• 无障碍服务约 30 秒断连一次属正常：部分 MIUI 机型系统会周期性回收并自动重连，不影响使用。
• 忽略电池优化：主界面底部「设置」→「忽略电池优化（后台保活）」→ 跳转系统请求页允许。定时任务依赖它准时触发，建议开启。

第 3 章 录制你的第一个任务

录制是创建任务最省事的方式：你只需在目标 App 里真实操作一遍，助手就会自动把每一步转成可回放的节点，并顺手为点击生成识图模板。本章从前置条件讲起，带你完成第一次录制。

录制前置条件

• 无障碍服务已开启：未开启时无法录制，点录制会提示并引导你去系统设置开启。
• 截屏授权（可选但推荐）：想自动生成识图模板，需要在主界面「权限状态」卡片点「立即授权」完成截屏授权。未授权也能录制，只是不会生成模板。
• 「录制时自动截取模板」开关：位于设置页，默认开启。关闭后录制同样不会生成模板。

三个录制入口

完整录制步骤

1. 点任一「录制」入口，弹出 Toast「开始录制：操作目标应用，完成后点击悬浮球或返回本页停止」。
2. 切换到目标 App，用真实手指操作：点击、长按、滑动都会被记录。
3. 操作完成后，点悬浮球面板的「录制」按钮，或返回主界面再点一次「录制」停止。
4. 弹出 Toast「录制结束，共 N 步」。
5. 打开任务编辑页查看：从编辑页发起录制时节点已直接追加；从其他入口录制则新建或打开任务，节点会自动带入。确认无误后填任务名，点「仅保存」或「保存并运行」。

录制会自动生成什么

• 智能点击节点：每次点击前自动截取目标区域生成图片模板（命名「录制@偏移 时:分:秒」），生成「智能点击」节点——回放时先识图匹配，失败自动用坐标兜底，区域按点击位置自动选上半屏/下半屏。
• 延时节点：两次操作间隔超过 50ms 会自动插入「间隔等待」延时节点（首个上限 5 秒，其余上限 120 秒）。
• 滑动节点：按录制时的时长原样回放（100–5000ms 范围内钳制）。
• 助手会自动过滤对 App 自身的操作，不会录进任务里。

注意事项

• 必须用真实手指操作：模拟器或 adb 注入的触摸在部分系统上不产生有效事件，录出来的任务不可靠。
• 录制时不要旋转屏幕：横竖屏切换可能把节点降级为纯坐标节点（坐标正确，但丢失识图模板）。
• 小程序 / WebView 场景：拿不到精确元素位置时，坐标可能落在容器中心，需到编辑页手动修正。
• 非滚动容器的拖动（拖拽排序、画布拖动）不产生滚动事件，录不下来，需要手动添加滑动节点。
• 未授权截屏时仍可正常录制，但只生成坐标节点，没有图片模板。
• 录制坐标为 (0,0) 的无效节点会被自动跳过，无需手动清理。

第 4 章 任务编辑详解

本章讲解任务编辑页的布局、13 种节点、管理操作与保存方式。

4.1 编辑页布局

• 任务参数区：任务名称、循环次数（最小 1）、循环间隔 ms（≥0）、倍速（0.5–4.0，默认 1.0）。倍速会压缩延时与滑动时长（÷ 倍速）。
• 节点列表区：固定高度、内部可滚动，每行显示彩色序号、类型名与摘要。
• 底部操作区：「+ 添加节点」「仅保存」「保存并运行」。

4.2 13 种节点详解

「+ 添加节点」弹窗列出全部类型（识图/智能/判断需先有模板）。

4.3 节点管理操作

• 点节点：打开参数编辑弹窗。
• 长按节点：菜单含编辑/删除/剪切/粘贴/上、下方插入；剪切-粘贴仅本次会话有效。
• 右侧删除按钮：直接删除。
• 彩色序号：圆形底按节点类型配色，便于区分。

4.4 「识别区域」概念

识图类节点限定在「识别区域」内匹配，更快更准：

• 三种区域：全屏 / 上半屏 / 下半屏，录制时自动按点击位置选择。
• 区域未命中时自动放宽到全屏重试兜底，命中率不受影响。
• 区域不准可在编辑弹窗修改。

4.5 识图节点参数说明

• 匹配阈值：相似度门槛，0.10–1.00 可在设置页调整，默认 0.85；越高越严、越低越易误匹配。
• 失败重试：未命中可重试（默认 2 次、间隔 800ms）。
• 兜底坐标：重试仍失败的保底点击位置，-1 为禁用。
• 失败策略：停止 / 跳过 / 兜底坐标 / 跳转指定节点。

4.6 保存三态

• 「仅保存」：保存不退出，可继续编辑。
• 「保存并运行」：保存 → 直接运行 → 退出编辑页。
• 空节点任务不允许保存（提示「任务没有节点」）。

4.7 常用编辑技巧

1. 修正小程序容器中心坐标：小程序/WebView 录制的坐标可能落在容器中心，需在弹窗改到实际点击位置。
2. 用「智能点击」双保险：识图找不到时自动落回坐标，抗界面变化。
3. 循环 + 跳转实现复杂流程：循环体包住重复步骤，跳转跨到任意节点，配合判断写出「不满足就重试」等分支。

第 5 章 运行与停止

任务编辑保存后，本章讲解如何启动运行、启动前后 App 会自动做哪些检查、运行时你能看到什么反馈，以及两种随时叫停的方法。

5.1 四种运行方式

5.2 3 秒倒计时（可跳过）

1. 主界面长按任务卡片，弹出菜单：运行 / 定时运行 / 导出到 Download / 删除任务。
2. 点「运行」，弹出倒计时弹窗：「3 秒后开始执行，请切换到目标应用界面」。
3. 趁这 3 秒切到目标应用，等倒计时结束自动开始；点「立即运行」跳过等待；点「取消」放弃本次运行。

5.3 运行前的自动校验

开始执行前，App 会自动检查几件事，多数情况按提示照做即可：

• 无障碍服务未开启：提示「请先开启无障碍服务」并跳转系统无障碍设置，开启后重试。
• 识图节点缺截屏授权：任务含识图/智能点击节点但未授权截屏时，提示「任务含识图节点，请先授权截屏」；授权成功后自动继续运行，无需重新启动。
• 界面匹配保护（默认开启）：运行前确认当前界面是否为录制时的界面：
  • 当前是桌面、本 App 或无法判断 → 自动拉起目标应用，等待约 15 秒，再留 15 秒手动切换；
  • 停在别的应用 → 提示「界面不匹配：请切换到录制界面，10 秒后自动开始」；
  • 超时仍未切换 → 提示「界面不匹配：当前是 XXX，任务已停止」。
  • 不需要该校验，可在「设置 → 界面匹配保护」关闭。
• 模板缺失预检：提示「有 N 个识图模板缺失，将使用坐标兜底」时不阻断，自动用坐标点击顶上；提示「预检：N 个识图节点疑似不准」时建议重新录制模板，否则可能点不准。
• 死循环安全阀：任务执行步数超过上限（节点数×500，最少 10000 步）会被强制停止，防止循环写错导致无限执行。

5.4 运行中的反馈

• 悬浮球变红：任务运行中悬浮球显示为红色（空闲为白色），一眼可辨。
• 点击前短闪：每次点击前约 100ms，目标位置出现红圈白边闪烁，提示下一步点哪里；时长可在「设置 → 任务运行时短闪 ms」调整（50–1000ms，默认 200）。
• 状态提示：主界面任务列表该项显示「运行中」，并有状态 Toast（如「任务开始」「运行中 第N轮」「任务结束」）。
• 任务执行期间悬浮层自动隐藏，避免遮挡与误触，结束后自动恢复。

5.5 停止任务

5.6 倍速与循环注意事项

• 倍速压缩所有等待：倍速（0.5–4.0，默认 1.0）作用于延时、滑动时长、循环间隔等全部时间参数（时长 ÷ 倍速），并非只加速点击。倍速过高时节点可能执行太快而失效，建议先用 1 倍速验证，再逐步加快。
• 循环间隔可设 0：循环任务每轮之间可无间隔，配合倍速，重复轮次会非常快。
• 循环次数最小为 1：循环开始节点次数低于 1 按 1 次处理；循环体写错可能触发 5.3 的安全阀强制停止，属正常保护，检查循环节点即可。

第 6 章 模板与截图

本章讲模板的来龙去脉：模板是什么、怎么用截图和相册两种方式创建、如何管理，以及识图匹配的基本原理。模板是「识图点击」的基础，建议在录制任务前先掌握本章内容。

6.1 模板是什么

模板就是一张识图匹配用的图片——从屏幕截图中框选出的目标区域（比如一个按钮、一个图标）。任务中的「识图点击」「智能点击」「判断」节点运行时，会在屏幕上寻找与模板相似的图案，找到后按记录的偏移位置点击。

模板页顶部说明了它的用途：「识图点击使用：截取屏幕 → 框选目标区域保存为模板 → 任务中引用模板」。创建模板有两条路径：悬浮球截图 和 相册导入。

6.2 截图创建模板（悬浮球路径）

点悬浮球面板的「截图」按钮，在当前界面直接完成框选，无需跳出应用：

1. 点「截图」→ App 隐藏悬浮层并截屏，截取的图片自动存入相册（smartclick_shot_时间戳.png），同时弹出 Toast：「已截取 1080x2400，中心坐标(540,1200)，拖拽框选区域保存为模板」（尺寸与坐标随屏幕变化）。
2. 屏幕出现内嵌裁剪浮层：顶部一行「取消 / 拖拽框选截图区域 / 重选」，第二行是坐标栏。
3. 用手指拖拽框选目标区域，坐标栏实时显示「(x1,y1) (x2,y2) 宽x高」（未拖拽时显示「请拖拽框选」占位）。
4. 框选完成，底部才出现保存条：模板名输入框 + 绿色「保存」。
5. 输入模板名（留空则用默认名），点「保存」→ Toast「模板已保存: xxx」→ 浮层自动关闭，悬浮球恢复。

6.3 相册导入创建模板

1. 主界面点底部「模板」→ 模板页右下角点相册图标。
2. 在系统相册选一张图（自动纠正方向、缩放到屏幕尺寸，保证 1:1 匹配）。
3. 进入裁剪页，顶部提示「拖拽框选截图区域，保存为识图模板」，框选操作与截图浮层一致（坐标栏 + 底部「模板名 / 保存」）。
4. 点「保存」→ Toast 成功并自动返回模板列表。

6.4 模板管理

模板页列表每项显示：缩略图、模板名、元信息「宽x高 · 点击偏移(ox,oy)」和右侧「删除」按钮。

• 自动命名：手动保存默认「模板 月-日 时:分:秒」（带秒，保证不重名）；录制自动生成的模板命名为「录制@(偏移x,偏移y) 时:分:秒」。输入框留空即可使用默认名。
• 删除：点列表项右侧「删除」立即删除，没有二次确认弹窗。

6.5 匹配原理简述

识图节点运行时，在指定「识别区域」（全屏/上半屏/下半屏）内寻找与模板最相似的位置，未命中会自动放宽到全屏重试。匹配相似度门槛为识别阈值，默认 0.85，可在设置页滑块调整（0.10–1.00）：阈值越高越严格、越不易误点，但也可能找不到。

为保证匹配稳定，保存时有两项校验：选区过小（小于 8px）会拒绝（提示「框选区域太小」）；框选偏宽会警告「框选区域偏宽，保存后识别匹配可能失败，建议缩小框选区域」。匹配失败时按节点设置重试（默认 2 次、间隔 800ms），仍失败则执行失败策略（停止/跳过/兜底坐标/跳转指定节点）。

第 7 章 定时任务

定时任务让任务到点自动运行，不需要你守在手机前。支持「仅一次」和「每天重复」两种模式，同一时刻可以安排多个任务。

7.1 两个入口

• 定时任务管理页：主界面点「⏰ 定时任务管理（一次性/每天重复）」按钮进入，可新增、修改、删除定时任务。
• 快捷创建：主界面长按任务卡片 → 菜单选「定时运行」→ 直接输入 HH:mm 并选择模式，即可快速添加，与定时任务管理页互通。

7.2 新增定时任务

1. 打开「⏰ 定时任务管理」→ 点「＋新增定时任务」。
2. 下拉选择要运行的任务。
3. 输入时间 HH:mm（默认 09:00）。
4. 单选模式：「仅一次」或「每天重复」。
5. 点保存，弹出提示「已创建/更新：任务名 每天/一次性 HH:mm」。

7.3 两种模式对比

7.4 触发机制：到点自动运行，完后退后台

• 到点后系统精确闹钟（AlarmManager）拉起 App，自动运行对应任务，实测触发偏差在几十毫秒内。
• 任务执行完自动退回后台，不打扰当前操作。
• 同一时刻可同时安排并执行多个任务。
• App 重启后自动恢复全部启用中的定时任务，无需重新设置。

7.5 列表状态与修改删除

定时任务列表每项展示：任务名、时间 HH:mm、模式、状态（● 启用中 / ○ 已完成/已停用）、最近执行时间与最近结果。

• 修改：点列表项 → 修改任务/时间/模式 → 保存。
• 删除：点条目右侧「删除」→ 确认后删除（会停止该定时配置）。

7.6 系统限制与注意事项

• 锁屏时可能不执行：闹钟能准时触发，但部分系统（如 MIUI）会拦截后台拉起，任务执行不了。请保持屏幕亮起或解锁后再执行。
• 需保持 App 已安装：定时配置存在本机，卸载 App 后定时任务一并消失。
• 建议开启忽略电池优化：设置页 →「忽略电池优化（后台保活）」，保证准时触发。
• 建议开启悬浮球服务：后台保活更稳。
• MIUI 后台回收无障碍：部分系统会回收后台 App 的无障碍服务，导致无法模拟点击，运行任务前尽量保持 App 在前台。

第 8 章 悬浮球、回放、设置与 FAQ

本章讲悬浮球操作、任务列表语义与「回放」机制，并汇总设置页选项、换机迁移和常见问题。

8.1 悬浮球：屏幕上的快捷控制中枢

悬浮球是 32dp 半透明小球，点球展开面板、再点收起；可与面板整体拖动，松手记住位置（越界自动复位到屏幕右侧中部）。

面板共 5 个按钮：

• 球色状态：空闲白、运行中红、暂停黄，一眼可知状态。
• 任务执行时悬浮层自动隐藏防遮挡，结束后恢复（通知常驻「悬浮控制面板运行中」）。

8.2 悬浮球任务列表：点击运行、长按回放

点「运行」展开任务列表（最多 8 项），底部提示：「点击=运行任务 · 长按=回放查看（屏幕闪烁）」——点击立即运行，长按屏幕回放；已有任务运行时会提示「已有任务在运行，请先停止」。

8.3 回放（屏幕闪烁）是什么

回放是纯视觉演示：长按任务后，全屏按时间轴逐节点画出「圆圈+十字构造线+序号」闪烁标记，滑动节点画起点→终点连线，不实际点击，可核对位置、排查录错。唯一入口是悬浮球列表长按（编辑页无回放按钮），Toast「回放开始：请切到录制应用界面查看闪烁；悬浮球可暂停/停止」，停止点悬浮球「停止」。

8.4 设置项速查表

8.5 导出 / 导入 / 换机迁移

1. 设置 →「导出全部任务与模板到 Download」→ Toast「已导出到 Download/smartclick_export」（Android 10+ 免存储权限）。
2. 换机/重装：把该文件夹同步到新手机，装好后进设置 →「从 Download 导入任务」。
3. 导入完成弹窗报告「导入 N 个任务」与错误明细，模板一并恢复。

8.6 FAQ 与注意事项（已知限制）

1. MIUI 后台回收无障碍服务：App 退后台任务可能无法执行，建议运行前保持前台。
2. 锁屏时定时任务可能不执行：系统限制后台启动，需亮屏或解锁。
3. 无障碍服务约 30 秒断连一次（系统回收，自动重连）：点击尽量在连接窗口内完成。
4. 录制必须用真实手指：模拟器/adb 注入的触摸在部分系统上不会被记录。
5. 小程序/WebView 录制的坐标可能是容器中心：需在编辑页手动修正。
6. 非滚动容器的拖动（拖拽排序/画布拖动）无法录制：需手动添加滑动节点。
7. 悬浮球别拖到屏幕边缘手势区太靠边：边缘手势会拦截点按。
8. 裁剪浮层用「取消」关闭：浮层无焦点时系统返回键可能无效。
9. 模板删除无二次确认：点「删除」即删，请谨慎。
10. 运行前提示模板「缺失/疑似不准」时：按提示重录模板。
11. 倍速影响所有时间（延时/循环间隔/短闪）：倍速过高会导致部分节点失效。