---
{
  "id": "platform.doc.overview",
  "topic": "doc",
  "title": "Rich Doc 總覽與 Office surface 分流",
  "locale": "zh-TW",
  "version": "2026-09-04",
  "summary": "Doc 是處理正式、可列印內容的私有 rich word-processing surface，十三個 Actions 涵蓋匯入、編輯、生命週期與 File Center 匯出。",
  "content": "Doc 是 Arinova 的 rich word-processing surface。Canonical 儲存是 ProseMirror JSON，Agent Action 以 Markdown 交換內容。報告、合約、頁面排版或可列印文件選 Doc；快速文字選 Memo；筆記本筆記選 Note；簡報選 Slide；計算選 Sheet。\n\n十三個 Actions 涵蓋建立與檔案中心匯入、讀取與列表、替換與追加、封存與取消封存、確認後永久刪除、PDF／docx／HTML／Markdown 匯出、頁面設定及文字或區塊格式。匯出只回 bounded metadata 與安全連結，不回文件 bytes；精確欄位以 registry schema 為準。\n\nCreate 回傳 `docId`、`version`、`wordCount` 與 `pageSettings`；update／append 回傳 canonical `contentMd` 供驗證。建立與匯入可指定可寫入的 shared space。Agent 建立的 Doc 只 grant 給該 Agent；其他 Doc 需明確授權。\n\nowner 可在 Doc 頁面將 `.md`、`.docx`、`.txt` 與 `.html` 匯入為新文件。檔案中心內既有檔案可直接轉換，不會重複建立來源檔；`.docx` 會保留在檔案中心供溯源。`import_doc` Action 支援檔案中心內的 `.md`、`.docx` 與 `.txt`；文字直傳與 HTML 匯入只開放用戶或 CLI。匯入不會取代目前文件。\n\nAgent surface 沒有 public-share、member、Agent-permission 或 named-version restore Action。全部 Doc Actions 都禁止在 public surface 執行。當下 schema、result、typed error 與 permission 高於本卡。\n",
  "aliases": [
    "doc",
    "rich document",
    "word processing",
    "formal document",
    "Word 檔",
    "report",
    "文件",
    "文書",
    "報告",
    "合約",
    "企劃書",
    "排版",
    "頁碼",
    "正式文件",
    "附錄"
  ],
  "tags": [
    "doc",
    "overview",
    "office",
    "routing"
  ],
  "relatedActions": [
    "arinova.doc.create_doc",
    "arinova.doc.import_doc",
    "arinova.doc.get_doc",
    "arinova.doc.update_doc",
    "arinova.doc.append_content",
    "arinova.doc.list_docs",
    "arinova.doc.archive_doc",
    "arinova.doc.unarchive_doc",
    "arinova.doc.delete_doc",
    "arinova.doc.export_doc",
    "arinova.doc.set_page_settings",
    "arinova.doc.format_text",
    "arinova.doc.format_block"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/doc/overview/"
}
---

Doc 是 Arinova 的 rich word-processing surface。Canonical 儲存是 ProseMirror JSON，Agent Action 以 Markdown 交換內容。報告、合約、頁面排版或可列印文件選 Doc；快速文字選 Memo；筆記本筆記選 Note；簡報選 Slide；計算選 Sheet。

十三個 Actions 涵蓋建立與檔案中心匯入、讀取與列表、替換與追加、封存與取消封存、確認後永久刪除、PDF／docx／HTML／Markdown 匯出、頁面設定及文字或區塊格式。匯出只回 bounded metadata 與安全連結，不回文件 bytes；精確欄位以 registry schema 為準。

Create 回傳 `docId`、`version`、`wordCount` 與 `pageSettings`；update／append 回傳 canonical `contentMd` 供驗證。建立與匯入可指定可寫入的 shared space。Agent 建立的 Doc 只 grant 給該 Agent；其他 Doc 需明確授權。

owner 可在 Doc 頁面將 `.md`、`.docx`、`.txt` 與 `.html` 匯入為新文件。檔案中心內既有檔案可直接轉換，不會重複建立來源檔；`.docx` 會保留在檔案中心供溯源。`import_doc` Action 支援檔案中心內的 `.md`、`.docx` 與 `.txt`；文字直傳與 HTML 匯入只開放用戶或 CLI。匯入不會取代目前文件。

Agent surface 沒有 public-share、member、Agent-permission 或 named-version restore Action。全部 Doc Actions 都禁止在 public surface 執行。當下 schema、result、typed error 與 permission 高於本卡。