# Workspace
> Открытое рабочее пространство на Univer Office SDK: облачная проба, своё развёртывание, подключение агентов через CLI и работа в Desktop.
- Human documentation: [https://docs.univer.ai/ru-RU/overview/examples/workspace](https://docs.univer.ai/ru-RU/overview/examples/workspace)
- Agent Markdown: [https://docs.univer.ai/ru-RU/overview/examples/workspace.md](https://docs.univer.ai/ru-RU/overview/examples/workspace.md)
- Requested language: `ru-RU`
- Content language: `ru-RU`
- Documentation version: `1.3.0`
- Source: [examples/workspace.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/examples/workspace.ru-RU.mdx)
---
**Univer Workspace** — открытое рабочее пространство на **[Univer Office SDK](https://docs.univer.ai/ru-RU/overview.md)** для людей и агентов. Редактируемые документы Office и Web Apps с привязкой к данным объединены в личных и командных Spaces с совместной работой, доступом, версиями и проверкой изменений. [Репозиторий](https://github.com/dream-num/univer-workspace) содержит приложение, средства развёртывания, CLI и настольный клиент.
Разверните Workspace у себя или начните с [облачной пробы](https://space.univer.ai). Существующий агент подключается через Workspace CLI, а Workspace Desktop объединяет диалог и то же пространство в локальном приложении. Все варианты работают с одним сервисом и файлами.
[Проба в облаке](#entry-points) · [Подключить агента](#cli-start) · [Своё развёртывание](#self-host) · [Возможности Desktop](#desktop-start) · [Код и адаптация](#build-your-own)
## Начните с облачного Workspace
Откройте [облачную пробу](https://space.univer.ai), войдите и выберите личный или доступный командный Space. Создавайте, редактируйте, организуйте и публикуйте документы. К этому работающему сервису можно подключить агента через CLI ниже. Используйте тестовые данные: содержимое пробного сервиса может сбрасываться.
**Workspace Server** управляет пользователями, Spaces, правами, хранением, совместной работой и версиями. **Web** предоставляет браузерный интерфейс редактирования и проверки. Частное развёртывание использует те же Server и Web.
```mermaid
flowchart LR
H["Участники команды"] --> W["Web онлайн
Правка · Совместная работа · Ревью"] --> S["Workspace Server
Пространства · Содержимое · Права · Версии"]
A["Ваш агент"] --> C["Workspace CLI
Skills · Операции"] --> S
```
## Подключите своего агента к облачному Workspace
Установите CLI и вводную Skill в среде агента. Нужен Node.js 22.12 или новее; рекомендуется 24. Агент с выполнением команд использует эти инструменты со своей моделью и диалогом. Явно задайте облачный сервис, чтобы браузер и агент работали в одном Workspace:
```bash
npm install --global univer-workspace-cli@latest
npx skills add dream-num/univer-workspace --skill univer-workspace-cli -g
uvw --version
uvw config set workspace.origin https://space.univer.ai
```
#### Первое подключение: один вход в браузере
Пропустите при наличии действующей сессии. Если нужен вход, выполните:
```bash
uvw auth login
```
Откройте ссылку, войдите и подтвердите код в браузере. Только после подтверждения пользователем выполните:
```bash
uvw auth login --complete
```
Этот шаг устанавливает сессию. Команды и подробности — в [руководстве Workspace CLI](https://github.com/dream-num/univer-workspace/blob/main/apps/cli/README.md).
После первого подтверждения в браузере CLI повторно использует сеанс. Не нужно создавать отдельный вход или интеграцию авторизации для каждого агента. Дайте агенту задачу и откройте возвращённую ссылку в Web, чтобы проверить то же содержимое и изменения Office перед слиянием.
### Начните с документа, который можно вычислить и проверить
```text
Создай в моём личном пространстве Workspace таблицу месячных расходов на английском: даты, категории, суммы и пять примерных строк. Добавь формулу итога и диаграмму по категориям.
Работай в отдельном черновике, проверь данные, формулы и отображение, затем дай ссылку на просмотр или ревью. Не объединяй до моего подтверждения.
```
Отправьте задачу подключённому агенту или используйте Desktop. Агент создаёт и проверяет, а вы запрашиваете правки, проводите ревью и решаете об объединении. То же содержимое можно открыть в онлайн-версии.
## Перенесите тот же процесс в свою инфраструктуру
[Открытый репозиторий](https://github.com/dream-num/univer-workspace) включает Server и Web. По [инструкции развёртывания](https://github.com/dream-num/univer-workspace/blob/main/apps/workspace/README.md#docker) настройте домен, вход, постоянное хранение и окружение. Для разработки используются Node.js 24 и pnpm 11.
Укажите свой сервис в той же CLI и авторизуйте учётную запись в нём. Замените пример адреса реальным:
```bash
uvw config set workspace.origin https://workspace.example.com
uvw auth login
```
Инструменты и Skills агента остаются прежними, но действуют на файлы и права вашего сервиса. Desktop тоже может подключаться к нему. Регистрация клиента и обратные вызовы описаны в [руководстве Agent](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/README.md#connect-to-a-local-workspace).
## Откройте Workspace в локальном клиенте Desktop
**Workspace Desktop** объединяет Workspace, среду агента, инструменты Office и предпросмотр в локальном приложении. Это офисный процесс в духе Codex или Cowork: опишите цель, откройте документ или Web App рядом с диалогом, попросите исправления и проверьте результат.
Подключите Desktop к облаку, своему развёртыванию или локальному сервису Workspace. Модель и диалог предоставляет выбранный хост агента; файлы и доступ управляются подключённым Workspace. Ниже показан реальный настольный процесс создания, управления и совместной работы.
[Установка и подключение](#desktop-install) · [Первая задача: ревью бюджета в двух документах](#desktop-first-task)
### Агентный процесс для повседневной Office-работы
Результаты Office требуют дальнейшего редактирования, вычислений, совместной работы и ревью. Desktop объединяет эти этапы вокруг редактируемого общего содержимого.
- **Сохранение контекста:** диалог, файлы, материалы Workspace и локальные ссылки под рукой.
- **Office-контент и Web Apps:** создавайте редактируемые таблицы, документы, презентации, Relational Table, Canvases и интерактивные страницы на основе их данных.
- **Просмотр и уточнение:** откройте результат рядом с диалогом, проверьте формулы и оформление, запросите правку.
- **Публикация после ревью:** изменения Office остаются в Worktree до проверки и слияния в общее пространство.
### От запроса к результату для ревью
Создавайте и меняйте документы Office и Web Apps в обычных диалогах, затем управляйте ими и делитесь доступом в Space. Нативные правки Office проверяются в Worktree перед слиянием. Публикация HTML и связанные записи используют собственные процессы сохранения и авторизации. Следующие диалоги могут обращаться к тем же файлам и данным.
```mermaid
flowchart LR
A["Диалог
Запрос и материалы"]
B["Документы Office
Worktree и ревью"]
C["Web App
HTML и привязка данных"]
D["Space
Управление · доступ · совместная работа"]
A --> B --> D
A --> C --> D
D -->|Продолжить с тем же содержимым| A
```
### Что объединяет приложение
| Возможность | Работа пользователя |
| --- | --- |
| Сессии агента | Диалог и контекст задачи; локальная настройка провайдера, модели и ключей. |
| Файлы и ссылки | Доступные Spaces; @ для файлов и папок Workspace и локальных материалов. |
| Просмотр содержимого | Открывайте нативные Office-файлы или Web Apps рядом с диалогом для проверки содержимого, действий и данных. |
| Ревью и передача | Просмотр добавленных, изменённых и удалённых документов; правка, слияние или отмена. |
| Локальный или серверный Workspace | Подключение к сервису команды или к сервису на своём компьютере. |
| Управление и совместная работа в Space | Организация созданных в диалоге файлов, управление доступом и редактирование общего содержимого с командой. |
### Workspace и агент на практике
Все следующие снимки и последовательность действий получены в установленном приложении macOS, подключённом к новому локальному Workspace. Учётная запись, Space, имена файлов, содержимое и диалог агента используют вымышленные данные на английском языке.
#### Создание и просмотр в обычном диалоге
**Build Five-File Launch Demo** — обычный диалог агента, в котором созданы таблица, документ, презентация, Relational Table и холст. На снимке настоящая передача результатов показана рядом с редактируемым **02 Launch Brief** в браузерной панели Desktop. Продолжайте запрашивать правки в диалоге, а управлять файлами и делиться ими можно в Space.
Агент также создаёт интерактивные отчёты, рабочие страницы и панели в обычном диалоге. В следующей сессии он создал **06 Launch Dashboard** на основе опубликованного бюджета: три карточки показывают бюджет, расходы и отклонение, а диаграмма следует за шестью направлениями через живые привязки HTML View. Этот пример только читает ту же нативную таблицу, без записи данных. [Двусторонняя привязка](https://docs.univer.ai/ru-RU/overview/features/shared/binding.md) экспериментальна и может меняться.
#### Управление, общий доступ и совместная работа в 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](https://github.com/dream-num/univer-workspace/releases): теги agent-v, Windows x64, macOS Apple Silicon или Linux x64. Поставка экспериментальная; ориентируйтесь на опубликованные версии.
2. В **Settings → Workspace** задайте сервис, войдите через браузер и разрешите доступ. Используйте готовый сервис или [локальную установку](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/README.md#connect-to-a-local-workspace).
3. В Models настройте поддерживаемого провайдера, модель и ключи. Это отдельно от входа Workspace: см. [настройку моделей](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/README.md#model-credentials).
4. Добавьте доступный Personal или Team Space, начните диалог и укажите материалы через @. Выполните задачу ниже и откройте просмотр и ревью.
Установщик содержит агентное приложение и Office-инструменты. Workspace запускается отдельно локально или на сервере; доступ к модели настраивается отдельно.
### Первая задача: ревью бюджета в двух документах
```text
Создай в текущем Space английскую таблицу Budget Review с восемью примерами отделов: Department, Budget, Actual, Variance. Разницу и итоги вычисли формулами, добавь диаграмму бюджета и фактических расходов.
Создай короткий документ с выводами о перерасходе и ссылкой на таблицу. Сохрани Office-изменения в одном Worktree, проверь данные, формулы и результат, открой просмотр и ревью и дождись моего одобрения перед слиянием.
```
Затем попросите «Уменьши бюджет Marketing на 10% и обнови выводы» и проверьте значения и различия перед принятием.
#### Реальный сеанс: от модели к записке для решения
Сессия Aurora в Desktop объединяет чтение исходных файлов, правку нативного документа и последующий запрос на проверку. Агент сохраняет существующий черновик в состоянии Ready до решения человека. См. [реальный диалог в Desktop](#conversation-preview) и [нативное сравнение Worktree](#workspace-review).
## Создайте свой Workspace на основе репозитория
Показанное приложение собрано на Office SDK. Возьмите [репозиторий Workspace](https://github.com/dream-num/univer-workspace), используйте движок содержимого и совместной работы и адаптируйте процессы, Skills, инструменты и интерфейс под свою команду.
### Найдите нужную часть проекта
| Расположение | Назначение |
| --- | --- |
| [`apps/workspace`](https://github.com/dream-num/univer-workspace/tree/main/apps/workspace) | Server, Web, API продукта и настройка развёртывания. |
| [`apps/cli`](https://github.com/dream-num/univer-workspace/tree/main/apps/cli) | Подключение существующих агентов к работающему Workspace. |
| [`apps/agent`](https://github.com/dream-num/univer-workspace/tree/main/apps/agent) | Хост агента, жизненный цикл подключения и оболочка Desktop. |
| [`skills/univer-workspace-cli`](https://github.com/dream-num/univer-workspace/tree/main/skills/univer-workspace-cli) | Вводная Skill для установки в существующего агента. |
| [`packages/client-core`](https://github.com/dream-num/univer-workspace/tree/main/packages/client-core) | Общие операции Workspace для Node-хостов. |
| [`packages/dsh-univer-workspace-plugin`](https://github.com/dream-num/univer-workspace/tree/main/packages/dsh-univer-workspace-plugin) | Инструменты Office, нативный предпросмотр и инструкции задач. |
| [`packages/dsh-univer-workspace-skin-plugin`](https://github.com/dream-num/univer-workspace/tree/main/packages/dsh-univer-workspace-skin-plugin) | Оформление Workspace и визуальные токены. |
| [`packages/workspace-html-viewer`](https://github.com/dream-num/univer-workspace/tree/main/packages/workspace-html-viewer) | Песочница HTML View и хост привязки данных для Web Apps. |
### Skills: от понимания пространства до выполнения задачи
#### Skills для вашего агента
Установленный в агенте [Skill `univer-workspace-cli`](https://github.com/dream-num/univer-workspace/blob/main/skills/univer-workspace-cli/SKILL.md) служит точкой обнаружения: подключение, поиск цели и загрузка инструкций. Полные Skills поставляются с CLI и соответствуют её командам и Facade API. Встроенный плагин Desktop также предоставляет инструкции и инструменты для задач.
| Инструкция | Охват |
| --- | --- |
| `core` | Поиск пространств и файлов, черновики задач, проверка и передача на ревью. |
| `sheet` · `doc` · `slide` · `base` · `board` | Таблицы, документы, презентации, Relational Table и Canvases. |
| `blob` | Загрузка, скачивание и замена исходных файлов. |
| `html-view` | Создание и управление живыми HTML-страницами для интерактивных Web Apps. |
| `embed` · `cross-unit-formula` | Встраивание содержимого и ссылки на данные и формулы между объектами. |
```bash
uvw skills list
uvw skills get core
uvw skills get sheet
uvw skills get html-view
```
Сначала загрузите `core`, затем нужный продукт или тему. `skills get` перечисляет пути, `uvw skills read ` читает выбранный документ, `--full` включает их вместе. Существующие агенты используют CLI, а Desktop встраивает инструменты и инструкции в диалог.
#### Инструкции внутри Desktop
Плагин включает Skill **univer** и справочники: поиск Spaces и документов, Office API, создание, проверка и передача Worktree. Агент может найти API, выполнить его над нативным содержимым и проверить результат.
[Плагин возможностей](https://github.com/dream-num/univer-workspace/blob/main/packages/dsh-univer-workspace-plugin/README.md) объединяет поиск файлов, редактирование через Headless Facade, структурную проверку, импорт/экспорт и управление Worktree. Эта предварительная версия готовит черновики к проверке; публикация использует процесс проверки и слияния развёрнутого приложения. На том же Office runtime можно добавлять отраслевые Skills, шаблоны и бизнес-инструменты.
Предварительный плагин включает девять Skills. Общая инструкция описывает поиск, идентификацию и передачу результата; инструкции продуктов содержат API и способы проверки. Агент читает материалы для текущей задачи.
| Skill | Инструкции |
| --- | --- |
| `univer` | Spaces, файлы, жизненный цикл черновика и передача |
| `univer-sheet` | Формулы, стили, диаграммы и проверка таблиц |
| `univer-doc` | Структура документа, абзацы и таблицы |
| `univer-slide` | Создание слайдов и визуальная проверка |
| `univer-base` | Поля, записи и представления |
| `univer-board` | Фигуры, соединители и компоновка холста |
| `univer-embed` | Встраивание одного продукта Office в другой |
| `univer-cross-unit-formula` | Ссылки и вычисления между Units |
| `univer-html-view` | Создание и проверка HTML-страниц, связанных с данными Office |
### Разделить цикл агента и возможности Office
Skills направляют агента, инструменты изменяют структурированный контент через Headless, а нативные редакторы отображают его людям. Workspace предоставляет файлы и контекст совместной работы. Можно сменить модель, добавить бизнес-инструменты или оформление, не создавая движок Office заново.
```mermaid
flowchart LR
A["Агент и модель"]
B["Skills и инструменты"]
C["Office SDK
Headless-операции и проверка"]
D["Сервис Workspace
Файлы, совместная работа и версии"]
E["Просмотр на компьютере
Редакторы и Web Apps"]
F["Worktree и Compare
Проверка человеком"]
A --> B --> C --> D
D <--> E
D --> F
F --> E
```
| Компонент | Ответственность |
| --- | --- |
| [Web SDK](https://docs.univer.ai/ru-RU/guides/sheets.md) | Общие модели, Office-редакторы, рендеринг, формулы и headless Facade. |
| [Server SDK](https://docs.univer.ai/ru-RU/server.md) | Совместная работа, версии и Worktree, подключённые к backend приложения. |
| [AI SDK](https://docs.univer.ai/ru-RU/ai.md) | Операции с содержимым, инспекция и проверка для агентов. |
| Runtime и Skills | DSH предоставляет сессии, модели, оркестрацию и согласование; плагин подключает Office. |
| Workspace и Desktop | Приложение предоставляет Spaces, файлы, идентификацию и ревью; Electron — десктопную поставку. |
Повторно используемый путь: запрос → инструменты → редактируемое содержимое → просмотр → ревью → общий результат. Office SDK даёт Office-слой, хост — диалог и цикл выполнения. Расширяйте [приложение и плагины](https://github.com/dream-num/univer-workspace/tree/main/apps/agent) или подключайте свой хост.
### Адаптируйте процесс к своим задачам
| Цель | С чего начать |
| --- | --- |
| Отраслевые документы и задачи | Добавьте Skills, шаблоны и инструкции, сохраняя проверку содержимого и визуального результата. |
| Свои пользователи, хранение и доступ | Расширьте приложение Workspace и его серверные политики. |
| Свой Office-клиент с агентом | Объедините хост, плагин возможностей и оформление, подключите модели и рабочие инструменты. |
### Изучить реализацию
[Сборка и поставка Desktop](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/desktop/README.md) · [Агентное приложение и настройка](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/README.md) · [Все примеры](https://docs.univer.ai/ru-RU/overview/examples.md)
[Office Lab](https://docs.univer.ai/ru-RU/overview/examples/office-lab.md)