Theme / v5.1.7

Oh My OpenAgent

AI 代理編排系統

實戰範例

實戰範例 012:用 v5.1.7 的權限引導與 goal 邊界安全操作

v5.1.7 新功能實戰:用 omo doctor 檢查 computer use 引擎、跟著權限引導完成 macOS 授權,並理解 goal 邊界如何避免誤觸。

這個範例要解決的問題

你想讓 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 會:

  1. 自動開啟對應的 System Settings 面板(只開一次,不重複打擾)
  2. 指名需要啟用的是哪個 app
  3. 提示你結束並重新啟動該 app
隨堂測驗

OmO 說缺少 Accessibility 授權並自動打開了系統設定面板。你啟用後,下一步該做什麼?

💡 想先看個提示?

回想引導的三個步驟:開面板、指名 app、然後呢?


第三步:理解 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

動手練習

  1. 跑 omo doctor 確認 computer use 引擎狀態
  2. 若缺權限,跟著引導完成授權並重啟 app
  3. 測試 /goal pause 與普通文字中的 “pause” 的差異

延伸閱讀

  • 官方 v5.1.7 release notes

  • 教學:v517-permissions-and-boundaries——v5.1.7 完整說明

  • 範例 011:011-beta-upgrade-safe-recall——beta 升級的安全召回