TechSpecs搜尋

Theme / v5.1.7

Oh My OpenAgent

AI 代理編排系統

主題首頁GitHub ↗
基礎觀念

v5.1.7：權限引導、引擎透明化與邊界修正

v5.0.0 → v5.1.7 的升級重點：macOS 電腦使用權限自動引導、engine 來源透明化、OpenCode goal 邊界與 agent 別名修正。含互動測驗與升級檢查清單。

概述

涵蓋 v5.0.1 ～ v5.1.7（2026-09-27 ～ 09-30，九個版本）。這是 OmO Native 成為 stable 之後的第一條穩定化支線——沒有大型新架構，重點在讓 computer use、goal 邊界與多 host 行為變得可預期：

主軸 一句話
權限引導 缺 Screen Recording / Accessibility 授權時，自動開對的設定面板並告訴你啟用什麼
引擎透明化 /computer status 與 omo doctor 說出 engine 在哪、從哪來
Goal 邊界 一般聊天不再變成 goal；goal 只經明確指令變更
跨平台 Windows 非英文語系、無副檔名檔案、home 目錄誤判專案

Computer use：說清楚它需要什麼

macOS 電腦使用功能的最大痛點從來不是能力，而是權限與來源不明。v5.1.7 一次補齊：

權限引導（自動打開對的面板）

缺少 Screen Recording 或 Accessibility 授權時：

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

被拒的 Accessibility listener 現在讀為權限問題——而不是莫名其妙的「supervisor not live」。

引擎來源透明化

/computer status 與 omo doctor 現在回報：

  • engine 的位置：app bundle 內、cache、或你設定的路徑
  • engine 的來源：它怎麼出現在那裡的
  • 不支援的 host 有一致答案

而且 omo doctor 不會下載 engine——查狀態就是查狀態，不會有副作用。

下載安裝信任自家引擎

從網路下載的 macOS 安裝，過去因 quarantine（隔離）標記讓自家附帶的 engine 看起來不可信。現在：engine 在 app 內且通過隨附 checksum 即信任；其他被隔離的 engine 仍然拒絕。

Goal 邊界：聊天歸聊天、目標歸目標

v5.1.x 收緊了 goal 的觸發與維護規則：

  • 一般聊天不再變成 goal：包含 pause / resume / clear 的訊息不會動到既有 goal
  • 超過 2,000 字元的 prompt 不再誤判為 goal 而 InvalidObjectiveError
  • Goal 只經兩條路變更：明確的 /goal 指令，或 default_mode.goal 開啟時的第一則訊息
隨堂測驗

小王在 OpenCode 中對 agent 說「請繼續剛才的重構，先 pause 一下讓我看 diff」。v5.1.7 的行為是？

💡 想先看個提示？

回看「Goal 只經兩條路變更」的規則。

OpenCode 與 Codex 的行為修正

OpenCode（v5.0.1 ～ v5.1.7）：

  • Hephaestus 選了非 GPT 模型：明確報 HephaestusRequiresGptError 而非 UnknownError
  • opencode run --agent sisyphus 等原始 config key 在 display name 套用後仍可選用
  • 傳入 category 或未知名稱給 --agent：明確報錯，而不是靜默跑預設 agent

Codex（v5.1.7）：

  • 更新時移除 Codex 0.156 拒絕的退役設定 features.child_agents_md，啟動不再失敗
  • bundled Hephaestus 規則的 spawn 範例指名 agent_type——照著範例做不再被 spawn guard 擋下

跨平台（v5.1.7）：

  • Windows 非英文語系：下載解壓不再因 tar 列出非 ASCII 月份名失敗
  • 無副檔名檔案（shebang script、Makefile）：不再誤報「LSP errors detected」
  • home 目錄不是專案：dotfiles 的 .git 或孤兒 ~/package.json 不再讓語言伺服器安裝提示對 home 裡每個檔案都觸發

隨堂總結測驗

隨堂測驗

`omo doctor` 在檢查 computer use 時，下列哪個行為是 v5.1.7 保證的？

💡 想先看個提示？

診斷與修復是兩種不同的工具職責——哪個可以動手、哪個只能看？

動手升級檢查清單

升級 v5.1.7：動手檢查清單

逐項勾選，確認你已完成升級必要的步驟（進度會保存在此瀏覽器）

0 / 6

延伸閱讀