Примеры
Запускайте примеры Collaboration SDK по возможностям и изучайте руководства, серверные и Web-точки входа.
Все примеры находятся в univer-collaboration-examples. Они имеют минимальную структуру web/main.ts + server/main.ts и работают независимо. Завершите быстрый старт, затем выберите пример под задачу интеграции.
| Пример | Основная идея | Команда |
|---|---|---|
| Быстрый старт | Основной путь совместной работы | pnpm example:quick-start |
| Адаптер базы данных | Адаптеры базы данных | pnpm example:database-adapter |
| Права доступа | Идентификация и авторизация | pnpm example:permissions |
| История | Производная история версий | pnpm example:history |
| Комментарии | Независимые комментарии | pnpm example:comments |
| Worktree | Изолированные правки и слияние | pnpm example:worktree |
| Преобразование файлов | Преобразование Office | pnpm example:exchange |
| Развёртывание на нескольких узлах | Горизонтальное масштабирование | pnpm example:multi-node |
Быстрый старт
Соберите Collaboration Client, Transport, Endpoint, Service и Memory Adapter. Проверьте в двух браузерах HTTP-загрузку, Sessions WebSocket, Room, ACK и рассылку одной Sheet.
pnpm example:quick-startОткройте http://127.0.0.1:3010/?unit=quick-start-sheet.
Адаптер базы данных
Пример показывает, как использовать встроенный SQLite Adapter и реализовать собственный Database Adapter.
pnpm example:database-adapterОткройте http://127.0.0.1:3010/?unit=persistent-sheet.
Права доступа
Создайте доверенную идентичность из cookie и отдельно защитите HTTP-чтение Unit, JOIN и отправку изменений. Страница переключается между учебным Alice · Editor и Bob · Viewer только для чтения.
pnpm example:permissionsОткройте http://127.0.0.1:3010.
История
Добавьте вне ядра History Service, отдельный Adapter, History Endpoint и вход истории браузера. Events создания Unit и коммита строят восстанавливаемый производный индекс.
pnpm example:historyОткройте http://127.0.0.1:3010/?unit=history-sheet, измените Sheet и выберите History сверху.
Комментарии
Добавьте Thread Comment Service, отдельный Adapter, Comment Endpoint и вход комментариев интерфейса. Comment Endpoint использует Sessions и Rooms Unit основного Endpoint.
pnpm example:commentsОткройте http://127.0.0.1:3010/?unit=comments-sheet, выберите ячейку и откройте комментарии.
Worktree
Показан полный цикл изолированного черновика, Ready, Reopen и Merge по Unit. Переключайтесь между основной веткой и черновиком, чтобы увидеть изоляцию правок AI Agent до слияния.
pnpm example:worktreeОткройте http://127.0.0.1:3010/?unit=worktree-sheet&worktree=demo-worktree.
Преобразование файлов
Объедините @univerjs-pro/exchange-node и Collaboration Service для серверного импорта/экспорта Sheet, опроса задач, импорта снимков и экспорта подтверждённых ревизий.
pnpm example:exchangeОткройте http://127.0.0.1:3010/?unit=exchange-sheet. Импортируйте через File → Open (File), экспортируйте через File → Save As.
Развёртывание на нескольких узлах
Запустите два узла совместной работы за Nginx. Redis передаёт обновления в реальном времени между узлами и хранит общие session tickets, поэтому любой узел может обслужить любой запрос. Требуется Docker Compose.
pnpm example:multi-nodeОткройте http://127.0.0.1:3010/ и нажмите New Sheet, чтобы создать файл. Скопируйте полный URL в другую вкладку для проверки совместного редактирования того же документа. Затем создайте ещё несколько файлов и посмотрите, как они распределяются между узлами.
Примеры не являются промышленными приложениями
Фиксированные пользователи, учебная авторизация, Memory Adapters, локальные секреты и хранение файлов и задач в памяти служат обучению. Приложение отвечает за идентификацию, авторизацию, хранение, секреты, файлы, развёртывание и взаимодействие.
Насколько полезно это руководство?