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 и сохраняет содержимое и результаты этого пересмотра вместе.
  • При повторном открытии документа фронтенд повторно использует действительные результаты в снимке, применяет последующие изменения и продолжает вычисления, что позволяет избежать полного перерасчета.
100%

Вычисление сервера выполняется как часть генерации моментальных снимков, и результаты сохраняются для этого пересмотра контента.

При первой нагрузке приложение настраивает, как первоначальный расчет использует сохраненные результаты:

  • WHEN_EMPTY: использовать сохранённые значения формул и вычислять только отсутствующие результаты.
  • NO_CALCULATION: пропустить начальный расчёт; результаты предоставляет приложение.
  • FORCED: пересчитать все формулы для обновления сохранённых результатов.

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

Производительность движка формул

Univer Rust формула двигателя бенчмарки охватывает 10 рабочих книг и включает в себя загрузку ввода Rust, сроки этапов, границы формата ввода и загрузку книги.

Формулы массивов и развёрнутые результаты

В рамках поддерживаемых функций и форматов Rust следует формуле массива и семантике разливов Excel. Он возвращает вычисленные значения вместе с якорем и диапазоном разливов, и он обрабатывает как динамические массивы, так и заявленные диапазоны формул унаследованных массивов.

Например, =SEQUENCE(3,2) в пустой A1 даёт:

AB
12
34
56

Формула остается в A1, и результаты занимают A1:B3. Когда массив сокращается, предыдущие значения разлива очищаются. Когда разлив блокируется, результатом является #SPILL! . Браузер, агент и экспортный конвейер могут повторно использовать вычисленный снимок.

Соответствующие функции и правила диапазона находятся в Формула поддержки и Excel массивное поведение.

Исполнение и проверка для агента

Держите существующую модель, разговор и инструментальную оркестровку. Инструменты AI SDK предоставляют этим агентам операции с контентом Office:

  1. Осмотрите структуру и прочитайте целевой контент.
  2. Примените изменения Фасада и запустите необходимые вычисления в безголовом режиме выполнения.
  3. Дождитесь, пока расчет и обязательство подтвердятся, затем прочитайте обновленное состояние обратно.
  4. Проверьте значения и структуру и добавьте скриншоты или проверки макета, когда требуется визуальная проверка.

Используйте контент-операции и визуальный осмотр вместе. Когда человеку нужно просмотреть работу, поместите сначала правки в Worktree, затем сравните и слите их. Univer CLI демонстрирует, как собрать эти возможности в приложение, которое может управлять агент.

Способы интеграции

ВозможностьНазначение
Среда содержимого Node.jsНачните с headless Univer и включите необходимые плагины для продуктов и вычислений.
Фоновая обработка файловСочетайте Rust с преобразованием Node.js, сохраняйте или возвращайте снимок.
Совместная работа и агентыПодключите сотрудничество и AI SDK, чтобы люди и агенты работали над подтвержденным контентом.

Все возможности

Насколько полезно это руководство?

© 2026 DreamNum Co., Ltd.