Local 配對、能力與可用性

配對是使用者控制的流程，不是 Agent task。桌面 app 會開啟已登入的瀏覽器授權頁；平台建立一次性 pairing code，再由桌面 app claim 以綁定裝置。Agent 只能引導使用者完成流程，不能替使用者配對、取得或處理 pairing credential。

裝置 capability opt-in 持久化在平台，app 重啟不會歸零。Agent grant 以 per-device、per-Agent 保存，而且一個 Agent 只能指派給一台桌面裝置。實際可用集合還要與當前 runtime 廣告的 capabilities、裝置 opt-in 取交集。關閉裝置 capability 會保留暫停中的 Agent grant，重新啟用後即可恢復；Agent access UI 會灰顯這些 grant，並提供明確的「重新授權全部目前啟用 capability」操作。Revoke 或 kill 會中斷工作、取消 active call、撤銷 active approval bypass，並讓 local actions 不可用；revoke 也會移除 Agent 指派。

LOCAL_DESKTOP_NOT_CONNECTED 應引導開啟或配對 app。LOCAL_CAPABILITY_UNAVAILABLE 表示 live runtime 沒有廣告能力，應檢查桌面 switch 與可能的 OS permission。LOCAL_CAPABILITY_NOT_GRANTED 表示持久化裝置／Agent 授權不允許，應調整 opt-in 或 grant。LOCAL_CAPABILITY_CHECK_FAILED 是暫時的授權檢查失敗，應如實回報，不能猜測已開通。

Related actions

arinova.local.fs.read_file, arinova.local.shell.run, arinova.local.screen.capture

Also known as

配對桌面, 桌面離線, 電腦控制工具 離線, capability opt-in, Agent 桌面授權, local tool 不可用, 撤銷裝置

---

Machine-readable Markdown · Knowledge index