這篇是 Mika 的安裝與使用教學。本站的實測是在電腦上用 Android 模擬器做的，所以這裡分兩條路：在自己的手機上裝（照官方流程），以及在電腦的模擬器上裝（本站實際走過的每一條指令）。裝之前請先讀過實測文的安全段落，知道自己交出去的是什麼權限。
開始前
- 手機：Android 12 以上才能操作 App，官方建議 14 以上；Android 11 只能用聊天、網頁和檔案功能。Linux 沙箱只支援 arm64 手機。
- 模型：一把支援工具呼叫的模型 API 金鑰（或 ChatGPT Plus／Pro 帳號）。要用地端模型的話，電腦上跑 Ollama 或 LM Studio，並讓它接受區域網路連線。
- 電腦模擬器路線：Linux 或 macOS 電腦、至少 16 GB 記憶體、支援硬體虛擬化（Linux 要能讀寫 /dev/kvm）、約 5 GB 磁碟空間、Java 17 以上。
路線一：裝在自己的手機上
步驟 1：下載安裝 APK
到專案的 Releases 頁下載最新的 APK（本站測的是 v0.1.22，約 88 MB）安裝。Android 會提示來源不明的 App，要允許這個來源安裝。
步驟 2：設定模型
第一次開啟會進入精靈。先按「Add provider」，從清單挑服務商填 API 金鑰，或按「Continue with ChatGPT」用帳號登入。地端模型選「Ollama」，把 Base URL 的 127.0.0.1 改成電腦在區域網路的位址（例如 http://192.168.1.20:11434/v1），電腦端的 Ollama 要設 OLLAMA_HOST=0.0.0.0 才接得到。按「Test and save」，Mika 會列出模型並請其中一個呼叫測試工具，兩者都成功才算接上。
接著在「Roles」指定主模型；視覺模型可以留空（只用文字讀畫面），輕量模型可以直接用主模型。
步驟 3：設定手機操作
精靈的「Phone control」頁有六個項目，照順序做：
1. 開啟開發者選項：設定 → 關於手機 → 連點「版本號碼」七次。
2. 開啟 USB 偵錯（開發者選項裡）。
3. 開啟 Mika 的無障礙服務：可以跳過，配對成功後 Mika 會自己打開。
4. 開啟無線偵錯（開發者選項裡；手機要連著 Wi-Fi，不需要網路）。
5. 用配對碼配對：在無線偵錯頁按「使用配對碼配對裝置」，把六位數字填進 Mika 的通知欄。只需要一次。
6. 自動連線：配對後 Mika 會自己啟動它的常駐助手。
全部完成會顯示「Phone control is set up」。手機重開機後，重新打開無線偵錯，Mika 會自動重連。
步驟 4：交代第一件事
回到對話頁，用一句話交代。建議先從看得到結果、又不會送出任何東西的任務開始，例如「打開時鐘 App，設一個明天早上 7:30 的鬧鐘，標籤寫實測，設好後告訴我鬧鐘清單」。它會在角落的小畫面裡操作，完成後回報。
路線二：裝在電腦的 Android 模擬器上（本站實際流程）
這條路線不碰自己的手機，適合先觀察它的行為。以下在 Ubuntu 24.04 上做，全部在使用者目錄，不需要 sudo（除了 KVM 權限）。
步驟 1：確認 KVM 可用
ls -l /dev/kvm sudo setfacl -m u:$USER:rw /dev/kvm
成功時 /dev/kvm 存在，而且目前使用者可以讀寫。沒有這一步，模擬器會報「x86_64 emulation currently requires hardware acceleration」。
步驟 2：裝 Android SDK 指令列工具與模擬器
mkdir -p ~/mika-emu/sdk && cd ~/mika-emu export ANDROID_SDK_ROOT=$HOME/mika-emu/sdk ANDROID_HOME=$HOME/mika-emu/sdk curl -sLo clt.zip https://dl.google.com/android/repository/commandlinetools-linux-13114758_latest.zip mkdir -p sdk/cmdline-tools && unzip -qo clt.zip -d sdk/cmdline-tools && mv sdk/cmdline-tools/cmdline-tools sdk/cmdline-tools/latest SM=sdk/cmdline-tools/latest/bin/sdkmanager yes | $SM --licenses >/dev/null $SM "platform-tools" "emulator" "system-images;android-35;google_apis_playstore;x86_64"
成功時 sdk/ 約 3.2 GB，裡面有 platform-tools/adb 和 emulator/emulator。系統映像選 Android 15 含 Google Play 的版本，才有 Chrome、地圖、YouTube 這些 App 可以測。
步驟 3：建立虛擬裝置並啟動
echo no | sdk/cmdline-tools/latest/bin/avdmanager create avd -f -n mika -k "system-images;android-35;google_apis_playstore;x86_64" -d pixel_7 sdk/emulator/emulator -avd mika -no-window -no-audio -gpu swiftshader_indirect -memory 4096 -cores 4 & sdk/platform-tools/adb wait-for-device shell getprop sys.boot_completed
成功時最後一行印出 1。本站用無視窗模式，截圖用 adb exec-out screencap -p > shot.png 看畫面；要看視窗就拿掉 -no-window。本站這台開機 24 秒。
步驟 4：安裝 APK 並開啟一次
curl -sLo Mika.apk https://github.com/wangzan101/Mika/releases/download/v0.1.22/Mika-v0.1.22.apk sdk/platform-tools/adb install -r Mika.apk sdk/platform-tools/adb shell monkey -p com.wangzan101.mika -c android.intent.category.LAUNCHER 1
成功時 adb install 印出 Success，模擬器畫面出現「Hi, I'm Mika」的歡迎頁。一定要先開啟一次，Mika 才會把下一步要用的腳本寫到手機儲存空間。
步驟 5：設定模型
照路線一的步驟 2 操作，差別在位址：模擬器裡 10.0.2.2 代表電腦本機，所以 Ollama 的 Base URL 填 http://10.0.2.2:11434/v1。本站是在電腦上多架了一層記錄代理，Mika 送給模型的每一筆內容都會留下紀錄，金鑰也不交給 App；作法見實測文。
步驟 6：用電腦啟動手機助手（不用配對）
模擬器不方便做無線偵錯配對，官方提供了從電腦啟動助手的方式：
sdk/platform-tools/adb shell sh /sdcard/Android/data/com.wangzan101.mika/files/usb-start.sh
成功時印出 Mika helper starting... Open Mika to confirm phone control is ready.，Mika 的「Phone control」頁會變成「Phone control is set up」，無障礙服務也會被自動打開。模擬器重開後要再跑一次。
步驟 7（選用）：開 MCP，從電腦派任務
sdk/platform-tools/adb shell sh /sdcard/Android/data/com.wangzan101.mika/files/connect-computer.sh sdk/platform-tools/adb forward tcp:8765 tcp:8765
第一條會印出 MCP 的位址（http://127.0.0.1:8765/mcp）和令牌。把它們填進電腦上支援 MCP 的 AI 工具，就能用 mika_run_task 派任務、mika_wait_task 等結果。本站的實測全部是這樣派的，好處是中文任務不用在模擬器裡打字。沒帶令牌的請求會得到 401，帶了 Origin 標頭的一律 403，而且只聽本機。
確認裝好了
交代一件能驗證的事，例如設鬧鐘，然後用 adb shell dumpsys alarm | grep deskclock 看系統裡是不是真的多了一筆。本站用地端 Qwen3.8 27B 跑這一題花了 361 秒，用 Claude Sonnet 5.5 花了 16 秒，兩者都設對了。
可能遇到的問題
1. 模擬器起不來、說需要硬體加速：/dev/kvm 權限掉了，重跑步驟 1 的 setfacl；本站重開模擬器時就遇過一次。
2. Mika 的「Phone control」突然顯示「Accessibility service isn't running」，任務開始亂按：如果你在電腦上用 uiautomator dump 之類的工具讀模擬器畫面，Android 會暫停其他無障礙服務。改用截圖觀察，然後把無障礙服務關掉再打開（adb shell settings delete secure enabled_accessibility_services，再 put 回 com.wangzan101.mika/com.wangzan101.mika.a11y.MikaAccessibilityService）。
3. 「Test and save」逾時：地端模型第一次載入要時間，Mika 只等 20 秒；先在電腦上跑一次模型讓它進記憶體，再按一次。
4. 表單打不到字：模擬器裡用 adb shell input text 只能輸入 ASCII；中文任務請走步驟 7 的 MCP。
接下來
裝好之後，先在「Settings › While working」看一下預設行為：詢問模式只在付款前問你，其他動作直接做。本站在實測文裡整理了這個設計在繁體中文環境的盲點，以及地端模型和雲端模型在同一組任務上的速度與花費差距。
- 它是什麼、解決什麼問題：Mika 是什麼：在後台螢幕替你操作手機 App 的開源 AI 代理
- 本站的實測與安全審查：Mika 實測：地端 Qwen 對上 Claude，以及把手機交給它之前要知道的事
