---
{
  "id": "platform.memo.pages-and-editing",
  "topic": "memo",
  "title": "Memo 頁面與安全編輯",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Memo 建立與部分更新會保留省略欄位、拒絕明給空白內容，並支援可選的 optimistic locking。",
  "content": "`create_page` 在指定 conversation 建立頁面；content 可省略，所以先建空頁再補內容是合法流程。`update_page` 是 partial update：省略欄位會保留目前值；明給 `tags` 則整組覆寫，不是 append。\n\n明給空字串或全空白 content 會以 detail code `MEMO_CONTENT_EMPTY` 拒絕，絕不靜默清空。若使用者要求清空，先釐清意圖再選安全替代內容。併發編輯時先 `get_page`，把讀到的 version 當可選 `expectedVersion`；不符會回 `RESOURCE_CONFLICT` 與 expected／actual version。此時重新讀取最新頁面、明確合併，再帶新 version 重試，不可盲目覆寫。\n\n每次成功 update 都 version+1 並寫入完整 snapshot，後續以 result 的新 version 為準。`list_pages` search 同時比對 title 與 content，pinned pages 排前。mutation dry run 會回 `resolvedResources` 與 `wouldRequireConfirmation`。create／update 傳入的 content 在 audit arguments 只留 redacted 長度提示，live result 仍是 plaintext；不得寫入 routing telemetry。\n",
  "aliases": [
    "建立備忘錄頁面",
    "編輯共享頁面",
    "expectedVersion",
    "Memo 衝突",
    "空白頁面內容",
    "置頂頁面",
    "MEMO_CONTENT_EMPTY"
  ],
  "tags": [
    "memo",
    "page",
    "optimistic-locking"
  ],
  "relatedActions": [
    "arinova.memo.create_page",
    "arinova.memo.list_pages",
    "arinova.memo.get_page",
    "arinova.memo.update_page",
    "arinova.memo.delete_page"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/memo/pages-and-editing/"
}
---

`create_page` 在指定 conversation 建立頁面；content 可省略，所以先建空頁再補內容是合法流程。`update_page` 是 partial update：省略欄位會保留目前值；明給 `tags` 則整組覆寫，不是 append。

明給空字串或全空白 content 會以 detail code `MEMO_CONTENT_EMPTY` 拒絕，絕不靜默清空。若使用者要求清空，先釐清意圖再選安全替代內容。併發編輯時先 `get_page`，把讀到的 version 當可選 `expectedVersion`；不符會回 `RESOURCE_CONFLICT` 與 expected／actual version。此時重新讀取最新頁面、明確合併，再帶新 version 重試，不可盲目覆寫。

每次成功 update 都 version+1 並寫入完整 snapshot，後續以 result 的新 version 為準。`list_pages` search 同時比對 title 與 content，pinned pages 排前。mutation dry run 會回 `resolvedResources` 與 `wouldRequireConfirmation`。create／update 傳入的 content 在 audit arguments 只留 redacted 長度提示，live result 仍是 plaintext；不得寫入 routing telemetry。