# Обзор Office SDK

> Узнайте о трех частях Office SDK: Web SDK, Server SDK и AI SDK, а также о том, как они работают вместе в приложении Office.

- Human documentation: [https://docs.univer.ai/ru-RU/overview](https://docs.univer.ai/ru-RU/overview)

- Agent Markdown: [https://docs.univer.ai/ru-RU/overview.md](https://docs.univer.ai/ru-RU/overview.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.3.0`

- Source: [index.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/index.ru-RU.mdx)

---

Univer Office SDK включает Web SDK, Server SDK и AI SDK. Он поддерживает электронные таблицы, документы, презентации, реляционные таблицы, холсты и PDF.

Web SDK предоставляет механизм общего контента, позволяющий использовать как браузерные редакторы, так и автономную обработку контента. Server SDK и AI SDK зависят от этой автономной среды выполнения. Server SDK добавляет совместную работу и обработку файлов, а AI SDK — операции с контентом и проверку для агентов.

## Изучите возможности

Просмотрите [каталог объектов](https://docs.univer.ai/ru-RU/overview/features.md) по продукту и категории, включая уровни поддержки, доступность открытого исходного кода и область интеграции. Общие возможности включают диаграммы, преобразование файлов, совместную работу, Worktree и встраивание.

[Начало работы](https://docs.univer.ai/ru-RU/overview/get-started.md): начните с одного шаблона требований и трех работоспособных примеров, затем подключите, создайте и разверните свое приложение.

## Архитектура и роли SDK

- [Web SDK](https://docs.univer.ai/ru-RU/guides/sheets.md)
- [Server SDK](https://docs.univer.ai/ru-RU/server.md)
- [AI SDK](https://docs.univer.ai/ru-RU/ai.md)

### Web SDK: механизм общего контента

Для разработчиков, отображающих, редактирующих или обрабатывающих содержимое Office в своих приложениях. Используйте Facade APIs для работы с контентом, данными и UI в редакторах браузера или автономных приложениях Node.js.

Web SDK использует архитектуру плагинов: возможности продукта, редактор UI и отдельные функции, такие как поиск и замена, могут быть объединены с помощью плагинов. Начните с предустановки или выберите плагины продуктов и функций, необходимые вашему приложению, и соберите их с их зависимостями.

Вы также можете разрабатывать собственные плагины для конкретных бизнес-функций без изменения основного кода Univer. Различные комбинации плагинов адаптируют один и тот же механизм контента к каждой среде: приложения браузера загружают редактор UI, а безголовые приложения не включают плагины браузера UI. См. [Архитектура Univer: дизайн плагина](/blog/univer#plugins).

**Визуализация на основе общего холста.** Содержимое Office использует общую архитектуру рендеринга на основе холста, что позволяет типам контента повторно использовать возможности макета и рисования, а также поддерживать вложенный контент. Например, текст ячейки электронной таблицы повторно использует макет и рендеринг документа для единообразного представления содержимого. См. [Архитектура механизма рендеринга](/blog/rendering).

**Гибридные вычисления.** Механизм формул поддерживает гибридную модель вычислений, в которой внешние вычисления работают с серверным механизмом Rust, сочетая быстрое редактирование с производительностью для больших рабочих нагрузок с формулами. Изучите [возможности формулы](https://docs.univer.ai/ru-RU/guides/sheets/features/core/formula.md) и [расчет на стороне сервера](https://docs.univer.ai/ru-RU/overview/features/shared/server-calculation.md).

[Начните с электронных таблиц](https://docs.univer.ai/ru-RU/guides/sheets/getting-started/quickstart.md) или выберите [документы](https://docs.univer.ai/ru-RU/guides/docs.md), [слайды](https://docs.univer.ai/ru-RU/guides/slides.md), [реляционные таблицы](https://docs.univer.ai/ru-RU/guides/bases.md), [холсты](https://docs.univer.ai/ru-RU/guides/boards.md) и [PDF-файлы](https://docs.univer.ai/ru-RU/guides/pdfs.md).

### Server SDK: соедините совместную работу и файлы

Для разработчиков, добавляющих совместное редактирование, преобразование файлов и внутренние расширения. Используйте возможности автономного контента Web SDK, интегрируйте модули в свою собственную серверную часть и используйте удостоверения, разрешения и хранилище вашего приложения.

**Совместная работа в режиме реального времени.** OT (Оперативное преобразование) обрабатывает параллельные операции, такие как изменения строк/столбцов и редактирование содержимого. Изменения сначала применяются локально, а затем распространяются на реплики, сохраняя при этом намерения пользователя, где это возможно. При необходимости добавьте историю, комментарии и Worktree. См. [дизайн для совместного редактирования](/blog/ot) и [быстрый старт сотрудничества](https://docs.univer.ai/ru-RU/server/collaboration/quick-start.md).

**Преобразование файлов.** Преобразование между файлами Office и данными документа Univer для импорта, редактирования и экспорта с возможностью совместной работы или без нее. См. [Импорт и экспорт файлов Office](https://docs.univer.ai/ru-RU/server/import-export/node.md) для API-интерфейсов преобразования и [интеграция обмена файлами](https://docs.univer.ai/ru-RU/server/import-export.md) для загрузки, задач и скачиваний.

**Развертывание и масштабирование.** Соберите модули в собственное приложение Node.js. Начните на одном компьютере, раздельно конвертируйте файлы по мере роста нагрузки, а затем масштабируйтесь до нескольких узлов совместной работы. См. [архитектура приложения](https://docs.univer.ai/ru-RU/server/architecture.md) и [руководство по развертыванию](https://docs.univer.ai/ru-RU/server/deployment.md).

[Explore Server SDK](https://docs.univer.ai/ru-RU/server.md).

### AI SDK: предоставить агентам точку входа.

Для разработчиков, добавляющих возможности Office к существующим агентам, средствам автоматизации и интерфейсам командной строки для конкретных приложений. Используйте среду автономного выполнения Web SDK и Facade APIs для операций с контентом, вычислений и проверки.

**Подключите существующий стек агентов.** Предоставляйте доступ к инструментам Office через API-интерфейсы TypeScript или приложение CLI, собранное на основе SDK. Ваше приложение управляет выбором модели, оркестровкой задач и навыками. Агенты получают результаты выполнения и отзывы о проверке, а затем продолжают свои рабочие процессы.

**Создавайте контент, который можно редактировать.** Агенты читают структуру документа, находят диапазоны или абзацы, а затем используют Facade APIs для создания и изменения электронных таблиц, документов, слайдов и другого контента, включая вычисления по формулам. Результаты сохраняют структуру контента и возможности редактирования, поэтому люди могут продолжать их совершенствовать. См. [операции с контентом](https://docs.univer.ai/ru-RU/ai/content-operations.md).

**Проверьте, затем исправьте.** Прочитайте значения и результаты формул, а также просмотрите снимки экрана фактической страницы. Для слайдов проверки макета также выявляют выходящий за пределы страницы, перекрывающийся и перекрывающийся текст. Агенты используют обратную связь для пересмотра и повторной проверки, образуя цикл чтения → редактирования и расчета → проверки → проверки. См. [визуальный осмотр](https://docs.univer.ai/ru-RU/ai/visual-inspection.md).

Подключитесь к Server SDK и используйте [Worktree](https://docs.univer.ai/ru-RU/ai/worktree.md) для изоляции изменений промежуточного агента перед проверкой человеком и объединением в веб-приложении. [Explore AI SDK](https://docs.univer.ai/ru-RU/ai.md).

## Рабочий процесс приложения

```mermaid
flowchart TB
    Human["Пользователь-человек"] --> Browser
    Agent["Агент AI / Автоматизация"] --> AI["AI SDK · Эксплуатация и проверка"]
    subgraph WebSDK["Web SDK · Механизм общего контента"]
      Browser["Редакторы браузера"]
      Headless["Headless · Модель контента и Facade APIs"]
    end
    Server["Server SDK · Совместная работа, преобразование и расширение"] -->|Зависит от| Headless
    AI -->|Зависит от| Headless
    Browser <-->|Общий контент| Server
    AI -.->|Сотрудничество и обзор| Server
    Server --> Storage["Идентификация приложения, разрешения и хранилище"]
    classDef default rx:8,ry:8,stroke-width:1px
```

- **Встроенный редактор**: используйте Web SDK для отображения и редактирования содержимого вашего приложения.
- **Совместное приложение**: объединить Web SDK и Server SDK, чтобы пользователи могли вместе редактировать общие документы.
- **Сотрудничество человека и агента**: агенты редактируют и проверяют черновики через AI SDK, Server SDK управляет версиями и объединением, а веб-приложение обеспечивает просмотр, сравнение и взаимодействие с человеком. Все три вносят вклад в полный рабочий процесс проверки.

> [!NOTE: Общая основа и зависимости]
> Web SDK может работать независимо как редактор или автономный движок контента. Server SDK и AI SDK зависят от возможностей автономного управления Web SDK: для работы без браузера UI по-прежнему требуется среда выполнения контента. Включите службы и модули, необходимые вашему приложению; Полный рабочий процесс «человек-агент» обычно объединяет все три SDK.

## Начните со своего варианта использования

| я хочу | Начните здесь |
| --- | --- |
| Встроить редактор электронных таблиц | [Web SDK быстрый старт](https://docs.univer.ai/ru-RU/guides/sheets/getting-started/quickstart.md) |
| Выбрать другой редактор Office | [Документы](https://docs.univer.ai/ru-RU/guides/docs.md), [слайды](https://docs.univer.ai/ru-RU/guides/slides.md), [реляционные таблицы](https://docs.univer.ai/ru-RU/guides/bases.md), [доски](https://docs.univer.ai/ru-RU/guides/boards.md), или [PDF-файлы](https://docs.univer.ai/ru-RU/guides/pdfs.md) |
| Разрешить нескольким пользователям редактировать один и тот же документ | [Быстрый старт сотрудничества](https://docs.univer.ai/ru-RU/server/collaboration/quick-start.md) |
| Импорт или экспорт файлов Office | [Преобразование файлов Server SDK](https://docs.univer.ai/ru-RU/server/import-export.md) |
| Работайте с документами через агента или CLI | [Обзор AI SDK](https://docs.univer.ai/ru-RU/ai.md) |
| Просмотр изменений агента в общем документе | [AI SDK Worktree](https://docs.univer.ai/ru-RU/ai/worktree.md) |

## Следующие шаги

Начните со среды выполнения контента Web SDK, объедините ее с Server SDK и AI SDK, чтобы завершить рабочий процесс вашего первого приложения, а затем постепенно добавляйте модули. Обеспечьте согласованность связанных версий пакета Univer и подготовьте среду, авторизацию и лицензии, необходимые для выбранных вами модулей.

Изучите [Примеры](https://docs.univer.ai/ru-RU/overview/examples.md), чтобы узнать о приложениях с открытым исходным кодом, интеграции агентов, демонстрациях и репозиториях. Вы также можете попробовать продукты Office в [онлайн-витрина](https://office.univer.ai).