# Office SDK 總覽

> 了解 Office SDK 的三個組成部分：Web SDK、Server SDK 和 AI SDK，以及它們如何共同建構 Office 應用。

- Human documentation: [https://docs.univer.ai/zh-TW/overview](https://docs.univer.ai/zh-TW/overview)

- Agent Markdown: [https://docs.univer.ai/zh-TW/overview.md](https://docs.univer.ai/zh-TW/overview.md)

- Requested language: `zh-TW`

- Content language: `zh-TW`

- Documentation version: `1.3.0`

- Source: [index.zh-TW.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/index.zh-TW.mdx)

---

Univer Office SDK 包含 Web SDK、Server SDK 和 AI SDK，支援試算表、文件、簡報、關聯式表格、畫布和 PDF。

Web SDK 提供統一的內容引擎，既可以執行瀏覽器編輯器，也可以透過 Headless 在伺服器端處理內容。 Server SDK 與 AI SDK 都依賴這項 Headless 能力，分別提供協同、檔案處理等伺服器端能力，以及 Agent 的內容操作與驗證能力。

## 瀏覽全部功能

進入[功能總覽](https://docs.univer.ai/zh-TW/overview/features.md)，按產品和分類查看完整功能、支援狀態、開源標記與存取範圍；也可以查看圖表、檔案轉換、協同、Worktree、嵌入等跨產品能力。

[快速開始](https://docs.univer.ai/zh-TW/overview/get-started.md)：從一個需求範本和三個可執行實例開始，再了解應用程式存取、建置與部署。

## SDK 架構與分工

- [Web SDK](https://docs.univer.ai/zh-TW/guides/sheets.md)
- [Server SDK](https://docs.univer.ai/zh-TW/server.md)
- [AI SDK](https://docs.univer.ai/zh-TW/ai.md)

### Web SDK：統一內容引擎

針對需要在產品中展示、編輯或處理 Office 內容的開發者。使用 Facade API 操作文件、資料和介面，既支援瀏覽器中的編輯器，也支援 Node.js 無頭執行。

Web SDK 採用插件架構，產品能力、編輯器介面，以及尋找替換等特定功能，都可以透過插件組合。你可以從預設（Preset）快速開始，也可以依照實際需求選擇產品與功能插件，依插件依賴關係組裝自己的 Office 應用。

你也可以開發自訂外掛程式來擴展業務功能，無需修改 Univer 核心程式碼。同一內容引擎透過不同的插件群組適當配執行環境：瀏覽器中載入編輯器 UI，Headless 場景則不載入瀏覽器 UI 插件。詳見 [Univer 架構：插件化設計](/blog/univer#plugins)。

**統一的 Canvas 渲染。** Office 內容統一採用以 Canvas 為基礎的渲染體系，讓不同內容類型重複使用排版與繪製能力，並支援內容巢狀。例如，試算表單元格中的文字與文件復用排版和渲染能力，保持一致的內容呈現。詳見[渲染引擎架構設計](/blog/rendering)。

**前後端混合計算。** 公式引擎支援前端計算與伺服器端 Rust 引擎配合的混合計算模式，兼顧編輯時的交互響應與大規模公式計算的處理性能。相關能力見[公式功能](https://docs.univer.ai/zh-TW/guides/sheets/features/core/formula.md)與[伺服器端計算](https://docs.univer.ai/zh-TW/overview/features/shared/server-calculation.md)。

[從試算表快速開始](https://docs.univer.ai/zh-TW/guides/sheets/getting-started/quickstart.md)，或選擇[文件](https://docs.univer.ai/zh-TW/guides/docs.md)、[簡報](https://docs.univer.ai/zh-TW/guides/slides.md)、[關聯式表格](https://docs.univer.ai/zh-TW/guides/bases.md)、[畫布](https://docs.univer.ai/zh-TW/guides/boards.md)和 [PDF](https://docs.univer.ai/zh-TW/guides/pdfs.md)。

### Server SDK：連線協作與文件

面向需要多人協同、文件轉換和伺服器端擴充的開發者。基於 Web SDK 的 Headless 內容能力，將所需模組整合到自己的後端，沿用業務身分、權限與儲存。

**即時協同。** 基於 OT（操作轉換）處理行列變更、內容修改等並發操作，讓編輯先在本地生效，再使多端副本最終一致，並儘可能保留用戶意圖；可進一步組合歷史記錄、評論與 Worktree。詳見[協同編輯設計](/blog/ot)與[協同接入](https://docs.univer.ai/zh-TW/server/collaboration/quick-start.md)。

**文件格式轉換。** 在 Office 文件與 Univer 文件資料之間轉換，打通匯入、編輯、匯出流程，也可不啟用協同服務。轉換 API 見[Office 文件匯入匯出](https://docs.univer.ai/zh-TW/server/import-export/node.md)，上傳、任務與下載介面見[文件交換集成](https://docs.univer.ai/zh-TW/server/import-export.md)。

**部署與擴充。** 將模組組裝進自己的 Node.js 應用，從單機部署開始，依負載拆分檔案轉換服務，再擴展到多協同節點。詳見[應用架構](https://docs.univer.ai/zh-TW/server/architecture.md)與[部署指引](https://docs.univer.ai/zh-TW/server/deployment.md)。

[進入 Server SDK 總覽](https://docs.univer.ai/zh-TW/server.md)。

### AI SDK：為 Agent 提供操作入口

針對為現有 Agent、自動化流程和業務 CLI 接入 Office 能力的開發者。基於 Web SDK 的 Headless 執行環境與 Facade API，提供內容操作、運算與檢查能力。

**接取已有 Agent 體系。** 透過 TypeScript API 或組裝後的業務 CLI 提供 Office 工具。模型選擇、任務編排與 Skills 由接入方組織，Agent 取得執行結果與檢查回饋後，繼續自己的工作流程。

**建立可繼續編輯的內容。** Agent 讀取文件結構、定位區域或段落，再透過 Facade API 建立和修改表格、文件、投影片等內容，並執行公式計算。成果保留內容結構與編輯能力，使用者可以繼續完善。見[內容操作](https://docs.univer.ai/zh-TW/ai/content-operations.md)。

**檢查結果，再繼續修正。** 回讀數值與公式結果，透過截圖核對實際頁面；投影片也可使用版面檢查定位文字出界、溢出與重疊問題。 Agent 根據回饋修正，再次驗證，形成「讀取 → 編輯與計算 → 檢查 → 修正」的循環。見[視覺檢查](https://docs.univer.ai/zh-TW/ai/visual-inspection.md)。

連線 Server SDK 後，可透過 [Worktree](https://docs.univer.ai/zh-TW/ai/worktree.md)隔離 Agent 的中間修改，再交由人類在 Web 中審閱和合併。[進入 AI SDK 總覽](https://docs.univer.ai/zh-TW/ai.md)。

## 應用程式中的協作流程

```mermaid
flowchart TB
    Human["人類使用者"] --> Browser
    Agent["AI Agent / 自動化"] --> AI["AI SDK · 操作與驗證"]
    subgraph WebSDK["Web SDK · 統一內容引擎"]
      Browser["瀏覽器編輯器"]
      Headless["Headless · 內容模型與 Facade API"]
    end
    Server["Server SDK · 協同、檔案轉換與擴充"] -->|依賴| Headless
    AI -->|依賴| Headless
    Browser <-->|分享內容| Server
    AI -.->|協同與審閱| Server
    Server --> Storage["應用程式身分、權限與存儲"]
    classDef default rx:8,ry:8,stroke-width:1px
```

- **嵌入式編輯器**：使用 Web SDK，在應用程式中展示和編輯內容。
- **多人協同應用**：組合 Web SDK 與 Server SDK，讓使用者共同編輯共用文件。
- **人類與 Agent 協作**：透過 AI SDK 讓 Agent 編輯和驗證草稿，Server SDK 管理版本與合併，Web 應用承載人的檢視、比較和審查互動。完整的審閱流程由三者共同完成。

> [!NOTE: 共同基礎與依賴關係]
> Web SDK 可以獨立用於編輯器或 Headless 內容處理。 Server SDK 與 AI SDK 皆依賴 Web SDK 的 Headless 能力；無需瀏覽器介面，也需要內容執行時間。按需啟用的是具體服務和模組，應用程式通常會組合三個 SDK 完成人類與 Agent 的協作流程。

## 依照你的需求開始

| 我想要 | 建議從這裡開始 |
| --- | --- |
| 在應用程式中嵌入試算表編輯器 | [Web SDK · 快速開始](https://docs.univer.ai/zh-TW/guides/sheets/getting-started/quickstart.md) |
| 選擇其他 Office 編輯器 | [文件](https://docs.univer.ai/zh-TW/guides/docs.md)、[簡報](https://docs.univer.ai/zh-TW/guides/slides.md)、[關聯式表格](https://docs.univer.ai/zh-TW/guides/bases.md)、[畫布](https://docs.univer.ai/zh-TW/guides/boards.md)、[PDF](https://docs.univer.ai/zh-TW/guides/pdfs.md) |
| 讓多個使用者共同編輯一份文件 | [Server SDK · 協同快速開始](https://docs.univer.ai/zh-TW/server/collaboration/quick-start.md) |
| 匯入或匯出 Office 文件 | [Server SDK · 檔案轉換](https://docs.univer.ai/zh-TW/server/import-export.md) |
| 讓 Agent 或 CLI 操作文件 | [AI SDK · 總覽與接取路徑](https://docs.univer.ai/zh-TW/ai.md) |
| 審閱 Agent 對共用文件的修改 | [AI SDK · Worktree](https://docs.univer.ai/zh-TW/ai/worktree.md) |

## 下一步

從 Web SDK 的內容執行階段開始，結合 Server SDK 與 AI SDK 跑通應用程式的第一個完整流程，再逐步增加所需模組。保持相關 Univer 套件版本匹配，並根據所選模組準備執行環境、身分權限和授權。

查看[範例](https://docs.univer.ai/zh-TW/overview/examples.md)，了解開源應用程式、Agent 整合、演示與原始碼；也可以開啟[線上示範](https://office.univer.ai)，體驗不同 Office 產品的互動與功能。