Headless и серверные вычисления
Операции с содержимым в Node.js и предварительные расчёты в Rust для приложений и агентов.
Headless Univer - это время выполнения контента Univer без интерактивного интерфейса редактора. Он делится моделями контента, командами, вычислениями и API-интерфейсами Facade с редактором браузера. Приложение может запускать его в Node.js для обработки контента там или в браузере для задач, которые не нуждаются в пользовательском интерфейсе. Его возможности зависят от зарегистрированного продукта и плагинов функций.
Среда выполнения JavaScript/TypeScript, описанная на этой странице, и univer-rs являются отдельными реализациями. univer-rs поддерживает вычисление на стороне сервера и преобразование файлов, и он участвует в рабочих процессах без головы по тем же снимкам.
Что позволяет Headless
- Чтение и изменение контента и структуры. Создание или загрузка снимка Univer, использование API-интерфейсов Facade для чтения и редактирования ячеек, абзацев, страниц, графических объектов или записей, а затем сохранение обновленного снимка. Эти операции поддерживают пакетную обработку, генерацию данных, проверку контента и автоматизацию агентов.
- Запуск зарегистрированной бизнес-логики. Доступны формулы расчета, сортировки, фильтрации, валидации и разворотных плагинов, а приложения могут изменять ресурсы, такие как изображения, диаграммы, формы и комментарии. Доступные операции зависят от зарегистрированных плагинов продукта и функции и их зависимостей.
- Подключитесь к другим сервисам. Добавьте клиент совместной работы Node.js для загрузки совместных блоков, отправки изменений и ожидания синхронизации. Объедините модули преобразования Server SDK со временем выполнения для импорта и экспорта файлов Office.
Headless не предоставляет редакторский интерфейс: нет меню, панели инструментов, диалогов, взаимодействия мыши или клавиатуры, скриншотов или печати. Постоянство, аутентификация, сервер совместной работы и конвертация файлов также не включены. save() возвращает снимок Univer; он не пишет в базу данных или экспортирует XLSX, DOCX или PDF. Скриншота и визуальные проверки макета требуют отдельного рендеринг Runtime, потому что безголовый браузер по-прежнему запускает слой рендеринга.
Какие пакеты относятся к Headless
Выберите пакеты контента, которые нужны приложению, затем зарегистрируйте необходимые плагины и зависимости продукта. Функции Pro также требуют настройки их лицензий.
Модели содержимого
Эти пакеты предоставляют экземпляры, модели контента, команды и основные операции с контентом.
@univerjs/core@univerjs/sheets@univerjs/docs
Формулы и числовые форматы
Эти пакеты обеспечивают выполнение формул, интеграцию формул листа и форматирование чисел.Выберите двигатель с открытым исходным кодом или двигатель Pro в соответствии с требуемыми функциями.
@univerjs/engine-formula@univerjs/sheets-formula@univerjs/sheets-numfmt@univerjs-pro/engine-formula
Данные и правила таблиц
Специфические данные и операции с правилами выполняются без панелей или визуального взаимодействия, которые обычно сопровождают их. Проверка данных также требует @univerjs/data-validation.
@univerjs/sheets-filter@univerjs/sheets-sort@univerjs/sheets-conditional-formatting@univerjs/sheets-data-validation@univerjs/sheets-table@univerjs/sheets-hyper-link@univerjs/sheets-note
Изображения, ссылки и комментарии
Эти пакеты добавляют модели, ресурсы и команды для изображений, ссылок и комментариев.Показ, загрузки и внешние источники данных подключаются отдельно по мере необходимости.
@univerjs/drawing@univerjs/sheets-drawing@univerjs/docs-drawing@univerjs/docs-hyper-link@univerjs/thread-comment@univerjs/sheets-thread-comment@univerjs/docs-thread-comment
Расширенные функции таблиц
Стержни, диаграммы, формы, искровые линии, очертания и нарезки обеспечивают собственную логику контента и вычислений. Графические зависимости могут включать @univerjs-pro/engine-chart и @univerjs-pro/engine-shape.
@univerjs-pro/sheets-pivot@univerjs-pro/sheets-chart@univerjs-pro/sheets-shape@univerjs-pro/sheets-sparkline@univerjs-pro/sheets-outline@univerjs-pro/sheets-slicer
Расширения документов
Блоки документов, таблицы, столбцы, формулы и формы поддерживают операции с контентом, но не контролируют редакторы.
@univerjs-pro/docs-callout@univerjs-pro/docs-code@univerjs-pro/docs-list@univerjs-pro/docs-quote@univerjs-pro/docs-table@univerjs-pro/docs-column@univerjs-pro/docs-latex@univerjs-pro/docs-formula@univerjs-pro/docs-shape
Модели других продуктов
Эти пакеты предоставляют модели и команды для других продуктов. pdfs-editor настраивает жизненный цикл редактора PDF и интеграцию совместной работы; слово редактор в названии пакета не подразумевает пользовательский интерфейс. Доступные API варьируются в зависимости от продукта.
@univerjs-pro/slides@univerjs-pro/bases@univerjs-pro/boards@univerjs-pro/pdfs@univerjs-pro/pdfs-editor
Сеть, вычислительные процессы и совместная работа
Добавьте инфраструктуру только тогда, когда это необходимо. @univerjs/network и @univerjs/rpc-node обеспечивают сетевые и Node.js вычислительные процессы, а @univerjs-pro/license обрабатывает интеграцию лицензий. @univerjs-pro/collaboration, @univerjs-pro/collaboration-client а также @univerjs-pro/collaboration-client-node вместе образуют клиент совместной работы без головы, а не сервер совместной работы. Работа с локальными снимками не требует службы совместной работы .
Пакеты вне среды обработки только содержимого
@univerjs/ui,@univerjs/designи пакеты*-uiдля продукта или функции, такие как@univerjs/sheets-ui,@univerjs/docs-uiа также@univerjs-pro/slides-uiобеспечивают пользовательский интерфейс, интеграцию рендеринга или взаимодействие. Не добавляйте их в конфигурацию Node.js которые обрабатывают только контент.@univerjs/sheets-find-replaceи@univerjs/sheets-crosshair-highlightне имеют суффикса-ui, но все еще зависят от@univerjs/sheets-ui.- Предустановки
@univerjs/preset-sheets-coreи@univerjs/preset-docs-coreпо умолчанию регистрируют плагины пользовательского интерфейса и не являются предустановками Node.js без головы. В этом случае используйте режим плагина для явного выбора зависимостей уровня контента.
@univerjs/engine-render требует отдельного рассмотрения. Текущие примеры Node.js регистрируют его для обеспечения общих зависимостей, таких как управление рендерингом. Регистрация плагина не создает холст или не монтирует редактор. Он может отображаться в композиции без головы, но чертеж, измерение шрифта и API скриншотов по-прежнему нуждаются в подходящей среде рендеринга. Поэтому не каждый API в пакете можно использовать в чистом Node.js.
Facade - это операционный API, а не адаптер среды. Для каждого используемого плагина контента импортируйте его расширение /facade и регистрируйте плагины, которые реализуют необходимые возможности. Расширения пользовательского интерфейса, такие как @univerjs/ui/facade или @univerjs/sheets-ui/facade, по-прежнему требуют пользовательского интерфейс, а также меню, прокрутка и взаимодействия визуального выбора, которые они предоставляют. Изучите зависимости плагина и фактический путь вызова, а не полагайтесь на имя пакета или наличие API Facade.
Композиции плагинов с возможностью запуска появляются в Оригинальное название: Headless Guide и Оригинальное название: Headless Guide.
Быстрый расчёт в браузере и серверный расчёт по ревизиям
Движения формулы работают как на интерфейсе, так и на сервере. Фронтенд реагирует при редактировании пользователем, и сервер вычисляет захваченный пересмотр контента, когда он генерирует снимок или обрабатывает файл.
- При редактировании браузер вычисляет затронутые формулы локально, необязательно в Рабочем, и отображает результаты сразу.Служба совместной работы записывает эти изменения контента и синхронизирует их.
- Когда генерируется снимок, политика моментального снимка сервера запускает рабочий процесс сохранения. Сервер фиксирует пересмотр содержимого для этой операции, вычисляет его с помощью
univer-rsи сохраняет содержимое и результаты этого пересмотра вместе. - При повторном открытии документа фронтенд повторно использует действительные результаты в снимке, применяет последующие изменения и продолжает вычисления, что позволяет избежать полного перерасчета.
Вычисление сервера выполняется как часть генерации моментальных снимков, и результаты сохраняются для этого пересмотра контента.
При первой нагрузке приложение настраивает, как первоначальный расчет использует сохраненные результаты:
WHEN_EMPTY: использовать сохранённые значения формул и вычислять только отсутствующие результаты.NO_CALCULATION: пропустить начальный расчёт; результаты предоставляет приложение.FORCED: пересчитать все формулы для обновления сохранённых результатов.
Эти опции регулируют только начальную загрузку. После загрузки редактирование продолжает вычисляться в интерфейсе, а сервер вычисляет по требованию, когда он генерирует версионный снимок или обрабатывает файлы. См. формула конфигурации, сотрудничество и преобразование файлов.
Производительность движка формул
Univer Rust формула двигателя бенчмарки охватывает 10 рабочих книг и включает в себя загрузку ввода Rust, сроки этапов, границы формата ввода и загрузку книги.
Формулы массивов и развёрнутые результаты
В рамках поддерживаемых функций и форматов Rust следует формуле массива и семантике разливов Excel. Он возвращает вычисленные значения вместе с якорем и диапазоном разливов, и он обрабатывает как динамические массивы, так и заявленные диапазоны формул унаследованных массивов.
Например, =SEQUENCE(3,2) в пустой A1 даёт:
| A | B |
|---|---|
| 1 | 2 |
| 3 | 4 |
| 5 | 6 |
Формула остается в A1, и результаты занимают A1:B3. Когда массив сокращается, предыдущие значения разлива очищаются. Когда разлив блокируется, результатом является #SPILL! . Браузер, агент и экспортный конвейер могут повторно использовать вычисленный снимок.
Соответствующие функции и правила диапазона находятся в Формула поддержки и Excel массивное поведение.
Исполнение и проверка для агента
Держите существующую модель, разговор и инструментальную оркестровку. Инструменты AI SDK предоставляют этим агентам операции с контентом Office:
- Осмотрите структуру и прочитайте целевой контент.
- Примените изменения Фасада и запустите необходимые вычисления в безголовом режиме выполнения.
- Дождитесь, пока расчет и обязательство подтвердятся, затем прочитайте обновленное состояние обратно.
- Проверьте значения и структуру и добавьте скриншоты или проверки макета, когда требуется визуальная проверка.
Используйте контент-операции и визуальный осмотр вместе. Когда человеку нужно просмотреть работу, поместите сначала правки в Worktree, затем сравните и слите их. Univer CLI демонстрирует, как собрать эти возможности в приложение, которое может управлять агент.
Способы интеграции
| Возможность | Назначение |
|---|---|
| Среда содержимого Node.js | Начните с headless Univer и включите необходимые плагины для продуктов и вычислений. |
| Фоновая обработка файлов | Сочетайте Rust с преобразованием Node.js, сохраняйте или возвращайте снимок. |
| Совместная работа и агенты | Подключите сотрудничество и AI SDK, чтобы люди и агенты работали над подтвержденным контентом. |
Насколько полезно это руководство?