---
{
  "id": "platform.slide.decks-and-lifecycle",
  "topic": "slide",
  "title": "Slide 簡報檔建立、存取、封存與刪除",
  "locale": "zh-TW",
  "version": "2026-09-05.1",
  "summary": "建立簡報時原子提交完整有序投影片；清單限目前擁有者與 Agent grant 範圍，永久刪除前則必須先封存並確認。",
  "content": "`create_deck` 須提供有序 `slides[]`（每張的 title、content），原子建立完整 deck。可寫的 `spaceId` 指定共享工作區。deck metadata 是 title、description、theme、defaultAspectRatio、archived；長寬比只支援 `16:9` 或 `4:3`。theme 嚴格只允許 `backgroundColor`、`fontFamily`，未知 key 回 `invalid_arguments`，與 element 可保留擴充 key 的行為相反。執行 Agent 會取得後續使用的 deck grant；`get_deck` 回 metadata，`list_slides` 才回有序內容。\n\n`update_deck` 只改有提供的 metadata，省略不能清空 description。生命週期可逆，使用 `archive_deck`／`unarchive_deck`；`list_decks` 預設隱藏 archived，只有 `includeArchived: true` 才含它。兩個 lifecycle Actions 保留 Agent version attribution 與 invalidation events。清單交集 triggering user 的 document visibility、Agent owner identity，以及直接 permission row 或符合資格的 Space grant；個人 deck 必須由 triggering user 擁有。grant 只能在產品側管理。runtime 使用相同 read/write 交集，失敗回 `permission_denied`。\n\n`export_deck` 只接受 PDF，只解析同 deck 內 ready 的 managed images，絕不抓 external URL，並透過 personal File Center pipeline 儲存。dry-run 驗證 access 但不建檔。`delete_deck` 不可逆：deck 必須 archived，否則回 \"must be archived before deleting\"；它需要 UserConfirm，且會清除 slides、圖片 bindings 與 version history，restore/copy 都救不回。要保留內容，應在 archive 前 preview、`copy_version` 或 `export_deck`；archived 時 history mutation 唯讀，必要時先 unarchive。只想可逆隱藏應 archive，不要 delete。\n",
  "aliases": [
    "建立簡報",
    "列出簡報",
    "封存簡報",
    "刪除簡報",
    "簡報權限",
    "簡報生命週期",
    "deck lifecycle"
  ],
  "tags": [
    "slide",
    "deck",
    "lifecycle",
    "permissions",
    "archive"
  ],
  "relatedActions": [
    "arinova.slide.create_deck",
    "arinova.slide.list_decks",
    "arinova.slide.get_deck",
    "arinova.slide.update_deck",
    "arinova.slide.archive_deck",
    "arinova.slide.unarchive_deck",
    "arinova.slide.export_deck",
    "arinova.slide.delete_deck"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/slide/decks-and-lifecycle/"
}
---

`create_deck` 須提供有序 `slides[]`（每張的 title、content），原子建立完整 deck。可寫的 `spaceId` 指定共享工作區。deck metadata 是 title、description、theme、defaultAspectRatio、archived；長寬比只支援 `16:9` 或 `4:3`。theme 嚴格只允許 `backgroundColor`、`fontFamily`，未知 key 回 `invalid_arguments`，與 element 可保留擴充 key 的行為相反。執行 Agent 會取得後續使用的 deck grant；`get_deck` 回 metadata，`list_slides` 才回有序內容。

`update_deck` 只改有提供的 metadata，省略不能清空 description。生命週期可逆，使用 `archive_deck`／`unarchive_deck`；`list_decks` 預設隱藏 archived，只有 `includeArchived: true` 才含它。兩個 lifecycle Actions 保留 Agent version attribution 與 invalidation events。清單交集 triggering user 的 document visibility、Agent owner identity，以及直接 permission row 或符合資格的 Space grant；個人 deck 必須由 triggering user 擁有。grant 只能在產品側管理。runtime 使用相同 read/write 交集，失敗回 `permission_denied`。

`export_deck` 只接受 PDF，只解析同 deck 內 ready 的 managed images，絕不抓 external URL，並透過 personal File Center pipeline 儲存。dry-run 驗證 access 但不建檔。`delete_deck` 不可逆：deck 必須 archived，否則回 "must be archived before deleting"；它需要 UserConfirm，且會清除 slides、圖片 bindings 與 version history，restore/copy 都救不回。要保留內容，應在 archive 前 preview、`copy_version` 或 `export_deck`；archived 時 history mutation 唯讀，必要時先 unarchive。只想可逆隱藏應 archive，不要 delete。