Единая среда для людей и AI
Univer Workspace — это open-source решение, построенное на базе Univer Office SDK. Платформа позволяет создавать, редактировать и совместно использовать документы (Docs), таблицы (Sheets), презентации (Slides), базы данных (Bases) и доски (Boards) в едином runtime. Ключевая особенность — сохранение связей данных и ссылок между различными типами контента при изменении документа.
Система поддерживает три режима взаимодействия:
- Workspace Browser: Прямое редактирование и коллаборация в реальном времени.
- Workspace Agent: Локальное веб-приложение на базе DSH (DeepSeek Harness) для диалогов с AI, референсинга файлов и проверки изменений.
- Workspace CLI: Инструмент для автоматизации задач, написания скриптов и интеграции с существующими AI-окружениями.
Архитектура безопасности: Worktree и Human-in-the-Loop
Главное отличие Univer Workspace от стандартных AI-инструментов — строгий контроль изменений. AI-агенты работают в изолированных Worktree (ветках), где они могут генерировать код, таблицы или отчеты, не затрагивая основную версию документа. Процесс выглядит так:
- Агент создает Worktree и вносит изменения.
- Агент верифицирует свой черновик.
- Статус меняется на Ready (Готово).
- Человек (Human) просматривает изменения в Browser или Agent.
- Пользователь принимает решение: Merge (слить в trunk) или Reopen (вернуть на доработку).
Сервер (Workspace Server) является единственным авторитетным источником прав доступа (ACL), хранит данные (Product, Collaboration, Blob) и управляет версиями. Клиентские запросы никогда не доверяются как источник истины.
Технические возможности и интеграции
Платформа предоставляет мощные возможности для автоматизации через CLI и Agent. AI-агенты могут генерировать мини-приложения на основе таблиц (dashboards, отчеты), где метрики и графики на веб-странице связаны с ячейками, поддерживая чтение, запись и совместное обновление.
Поддерживаются следующие функции:
- Аутентификация: OAuth (GitHub, Discord, Password) и анонимный просмотр.
- Форматы: Экспорт/импорт, рендеринг в PNG/PDF, работа с Typst.
- API: Полноценный HTTP API с OpenAPI спецификацией и явными границами восстановления.
Требования и запуск
Для развертывания решения требуются современные инструменты разработки. Ниже приведена таблица системных требований и портов:
| Компонент | Требование / Порт | Примечание |
|---|---|---|
| Node.js | Версия 24 или новее | Обязательное требование для runtime |
| pnpm | Версия 11 | Менеджер пакетов |
| Workspace Browser | http://127.0.0.1:5173 | Интерфейс редактирования (Vite HMR) |
| Workspace Server | http://127.0.0.1:3020 | API, WebSocket, хранение данных |
| API Docs | /api-docs, /openapi.yaml | Документация серверных эндпоинтов |
Быстрый старт включает установку зависимостей (pnpm install), копирование конфигурации (.env.example -> .env) и запуск сервера и веб-клиента через pnpm workspace:dev:server и pnpm workspace:dev:web соответственно.
Источник: Github ↗
