Workspace
Открытое рабочее пространство на Univer Office SDK: облачная проба, своё развёртывание, подключение агентов через CLI и работа в Desktop.
Рабочее пространство Univer - это рабочее пространство Office с открытым исходным кодом, построенное на Univer Office SDK, в котором люди и агенты работают вместе. Редактируемый контент Office и веб-приложения, связанные с данными, организованы в личные и командные пространства вместе с обменом, сотрудничеством, версиями и обзором изменений. Источник репозитория содержит приложение, конфигурацию развертывания, CLI и настольный клиент.
Можно развернуть Workspace на собственной инфраструктуре или начать с облачный тест. Существующий агент подключается через Workspace CLI. Workspace Desktop приносит в локальное приложение разговор агента и то же рабочее пространство. Все эти маршруты работают на одном сервисе и одних и тех же файлах.
Проба в облаке · Подключить агента · Своё развёртывание · Возможности Desktop · Код и адаптация
Начните с облачного Workspace
Откройте облачный тест, войдите и введите свое личное пространство или командное пространство, к которому вы можете получить доступ. Создайте или откройте документ, затем попробуйте прямое редактирование, организацию файлов и обмен. Сервис Workspace уже работает, поэтому агент также может подключиться к нему через CLI, описанный ниже. Испытание предназначено для выборки данных, и эти данные могут быть сброшены.
Рабочее пространство сервера управляет идентификацией, Пространствами, разрешениями, хранением, сотрудничеством и версиями. Веб сайт - это интерфейс браузера для редактирования и просмотра. Частное развертывание запускает то же самое серверное и веб-приложение.
Подключите своего агента к облачному Workspace
Установите CLI и Discovery Skill в среде, где работает ваш агент. Требуется Node.js 22.12 или новее, и рекомендуется Node.js 24. Агент, который может выполнять команды, использует эти инструменты, продолжая предоставлять свою собственную модель и разговор. Установите облачный сервис явно так, чтобы браузер и агент работали в одном рабочем пространстве:
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Этот шаг требуется только при установлении сеанса. Руководство Workspace CLI документирует полный набор команд и аутентификацию.
После того, как браузер авторизует CLI один раз, CLI повторно использует этот сеанс для более поздних задач. Не требуется никакой страницы входа в систему или интеграции аутентификации для конкретного агента. Дайте подключенному агенту задачу, а затем откройте ссылку, которую он возвращает в Интернете: контент тот же, и изменения нативного офиса агента могут быть рассмотрены перед слиянием.
Начните с документа, который можно вычислить и проверить
Создай в моём личном пространстве 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 для использования частного развертывания и авторизации учетной записи в этой службе. Замените приведенный ниже примерный адрес фактическим происхождением службы:
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 и записи связывания следуют за их собственными потоками сохранения и авторизации. Более поздние разговоры могут ссылаться на те же файлы и данные.
Что объединяет приложение
| Возможность | Работа пользователя |
|---|---|
| Сессии агента | Разговоры и контекст задачи, с провайдером и конфигурацией модели, управляемые локально. |
| Файлы и ссылки | Просмотрите Пространства, к которым вы можете получить доступ. Используйте @ для ссылки на файлы или папки Workspace и локальный материал. |
| Просмотр содержимого | Откройте нативные файлы Office или веб-приложения рядом с разговором, чтобы проверить контент, взаимодействия и данные. |
| Ревью и передача | Посмотрите, какие документы Worktree добавили, изменили или удалили, а затем запросите изменения, слить или отбросить. |
| Локальный или серверный Workspace | Подключитесь к онлайн-сервису команды или запустите сервис Workspace на локальной машине. |
| Управление и совместная работа в Space | Организуйте разговоры с файлами, создавайте, управляйте обменом и редактируйте один и тот же контент с товарищами по команде. |
Workspace и агент на практике
На скриншотах ниже показан реальный рабочий стол macOS, подключенный к локальному рабочему пространству и использующий вымышленные материалы запуска.Этот предварительный просмотр интеграции сочетает в себе расширяемый хост Agent, плагин Space и фирменную кожу Univer; доступность следует за релизами проекта.
Создавайте и просматривайте результаты в диалоге
Опишите требование в обычном разговоре, и Агент создает или пересматривает документы Office и веб-приложения. Предварительные просмотры появляются справа, а дальнейшие уточнения продолжаются через разговор. Содержимое сохраняется в Workspace, где Space управляет файлами, обменом и сотрудничеством.
01 стартовый бюджет объединяет бюджеты, фактические расходы, прогнозы, формулы дисперсий и итоговые показатели в одном листе. Графики сравнивают бюджет с фактическими расходами и показывают дисперсию для каждого рабочего потока.
2 Короткометражный старт превращает цель, план запуска, меры успеха и действия владельца в редактируемый документ.
03 История запуска превращает план в презентацию с этапами запуска, воротами одобрения и мерами успеха, готовыми к командному обзору.
04 План запуска отслеживает задачи по фазе, статусу, приоритету и владельцу и поддерживает переключение между сеткой, доской статуса и фазовыми представлениями по мере продвижения работы.
05 Карта запуска соединяет этапы запуска на холсте, помещая результаты, владельцев и контрольные точки утверждения в один визуальный план.
Тот же рабочий процесс разговора также создает веб-приложения. 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 и предварительный просмотр плагина следуют отдельным путям доставки; используйте опубликованный выпуск или инструкции репозитория для установленной версии.
-
Выберите установщик рабочего стола из GitHub выпустили. В релизах рабочего стола используются теги agent-v, поэтому выберите Windows x64, macOS Apple Silicon или Linux x64 для вашей машины. Доставка рабочего стола является экспериментальной, а доступность следует за опубликованными релизами.
-
В Настройки → Рабочее пространство выберите службу Workspace, войдите через браузер и авторизуйте доступ.Подключитесь к развернутой службе или следуйте за локальная установка для запуска службы локально.
-
В настройках моделей настройте поддерживаемого провайдера, модель и учетные данные. Вход в рабочее пространство и доступ к модели настроены отдельно; см. конфигурация модели.
-
Добавьте доступное личное или командное пространство, начните разговор и используйте @ для ссылки на исходный материал. Запустите задачу ниже, затем откройте предварительный просмотр контента и обзор изменений.
Установщик включает в себя приложение агента и инструменты Office.Сервис Workspace работает отдельно, локально или удаленно, а модельный доступ использует настроенный провайдер.
Первая задача: ревью бюджета в двух документах
Создай в текущем Space английскую таблицу Budget Review с восемью примерами отделов: Department, Budget, Actual, Variance. Разницу и итоги вычисли формулами, добавь диаграмму бюджета и фактических расходов.Создай короткий документ с выводами о перерасходе и ссылкой на таблицу. Сохрани Office-изменения в одном Worktree, проверь данные, формулы и результат, открой просмотр и ревью и дождись моего одобрения перед слиянием.Далее следуйте: «Снизить бюджет маркетинга на 10% и обновить резюме». Проверьте пересмотренные значения и изменения в документе, прежде чем принять проект.
Создайте свой Workspace на основе репозитория
Приложение, описанное выше, представляет собой композицию Office SDK, которая может быть адаптирована.Начните с Репозиторий рабочего пространства, повторно используйте время выполнения контента и возможности совместной работы, а также перестраивайте рабочие процессы, навыки, инструменты и интерфейс вокруг требований команды.
Найдите нужную часть проекта
| Расположение | Назначение |
|---|---|
apps/workspace | Server, Web, API продукта и настройка развёртывания. |
apps/cli | Подключение существующих агентов к работающему Workspace. |
apps/agent | Хост агента, жизненный цикл подключения и оболочка Desktop. |
skills/univer-workspace-cli | Discovery Skill встроен в уже существующий агент. |
packages/client-core | Общие операции Workspace для Node-хостов. |
packages/dsh-univer-workspace-plugin | Инструменты Office, нативный предпросмотр и инструкции задач. |
packages/dsh-univer-workspace-skin-plugin | Оформление Workspace и визуальные токены. |
packages/workspace-html-viewer | HTML 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 | Встраивание другого контента и соединение данных и формул между типами контента. |
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 | Инструкции |
|---|---|
univer | Spaces, файлы, жизненный цикл черновика и передача |
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 и сосредоточить свои усилия на бизнес-процессах, интерфейсе и интеграции.
Агенты работают с контентом в Node.js через CLI или Desktop, и люди просматривают, редактируют и просматривают его в редакторе Web или Deskton. Workspace Server хранит общие документы, черновики и состояние совместной работы, и он может работать локально, на частных серверах или в облаке.
| Слой | Ответственность |
|---|---|
| Web SDK | Модели контента, формулы, публичные Facade API и нативные редакторы. |
| AI SDK | Поиск API, структурная проверка контента и выполнение Facade для указанного документа. |
| Server SDK | Совместное редактирование, ревизии, черновики Worktree и преобразование файлов. |
| Приложение | Workspace управляет пространствами, файлами, правами, общим доступом и ревью. Хост агента отвечает за диалоги, вызовы модели и инструменты. |
CLI и Desktop совместно используют Уровень контентных операций. Его пул времени выполнения сохраняет загруженные документы живыми в течение всего срока службы хоста и синхронизирует версии перед выполнением. Поэтому разные клиенты повторно используют одну и ту же логику редактирования и представления. См. использование Runtime .
Визуальный осмотр дополняет структурированные проверки.Скриншоты поступают от рендеринга браузера, а автоматическая диагностика макета в настоящее время обнаруживает переполнение и перекрытие текста в слайдах.
От правки агента к проверяемому изменению
В примере с обзором бюджета агент редактирует электронную таблицу, содержащую формулы и стили. Нативный путь редактирования Office протекает следующим образом:
- Найти и загрузить. Агент выбирает документ и Worktree, загружает снимки и изменения и синхронизируется с выбранной версией. Единица - это один экземпляр документа, такой как рабочая тетрадь.
- Редактировать через Фасад. Среда выполнения Node.js выполняет публичные вызовы Фасада против этого блока. Изменения контента вызывают мутации, которые собираются в набор изменений и представляются в проект.
- Проверьте результат. Агент считывает значения и формулы обратно и проверяет отданный результат при необходимости.Редактирование продолжается в том же проекте до тех пор, пока результат не будет готов к рассмотрению.
- Провести ревью и слияние. Человек проверяет различия через 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 · Агентное приложение и настройка · Все примеры
Насколько полезно это руководство?