---
{
  "id": "platform.local.pairing-capabilities-and-availability",
  "topic": "local",
  "title": "Local 配對、能力與可用性",
  "locale": "zh-TW",
  "version": "2026-08-23",
  "summary": "Local tool 只有在配對連線、裝置 opt-in、per-Agent grant 與 runtime capability 全部一致時才可用。",
  "content": "配對是使用者控制的流程，不是 Agent task。桌面 app 會開啟已登入的瀏覽器授權頁；平台建立一次性 pairing code，再由桌面 app claim 以綁定裝置。Agent 只能引導使用者完成流程，不能替使用者配對、取得或處理 pairing credential。\n\n裝置 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 指派。\n\n`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` 是暫時的授權檢查失敗，應如實回報，不能猜測已開通。\n",
  "aliases": [
    "配對桌面",
    "桌面離線",
    "電腦控制工具 離線",
    "capability opt-in",
    "Agent 桌面授權",
    "local tool 不可用",
    "撤銷裝置"
  ],
  "tags": [
    "local",
    "pairing",
    "capabilities",
    "availability"
  ],
  "relatedActions": [
    "arinova.local.fs.read_file",
    "arinova.local.shell.run",
    "arinova.local.screen.capture"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/local/pairing-capabilities-and-availability/"
}
---

配對是使用者控制的流程，不是 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` 是暫時的授權檢查失敗，應如實回報，不能猜測已開通。