應用程式架構
了解 Web SDK、Server SDK 與 AI SDK 的職責，以及如何組合為應用程式。
Univer Office SDK 包含三個 SDK：Web SDK 提供嵌入式編輯器和無頭1內容處理能力，Server SDK 提供協同與檔案匯入匯出能力，AI SDK 提供 Agent 工作流程能力。
Univer 是用於建立人類與 AI Agent 共同操作 Office 內容的工具集。應用程式可同時提供面向人類的 Web、面向 AI Agent 的 CLI 與共用 Server，也可只採用需要的元件。
SDK 組成
| 元件 | 執行環境 | 主要 SDK | SDK 提供 | 應用程式負責 |
|---|---|---|---|---|
| Web | 瀏覽器 | Web SDK | 互動式 Office 顯示與編輯 | UI、產品互動與瀏覽器整合 |
| CLI | Node.js | AI SDK | 面向 AI Agent 的內容檢查與編輯 | AI Agent 流程、工具呼叫與任務邊界 |
| Server | Node.js | Server SDK（Collaboration、Exchange） | 自行託管的協同與 Office 檔案匯入匯出 | 業務 API、身分、權限、檔案儲存與部署 |
文件分為 Web SDK、Server SDK與 AI SDK，分別涵蓋編輯器、協同及檔案交換服務、AI Agent 內容操作。
AI SDK 重用 Web SDK 的無介面內容能力。這些元件代表主要開發入口與執行位置，不是三套獨立技術堆疊，也不是無需應用程式程式碼就可部署的完整產品。
整合檔案匯入匯出
Server SDK 的 @univerjs-pro/exchange-node 負責 Office 檔案與 Univer 文件資料互轉。應用程式整合轉換模組並提供上傳、轉換、下載 API。Web SDK 處理瀏覽器互動，CLI 可在 Node.js 呼叫轉換模組。瀏覽器設定仍放在各產品的 Web SDK 文件中。
- 不使用協同編輯： 將檔案轉為文件快照，在瀏覽器開啟與編輯。匯出時將最新快照交給轉換模組產生檔案。此流程需要伺服器轉換，但不需要協同服務。
- 使用協同編輯： 將匯入資料保存為協同文件。Web 與 AI SDK 透過文件 ID 操作相同內容。匯出前先同步目前修改，再讀取及轉換最新文件資料。
只需轉換檔案時，可在本機 Node.js 程序或遠端服務使用 Exchange，不需要 AI SDK 或協同編輯。應用程式流程請參閱檔案交換整合，轉換模組請參閱 Office 檔案匯入匯出。
部署形態
| 形態 | Web | CLI | Server | 適用範圍 |
|---|---|---|---|---|
| 本機應用程式 | 本機瀏覽器／桌面 UI | 本機程序 | 本機程序 | 桌面 Office 與本機 AI Agent |
| SaaS 應用程式 | 瀏覽器 | 使用者裝置／雲端 AI Agent | 遠端服務 | 多使用者與集中維運 |
| Web + Server | 瀏覽器 | — | 本機或遠端 | 尚未提供 AI Agent 入口 |
| 僅 Web | 瀏覽器／桌面 UI | — | — | 本機、單人、非協同編輯 |
元件可在同一台機器執行，也可跨用戶端與雲端部署。位置不改變職責；只要存在 Server，Web 與 CLI 就透過它存取共用內容與產品能力。
選擇入口
| 目標 | 從這裡開始 |
|---|---|
| 在 Web 嵌入 Office 編輯器 | Web SDK 文件 |
| 為編輯器加入 Office 匯入匯出 | 檔案交換整合 |
| 在 Node.js 轉換 Office 檔案 | Office 檔案匯入匯出 |
| 加入自行託管的即時協同 | Collaboration SDK 概覽 |
| 讓 AI Agent 讀寫 Office 內容 | AI SDK 概覽 |
| 了解 CLI 無介面 Runtime | Runtime 重用與 Daemon |
| 隔離 AI Agent 修改供人類審閱 | Worktree |
若尚未確定路徑，請先閱讀開始使用。
Footnotes
-
無頭（headless）指不掛載互動式編輯器介面，直接操作文件內容；它不代表已包含協同、持久化儲存或檔案轉換服務。 ↩
你覺得這篇文檔如何？