這個範例要解決的問題
你想讓 OmO 幫你操作桌面(例如自動填表、截圖分析),但在 macOS 上第一次執行時,它說「supervisor not live」——你完全不知道缺了什麼權限、該去哪裡開。
v5.1.7 把這個體驗修好了:它會告訴你缺什麼、開對的面板、指名要啟用的 app。
第一步:先查狀態,不下載
omo doctor
v5.1.7 的 omo doctor 會回報 computer use 引擎的位置與來源。以下為資訊示意,並非 CLI 的逐字輸出:
Computer use engine:
location: /Applications/OmO.app/Contents/Resources/engine
source: app bundle (checksum verified)
status: ready
也可以用 /computer status 取得同樣的資訊。
第二步:跟著權限引導完成授權
如果缺少 Screen Recording 或 Accessibility 授權,v5.1.7 會:
- 自動開啟對應的 System Settings 面板(只開一次,不重複打擾)
- 指名需要啟用的是哪個 app
- 提示你結束並重新啟動該 app
隨堂測驗
OmO 說缺少 Accessibility 授權並自動打開了系統設定面板。你啟用後,下一步該做什麼?
💡 想先看個提示?
回想引導的三個步驟:開面板、指名 app、然後呢?
macOS 的 Accessibility 授權需要 app 重新啟動才會生效——v5.1.7 的引導明確提示「quit and relaunch it」。另外,
omo doctor 不會下載任何東西(包含權限),權限只能由使用者在系統設定中授予。第三步:理解 goal 邊界
v5.1.x 收緊了 goal 的觸發規則。假設你在 OpenCode 中說:
請繼續剛才的重構,先 pause 一下讓我看 diff
要真正控制 goal,用明確指令:
/goal pause
/goal resume
/goal clear
第四步:避免靜默 fallback
v5.1.x 修掉多個「系統在你不知情時換了行為」的問題。例如:
opencode run --agent sisyphus
- 傳入原始 config key(如
sisyphus):正確選用該 agent - 傳入category 或未知名稱:明確報錯,而不是靜默跑預設 agent
opencode run --agent nonexistent
# 會回報未知 agent;錯誤文字以實際版本輸出為準
第五步:跨平台小修正
v5.1.7 也修了幾個日常痛點:
| 情境 | 修正 |
|---|---|
| Windows 非英文語系解壓下載 | 不再因 tar 列出非 ASCII 月份名失敗 |
編輯無副檔名檔案(Makefile、shebang script) |
不再誤報「LSP errors detected」 |
| home 目錄 | 不再被當成專案(dotfiles 的 .git 不觸發安裝提示) |
常見誤區
| 誤區 | 事實 |
|---|---|
| 「omo doctor 會自動修好權限」 | doctor 只診斷,不下載、不修改 |
| 「文字裡的 pause 會暫停 goal」 | 只有明確 /goal 指令才變更 goal |
| 「–agent 傳錯名字會用預設」 | v5.1.7 起明確報錯 |
| 「權限啟用後立即生效」 | macOS 需重啟 app |
動手練習
- 跑
omo doctor確認 computer use 引擎狀態 - 若缺權限,跟著引導完成授權並重啟 app
- 測試
/goal pause與普通文字中的 “pause” 的差異
延伸閱讀
-
教學:
v517-permissions-and-boundaries——v5.1.7 完整說明 -
範例 011:
011-beta-upgrade-safe-recall——beta 升級的安全召回