Примеры
Запускайте примеры 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 |
| Файловый сервис | Хранение файлов | pnpm example:file-service |
| Преобразование файлов | Преобразование Office | pnpm example:exchange |
| All Unit | Все возможности вместе | pnpm example:all-unit |
| Развёртывание на нескольких узлах | Горизонтальное масштабирование | 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 и как перейти на PostgreSQL Adapter или собственный 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.
Файловый сервис
Подключите File Service и File Endpoint: изображения, вставленные в Sheet, загружаются на сервер, а данные Unit хранят только ID файла.
pnpm example:file-serviceОткройте http://127.0.0.1:3010/?unit=file-service-sheet и вставьте изображение через Insert → Image → Float Image.
Преобразование файлов
Соберите Exchange Service и Exchange Endpoint для серверного импорта/экспорта Sheet, опроса задач и экспорта подтверждённых ревизий.
pnpm example:exchangeОткройте http://127.0.0.1:3010/?unit=exchange-sheet. Импортируйте и экспортируйте через панель Import / Export над редактором.
All Unit
Объедините шесть типов Unit, файлы, импорт/экспорт, встроенные вложения, комментарии, историю и печать в одном приложении.
pnpm example:all-unitОткройте http://127.0.0.1:3010 и переключайте Unit в боковой панели.
Развёртывание на нескольких узлах
Запустите два узла совместной работы за Nginx. Redis передаёт обновления в реальном времени между узлами и хранит общие session tickets, поэтому любой узел может обслужить любой запрос. Требуются Docker Compose и лицензия, покрывающая два узла.
pnpm example:multi-nodeОткройте http://127.0.0.1:3010/ и нажмите New Sheet, чтобы создать файл. Скопируйте полный URL в другую вкладку для проверки совместного редактирования того же документа. Затем создайте ещё несколько файлов и посмотрите, как они распределяются между узлами.
Примеры не являются промышленными приложениями
Фиксированные пользователи, учебная авторизация, Memory Adapters, локальные секреты и хранение задач в памяти служат обучению. Приложение отвечает за идентификацию, авторизацию, хранение, секреты, файлы, развёртывание и взаимодействие.
Насколько полезно это руководство?