[toc]
# clicker使用手册
### 介绍
clicker是一款强大的鼠标点击软件。她可以帮你解放双手，自动识别屏幕内容完成一些重复度较高的操作。
假如你是一名游戏爱好者，长期玩一个游戏是不是占用了你很多的学习、生活、运动时间？有没有幻想过，你的电脑可以自动帮你玩游戏？登登~看到我，你就可以开着游戏撩着妹，离梦想不远啦~~
本软件适用于仅靠点击鼠标就能操作的游戏，不少网页游戏如“火影忍者ol”、"鼠标射击类"等等。
### 软件下载
欢迎下载软件试用~
链接：https://pan.baidu.com/s/14L92UCs_-_7sRYJG5-BxxA
提取码：mus4
### 功能特点
1. 灵活度高，支持自定义任务；
2. 可在一个配置文件中配置多个任务，并可为每个任务设置次数、点击频率；
3. 善用关键字可以减少系统运行的IO；
4. 从设计上讲，可以把clicker当做一个基于图片命名的“编程工具”。
### 基础篇——使用说明
以下示例以游戏”火影忍者Online“为例，并提供了部分功能的配置和图片设置：
1. 目前仅支持在windows系统中运行，无需安装任何环境；
2. 下载软件后，必须保持clicker.exe文件与images文件夹在同一路径下；为了使用方便，可以把clicker的快捷方式发送到电脑桌面。
3. 运行exe文件，从`config`文件夹中，选择您要做的任务的配置文件。
4. 然后，任务就可以自动进行啦！
### 高级篇——自定义任务
#### 自定义任务步骤
##### 1-创建任务文件夹
在images文件夹下添加任务截图文件夹，并以`task_`+任务名开头标识任务截图文件夹。
##### 2-在文件夹下新增截图
推荐以数字开头，目前约定长度为4位，代表图片在windows中的排序；
##### 3-config目录下新增配置文件
新建`.txt`文件并重命名为`任意名称.ini`，按照demo添加参数配置。
参数说明：
- task {taskname}：任务名称
- times：代表任务重复执行几次
- index：代表任务开始节点
- rate：该参数影响截屏、点击速率，建议设置范围在1-2s之间，太快或太慢都不太好。示例代码：
```ini
# 定义羁绊任务
[jiban]
times=20
index=0
rate=2
```
3. 一个.ini配置文件中支持增加多个任务，但任务名称不能同名，先后如有相同的操作，请设置不同的任务名称。如：
```ini
[reset]
times=1
index=0
rate=1.4
[qiangzhe]
times=1
index=0
rate=1.4
# 与第一步操作相同，但不能同名
[reset2]
times=1
index=0
rate=1.4
```
#### 自定义任务规范
##### 任务设置关键字
| 截图关键字 | 说明 |
| -------------- | -------------------------------------------------------- |
| `start_delay` | 当前节点点击后，进入等待状态，直到退出按钮或公共按钮的出现；一般在开始按钮时使用。羁绊中可以使用。 |
| `delay_now` | 需要在任务配置中，插入一个名称包含`delay_now`的图片文件，表示任务会等到页面中撤退按钮消失才会继续查找下一个节点；在副本任务中有用到。 |
| `once_`或者`_once` | 表示当前节点如果找不到就算了，直接进入下一个节点。 |
#### 执行调优
系统提供了日志文件，供大家发现配置问题，以进一步优化脚本。日志路径在：解压exe文件所在路径下。日志格式如下：
```
2020-06-26 23:57:16,496 - basic\logger.py[line:39] - INFO: [step-8]======================1008-failed.png
2020-06-26 23:57:16,730 - basic\logger.py[line:39] - INFO: 第9次尝试点击，但是未找到按钮[1008-failed.png]休息2s后继续……
2020-06-26 23:57:18,732 - basic\logger.py[line:39] - INFO: [step-8]======================1008-failed.png
2020-06-26 23:57:18,947 - basic\logger.py[line:39] - INFO: 第10次尝试点击，但是未找到按钮[1008-failed.png]轮询模式启动……
2020-06-26 23:57:18,949 - basic\logger.py[line:39] - INFO: 系统已进入轮询模式~~
2020-06-26 23:57:18,950 - basic\logger.py[line:39] - INFO: [polling-8]======================1008-failed.png
2020-06-26 23:57:19,167 - basic\logger.py[line:39] - INFO: 本次轮询未找到匹配的按钮
2020-06-26 23:57:20,170 - basic\logger.py[line:39] - INFO: [polling-9]======================1009-return_ten.png
2020-06-26 23:57:20,389 - basic\logger.py[line:39] - INFO: 本次轮询未找到匹配的按钮
2020-06-26 23:57:21,392 - basic\logger.py[line:39] - INFO: [polling-10]======================1010_return_ten.png
2020-06-26 23:57:21,673 - basic\logger.py[line:39] - INFO: 本次轮询未找到匹配的按钮
2020-06-26 23:57:22,676 - basic\logger.py[line:39] - INFO: [polling-1]======================1001-once_menu.png
2020-06-26 23:57:22,975 - basic\logger.py[line:39] - INFO: 本次轮询未找到匹配的按钮
2020-06-26 23:57:23,977 - basic\logger.py[line:39] - INFO: [polling-2]======================1002-once_limit.png
2020-06-26 23:57:24,247 - basic\logger.py[line:39] - INFO: 本次轮询未找到匹配的按钮
2020-06-26 23:57:25,251 - basic\logger.py[line:39] - INFO: [polling-3]======================1003-once_chooseTask.png
2020-06-26 23:57:25,713 - basic\logger.py[line:39] - INFO: 系统正在操作按钮：1003-once_chooseTask.png
2020-06-26 23:57:25,715 - basic\logger.py[line:39] - INFO: 轮询模式已关闭
2020-06-26 23:57:29,725 - basic\logger.py[line:39] - INFO: 第2次任务已执行完毕
2020-06-26 23:57:29,727 - basic\logger.py[line:39] - INFO: [step-4]======================1004-once_partispate.png
2020-06-26 23:57:29,995 - basic\logger.py[line:39] - INFO: 该按钮点击一次就够了哦~即将跳过当前操作
2020-06-26 23:57:29,996 - basic\logger.py[line:39] - INFO: [step-5]======================1005-once_getIn.png
2020-06-26 23:57:30,260 - basic\logger.py[line:39] - INFO: 该按钮点击一次就够了哦~即将跳过当前操作
2020-06-26 23:57:30,262 - basic\logger.py[line:39] - INFO: [step-6]======================1006-once_confirm.png
2020-06-26 23:57:30,475 - basic\logger.py[line:39] - INFO: 该按钮点击一次就够了哦~即将跳过当前操作
```
##### 经典场景支持
羁绊：
1. 为了减少截屏频次，使用`start_delay`开始后，等待“公共”按钮的出现，并完成点击；
2. 但是公共按钮点击后，还有一层公共按钮——“蓝色确定”或“橙色确认”，为了尽早让系统自动开启轮询模式，可以设置max参数的值小一些。
### 问题排查
1.系统一直打印日志：”[任务执行中，系统正在等待“撤退”按钮出现,5s后再扫描一遍]“，不再向下执行。
【解答】出现该问题的原因是，common文件夹中的公共按钮，如退出、确认、失败等按钮截图不存在或匹配失败。
### 郑重承诺
1. 本软件不属于游戏外挂，仅适用于操作无聊、简单、重复高的场景；
2. 郑重承诺：本软件无毒无害，仅用于帮助别人节省时间。
