---
{
  "id": "platform.slide.slides-ordering-and-editing",
  "topic": "slide",
  "title": "Slide 投影片排序、編輯、複製與衝突",
  "locale": "zh-TW",
  "version": "2026-07-25",
  "summary": "投影片是完整有序序列；編輯使用 expectedVersion，插入與複製位置固定，且最後一張投影片不可刪除。",
  "content": "`list_slides` 回傳完整有序序列。`add_slide` 未提供 `afterSlideId` 時加在最後，提供時緊接指定投影片；找不到 anchor 回 `resource_not_found`。省略 content 會建立空白 version 2 slide。`duplicate_slide` 複製來源 content 與講者備註，可用 title 覆寫標題，並把複本放在來源正後方。\n\n`update_slide` 使用 optimistic locking，必須帶剛讀到的整數 `expectedVersion`；只有提供的 title、content、`speakerNotes` 會改，成功後 row version 加一。content 是整份取代而非 element merge，改一個元素也要送回完整 elements 陣列。值過舊會回含 `currentVersion` 的 `resource_conflict`；應重讀、合併，再用新值重試，不可原封重送。這個 row version 與 deck-level history Actions 無關。content 與 speaker notes 會從 Action audit plaintext redact。\n\n`reorder_slides` 必須正好包含目前每個 slide ID 一次，不得漏掉、重複或混入其他簡報的 ID；提供的陣列會原子地成為完整新順序。`delete_slide` 需要 UserConfirm，且不能刪最後一張；要替換唯一頁面需先新增再刪。每個 deck 最多 200 張；達上限後 add/duplicate 回 typed resource conflict。併發編輯後以 Action 結果與持久化狀態為準。\n",
  "aliases": [
    "新增投影片",
    "調整投影片順序",
    "複製投影片",
    "投影片版本衝突",
    "expectedVersion",
    "講者備註"
  ],
  "tags": [
    "slide",
    "ordering",
    "editing",
    "optimistic-lock",
    "speaker-notes"
  ],
  "relatedActions": [
    "arinova.slide.list_slides",
    "arinova.slide.add_slide",
    "arinova.slide.update_slide",
    "arinova.slide.delete_slide",
    "arinova.slide.reorder_slides",
    "arinova.slide.duplicate_slide"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/slide/slides-ordering-and-editing/"
}
---

`list_slides` 回傳完整有序序列。`add_slide` 未提供 `afterSlideId` 時加在最後，提供時緊接指定投影片；找不到 anchor 回 `resource_not_found`。省略 content 會建立空白 version 2 slide。`duplicate_slide` 複製來源 content 與講者備註，可用 title 覆寫標題，並把複本放在來源正後方。

`update_slide` 使用 optimistic locking，必須帶剛讀到的整數 `expectedVersion`；只有提供的 title、content、`speakerNotes` 會改，成功後 row version 加一。content 是整份取代而非 element merge，改一個元素也要送回完整 elements 陣列。值過舊會回含 `currentVersion` 的 `resource_conflict`；應重讀、合併，再用新值重試，不可原封重送。這個 row version 與 deck-level history Actions 無關。content 與 speaker notes 會從 Action audit plaintext redact。

`reorder_slides` 必須正好包含目前每個 slide ID 一次，不得漏掉、重複或混入其他簡報的 ID；提供的陣列會原子地成為完整新順序。`delete_slide` 需要 UserConfirm，且不能刪最後一張；要替換唯一頁面需先新增再刪。每個 deck 最多 200 張；達上限後 add/duplicate 回 typed resource conflict。併發編輯後以 Action 結果與持久化狀態為準。