Обзор Office SDK
Узнайте о трех частях Office SDK: Web SDK, Server SDK и AI SDK, а также о том, как они работают вместе в приложении Office.
Univer Office SDK состоит из трех частей: Web SDK, Server SDK и AI SDK. Он охватывает электронные таблицы, документы, слайды, реляционную таблицу, холсты и PDF-файлы.
Web SDK - это механизм совместного контента. Он запускает редакторы браузера, а также работает без головы для обработки контента без пользовательского интерфейса. Два других SDK основаны на этом безголовом режиме выполнения: Server SDK добавляет совместную работу и обработку файлов, а AI SDK добавляет операции с контентом и проверку результатов для агентов.
Изучите возможности
каталог функций перечисляет, что поддерживает каждый продукт, сгруппированный по продукту и категории. Он также записывает уровень поддержки, является ли функция с открытым исходным кодом и объем интеграции. Графики, преобразование файлов, сотрудничество, Worktree и встраивание распределены по продуктам.
Начинай. предоставляет один шаблон требований и три исполняемых примера, а затем объясняет, как подключать, создавать и развертывать приложение.
Архитектура и роли SDK
Web SDK: механизм общего контента
Используйте Web SDK для отображения, редактирования или обработки содержимого Office в приложении. API-интерфейсы Facade - это интерфейс к контенту, данным и пользовательскому интерфейсу, независимо от того, работает ли код в редакторе браузера или в безголовом процессе Node.js.
Web SDK построен полностью из плагинов, включая возможности продукта, пользовательский интерфейс редактора и отдельные функции, такие как поиск и замена.Приложение может начинаться с предустановленного или выбирать нужные ему плагины продукта и функции и собирать их с помощью своих зависимостей.
Бизнес-специфические функции могут быть реализованы в пользовательских плагинах без изменения основного кода Univer. Один и тот же движок контента адаптируется к каждой среде через свой набор плагинов: приложение браузера загружает пользовательский интерфейс редактора, в то время как приложение без головы опускает эти плагины пользовательского интерфейса. См. Архитектура Univer: дизайн плагинов .
Общий рендеринг Canvas. Весь контент Office визуализируется через одну и ту же архитектуру Canvas, поэтому типы контента могут повторно использовать макет и код чертежа и могут содержать вложенный контент. Текст сотовой таблицы, например, следует за макетом документа и траекторией рендеринга, что поддерживает согласованность представления. См. Архитектура Rendering Engine.
Гибридные вычисления. Двигатель формулы вычисляет в интерфейсе и на серверной стороне движка Rust. Расчет Frontend сохраняет редактирование отзывчивым, в то время как движок Rust обрабатывает большие рабочие нагрузки формул. См. Формула возможностей и вычисление на стороне сервера.
Начнем с таблицы.Тот же SDK охватывает также документы, слайды, реляционные таблицы, доски и PDF.
Server SDK: соедините совместную работу и файлы
Server SDK добавляет совместное редактирование, преобразование файлов и расширения бэкэнда. Он опирается на возможности безголового контента Web SDK: модули запускаются внутри вашего бэкенда и используют собственную личность приложения, разрешения и хранилище.
Сотрудничество в реальном времени. OT (Operational Transformation) обрабатывает одновременные операции, такие как изменения строк или столбцов и редактирование контента. Сначала редактируется локально, а затем реплики сходятся, сохраняя при этом намерение каждого пользователя, где это возможно. История, комментарии и Worktree являются отдельными модулями, которые приложение добавляет при необходимости. См. Совместное редактирование дизайна и Быстрый старт сотрудничества.
Преобразование файлов. Conversion перемещает контент между файлами Office и данными документов Univer и соединяет этапы импорта, редактирования и экспорта. Он работает с сотрудничеством или без него. См. Офисные файлы импорт и экспорт для API преобразования и Обмен файлами интеграция - для загрузок, задач и загрузок.
Развертывание и масштабирование. Модули собраны внутри вашего собственного приложения Node.js, и для запуска достаточно одной машины. По мере роста нагрузки приложение может перемещать преобразование файлов в отдельную службу, а затем масштабировать на несколько узлов совместной работы. См. Архитектура приложений и Руководство по развертыванию.
Обзор Server SDK описывает модули более подробно.
AI SDK: предоставить агентам точку входа.
AI SDK добавляет возможности Office к существующим агентам, автоматизации и прикладным CLI. Он основан на безголовом времени выполнения и API-интерфейсах Facade Web SDK для операций с контентом, расчета и проверки.
Инструменты Подключите существующий стек агентов. Office могут быть представлены как API TypeScript или как CLI, собранные из SDK. Выбор модели, оркестровка задач и навыки остаются в приложении. Агенты получают результаты выполнения и обратную связь проверки, а затем продолжают свой рабочий процесс.
Создайте контент, который остается редактируемым. Агент считывает структуру документа, находит нужный ему диапазон или абзац и использует API Facade для создания и изменения электронных таблиц, документов, слайдов и другого контента, включая вычисление формул. Результат сохраняет свою структуру контента и остается редактируемым, чтобы люди могли продолжать его дорабатывать. См. контент-операции.
Проверь, потом пересмотри. Агент считывает обратные значения и результаты формулы и проверяет скриншот фактической страницы. Для слайдов проверки макета также идентифицируют текст, который запускается со страницы, переполняется или перекрывается. Агент использует эту обратную связь для пересмотра контента и его повторной проверки, которая завершает чтение → редактирование и вычисление → проверка → пересмотр цикла. См. визуальный осмотр.
С Server SDK Worktree изолирует промежуточные изменения, вносимые агентом, до тех пор, пока человек не просмотрит и не сольет их в веб-приложение.Начните с Обзор AI SDK.
Рабочий процесс приложения
- Встроенный редактор: Web SDK отображает и редактирует контент внутри приложения.
- Совместное применение: Web SDK и Server SDK позволяют пользователям редактировать общие документы.
- Сотрудничество человека и агента: агенты редактируют и проверяют черновики через AI SDK, Server SDK управляет версиями и слиянием, а веб-приложение обеспечивает просмотр, сравнение и человеческий обзор.Полный рабочий процесс обзора включает все три.
Общий фонд и зависимости
Web SDK работает независимо, как редактор или как движок безголового контента. Server SDK и AI SDK зависят от возможностей безголовного интерфейса Web SDK: для работы без пользовательского интерфейса браузера все еще требуется время выполнения контента. Приложение обеспечивает необходимые услуги и модули, а полный рабочий процесс человека-агента обычно объединяет все три SDK.
Начните со своего варианта использования
| я хочу | Начните здесь |
|---|---|
| Встроить редактор электронных таблиц | Web SDK быстрый старт |
| Выбрать другой редактор Office | Документы, слайды, реляционные таблицы, доски, или PDF-файлы |
| Разрешить нескольким пользователям редактировать один и тот же документ | Быстрый старт сотрудничества |
| Импорт или экспорт файлов Office | Преобразование файлов Server SDK |
| Работайте с документами через агента или CLI | Обзор AI SDK |
| Просмотр изменений агента в общем документе | AI SDK Worktree |
Следующие шаги
Начнем с того, что Web SDK Время выполнения контента. Server SDK и AI SDK завершить первый рабочий процесс приложения, и дополнительные модули могут быть добавлены по мере необходимости. Univer Версии пакетов выровнены и подготавливают среду, авторизацию и лицензии, которые требуют выбранные модули.
Примеры собирает приложения с открытым исходным кодом, интеграции агентов, демо-версии и репозитории. Вы также можете попробовать продукты Office в онлайн-шоу.
Насколько полезно это руководство?