Workspace

Univer Workspace — открытое рабочее пространство на Univer Office SDK для людей и агентов. Редактируемые документы Office и Web Apps с привязкой к данным объединены в личных и командных Spaces с совместной работой, доступом, версиями и проверкой изменений. Репозиторий содержит приложение, средства развёртывания, CLI и настольный клиент.

Разверните Workspace у себя или начните с облачной пробы. Существующий агент подключается через Workspace CLI, а Workspace Desktop объединяет диалог и то же пространство в локальном приложении. Все варианты работают с одним сервисом и файлами.

Проба в облаке · Подключить агента · Своё развёртывание · Возможности Desktop · Код и адаптация

Начните с облачного Workspace

Откройте облачную пробу, войдите и выберите личный или доступный командный Space. Создавайте, редактируйте, организуйте и публикуйте документы. К этому работающему сервису можно подключить агента через CLI ниже. Используйте тестовые данные: содержимое пробного сервиса может сбрасываться.

Workspace Server управляет пользователями, Spaces, правами, хранением, совместной работой и версиями. Web предоставляет браузерный интерфейс редактирования и проверки. Частное развёртывание использует те же Server и Web.

Подключите своего агента к облачному Workspace

Установите CLI и вводную Skill в среде агента. Нужен Node.js 22.12 или новее; рекомендуется 24. Агент с выполнением команд использует эти инструменты со своей моделью и диалогом. Явно задайте облачный сервис, чтобы браузер и агент работали в одном Workspace:

npm install --global univer-workspace-cli@latestnpx skills add dream-num/univer-workspace --skill univer-workspace-cli -guvw --versionuvw config set workspace.origin https://space.univer.ai

uvw auth login

uvw auth login --complete

После первого подтверждения в браузере CLI повторно использует сеанс. Не нужно создавать отдельный вход или интеграцию авторизации для каждого агента. Дайте агенту задачу и откройте возвращённую ссылку в Web, чтобы проверить то же содержимое и изменения Office перед слиянием.

Начните с документа, который можно вычислить и проверить

Создай в моём личном пространстве Workspace таблицу месячных расходов на английском: даты, категории, суммы и пять примерных строк. Добавь формулу итога и диаграмму по категориям.Работай в отдельном черновике, проверь данные, формулы и отображение, затем дай ссылку на просмотр или ревью. Не объединяй до моего подтверждения.

Отправьте задачу подключённому агенту или используйте Desktop. Агент создаёт и проверяет, а вы запрашиваете правки, проводите ревью и решаете об объединении. То же содержимое можно открыть в онлайн-версии.

Перенесите тот же процесс в свою инфраструктуру

Открытый репозиторий включает Server и Web. По инструкции развёртывания настройте домен, вход, постоянное хранение и окружение. Для разработки используются Node.js 24 и pnpm 11.

Укажите свой сервис в той же CLI и авторизуйте учётную запись в нём. Замените пример адреса реальным:

uvw config set workspace.origin https://workspace.example.comuvw auth login

Инструменты и Skills агента остаются прежними, но действуют на файлы и права вашего сервиса. Desktop тоже может подключаться к нему. Регистрация клиента и обратные вызовы описаны в руководстве Agent.

Откройте Workspace в локальном клиенте Desktop

Workspace Desktop объединяет Workspace, среду агента, инструменты Office и предпросмотр в локальном приложении. Это офисный процесс в духе Codex или Cowork: опишите цель, откройте документ или Web App рядом с диалогом, попросите исправления и проверьте результат.

Подключите Desktop к облаку, своему развёртыванию или локальному сервису Workspace. Модель и диалог предоставляет выбранный хост агента; файлы и доступ управляются подключённым Workspace. Ниже показан реальный настольный процесс создания, управления и совместной работы.

Установка и подключение · Первая задача: ревью бюджета в двух документах

Агентный процесс для повседневной Office-работы

Результаты Office требуют дальнейшего редактирования, вычислений, совместной работы и ревью. Desktop объединяет эти этапы вокруг редактируемого общего содержимого.

• Сохранение контекста: диалог, файлы, материалы Workspace и локальные ссылки под рукой.
• Office-контент и Web Apps: создавайте редактируемые таблицы, документы, презентации, Relational Table, Canvases и интерактивные страницы на основе их данных.
• Просмотр и уточнение: откройте результат рядом с диалогом, проверьте формулы и оформление, запросите правку.
• Публикация после ревью: изменения Office остаются в Worktree до проверки и слияния в общее пространство.

От запроса к результату для ревью

Создавайте и меняйте документы Office и Web Apps в обычных диалогах, затем управляйте ими и делитесь доступом в Space. Нативные правки Office проверяются в Worktree перед слиянием. Публикация HTML и связанные записи используют собственные процессы сохранения и авторизации. Следующие диалоги могут обращаться к тем же файлам и данным.

Что объединяет приложение

Workspace и агент на практике

Все следующие снимки и последовательность действий получены в установленном приложении macOS, подключённом к новому локальному Workspace. Учётная запись, Space, имена файлов, содержимое и диалог агента используют вымышленные данные на английском языке.

Создание и просмотр в обычном диалоге

Build Five-File Launch Demo — обычный диалог агента, в котором созданы таблица, документ, презентация, Relational Table и холст. На снимке настоящая передача результатов показана рядом с редактируемым 02 Launch Brief в браузерной панели Desktop. Продолжайте запрашивать правки в диалоге, а управлять файлами и делиться ими можно в Space.

Агент также создаёт интерактивные отчёты, рабочие страницы и панели в обычном диалоге. В следующей сессии он создал 06 Launch Dashboard на основе опубликованного бюджета: три карточки показывают бюджет, расходы и отклонение, а диаграмма следует за шестью направлениями через живые привязки HTML View. Этот пример только читает ту же нативную таблицу, без записи данных. Двусторонняя привязка экспериментальна и может меняться.

Управление, общий доступ и совместная работа в Space

Aurora Launch Studio объединяет пять нативных файлов и 06 Launch Dashboard, созданных в диалогах. В одном Space можно организовать бюджет, записку, презентацию из трёх слайдов, задачи, холст и Web App, управлять доступом и делиться ими с командой. Люди продолжают совместно редактировать нативный Office-контент, а связанная страница следует за его данными. Web и Desktop используют те же файлы; последующие правки агента ожидают проверки в отдельном Worktree.

Просмотр содержимого и проверка черновиков в Desktop

Последовательность показывает реальные действия Desktop: просмотр файлов локального Space, открытие нативных редакторов и возвращение к настоящему диалогу агента. Содержимое остаётся редактируемым в приложении.

Совместная работа с общим содержимым в Desktop

Web и Desktop открывают 01 Launch Budget под одной локальной учётной записью. Заметка из Web появляется в настоящем редакторе Desktop, а подтверждение из Desktop синхронизируется обратно в Web. На снимке видны обе заметки и состояние синхронизации. Это проверка между клиентами одной учётной записи; черновики агента остаются в отдельных Worktree.

Создание, правки и передача на проверку через диалог

Агент изменяет 02 Launch Brief в отдельном Worktree: добавляет двухнедельный этап согласования и задачи ответственных, повышает целевой показатель возврата с 40% до 45% и описывает риск с мерами снижения. Снимок показывает реальный диалог и нативный предпросмотр. Общий оригинал не изменён.

Worktree и Compare: проверка черновика в Desktop

Откройте Review changes из документа, чтобы сравнить общее содержимое и предложение Worktree в нативных представлениях. Прокрутите документ и проверьте различия перед принятием изменений. Показанная предварительная интеграция доступна только для чтения; в этом примере черновик не объединён.

Просмотр параметров доступа в Desktop

Панель общего доступа к Space в Desktop показывает роли участников и правила доступа по ссылке для этого командного пространства. Участники получают доступ к общему содержимому согласно своей роли; копирование ссылки не предоставляет доступ. При создании снимка разрешения не изменялись.

Пять типов нативного контента в одном приложении

Англоязычный проект Aurora связывает бюджет, записку, презентацию, задачи и схему процесса на вымышленных данных. Это нативные редакторы Office внутри Desktop; люди могут продолжать редактировать содержимое, с которым работает агент.

Снимки показывают интеграционную предварительную версию с оформлением Univer через точки расширения хоста. Она объединяет расширяемый хост агента и плагин Space; доступность предварительного плагина определяется релизами проекта.

Sheets: вычисляемая бизнес-модель

Бюджет охватывает шесть направлений с формулами Budget, Actual и Variance и нативной сравнительной диаграммой. Итого: бюджет USD 102,000, фактические расходы USD 100,000 и благоприятное отклонение USD 2,000. Агент проверяет расчёты через Facade API.

Docs: от данных к решениям

Заголовки, стили абзацев, списки и нативная таблица упорядочивают цель, план, показатели и ответственных. Последующий диалог позволяет изменить часть того же редактируемого документа в Worktree.

Slides: представить логику бизнеса

Три слайда объединяют редактируемые текст и фигуры в едином стиле: ценность запуска, план из четырёх этапов, показатели и ответственные. Их можно доработать и показать в том же приложении.

Relational Table: организовать выполнение

Шесть задач содержат типизированные поля статуса, приоритета, ответственного, срока и заметок. Цветные варианты показывают ход работы и приоритеты в общем реестре.

Canvases: связать стратегию и действия

Нативные фигуры, текст и соединители показывают четыре этапа: Align → Activate → Share → Learn. Короткие заметки связывают этапы с действиями и основаниями.

Установка и подключение

В расширяемом агентском приложении можно установить и включить плагин Space, подключить сервис из Space, настроить модель и добавить оформление. Здесь показана такая композиция. Полное приложение Desktop и предварительный плагин распространяются по-разному; следуйте релизу или инструкции репозитория для своей версии.

1. Выберите Desktop в GitHub Releases: теги agent-v, Windows x64, macOS Apple Silicon или Linux x64. Поставка экспериментальная; ориентируйтесь на опубликованные версии.

2. В Settings → Workspace задайте сервис, войдите через браузер и разрешите доступ. Используйте готовый сервис или локальную установку.

3. В Models настройте поддерживаемого провайдера, модель и ключи. Это отдельно от входа Workspace: см. настройку моделей.

4. Добавьте доступный Personal или Team Space, начните диалог и укажите материалы через @. Выполните задачу ниже и откройте просмотр и ревью.

Установщик содержит агентное приложение и Office-инструменты. Workspace запускается отдельно локально или на сервере; доступ к модели настраивается отдельно.

Первая задача: ревью бюджета в двух документах

Создай в текущем Space английскую таблицу Budget Review с восемью примерами отделов: Department, Budget, Actual, Variance. Разницу и итоги вычисли формулами, добавь диаграмму бюджета и фактических расходов.Создай короткий документ с выводами о перерасходе и ссылкой на таблицу. Сохрани Office-изменения в одном Worktree, проверь данные, формулы и результат, открой просмотр и ревью и дождись моего одобрения перед слиянием.

Затем попросите «Уменьши бюджет Marketing на 10% и обнови выводы» и проверьте значения и различия перед принятием.

Реальный сеанс: от модели к записке для решения

Сессия Aurora в Desktop объединяет чтение исходных файлов, правку нативного документа и последующий запрос на проверку. Агент сохраняет существующий черновик в состоянии Ready до решения человека. См. реальный диалог в Desktop и нативное сравнение Worktree.

Создайте свой Workspace на основе репозитория

Показанное приложение собрано на Office SDK. Возьмите репозиторий Workspace, используйте движок содержимого и совместной работы и адаптируйте процессы, Skills, инструменты и интерфейс под свою команду.

Найдите нужную часть проекта

Skills: от понимания пространства до выполнения задачи

Skills для вашего агента

Установленный в агенте Skill univer-workspace-cli служит точкой обнаружения: подключение, поиск цели и загрузка инструкций. Полные Skills поставляются с CLI и соответствуют её командам и Facade API. Встроенный плагин Desktop также предоставляет инструкции и инструменты для задач.

uvw skills listuvw skills get coreuvw skills get sheetuvw skills get html-view

Сначала загрузите core, затем нужный продукт или тему. skills get перечисляет пути, uvw skills read <name> <path> читает выбранный документ, --full включает их вместе. Существующие агенты используют CLI, а Desktop встраивает инструменты и инструкции в диалог.

Инструкции внутри Desktop

Плагин включает Skill univer и справочники: поиск Spaces и документов, Office API, создание, проверка и передача Worktree. Агент может найти API, выполнить его над нативным содержимым и проверить результат.

Плагин возможностей объединяет поиск файлов, редактирование через Headless Facade, структурную проверку, импорт/экспорт и управление Worktree. Эта предварительная версия готовит черновики к проверке; публикация использует процесс проверки и слияния развёрнутого приложения. На том же Office runtime можно добавлять отраслевые Skills, шаблоны и бизнес-инструменты.

Предварительный плагин включает девять Skills. Общая инструкция описывает поиск, идентификацию и передачу результата; инструкции продуктов содержат API и способы проверки. Агент читает материалы для текущей задачи.

Разделить цикл агента и возможности Office

Skills направляют агента, инструменты изменяют структурированный контент через Headless, а нативные редакторы отображают его людям. Workspace предоставляет файлы и контекст совместной работы. Можно сменить модель, добавить бизнес-инструменты или оформление, не создавая движок Office заново.

Повторно используемый путь: запрос → инструменты → редактируемое содержимое → просмотр → ревью → общий результат. Office SDK даёт Office-слой, хост — диалог и цикл выполнения. Расширяйте приложение и плагины или подключайте свой хост.

Адаптируйте процесс к своим задачам

Изучить реализацию

Сборка и поставка Desktop · Агентное приложение и настройка · Все примеры

Office Lab