Running from Source zh TW

English: Running-from-Source

從原始碼執行

Python 核心

python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"

只用命令列（無 GUI）

1. 裁切一張想偵測目標的截圖，放到 targets/ 資料夾裡。

2. 複製 rules.example.json 為 rules.json，修改 roi（要監控的螢幕區域，絕對像素座標）與 image 路徑。

3. 執行：

   python -m core.run rules.json

新規則預設 "dryRun": true——引擎只會記錄命中結果，不會真的點擊或輸入任何東西。確認辨識穩定後，再手動把它改成 false。任何時候按下 Ctrl+Alt+Q 都能立即停止引擎。

GUI（Electron）

1. 啟動 Python 伺服器（只綁定 127.0.0.1:8765，不對外開放）：

   python -m core.server --rules-path rules.json

2. 開另一個終端機，安裝並啟動 GUI：

   cd gui
   npm install
   npm run dev

   npm run dev 會同時啟動 Vite 開發伺服器與 Electron。關閉視窗只會縮到系統匣，不會真的結束程式——要離開請用系統匣選單裡的「Quit」。

另請參閱 自己建置安裝檔 來自己打包成可散布的安裝檔。