Headless y cálculo en el servidor

Ejecuta contenido en Node.js y precálculos en Rust para ofrecer resultados estructurados y visuales a los agentes.

Headless Univer es el tiempo de ejecución de contenidos Univer sin el editor interactivo UI. Comparte modelos de contenido, comandos, cálculos y APIs Facade con el editor del navegador. Una aplicación puede ejecutarlo en Node.js para procesar contenido allí, o en un navegador para tareas que no necesitan una interfaz de usuario. Sus capacidades dependen del producto registrado y de los plugins de características.

El tiempo de ejecución JavaScript/TypeScript descrito en esta página y univer-rs son implementaciones separadas. univer-rs es compatible con el cálculo del lado del servidor y la conversión de archivos, y participa en flujos de trabajo sin cabeza sobre las mismas instantáneas.

Qué permite Headless

  • Leer y modificar contenido y estructura. Crear o cargar una instantánea Univer, utilice APIs Facade para leer y editar celdas, párrafos, páginas, objetos gráficos o registros, y luego guardar la instantánea actualizada. Estas operaciones soportan el procesamiento por lotes, la generación de datos, la inspección de contenidos y la automatización de agentes.
  • Ejecute la lógica comercial registrada. Los plugins de cálculo, clasificación, filtración, validación y pivote están disponibles, y las aplicaciones pueden modificar recursos como imágenes, gráficos, formas y comentarios. Las operaciones disponibles dependen del producto registrado y de los plugins de características y sus dependencias.
  • Conectarse a otros servicios. Agregue el cliente de colaboración Node.js para cargar Unidades colaborativas, enviar cambios y esperar a sincronización. Combine módulos de conversión Server SDK con el tiempo de ejecución para importar y exportar archivos de Office.

Headless no proporciona al editor UI: no se incluyen menus, barras de herramientas, diálogos, interacción con el ratón o el teclado, capturas de pantalla o impresión. Persistencia, autenticación, un servidor de colaboración y conversión de archivos tampoco están incluidos. save() devuelve una instantánea Univer; no escribe a una base de datos o exporta XLSX, DOCX, o PDF. Imágenes y controles de diseño visual requieren una capa de renderización separada Tiempo de ejecución,

Qué paquetes pertenecen a Headless

Seleccione los paquetes de contenido que la aplicación necesita, luego registre los plugins y dependencias de producto requeridos. Las características de Pro también requieren que sus licencias sean configuradas.

Modelos de contenido

Estos paquetes proporcionan casos, modelos de contenido, comandos y operaciones de contenido básicos.

  • @univerjs/core
  • @univerjs/sheets
  • @univerjs/docs

Fórmulas y formatos numéricos

Estos paquetes proporcionan ejecución de fórmulas, integración de fórmulas de hoja y formato de número. Seleccione el código abierto o el motor Pro de acuerdo con las características requeridas.

  • @univerjs/engine-formula
  • @univerjs/sheets-formula
  • @univerjs/sheets-numfmt
  • @univerjs-pro/engine-formula

Datos y reglas de las hojas

Los datos de hoja y las operaciones de reglas funcionan sin los paneles o la interacción visual que normalmente los acompañan. La validación de datos también requiere @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

Imágenes, enlaces y comentarios

Estos paquetes añaden modelos, recursos y comandos para imágenes, enlaces y comentarios. Visualización, cargas y fuentes de datos externas se conectan por separado según sea necesario.

  • @univerjs/drawing
  • @univerjs/sheets-drawing
  • @univerjs/docs-drawing
  • @univerjs/docs-hyper-link
  • @univerjs/thread-comment
  • @univerjs/sheets-thread-comment
  • @univerjs/docs-thread-comment

Funciones avanzadas de hojas

Pivots, diagramas, formas, chispas, contornos y rebanados proporcionan su propio contenido y lógica de cálculo. Las dependencias gráficas pueden incluir @univerjs-pro/engine-chart y @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

Extensiones de documentos

Los bloques de documentos, tablas, columnas, fórmulas y formas soportan las operaciones de contenido pero no los controles de editor.

  • @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

Modelos de otros productos

Estos paquetes proporcionan modelos y comandos para los otros productos. pdfs-editor configura el editor de PDF ciclo de vida y la integración de la colaboración; el editor de palabras en un nombre de paquete no implica una interfaz de usuario.

  • @univerjs-pro/slides
  • @univerjs-pro/bases
  • @univerjs-pro/boards
  • @univerjs-pro/pdfs
  • @univerjs-pro/pdfs-editor

Red, procesos de cálculo y colaboración

Agrega la infraestructura sólo cuando sea necesario. @univerjs/network y @univerjs/rpc-node proporcionan redes y Node.js procesos de cálculo, y @univerjs-pro/license maneja la integración de licencias. @univerjs-pro/collaboration, @univerjs-pro/collaboration-client, y @univerjs-pro/collaboration-client-node juntos forman un cliente de colaboración sin cabeza, no un servidor de colaboración. Trabajar con instantáneas locales no requiere un servicio de colaboración.

Paquetes fuera del runtime de contenido puro

  • @univerjs/ui, @univerjs/design, y los *-ui paquetes para un producto o característica, como @univerjs/sheets-ui, @univerjs/docs-ui, y @univerjs-pro/slides-ui, proporcionan IU, renderizando la integración o la interacción. No añadirlos a una configuración de Node.js que sólo procesa el contenido.
  • @univerjs/sheets-find-replace y @univerjs/sheets-crosshair-highlight no tienen sufijo -ui pero todavía dependen de @univerjs/sheets-ui, por lo que un nombre de paquete por sí solo no implica que son plugins sin cabeza.
  • Los presets predeterminados @univerjs/preset-sheets-core y @univerjs/preset-docs-core registran plugins de interfaz de usuario y no son presets sin cabeza Node.js. En ese caso, utilice el modo plugin para seleccionar dependencias de capa de contenido explícitamente.

@univerjs/engine-render requiere una consideración separada. Los ejemplos actuales de Node.js lo registran para suministrar dependencias compartidas como la gestión de renderizado. Registrar el plugin no crea un Canvas o montar un editor. Puede aparecer en una composición sin cabeza, pero la medición de fuentes y API de captura de pantalla todavía necesitan un entorno de renderización adecuado. Por lo tanto, no cada API en el paquete es utilizable en Node.js puro.

Facade es una API de operación, no un adaptador de entorno. Para cada plugin de contenido en uso, importa su extensión /facade, y registra los plugins que implementan las capacidades requeridas. Extensiones UI como @univerjs/ui/facade y @univerjs/sheets-ui/facade todavía requieren UI, y así hacen los menús, desplazamiento, y las interacciones de selección visual que proporcionan. Examinar las dependencias del plugin y la ruta de llamada real en lugar de confiar en un nombre de paquete API.

Las composiciones de plugin ejecutables aparecen en el Hojas Guía sin cabeza y el Docs Guía sin cabeza.

Cálculo inmediato en el navegador y por revisión en el servidor

Los motores de Fórmula funcionan tanto en el frontend como en el servidor. El frontend responde a medida que el usuario edita, y el servidor calcula una revisión de contenido capturada cuando genera una instantánea o procesa un archivo.

  • Durante la edición, el navegador calcula las fórmulas afectadas localmente, opcionalmente en un Trabajador, y muestra los resultados inmediatamente. El servicio de colaboración registra estos cambios de contenido y los sincroniza.
  • Cuando se genera una instantánea, la política de instantáneas del servidor inicia el flujo de trabajo de ahorro. El servidor captura la revisión de contenido para esa operación, la calcula con univer-rs, y guarda el contenido y los resultados de esa revisión juntos.
  • Cuando se reabierte el documento, el frontend reutiliza los resultados válidos en la instantánea, aplica los cambios posteriores, y continúa calculando, lo que evita una recalculación completa.
100%

Los cambios de contenido se sincronizan continuamente. El cálculo del servidor funciona como parte de la generación de instantáneas, y los resultados se guardan para esa revisión de contenido.

En primera carga, la aplicación configura cómo el cálculo inicial utiliza los resultados guardados:

  • WHEN_EMPTY: reutilizar los valores guardados y calcular solo los resultados que faltan.
  • NO_CALCULATION: omitir el cálculo inicial; la aplicación proporciona los resultados.
  • FORCED: recalcular todas las fórmulas para actualizar los resultados.

Estas opciones sólo rigen la carga inicial. Después de la carga, la edición continúa calculando en el frontend, y el servidor calcula a la demanda cuando genera una instantánea o archivos de procesos versionados. Ver configuración de fórmula, colaboración y conversión de archivo.

Rendimiento del motor de fórmulas

El Univer Puntos de referencia del motor de la fórmula de Rust cubre 10 libros de trabajo e incluye carga de entradas de óxido, tiempos de escenario, límites de formato de entrada y descargas del libro de trabajo.

Fórmulas matriciales y resultados desbordados

Dentro de las funciones y formatos soportados, Rust sigue la forma de matriz y semántica de derrame de Excel. Devuelve los valores calculados junto con el rango de anclaje y derrame, y maneja tanto los arrays dinámicos como los rangos declarados de fórmulas de matriz heredadas.

Por ejemplo, =SEQUENCE(3,2) en una celda A1 vacía produce:

AB
12
34
56

La fórmula permanece en A1, y los resultados ocupan A1:B3. Cuando el array se contrae, los valores de derrame anteriores se despejan. Cuando se bloquea un derrame, el resultado es #SPILL! . El navegador, un agente, y el oleoducto de exportación pueden reutilizar la instantánea calculada.

Las reglas de función y rango correspondientes están en apoyo a las fórmulas y Excel comportamiento de la matriz.

Conectar ejecución y verificación con un agente

Mantenga el modelo existente, la conversación y la orquestación de herramientas. Herramientas AI SDK exponen operaciones de contenido de Office a ese agente:

  1. Inspeccione la estructura y lea el contenido objetivo.
  2. Aplicar los cambios Facade y ejecutar los cálculos necesarios en el tiempo de ejecución sin cabeza.
  3. Esperar el cálculo y el compromiso para ser confirmado, luego leer el estado actualizado de nuevo.
  4. Revise los valores y la estructura, y agregue capturas de pantalla o cheques de diseño cuando se requiere verificación visual.

Utilice operaciones de y inspección visual juntos. Cuando una persona necesita revisar el trabajo, coloque las ediciones en un Worktree primero, compare y fusione. Univer CLI demuestra cómo montar estas capacidades en una aplicación que un agente puede conducir.

Rutas de integración

CapacidadQué permite
Entorno de contenido Node.jsComience con headless Univer y active los plugins de producto y cálculo requeridos.
Procesamiento de archivosCombina Rust y la conversión Node.js y guarda o devuelve el snapshot.
Edición compartida y agentesConecte colaboración y AI SDK para que las personas y los agentes trabajen en contenido confirmado.

Todas las funciones

¿Cómo es esta guía?

© 2026 DreamNum Co., Ltd.