套件概覽

本頁協助選擇 Collaboration SDK 套件。先組合核心協同，再加入產品需要的擴充模組，無需安裝所有套件。

Database Adapter、File 與 Office Exchange 的服務端套件以 Apache-2.0 開源，原始碼見 univer-collaboration-sdk-community。它們與其他套件使用相同的套件前綴和版本，安裝方式相同。

Core Collaboration

核心協同提供瀏覽器協同、伺服器協定、OT、修訂版本與持久化的主要流程。

核心伺服器需要 Transport、Endpoint、Service 與一個 Database Adapter。Memory、SQLite 與 PostgreSQL 實作相同契約，通常擇一使用。多節點部署時，還需要一個 pub/sub 介面卡與一個共用的 Session Ticket 儲存。兩者的契約（IPubSubAdapter、ISessionTicketStore）由 Endpoint 定義，SDK 提供 Redis 實作。

History

History 根據核心 Unit 建立與變更集提交事件建立版本歷史索引。

歷史資料是可重建的衍生索引，Unit 內容仍以核心變更集為準。

Thread Comment

Thread Comment 管理 Sheets 與 Docs 的留言本文、回覆及解決狀態。

Comment Adapter 儲存留言資料。隨內容移動的錨點仍屬於核心快照與變更集。

Worktree

Worktree 提供隔離草稿、狀態轉換與逐 Unit 合併。

Worktree Service 最終透過 Core Service 合併到主幹，因此兩個 Service 邊界都須設定 Middleware。

File

File 儲存 Univer 用戶端上傳的二進位檔案：插入 Unit 的圖片與附件，以及匯入匯出的來源檔與結果檔。Unit 資料只記錄檔案 ID。

中繼資料與內容是兩個獨立契約，可以分別選擇實作，例如中繼資料放資料庫、內容放物件儲存。

Office Exchange

Office Exchange 在 Office 檔案與協同 Unit 之間匯入匯出，來源檔與結果檔由 File 儲存。

Exchange Service 透過 Core Service 建立和讀取 Unit，透過 File Service 讀寫檔案，因此與 Core 和 File 一起組裝。

選擇原則

1. 從快速開始的核心套件開始。
2. 選擇 Memory、SQLite、PostgreSQL 或自訂 Core Database Adapter 其中之一。
3. 多節點部署時，加上 Redis 的 pub/sub 介面卡與 Session Ticket 儲存。
4. 只安裝產品實際使用的擴充套件。
5. 需要圖片、附件或匯入匯出時，先組裝 File，再按需加入 Office Exchange。
6. 即使共用同一個資料庫，各模組也應建立獨立 Adapter。

模組關係請參閱協同擴充模組，可執行組合請參閱範例索引。