Skip to content

Your First Script zh TW

Jump to bottom
Claude edited this page Oct 16, 2026 · 3 revisions

第一支腳本

腳本在電腦上用 VS Code 寫，透過 Wi-Fi 在手機上執行。這頁從安裝擴充套件開始，寫到一支會打開 Android 設定、並點擊畫面上認出的東西的腳本。每一步的細節見擴充套件說明，API 見 docs/lua-api.md。

腳本是什麼

腳本是手機上的一個資料夾，裡面有 main.lua，選填的 script.json（名稱、說明、要用的虛擬顯示器），以及用到的模板圖片。

1. 安裝擴充套件

需要 VS Code 1.90 以上（或 VSCodium、Cursor 等使用 Open VSX 的編輯器），手機和電腦在同一個 Wi-Fi 網路。在擴充套件面板搜尋 MoonClicker，安裝「MoonClicker 腳本工作台」，之後會自動更新。擴充套件的介面跟隨 VS Code 的顯示語言，以下用中文介面的名稱。

擴充套件與 App 的版本號前兩碼要相同，例如擴充套件 0.5.x 配 App 0.5.x。

2. 在手機上開啟腳本工作台

  1. 在 MoonClicker 的「設定 → 關於」連按版本號七下，解鎖「開發人員選項」。
  2. 打開「設定 → 開發人員選項」，開啟「腳本工作台（Script Workbench）」，再點「開啟配對模式」。畫面會顯示六位數 PIN 碼，五分鐘內有效。

Android 17 還要在「設定 → 權限與系統功能」允許「區域網路權限」，否則 VS Code 連不進來。

3. 連線

  1. 在 VS Code 活動列打開「MoonClicker 腳本」，點「連線到裝置」。
  2. 從清單選擇你的手機。找不到時選「手動輸入 IP:port」，輸入手機上「腳本工作台」下方顯示的伺服器位址。
  3. 輸入 PIN 碼。
  4. 第一次連線時，VS Code 會請你選一個本機資料夾存放這支手機的腳本。選一個空資料夾，它會在目前視窗開啟。手機上每支腳本是其中一個子資料夾，連線期間兩邊的改動會互相同步。

4. 建立腳本

點側邊欄標題列的「新增腳本」，輸入名稱，例如 hello（小寫英數字、.、_、-），它的 main.lua 會自動打開。

讓它在背景的虛擬顯示器上跑：打開 hello/script.json，改成

{
  "uniqueId": "hello",
  "name": "Hello",
  "display": { "width": 720, "height": 1280 }
}

再寫 main.lua：

log("hello from MoonClicker")
app.launch("com.android.settings")
sleep(2000)

5. 執行

游標在 main.lua 裡時按 F5。VS Code 會存檔、同步，然後在手機上執行：建立虛擬顯示器並在上面打開設定。日誌顯示在 VS Code「輸出」面板的 MoonClicker Script Log。Shift+F5 停止執行中的腳本；同時有好幾支在跑時，VS Code 會問要停哪一支。

不同顯示器上的腳本可以同時執行，各有自己的通知、日誌與資料。一個顯示器同時只跑一支腳本，目標顯示器被佔用時會回報是哪支腳本在用。

6. 辨識畫面上的東西

  1. 從側邊欄標題列打開 Workbench 面板，它會即時顯示虛擬顯示器的畫面；如果選的是別的顯示器，切換過去。
  2. 在「1 · 採集」點「立即擷取」。再到「2 · 建立模板」框住設定畫面上的一個東西，例如搜尋圖示，「所屬腳本」選 hello，「模板名稱」填 search，點「儲存模板」。圖片會存成腳本資料夾裡的 search.png，並同步回電腦。
  3. 把 sleep(2000) 換成：
local hit = vision.wait("search.png", 5000)
if hit then
    log("找到了", hit.cx, hit.cy)
    input.tap(hit.cx, hit.cy)
else
    log("沒找到")
end
  1. 再按一次 F5。腳本最多等五秒，找到圖示就點下去。

要找文字而不是圖片，先下載 OCR 元件（執行範例腳本第 1 步），再用 vision.wait({ text = "搜尋" })。寫程式之前，可以先在 Workbench 面板對即時畫面測試模板與 OCR。範例解說有一支比較完整的腳本。

Home

English

正體中文

Clone this wiki locally