---
{
  "id": "platform.image_editor.overview",
  "topic": "image_editor",
  "title": "即時圖片編輯器協作總覽",
  "locale": "zh-TW",
  "version": "2026-07-24",
  "summary": "Image Editor actions 只在使用者看得見的瀏覽器編輯 session 中，依可撤銷的明確 Agent grant 協作。",
  "content": "`image_editor` family 只在使用者目前開啟的圖片編輯器內協作；每個 command 都由使用者的瀏覽器執行並把可見結果套回 canvas，不是 server-side 單發圖像工具。`list_sessions` 找可用的 live sessions，`select_region` 取代目前選區，`request_edit` 對該選區執行計費編輯，`undo` 回退瀏覽器 canvas history，`export` 把目前 canvas 寫成新的 project revision。欄位形狀一律讀 runtime action schema，不從本卡抄寫。\n\n授權有兩道獨立閘門：使用者在 live session 明確 grant 本 Agent，以及資料庫內該 image project 的 Agent `write` 權限；每次呼叫都會重驗 project 權限。registry 的 `ConfirmationPolicy::None` 不代表免同意，session-lifetime grant 本身就是 UserConfirm 邊界。使用者可隨時 revoke 或 takeover，進行中的 command 會以 `grant_revoked` 或 `user_takeover` 取消；這是正常協作結果，不得重試繞過。\n\n`sessionId` 是暫時的 in-memory 狀態。關閉編輯器或瀏覽器斷線就失效，因此一律先呼叫 `list_sessions`，不可假造 ID，也不可沿用舊回合 ID。每筆列出的 session 與每個 command result 都帶 `projectId` context。五個 Image Editor actions 全部不能在 public surface 執行。若卡片與 registry、action result、typed error 或 project state 不同，以 runtime 為準。\n",
  "aliases": [
    "圖片編輯器",
    "圖像編輯器",
    "修圖",
    "即時修圖",
    "編輯工作階段",
    "image editor",
    "edit session"
  ],
  "tags": [
    "image-editor",
    "overview",
    "live-session",
    "grant"
  ],
  "relatedActions": [
    "arinova.image_editor.list_sessions",
    "arinova.image_editor.select_region",
    "arinova.image_editor.request_edit",
    "arinova.image_editor.undo",
    "arinova.image_editor.export"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/image_editor/overview/"
}
---

`image_editor` family 只在使用者目前開啟的圖片編輯器內協作；每個 command 都由使用者的瀏覽器執行並把可見結果套回 canvas，不是 server-side 單發圖像工具。`list_sessions` 找可用的 live sessions，`select_region` 取代目前選區，`request_edit` 對該選區執行計費編輯，`undo` 回退瀏覽器 canvas history，`export` 把目前 canvas 寫成新的 project revision。欄位形狀一律讀 runtime action schema，不從本卡抄寫。

授權有兩道獨立閘門：使用者在 live session 明確 grant 本 Agent，以及資料庫內該 image project 的 Agent `write` 權限；每次呼叫都會重驗 project 權限。registry 的 `ConfirmationPolicy::None` 不代表免同意，session-lifetime grant 本身就是 UserConfirm 邊界。使用者可隨時 revoke 或 takeover，進行中的 command 會以 `grant_revoked` 或 `user_takeover` 取消；這是正常協作結果，不得重試繞過。

`sessionId` 是暫時的 in-memory 狀態。關閉編輯器或瀏覽器斷線就失效，因此一律先呼叫 `list_sessions`，不可假造 ID，也不可沿用舊回合 ID。每筆列出的 session 與每個 command result 都帶 `projectId` context。五個 Image Editor actions 全部不能在 public surface 執行。若卡片與 registry、action result、typed error 或 project state 不同，以 runtime 為準。