Workspace

Открытое рабочее пространство на Univer Office SDK: облачная проба, своё развёртывание, подключение агентов через CLI и работа в Desktop.

Рабочее пространство Univer - это рабочее пространство Office с открытым исходным кодом, построенное на Univer Office SDK, в котором люди и агенты работают вместе. Редактируемый контент Office и веб-приложения, связанные с данными, организованы в личные и командные пространства вместе с обменом, сотрудничеством, версиями и обзором изменений. Источник репозитория содержит приложение, конфигурацию развертывания, CLI и настольный клиент.

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

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

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

Откройте облачный тест, войдите и введите свое личное пространство или командное пространство, к которому вы можете получить доступ. Создайте или откройте документ, затем попробуйте прямое редактирование, организацию файлов и обмен. Сервис Workspace уже работает, поэтому агент также может подключиться к нему через CLI, описанный ниже. Испытание предназначено для выборки данных, и эти данные могут быть сброшены.

Рабочее пространство сервера управляет идентификацией, Пространствами, разрешениями, хранением, сотрудничеством и версиями. Веб сайт - это интерфейс браузера для редактирования и просмотра. Частное развертывание запускает то же самое серверное и веб-приложение.

100%

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

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

Bash
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
Первое подключение: один вход в браузере

Этот шаг можно пропустить, когда уже существует действительный сеанс. Если требуется вход, запустите:

Bash
uvw auth login

Откройте обратную ссылку, войдите и подтвердите код в браузере. После того, как пользователь подтвердит завершение, запустите:

Bash
uvw auth login --complete

Этот шаг требуется только при установлении сеанса. Руководство Workspace CLI документирует полный набор команд и аутентификацию.

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

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

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

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

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

репозиторий с открытым исходным кодом содержит Server и Web.Создайте приложение с помощью Руководство по развертыванию, затем настройте домен, вход, постоянное хранилище и настройки времени выполнения.Разработка из источника использует Node.js 24 и pnpm 11; руководство поддерживает детали развертывания производства.

Перед развертыванием подготовьте четыре части:

СоставляющаяЧто настроить
СервисДоступный URL рабочего пространства и веб-приложение Server +. Настольный компьютер и CLI подключаются к этому развертыванию.
Постоянные данныеБаза данных продуктов, база данных совместной работы и загруженные файлы сохранялись вместе.Развертывание по умолчанию хранит их под .data; для Docker установите постоянный том.
ИдентификацияНастройка входа. Когда Desktop подключается, зарегистрируйте клиент Agent OAuth с точным соответствием URL обратного вызова.
Лицензия SDKОбеспечить VITE_UNIVER_LICENSE при создании Web для домена развертывания и настроить лицензию, требуемую временем выполнения контента Node.js, отдельно.

Модели учетных данных принадлежат хосту Агента и настроены отдельно от входа в Workspace. Руководство по развертыванию и Подстава агента описывают текущие настройки.

Настройте тот же CLI для использования частного развертывания и авторизации учетной записи в этой службе. Замените приведенный ниже примерный адрес фактическим происхождением службы:

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

Агент хранит те же инструменты и навыки и теперь работает с файлами и разрешениями частной службы. Настольный компьютер также может подключиться к этой службе. Руководство по подключению агентов документирует регистрацию клиента и конфигурацию обратного вызова.

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

Рабочий стол Workspace сочетает в себе Workspace, время выполнения агента, инструменты Office и предварительные просмотры контента в одном локальном клиенте. Работа Office следует шаблону разговора и предварительного просмотра, знакомому из Codex или Cowork: опишите желаемый результат, проверьте документ или веб-приложение рядом с разговором, запросите пересмотр и просмотрите результат.

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

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

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

Офисная работа продолжается после того, как разговор возвращает загружаемый файл. Люди продолжают редактировать, вычислять по реальным данным, работать с товарищами по команде и решать, какие изменения принять. Настольный компьютер размещает эти действия в одной рабочей среде.

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

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

Офисные документы и веб-приложения создаются и пересматриваются в обычном разговоре, затем управляются и передаются в пространстве. Изменения в родном офисе проходят через обзор Worktree, прежде чем они сольются. Публикация HTML и записи связывания следуют за их собственными потоками сохранения и авторизации. Более поздние разговоры могут ссылаться на те же файлы и данные.

100%

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

ВозможностьРабота пользователя
Сессии агентаРазговоры и контекст задачи, с провайдером и конфигурацией модели, управляемые локально.
Файлы и ссылкиПросмотрите Пространства, к которым вы можете получить доступ. Используйте @ для ссылки на файлы или папки Workspace и локальный материал.
Просмотр содержимогоОткройте нативные файлы Office или веб-приложения рядом с разговором, чтобы проверить контент, взаимодействия и данные.
Ревью и передачаПосмотрите, какие документы Worktree добавили, изменили или удалили, а затем запросите изменения, слить или отбросить.
Локальный или серверный WorkspaceПодключитесь к онлайн-сервису команды или запустите сервис Workspace на локальной машине.
Управление и совместная работа в SpaceОрганизуйте разговоры с файлами, создавайте, управляйте обменом и редактируйте один и тот же контент с товарищами по команде.

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

На скриншотах ниже показан реальный рабочий стол macOS, подключенный к локальному рабочему пространству и использующий вымышленные материалы запуска.Этот предварительный просмотр интеграции сочетает в себе расширяемый хост Agent, плагин Space и фирменную кожу Univer; доступность следует за релизами проекта.

Создавайте и просматривайте результаты в диалоге

Опишите требование в обычном разговоре, и Агент создает или пересматривает документы Office и веб-приложения. Предварительные просмотры появляются справа, а дальнейшие уточнения продолжаются через разговор. Содержимое сохраняется в Workspace, где Space управляет файлами, обменом и сотрудничеством.

01 стартовый бюджет объединяет бюджеты, фактические расходы, прогнозы, формулы дисперсий и итоговые показатели в одном листе. Графики сравнивают бюджет с фактическими расходами и показывают дисперсию для каждого рабочего потока.

Тот же рабочий процесс разговора также создает веб-приложения. 06 Запуск Dashboard представляет бюджет, фактические расходы и дисперсию в виде карт KPI, диаграмм и деталей рабочего потока. HTML-связи позволяют странице читать данные таблиц, поэтому команда может использовать интерактивный отчет рядом с файлами Office. Обязательный остается экспериментальным.

Управляйте результатами в Space

Результаты беседы становятся файлами, которые команда продолжает использовать. Space держит в одном месте контент Office и веб-приложения, с категориями продуктов, последними файлами, фаворитами и личными или командными пространствами. Представление Все ниже собирает материал из Студия Aurora Launch и Приглашения команды.

Продолжайте редактирование и совместную работу из Space

Открыть 01 стартовый бюджет из Space, чтобы продолжить в родном редакторе электронных таблиц. Бюджетные строки, формулы и итоговые данные остаются редактируемыми, а комментарии, история редактирования и общий доступ доступны в том же виде. Web и Desktop читают одни и те же файлы Workspace. Более поздние версии Агента могут оставаться в отдельном Worktree до обзора.

Worktree и Compare: проверка перед объединением

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

Поделитесь документом или Web App с командой

Откройте Поделиться на приборной панели, чтобы проверить, кто может получить доступ к странице и скопировать ее ссылку. В этом командном пространстве страница наследует разрешения участников из Пространства, а Управление доступом в космос открывает место, где эти разрешения управляются. Копирование ссылки не дает дополнительного доступа.

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

Если рабочий стол расширяемого агента уже используется, путь интеграции заключается в установке и включении плагина возможностей Space, подключении из Space, настройке модели и добавлении скина бренда. Скриншоты на этой странице используют эту композицию. Полный выпуск рабочего стола Workspace и предварительный просмотр плагина следуют отдельным путям доставки; используйте опубликованный выпуск или инструкции репозитория для установленной версии.

  1. Выберите установщик рабочего стола из GitHub выпустили. В релизах рабочего стола используются теги agent-v, поэтому выберите Windows x64, macOS Apple Silicon или Linux x64 для вашей машины. Доставка рабочего стола является экспериментальной, а доступность следует за опубликованными релизами.

  2. В Настройки → Рабочее пространство выберите службу Workspace, войдите через браузер и авторизуйте доступ.Подключитесь к развернутой службе или следуйте за локальная установка для запуска службы локально.

  3. В настройках моделей настройте поддерживаемого провайдера, модель и учетные данные. Вход в рабочее пространство и доступ к модели настроены отдельно; см. конфигурация модели.

  4. Добавьте доступное личное или командное пространство, начните разговор и используйте @ для ссылки на исходный материал. Запустите задачу ниже, затем откройте предварительный просмотр контента и обзор изменений.

Установщик включает в себя приложение агента и инструменты Office.Сервис Workspace работает отдельно, локально или удаленно, а модельный доступ использует настроенный провайдер.

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

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

Далее следуйте: «Снизить бюджет маркетинга на 10% и обновить резюме». Проверьте пересмотренные значения и изменения в документе, прежде чем принять проект.

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

Приложение, описанное выше, представляет собой композицию Office SDK, которая может быть адаптирована.Начните с Репозиторий рабочего пространства, повторно используйте время выполнения контента и возможности совместной работы, а также перестраивайте рабочие процессы, навыки, инструменты и интерфейс вокруг требований команды.

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

РасположениеНазначение
apps/workspaceServer, Web, API продукта и настройка развёртывания.
apps/cliПодключение существующих агентов к работающему Workspace.
apps/agentХост агента, жизненный цикл подключения и оболочка Desktop.
skills/univer-workspace-cliDiscovery Skill встроен в уже существующий агент.
packages/client-coreОбщие операции Workspace для Node-хостов.
packages/dsh-univer-workspace-pluginИнструменты Office, нативный предпросмотр и инструкции задач.
packages/dsh-univer-workspace-skin-pluginОформление Workspace и визуальные токены.
packages/workspace-html-viewerHTML View Sandbox и хост-связывающий данные для веб-приложений.

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

Эти навыки позволяют существующему агенту создавать и редактировать контент Office и веб-приложения в подключенном рабочем пространстве, а затем передавать изменения для просмотра. Подключите агента к рабочему пространству; приведенное ниже руководство работает с файлами и разрешениями этой службы.

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

Навыки univer-workspace-cli, установленный в существующем агенте, является точкой входа обнаружения. Он объясняет, как подключать, находить цель и загружать операционное руководство. Полный корабль навыков выполнения с CLI и соответствовать его командам и API Facade. Встроенный плагин возможностей в Desktop также обеспечивает руководство задачами и инструментами.

ИнструкцияОхват
coreПоиск Пространств и файлов, работа в черновиках задач, проверка контента и передача для обзора.
sheet · doc · slide · base · boardТаблицы, документы, презентации, Relational Table и Canvases.
blobЗагрузка, загрузка и замена оригинальных файлов.
html-viewСоздание и управление живыми HTML-страницами для интерактивных веб-приложений.
embed · cross-unit-formulaВстраивание другого контента и соединение данных и формул между типами контента.
Bash
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

Плагин возможностей Desktop включает в себя навык универ и его ссылки. Он описывает, как связаны Пространства и документы, как использовать API Office и как создавать, проверять и доставлять Worktree. Инструкции сопровождают исполняемые инструменты, поэтому агент может искать API, запускать его на родном контенте и проверять результат.

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

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

SkillИнструкции
univerSpaces, файлы, жизненный цикл черновика и передача
univer-sheetФормулы, стили, диаграммы и проверка таблиц
univer-docСтруктура документа, абзацы и таблицы
univer-slideСоздание слайдов и визуальная проверка
univer-baseПоля, записи и представления
univer-boardФигуры, соединители и компоновка холста
univer-embedВстраивание одного продукта Office в другой
univer-cross-unit-formulaСсылки и расчеты по единицам
univer-html-viewСоздание и проверка HTML-страниц, связанных с данными Office

Как Office SDK обеспечивает работу Workspace

Workspace соединяет нативные редакторы, операции с контентом агентов и совместную работу с одними и теми же документами и разрешениями. Вы можете опираться на это приложение с открытым исходным кодом и на Office SDK и сосредоточить свои усилия на бизнес-процессах, интерфейсе и интеграции.

100%

Агенты работают с контентом в Node.js через CLI или Desktop, и люди просматривают, редактируют и просматривают его в редакторе Web или Deskton. Workspace Server хранит общие документы, черновики и состояние совместной работы, и он может работать локально, на частных серверах или в облаке.

СлойОтветственность
Web SDKМодели контента, формулы, публичные Facade API и нативные редакторы.
AI SDKПоиск API, структурная проверка контента и выполнение Facade для указанного документа.
Server SDKСовместное редактирование, ревизии, черновики Worktree и преобразование файлов.
ПриложениеWorkspace управляет пространствами, файлами, правами, общим доступом и ревью. Хост агента отвечает за диалоги, вызовы модели и инструменты.

CLI и Desktop совместно используют Уровень контентных операций. Его пул времени выполнения сохраняет загруженные документы живыми в течение всего срока службы хоста и синхронизирует версии перед выполнением. Поэтому разные клиенты повторно используют одну и ту же логику редактирования и представления. См. использование Runtime .

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

От правки агента к проверяемому изменению

В примере с обзором бюджета агент редактирует электронную таблицу, содержащую формулы и стили. Нативный путь редактирования Office протекает следующим образом:

  1. Найти и загрузить. Агент выбирает документ и Worktree, загружает снимки и изменения и синхронизируется с выбранной версией. Единица - это один экземпляр документа, такой как рабочая тетрадь.
  2. Редактировать через Фасад. Среда выполнения Node.js выполняет публичные вызовы Фасада против этого блока. Изменения контента вызывают мутации, которые собираются в набор изменений и представляются в проект.
  3. Проверьте результат. Агент считывает значения и формулы обратно и проверяет отданный результат при необходимости.Редактирование продолжается в том же проекте до тех пор, пока результат не будет готов к рассмотрению.
  4. Провести ревью и слияние. Человек проверяет различия через Compare и решает, объединять ли Worktree с общей версией.

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

Как Web App подключается к тем же данным Office

Панель запуска использует ту же электронную таблицу, что и редактор бюджета. HTML View отображает страницу в песочнице iframe. Хост Workspace разрешает исходные документы, к которым пользователь может получить доступ и поставляет свои авторизованные движки контента. Метрические карты и диаграммы подписываются на исходные данные, поэтому вторая копия бюджета не требуется.

Для редактируемых привязок запись требует подписанного идентификатора и разрешения на редактирование исходного документа. Когда пользователь покидает страницу, хост ждет отложенных записей и подтверждения совместной работы, и он сообщает о сохранении сбоев. HTML-страница, публикующая и привязывающая записи, использует свои собственные пути сохранения и автоматически не следует за нативным потоком слияния Office Worktree. См. Связь экспериментальных данных и HTML View host реализация .

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

ЦельС чего начать
Отраслевые документы и задачиДобавьте навыки домена, шаблоны и руководство по инструментам, а также сохраните контент и визуальные проверки.
Свои пользователи, хранение и доступРасширьте приложение Workspace и его серверные политики.
Ваш собственный агент-клиент OfficeОбъедините хост-агент, плагин возможностей и кожу бренда, а затем подключите выбранные модели и бизнес-инструменты.

Пример: Skill для ревью бюджета

Навык домена может кодировать правила обзора команды при повторном использовании существующих инструментов Office:

  • Найдите исходную книгу, период и столбцы «Бюджет/Актуальный» и спросите о любых недостающих бизнес-определениях перед редактированием.
  • Загрузить руководство по таблицам, создать Worktree, обновить формулы через Facade и подготовить документ для ревью.
  • Проверяйте итоговые данные, результаты формул и представление, сообщайте об изменённых файлах и выполненных проверках, а затем передайте черновик человеку для ознакомления.

Бизнес-правила и шаблоны относятся к Skill. В приложении остаются проверки доступа, сохранение проекта и согласование слияния. Для подключения ERP или CRM добавьте инструмент приложения, который возвращает необходимые данные и повторно использует тот же поток редактирования и обзора Office. Выполнение Skill направляет; он не предоставляет доступ к файлу.

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

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

Office Lab

Насколько полезно это руководство?

© 2026 DreamNum Co., Ltd.