[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. 鄭重承諾：本軟件無毒無害，僅用于幫助別人節省時間。