Name: OCR Trigger Clicker
Author: Sid

核心功能

一套工具涵蓋文字偵測、圖片比對、流程編排與多任務管理。

OCR 文字辨識

基於 RapidOCR 引擎（PP-OCRv5 繁中模型，原生支援日文；English 語系自動改用英文專用模型，可選 DirectML GPU 加速）。可指定 ROI 精確比對，避免全螢幕干擾。

圖片比對

以圖找圖，支援多尺度搜尋與 NMS 篩選。適合無文字的按鈕或圖示。

多步驟流程

每條規則由有序步驟組成：偵測、點擊、按鍵、等待、跳轉、數值比對、圖片比對、提示訊息、滾輪、拖曳。

多任務管理

不同場景（不同遊戲、不同表單）建立獨立任務，規則完全隔離，一鍵切換。

OCR 即時診斷

即時顯示目前視窗內所有可辨識文字及其位置與信心度，選取目標後按「建立為新文字規則」一鍵填好偵測條件與位置。

安全與通知

前景保護、系統托盤常駐、on_fail 通知與自動停止群組，執行中更安心。

混合模式

遊戲只吃前景操控也能自動化——平時後台偵測零干擾，需要動作時才短暫切到前景點一下，隨即復原你的視窗與滑鼠。適合低頻動作任務。

錄製操作

按 F9 開始錄製，在遊戲裡點擊示範一遍，停止後自動轉成規則——不用一條條手動設定。

使用指引

從下載到啟動，最快 3 分鐘。

快速入門

下載安裝：從 GitHub Releases 下載 OCRTriggerClicker-win-Setup.exe，執行安裝後啟動工具（之後新版本會自動更新）。
選目標視窗：在工具列選取你要操控的視窗（遊戲、ERP 系統、瀏覽器等）。
建立群組：按工具列的「+ 群組」按鈕新增群組。預設是「執行一次」+「依序執行」。
加規則：在群組內按「+ 規則」按鈕新增規則，第一步選「偵測」，輸入你要找的文字。
用 OCR 診斷確認：按「OCR 診斷」確認文字有沒有被偵測到。
加動作步驟：偵測後面加「點擊（click）」或「按鍵（key）」。
測試：按「▶測試」確認規則是否正常觸發。OK 就按「啟動」開始跑。
不想手動設？錄製操作：按「錄製操作」（或 F9）錄一遍點擊示範，停止後自動轉成規則（只記錄滑鼠點擊，盡量點在文字或圖示上效果更好）。

進階技巧

縮小 ROI：偵測區域越小，OCR 速度越快。建議只框選包含目標文字的最小範圍。
加等待：在動作步驟之間加「等待（wait）」，讓畫面有時間變化。
用 jump 跳轉：在規則間跳轉（限同群組內），可實現條件分支流程。
用 compare 做數值判斷：對 ROI 內的數字做大於／小於／等於判斷。
用 match_image 圖片比對：截取圖片後框選偵測 ROI，適合無文字的按鈕辨識。
善用常駐監控：勾選「常駐監控」讓規則每幀都跑，適合做錯誤攔截。
用錄製當起點：複雜流程先錄一遍生成規則，再微調偵測文字與點擊位置，比從零開始快很多（點在 UI 文字或圖示上，轉換品質最好）。

工具教學

每個工具都有專屬功能，搭配使用能大幅降低設定難度。

OCR 診斷面板

即時顯示目標視窗中所有可辨識的文字、位置與信心度。

按主介面上的「OCR 診斷」按鈕。
面板開啟後，即時掃描目標視窗，列出所有辨識到的文字。
點選任一筆文字，可以看到它的位置（ROI）和信心度。
按「建立為新文字規則」自動帶入文字和 ROI。

ROI 框選

ROI（Region of Interest）就是你要偵測的畫面範圍。範圍越小，速度越快、準確度越高。

在偵測步驟中，按「框選偵測區域」按鈕。
主視窗自動最小化，目標視窗跳到前景。
在目標視窗上拖曳滑鼠，框選你要偵測的區域。
放開滑鼠後自動回到主視窗，ROI 座標自動填入。

Click Picker（點擊座標選取）

選取你要點擊的精確位置。

在點擊步驟中，按「選取點擊座標」按鈕。
主視窗最小化，目標視窗跳到前景。
在目標視窗上單擊你要點擊的位置。
自動回到主視窗，座標自動填入。可搭配「隨機偏移」避免被檢測。

match_image 圖片比對

以圖找圖，不受背景文字干擾。無文字可辨識的按鈕或圖示建議優先選用。

在步驟中選擇「match_image（圖片比對）」。
按「截取區域」從遊戲畫面截取圖片；必要時用「修剪圖片」把範圍剪到最準。
按「框選搜尋區域」框選搜尋範圍。
調整「相似度門檻」：預設 0.85，越高越嚴格。
按「測試比對」確認是否命中。

乾跑測試（Dry-run）

不實際執行動作，先看規則會發生什麼事。

選取你要測試的規則。
按「▶測試」按鈕。偵測步驟會實際截圖辨識，但點擊／按鍵不會真的執行。
查看結果，根據結果調整參數再測一次。

錄製操作（示範錄製）

不知道怎麼設定規則？直接錄一遍，工具自動轉成規則——不用一條條手動設定。

選取目標視窗，按「錄製操作」按鈕（或按 F9）開始錄製。
在遊戲裡正常點擊要做的事情，錄製期間不搶焦點，可照常操作。
再按一次 F9（或按「停止」）結束錄製。
選擇「建立新任務」或「併入既有任務」，每個錄製段會變成一個群組。

⚠️ 本模式只記錄滑鼠點擊（左鍵／右鍵／中鍵）。鍵盤按鍵、拖曳、滾輪不會被錄製——錄製時想「等一下再點」就直接放慢手速，不要按鍵盤。

錄製小技巧：點在「有東西」的地方，轉換品質更好

✅ 點在 UI 文字上方 → 自動轉成「等文字出現再點擊」，畫面縮放／同長寬比換解析度都不怕，最穩定。
✅ 點在 圖示／按鈕（無文字但有特徵）→ 自動轉成圖片比對（match_image）後點擊。
❌ 點在 空白處 → 只能轉成固定等待後點擊（純計時播放），換解析度或畫面位移後容易點錯位置。

💡 自動轉換：點在文字上 → 等文字出現再點擊；無文字但有圖示 → 圖片比對後點擊；空白處 → 固定等待後點擊。座標一律存為視窗比例，相同長寬比（16:9）換螢幕／換解析度不用重設。

▶ 看示範影片 — 一鏡到底示範錄製與轉換。

規則設計原則

先搞懂這四條原則，就能設計出大部分的腳本。

原則一：失敗就跳

規則的步驟從上往下跑。任何一步失敗，整條規則就結束，後面的步驟全部跳過、等下一次重新開始（除非該步驟把失敗處理改成「按下按鍵後繼續」）。

所以：動作步驟一定要放在偵測後面，沒偵測到就不會誤點，最安全。

原則二：等待只在成功後

把等待放在偵測後面：偵測成功才等待，偵測失敗就跳過等待，不會卡住。

想等畫面準備好再動作，直接在動作步驟裡設定「動作後延遲」即可，不必額外加一個等待步驟。

原則三：背景規則適合攔截型

勾選「常駐監控」的規則每一圈都會自己檢查，不受群組順序影響，適合處理緊急狀況（例如出現錯誤訊息立刻按掉）。

一般任務放在群組規則就好，不需要勾選「常駐監控」。

原則四：要推進就靠動作步驟

群組內的規則照順序一條接一條。要「完成並進到下一條」，規則裡要有實體動作（點擊／按鍵／拖曳／滾輪）；只放「偵測＋通知」會一直重複通知、停在原地。

想「各自出現就提醒」改用「常駐監控」；想在失敗時直接換下一條，把失敗處理設成「跳過此規則」。

常見腳本模式

以下四種模式涵蓋 80% 的使用場景。

模式一：循環任務

偵測到特定文字 → 執行動作 → 等待畫面變化 → 再偵測。重複循環。

detect（文字A）→ click → wait 1000ms → detect（文字B）→ click → wait ...

適用：遊戲日常 farming、表單重複填寫、批次處理。

模式二：錯誤攔截

背景規則每幀檢查，偵測到錯誤訊息就自動按掉。

detect（錯誤訊息）→ click（確認按鈕）

適用：長時間運算時自動處理彈窗、遊戲掉線自動重連。

模式三：數值監控

偵測特定數字，超過／低於門檻就觸發動作。

compare（數值 >= 100）→ click / key

適用：監控遊戲血量、進度百分比、庫存數量。

模式四：圖片比對

無文字時用圖片比對偵測按鈕或圖示。

match_image（圖片）→ click（匹配位置）

適用：遊戲介面按鈕辨識、無文字的 UI 元素。

腳本設計範例

四個完整範例，從簡單到進階。可以直接複製步驟順序到你的規則中。

範例一：遊戲日常 Farming

偵測到 NPC 對話「要開始了嗎？」→ 按「確定」→ 等 2 秒 → 偵測「任務完成」→ 按「領取獎勵」。

步驟 1: detect「要開始了嗎？」→
步驟 2: click「確定」→
步驟 3: wait 2000ms →
步驟 4: detect「任務完成」→
步驟 5: click「領取獎勵」

群組設定：「執行一次」。完成一輪後手動再按「啟動」，或改「循環執行」自動重複。

範例二：錯誤自動處理

遊戲彈出「連線中斷」視窗，自動按「重新連接」。

步驟 1: detect「連線中斷」→
步驟 2: click「重新連接」

勾選「常駐監控」，讓這條規則每幀都檢查。沒偵測到就跳過，不會卡住。

範例三：血量低於門檻自動喝藥

偵測到血量數字 <= 30% 就自動喝藥。

步驟 1: compare（ROI: 血量區域）數值 <= 30 →
步驟 2: key「F1」（喝藥快捷鍵）

compare 步驟會自動從 ROI 中抓數字。群組設定「循環執行」讓它持續監控。

範例四：偵測圖示按鈕自動點擊

遊戲中出現特定圖示（例如寶箱），自動點擊拾取。

步驟 1: match_image（圖片: 寶箱截圖）→
步驟 2: click（匹配位置）

相似度門檻從 0.7 開始調。先用「測試比對」確認命中率再正式啟動。

常見問題

初次使用前建議先閱讀，多數問題都能在這裡找到解答。

需要安裝 Python 或任何環境嗎？

不需要。從 GitHub Releases 下載 OCRTriggerClicker-win-Setup.exe 安裝後直接執行即可。

需要安裝任何外部程式嗎？

不需要。滑鼠與鍵盤模擬使用 pynput（Win32 SendInput API），完全內建。

支援哪些語言的文字辨識？

預設內建繁體中文 PP-OCRv5 RapidOCR 模型（含英文與數字辨識能力，亦原生支援日文假名與漢字）；介面切換為 English 語系時自動改用英文專用模型，英文辨識效果最佳。若要更換模型，需在 custom_models/ 資料夾中以相同檔名取代模型與字典檔案。

OCR 辨識速度如何？

處理速度視 ROI 大小與 CPU/GPU 效能而定。支援 DirectML GPU 加速（需 DirectX 12 顯卡）。

可以比對圖示或按鈕圖片嗎？

可以。步驟類型選擇 match_image（圖片比對），截取圖片並設定相似度門檻即可。

錄製操作會把我的操作都錄進去嗎？要怎麼開始？

按「錄製操作」按鈕或按 F9 開始錄製，錄製期間在遊戲裡正常點擊示範；再按一次 F9（或按「停止」）結束。停止後會跳出對話框，可選擇建立新任務或併入既有任務（每個錄製段變一個群組）。錄製不搶焦點，可安心操作。

⚠️ 注意：本模式只記錄滑鼠點擊（左／右／中鍵），鍵盤按鍵、拖曳、滾輪不會被錄製。錄製時想等畫面變化，就直接放慢手速，不要按鍵盤。

錄製轉出來的規則為什麼有些是「等文字出現」有些是固定等待？

轉換時會自動判斷每次點擊：點在文字上 → 轉成「偵測該文字後點擊」（等畫面出現再點，較穩定）；點在無文字的圖示上 → 嘗試轉成圖片比對（match_image）後點擊；點在空白處或找不到特徵 → 轉成固定等待後點擊。三種都自動處理，不需要手動挑。

💡 錄製小技巧：點擊時盡量瞄準 UI 文字或圖示等「有特徵」的位置，轉換品質最好；避免點空白處，否則只能變固定等待、換解析度後容易點偏。

規則沒偵測到文字會怎樣？會卡住嗎？

不會卡住。規則的步驟從上往下跑，但如果某一步失敗，整條規則就結束，後面的步驟全部跳過（預設的失敗處理就是「跳過本次」，不必額外設定）。

偵測成功 → 執行等待 → 繼續下一步。
偵測失敗 → 直接跳過等待和後續動作，不會卡關。

注意：當等待正在倒數時，全部規則（含背景規則）都會暫停，只有按「停止」才能中斷。

多個規則可以同時執行嗎？

群組內的規則依序執行，一次只執行一條。常駐監控規則則每幀都會執行，不受群組順序影響。

依序跟並行有什麼差別？

依序（↻）：從第一條規則開始，沒觸發就卡住（一直重試），觸發了才換下一條。像排隊。
💡 什麼算「觸發」：要做出實體動作（點擊／按鍵／拖曳／滾輪），或用 on_fail「跳過此規則（advance）」才代表完成、進到下一條。只放「通知(notify)」不算動作——規則會一直重複通知、卡在原地。
並行（∥）：每幀從頭掃全部規則，第一條符合的就做，做完就結束這一輪。像搶答。

要怎麼讓程式先做 A 再做 B？

把 A 規則放在 B 前面（同群組用「依序執行」），A 觸發後指標才會走到 B。或在不同群組，把 A 群組排在 B 群組前面。

規則設定檔存在哪裡？

設定檔與任務資料儲存在 %APPDATA%\ocr-trigger-clicker\，刪除 exe 後設定仍會保留。

不同解析度可以通用嗎？

座標一律存為視窗比例，只要遊戲視窗長寬比不變（遊戲通常會鎖定比例），同長寬比解析度間可自動通用——例如 1920×1080 與 1600×900 互換不用重設。

⚠️ 長寬比不同時遊戲 UI 布局會重排，ROI／點擊位置偏移，需重新框選調整。
⚠️ 圖片比對有限制：match_image 的縮放搜尋範圍約 0.5~2 倍，解析度差距過大時可能找不到；文字偵測（OCR）不受此限。
💡 通用性以任務來源解析度為基準：用自己解析度建立的任務最穩定；匯入他人分享的任務前，確認來源解析度長寬比與自己一致（分享時請註明來源解析度）。Windows 系統顯示縮放建議與建立任務時一致。

遊戲沒反應怎麼辦？

試試按右鍵 → 以系統管理員身分執行。部分遊戲需要管理員權限才能接收模擬輸入。

可以後台掛機嗎？

可以。偏好設定中選擇「後台模式」（Frida 注入）後，工具改用 PrintWindow 截圖 + Frida 注入點擊與按鍵，目標視窗可被其他視窗遮蓋（但不能最小化），零游標干擾、不搶焦點。

⚠️ 若遊戲不給後台，尤其是多數 Unity 開發的遊戲，這是遊戲本身的底層設計限制、不是工具的問題——Unity 用 GPU 直接繪製畫面（不經 PrintWindow 這條 Windows 相容繪圖路徑），輸入也走自己的低階輸入系統（不接收 PostMessage 這類舊式視窗訊息），所以後台看不到畫面、也點不進去。遇到這種情況可以改用混合模式：平時以後台截圖偵測、零干擾，需要點擊／按鍵時才自動把遊戲短暫切到前景操作，完成後復原你原本的視窗與滑鼠位置。適合低頻動作的任務——例如遊戲正在自動戰鬥爬主線、只有過關時要點「下一關」，寫好規則後就能掛著去做別的事；動作很頻繁的話，一般前景模式反而更順。

實際例子：棕色塵埃 2（Unity）後台滑鼠點擊可用，但後台鍵盤會被遊戲擋下——滑鼠與鍵盤是分開驗證的，後台滑鼠可用不代表鍵盤也可用（部分遊戲必須視窗聚焦才接收鍵盤輸入）。

後台截圖出現黑畫面？

部分遊戲（例如鳴潮）在工具沒有以系統管理員身分執行時，會拒絕把畫面交給 PrintWindow 繪製，導致截圖全黑、偵測不到任何文字。解法：關閉工具 → 按右鍵 → 以系統管理員身分執行重開。也可以把捷徑設成「一律以系統管理員執行」。

OCR Trigger Clicker