Package 概览

本页是 Collaboration SDK 的选包地图。先组装 Core Collaboration，再按产品需求增加扩展模块；不需要 一次安装所有 package。

Database Adapter、File 与 Office Exchange 的服务端 package 以 Apache-2.0 开源，源码见 univer-collaboration-sdk-community。 它们与其他 package 使用相同的包名前缀和版本，安装方式相同。

Core Collaboration

Core Collaboration 提供浏览器协同、服务端协议、OT、revision 与持久化主链路。

Core Server 需要 Transport、Endpoint、Service 和一个 Database Adapter。Memory、SQLite 与 PostgreSQL 是同一 Adapter 合同的三种实现，通常只选择其中一个。多节点部署时，还需要一个 pub/sub 适配器和一个共享的 Session Ticket 存储。两者的合同（IPubSubAdapter、ISessionTicketStore）由 Endpoint 定义，SDK 提供 Redis 实现。

History

History 从 Core 的 Unit 创建和 changeset commit Event 建立版本历史索引。

History 数据是可重建的派生索引，Core changeset 仍是 Unit 内容的权威来源。

Thread Comment

Thread Comment 管理 Sheet 与 Doc 的评论正文、回复和 solved 状态。

Comment Adapter 保存评论数据；随内容变化的 anchor 仍属于 Core snapshot 与 changeset。

Worktree

Worktree 提供隔离 draft、状态流转与逐 Unit 合入。

Worktree Service 最终通过 Core Service 合入 trunk，因此两套 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. 从 Quick Start 的 Core package 开始。
2. 在 Memory、SQLite、PostgreSQL 与自定义实现中选择一个 Core Database Adapter。
3. 多节点部署时，加上 Redis 的 pub/sub 适配器与 Session Ticket 存储。
4. 只安装产品实际启用的扩展模块 package。
5. 需要图片、附件或导入导出时，先组装 File，再按需加入 Office Exchange。
6. 即使多个模块使用同一个数据库，也要分别创建各自的 Adapter。

模块关系见协同扩展模块，可运行组合见示例索引。