Обзор Office SDK

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

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

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

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

Начало работы: начните с одного шаблона требований и трех работоспособных примеров, затем подключите, создайте и разверните свое приложение.

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

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

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

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

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

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

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

Начните с электронных таблиц или выберите документы, слайды, реляционные таблицы, холсты и PDF-файлы.

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

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

Совместная работа в режиме реального времени. OT (Оперативное преобразование) обрабатывает параллельные операции, такие как изменения строк/столбцов и редактирование содержимого. Изменения сначала применяются локально, а затем распространяются на реплики, сохраняя при этом намерения пользователя, где это возможно. При необходимости добавьте историю, комментарии и Worktree. См. дизайн для совместного редактирования и быстрый старт сотрудничества.

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

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

Explore Server SDK.

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

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

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

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

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

Подключитесь к Server SDK и используйте Worktree для изоляции изменений промежуточного агента перед проверкой человеком и объединением в веб-приложении. Explore AI SDK.

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

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

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

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

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

Изучите Примеры, чтобы узнать о приложениях с открытым исходным кодом, интеграции агентов, демонстрациях и репозиториях. Вы также можете попробовать продукты Office в онлайн-витрина.