Klick'r v4.0.5.25

Klick'r v4.0.5.25

版本日期：2026-09-29。

本版加入实验性的路线录制与回放，改进精细框选，并修复工具栏靠右时测试结果被挤出屏幕的问题。沿用现有正式包名与发布签名，不新增第三方依赖。

测试结果自动向内展开

• 条件测试和事件测试的结果面板会根据工具栏位置自动换向：工具栏靠左，结果向右展开；工具栏靠右，结果向左展开。
• 打开面板、拖动、返回测试窗口及切换屏幕方向时重新计算布局，避免结果跑到屏幕外。
• 切换方向保留现有测试设置，不扩大主悬浮菜单的贴边点击范围。

更清楚、少遮挡的框选

• 颜色、数值、文字检测区域和图像截取统一使用细边框、框外小手柄；小选区不再显示遮住目标的大号内部提示。
• 截图预览默认保持原尺寸，不再打开后自动缩小到 80%；图像截取仍可手动缩放和平移。
• 颜色条件保留单像素取色，也可以扩大检测区域。区域模式比较平均颜色，不是寻找区域内任意同色点；旧条件不会自动扩大。

路线录制与回放（实验功能）

• 支持可见整数 X/Y 坐标定位，或固定方向、固定缩放、玩家标记居中的滚动小地图定位；保存路径点，不录制视频或原始手指操作。
• 支持点击地面及固定摇杆短按移动，通过 A/B 两个不同方向校准移动关系；A/B 不是路线起点与终点。
• 支持从起点附近自动接近、在终点附近沿原路返回，以及在智能场景动作中调用已保存路线。
• 减少短直线上密集路径点造成的反复停顿，保留拐点、折返、终点和位置确认；回放不保证与手动行走等速。
• 补齐载入、保存、校准、回放前检查和结束反馈，分别提示地图不匹配、X/Y 未识别、遮挡、无新画面和等待连续确认。
• 保留定位丢失、卡住、超时、换图和屏幕尺寸变化等保护，不会自动绕障碍或探索随机地图。

入口、配置步骤及限制请先阅读路线使用指南。请先在安全的短路线测试，不要直接用于长时间无人值守任务。

下载与升级

• 不确定设备架构时，下载 Klickr-4.0.5.25-universal-release.apk；另提供四种架构的精简包及 SHA256SUMS.txt。
• 本仓库旧正式版可覆盖升级，升级前先导出场景备份，不要卸载或清除数据。本版包含数据库 27→28 升级，用于保存“执行路线”动作；不建议直接降级安装旧版。
• .debug 测试版与正式版数据独立，场景需通过备份导出、导入转移。上游／应用商店版本可能签名不同。
• 路线文件目前仅保存在本机，不随场景备份导出。 场景备份只保存路线 ID；从测试版或其他设备迁移后，需要重新录制／配置路线并重新选择，不能把场景备份当作路线备份。
• 本版对应源码：v4.0.5.25 标签，也可下载发布页的 Source code；保留原项目版权与 GPL 许可证。

验证与边界

• 发布准备阶段运行完整单元测试、完整 Lint 与 FDroid Debug 构建，全部通过；共 120 个套件、1191 项单元测试，0 失败、0 错误、0 跳过，覆盖路线逻辑、数据库迁移、选区绘制与触摸、面板左右换向等回归场景（包含 Gradle 判定无需重跑的未变更任务）。
• Google 官方 Android 12 平板模拟器检查了左右测试面板、拖动、返回后的设置保留与细框选区；路线使用合成地图验证了录制、回放、暂停、附近接入、原路返程和失败保护。详细记录见路线验证与面板验证。这些记录中的“未发布”指当时的开发测试阶段。
• 正式发布流程针对本标签执行完整单元测试、Lint 与 Android 图片／OCR 识别测试，通过后才构建和发布签名 APK；实际结果见 Release 工作流。项目仍有既有 Lint 警告，不宣称零警告。
• 合成地图和静态截图验证不等于商业游戏动态行走、云手机或数小时路线稳定性验证；随机地图、旋转小地图、动态摇杆和多点移动／攻击不在支持范围内。系统资源不足时仍可能回收应用进程。

完整代码差异 · 问题反馈

Klick'r v4.0.5.24

Klick'r v4.0.5.24

版本日期：2026-09-27。

本版重点是长时间运行的内存控制、资源清理和退出诊断，不新增第三方依赖，不增加数据库迁移。

稳定性优化

• 图片模板缓存改为 Java 最大堆的 1/8，封顶 32 MiB；按实际分配容量计费，避免大量小模板低估内存。
• 截图使用独立单缓冲复用，关闭或尺寸切换时解除旧引用；缓存清理不提前回收仍在识别中的图片。
• 调试报告使用单个后台写入任务，队列同时限制条数与字节数，单事件明细也有限额。磁盘过慢或写入失败时取消本次报告，不拖垮场景执行，也不把残缺报告标成完整。
• 加强截图会话、旋转切换、原生检测器和服务停止时的资源清理与异常处理。
• 悬浮菜单停止后取消未完成的尺寸更新，避免窗口销毁后的回调异常；不扩大贴边热区，不改变已确认的菜单布局。
• 补齐运行异常提示的现有语言资源，保留完整 Lint 发布检查。

更完整的退出诊断

• 每次运行开始及此后约每 30 秒记录内存状态，保留最近 120 条采样并落盘，长等待期间也继续记录。
• 记录应用版本、包名、PID、Java/Native/PSS 内存、图片缓存和设备总内存状态，不采集其他应用进程列表。
• 诊断包附带可读系统退出原因、运行结束与清理状态，以及调试报告完成/过载/写入失败等状态。
• 出现问题可从“场景首页 → 更多选项 → 运行历史”导出诊断 ZIP。诊断数据仅保存在本机，不自动上传；分享前请检查私人信息。

下载与升级

• 不确定设备架构时下载 Klickr-4.0.5.24-universal-release.apk；其余四个 APK 是对应架构的精简包。
• 使用本仓库原正式包名与发布签名，升级前先备份场景，直接覆盖旧正式版，不要卸载或清除数据。
• 之前的 .debug 独立测试版与正式版不共享数据，请通过场景备份转移脚本。上游/商店版本签名可能不同，不能保证直接覆盖。
• 不改变图片、文字、数值、颜色的识别算法、匹配阈值、点击坐标或计数器运算规则。大量模板场景可能增加缓存重新读取次数。
• 校验文件：同页 SHA256SUMS.txt。项目对应源码：v4.0.5.24 标签，也可下载发布页的 Source code；构建配置和依赖版本包含在源码内。

验证与边界

• 发布准备阶段：106 个套件、1037 项本地单元测试通过；相关模块 Lint 与完整 Debug 构建通过。新增回归包括调试回调压力、有界队列、IO 失败、缓存释放、采样上限和服务清理。
• 同一稳定性实现的独立 Debug 测试包在 Google 官方 Android 12L 平板模拟器中完成 5000 次计数器/颜色条件循环，约 4 分 56 秒自然结束；调试窗口与报告开启，PSS 采样约 110–131 MiB。
• 上述模拟器测试不是最终签名 Release APK 的长时间游戏实测，也不是云手机系统内存耗尽复现。发布流程会重新执行单元测试、Lint、Android 识别测试后构建签名 Release APK，实际结果见 GitHub Actions。
• 优化降低应用自身内存压力，不能保证系统或云手机平台在资源不足时不回收进程，也不代表两天真实游戏稳定性已经验证。

中文使用说明 · 完整代码差异 · 问题反馈

Klick'r v4.0.5.23

Klick'r v4.0.5.23

本版重点：稳定执行、避免重复点击、方便定位脚本失败原因。

新增功能

• 点击后确认：点击一次后等待目标条件连续两帧满足再继续，确认失败停止场景，不自动重复点击。入口：点击动作配置底部。
• 智能滑动查找：先检查目标，再按设定间隔滑动，找到即停，最多 1–50 次。入口：滑动动作配置底部。
• 运行历史与诊断导出：保存最近 20 次运行、每次最近 500 个已完成动作和最多 5 张失败截图，支持 ZIP 导出。入口：场景首页 → 更多选项 → 运行历史。

稳定性修复

• 修复截图缺失被误判为目标消失、子流程沿用旧截图的问题。
• 修复长子流程和长等待被外层超时提前截断的问题，保留取消与循环调用保护。
• 连续失败按整个事件统计，避免前置成功动作清除失败计数。
• 缺失计数器不再按 0 比较；Android 拒绝动作时返回实际失败。
• 补齐动作目标引用的复制、导入修复，以及旧备份中等待和断点配置的保留。

升级与兼容

• 新增可选功能默认关闭，普通点击和滑动保持原有用法。
• 贴边入口大小、悬浮菜单和暂停按钮布局不变。
• 数据库自动升级到 27；升级前建议导出场景备份，直接覆盖安装，不要卸载旧正式版。
• 推荐下载 universal-release.apk，兼容手机和模拟器；也可选择对应架构的小体积安装包。
• Debug 测试版与正式版是两个独立应用，需通过场景备份转移测试版里的脚本。
• 诊断数据仅保存在本机，不自动上传；分享 ZIP 前请检查截图中的私人信息。

验证范围

发布准备阶段已通过 992 项本地单元测试、31 项 Android 识别测试（另 1 项样本生成测试按原设计跳过），Debug 构建与 Lint 门禁通过。发布流程还会重新执行测试门禁并构建签名 Release APK。自动化回归不等同于真实游戏长时间运行验证。

详细中文使用说明

完整代码差异

Klick'r v4.0.5.22

Full Changelog: v4.0.5.21...v4.0.5.22

Klick'r v4.0.5.21

Full Changelog: v4.0.5.20...v4.0.5.21

Klick'r v4.0.5.19

本次更新

场景执行速度优化

• 同一张屏幕帧中，多个事件使用完全相同的图片、文字、数值或颜色条件时，共享一次识别结果，减少重复计算。
• 每次重新截屏都会清空识别缓存，确保动态画面和滑动后的内容使用最新图像。
• 执行动作后立即失效当前缓存，避免连续事件误用动作前的旧识别结果。

调试窗口显示修复

• 主菜单自动收起时，只收起操作按钮，已开启的实时调试窗口会继续显示。
• 点击科技图标仍可展开全部控制按钮；关闭调试后，收起状态只保留科技图标。
• 增加菜单展开、收起及关闭调试三种状态的回归测试。

稳定性

• 保持现有文字、图片、数值和颜色识别逻辑，不降低滑动过程中的识别与点击能力。
• 增加同帧复用、跨帧失效和不同阈值隔离测试。

下载说明

• 不确定设备架构时，请下载 Klickr-4.0.5.19-universal-release.apk。
• 常见安卓真机可优先下载 arm64-v8a 版本，体积更小。
• 模拟器通常选择 x86_64 版本。
• SHA256SUMS.txt 用于校验下载文件完整性。

完整变更记录： v4.0.5.18...v4.0.5.19

Klick'r v4.0.5.18

本次更新

识别结果点击

• “点击检测到的条件”现在统一支持图像、文字、数字和颜色条件。
• 图像、文字和数字会点击实际识别区域中心；颜色条件点击检测区域中心。
• 当底层没有返回有效识别坐标时，回退到检测区域中心；无有效区域时不再误点屏幕 (0,0)。

文字识别

• 文字条件匹配一整行中的目标子串时，点击范围会收窄到目标文字，不再点击整行中心。
• 中文等多字节文字按 Unicode 字符位置计算，避免点击位置偏移。
• 文字识别选框取消固定的 128×64 最小限制，现在可以像数字识别一样缩小，方便选择小字。

下载说明

• 不确定设备架构时，请下载 Klickr-4.0.5.18-universal-release.apk。
• 常见安卓真机可优先下载 arm64-v8a。
• 模拟器通常选择 x86_64。
• SHA256SUMS.txt 用于校验下载文件完整性。

Klick'r v4.0.5.17

本次更新

滑动过程中的图像识别

• 修复图像匹配置信度单位不一致的问题，高置信度目标在滑动过程中可单帧立即触发。
• 接近阈值的结果仍保留多帧确认，兼顾响应速度与防误判能力。
• 保留横向、纵向运动模糊容错，并继续校验颜色布局，避免模糊后匹配到相似图标。

数字识别

• 提高动态背景、复杂游戏画面、小尺寸描边数字的识别稳定性。
• 对原始画面和背景抑制后的增强画面进行多路识别，并通过结果共识选择可靠数字。
• 优先识别完整数字区域，减少 124 被截断为 24、16 漏识别等情况。
• 修复 =、>=、<= 数字比较逻辑和阈值语义。
• 调试面板统一使用百分比显示识别置信度，实际识别数值仍用于条件比较。

框选体验

• 数字检测区域现在可以缩小到接近图像识别选框的尺寸，方便精确框选单个数字。
• 保留文字识别所需的最小区域限制，避免影响文字 OCR 稳定性。

下载说明

• 不确定设备架构时，请下载 Klickr-4.0.5.17-universal-release.apk。
• 常见安卓真机推荐 arm64-v8a，文件更小。
• 安卓模拟器通常选择 x86_64。
• SHA256SUMS.txt 可用于校验下载文件完整性。

完整变更记录：v4.0.5.16...v4.0.5.17

Klick'r v4.0.5.16

本次更新

场景执行速度优化

• 修复运行完整场景时，一个事件完成后需要等待数秒才处理下一个事件的问题。
• 图片条件的快速确认改为依据各自设置的“允许差异”动态计算，不再统一要求达到 98% 置信度。
• 明显满足条件的图片可在首帧直接触发，减少重复扫描全部事件造成的等待。
• 接近识别临界值的图片以及“图片不可见”条件仍保留多帧稳定确认，兼顾响应速度和防误触能力。
• 事件执行后继续清理旧画面的确认状态，避免场景切换后使用过期识别结果。

性能诊断

• 增加慢条件识别、慢动作执行和慢场景帧日志，便于继续定位 OCR、动作等待或复杂场景造成的耗时。

验证

• processing 模块完整单元测试通过。
• GitHub Actions 正式签名 Release 构建通过。
• 已生成 universal、arm64-v8a、armeabi-v7a、x86 和 x86_64 APK。

下载说明

• 不确定设备架构时，请下载 Klickr-4.0.5.16-universal-release.apk。
• 常见安卓真机优先下载 Klickr-4.0.5.16-arm64-v8a-release.apk，文件更小。
• 安卓模拟器通常选择 x86_64，较老模拟器可选择 x86。
• SHA256SUMS.txt 用于校验下载文件完整性。

完整变更记录：v4.0.5.15...v4.0.5.16

Klick'r v4.0.5.9

本次更新

悬浮控制菜单改版

• 智能场景和简单场景的运行菜单统一改为紧凑的圆角图标栏，减少遮挡游戏画面。
• 所有按钮统一为 56dp 触控区域，并缩小图标视觉尺寸，兼顾美观与易点击。
• 增加半透明深色背景、圆角、阴影和按压反馈，使菜单在不同游戏背景上都更清晰。
• 收起后只保留一个蓝色“控制中心”图标，并自动贴近最近的屏幕边缘；点击即可展开全部功能。
• 展开和收起时增加轻量缩放反馈，操作状态更加明确。

自动收起设置

• 悬浮菜单默认在空闲 5 秒后自动收起，避免长期占用屏幕空间。
• 设置页面新增“自动收起悬浮菜单”开关。
• 可选择 3 秒、5 秒、10 秒或 15 秒的收起延迟；关闭开关后菜单将保持展开。
• 操作菜单或拖动菜单时会重新计时，调试界面需要显示时不会错误收起。

场景切换稳定性

• 新增统一运行状态机，明确区分启动、运行、切换、停止等状态。
• 智能场景和简单场景改为独立运行适配器，减少两种脚本切换时的相互影响。
• 场景切换增加互斥保护，避免快速连续点击引起重复加载或界面与脚本状态不同步。
• 切换失败时会恢复原场景、原运行状态和原悬浮菜单；无法恢复时会安全停止服务。
• 优化悬浮层替换和录屏权限交接：简单场景切换到智能场景但没有录屏权限时，会自动进入授权流程。

质量验证

• 新增运行状态机测试，覆盖重复启动、快速切换、失败回滚和停止边界。
• 本地完整单元测试与 Android Lint 均通过。
• GitHub Actions 单元测试以及 Android 模拟器图像识别/OCR 测试均通过。

下载说明

• 不确定设备架构时，请下载 Klickr-4.0.5.9-universal-release.apk。
• 常见安卓真机可优先下载 Klickr-4.0.5.9-arm64-v8a-release.apk，体积更小。
• 32 位旧安卓设备可选择 Klickr-4.0.5.9-armeabi-v7a-release.apk。
• 模拟器通常选择 x86_64，较旧模拟器可选择 x86。
• SHA256SUMS.txt 用于校验下载文件完整性。

完整变更记录： v4.0.5.8...v4.0.5.9