Descripción de Office SDK

Obtenga información sobre las tres partes de Office SDK: Web SDK, Server SDK y AI SDK, y cómo funcionan juntas en una aplicación de Office.

Univer Office SDK consta de tres partes: Web SDK, Server SDK y AI SDK. Cubre hojas de cálculo, documentos, diapositivas, Tabla de Relación, Canvasos y PDFs.

Web SDK es el motor de contenido compartido. Corre los editores del navegador y también funciona sin cabeza para procesar contenido sin interfaz de usuario. Los otros dos SDKs se basan en ese tiempo de ejecución sin cabeza: Server SDK añade colaboración y procesamiento de archivos, y AI SDK agrega operaciones de contenido e inspección de resultados para los agentes.

Explorar características

El catálogo de características enumera lo que cada producto soporta, agrupado por producto y categoría. También registra el nivel de soporte, si una característica es de código abierto, y el alcance de la integración. Los gráficos, la conversión de archivos, la colaboración, Worktree, y la incrustación son compartidos a través de productos.

Empieza. proporciona una plantilla de requisitos y tres ejemplos ejecutables, luego explica cómo conectar, construir y desplegar una aplicación.

Arquitectura y responsabilidades de los SDK

Web SDK: el motor de contenidos compartidos

Utilice Web SDK para mostrar, editar o procesar contenido de Office en una aplicación. Las API de Facade son la interfaz a contenido, datos e interfaz de usuario, ya sea que el código se ejecuta en un editor de navegadores o en un proceso Node.js sin cabeza.

Web SDK se construye completamente desde plugins, incluyendo capacidades de producto, editor UI, y características individuales como encontrar y reemplazar. Una aplicación puede comenzar desde un preset, o seleccionar el producto y los plugins de características que necesita y ensamblarlos con sus dependencias.

Las características específicas de negocio se pueden implementar en plugins personalizados sin modificar Univer's core code. El mismo motor de contenido se adapta a cada entorno a través de su conjunto de plugins: una aplicación del navegador carga al editor UI, mientras que una aplicación sin cabeza omite esos plugins UI. Ver Univer Arquitectura: diseño plugin.

Representación de lienzos compartidos. Todo el contenido de Office se hace a través de la misma arquitectura de Canvas, por lo que los tipos de contenido pueden reutilizar el código de diseño y dibujo y pueden contener contenido anidado. El texto de la celda de hoja de cálculo, por ejemplo, sigue el diseño de documentos y el camino de renderización, que mantiene la presentación consistente. Arquitectura del motor de rendering.

Computación híbrida. El motor de fórmulas calcula en el frontend y en un motor Rust lado del servidor. El cálculo Frontend sigue editando, mientras que el motor Rust maneja grandes cargas de trabajo de fórmula. Ver Capacidades de fórmula y cálculo lado del servidor.

Empieza con hojas de cálculo. El mismo SDK también cubre documentos, diapositivas, cuadros relacionales, tableros, y PDF.

Server SDK: conecta colaboración y archivos

Server SDK añade ediciones compartidas, conversión de archivos y extensiones de backend. Se basa en las capacidades de contenido sin cabeza de Web SDK: los módulos funcionan dentro de su propio backend y usan la propia identidad, permisos y almacenamiento de la aplicación.

Colaboración en tiempo real. OT (Transformación Operacional) maneja operaciones concurrentes tales como cambios de fila o columna y ediciones de contenido. Una edición se aplica localmente primero, y las réplicas entonces convergen preservando la intención de cada usuario cuando sea posible. Historia, comentarios y Worktree son módulos separados que una aplicación añade cuando sea necesario. Véase diseño de edición colaborativa y colaboración rápido.

Conversión de archivos. Conversion mueve contenido entre archivos de Office y datos de documentos Univer y conecta los pasos de importación, edición y exportación. Funciona con o sin colaboración. Ver Importación y exportación de archivos de oficinas para las API de conversión y integración del intercambio de archivos de cargas, tareas y descargas.

Despliegue y escalado. Los módulos se montan dentro de su propia aplicación Node.js y una sola máquina es suficiente para comenzar. A medida que crece la carga, la aplicación puede mover la conversión de archivos a un servicio separado y luego escala a múltiples nodos de colaboración. Ver aplicación arquitectura y Guía para el despliegue.

El Vista general de Server SDK describe los módulos con más detalle.

AI SDK: proporcione a los agentes un punto de entrada

AI SDK añade capacidades de oficina a los agentes existentes, automatización y CLIs específicos para aplicaciones. Se basa en el tiempo de ejecución sin cabeza y API de Facade de Web SDK para operaciones de contenido, cálculo e inspección.

Las herramientas de Conecta tu pila de agente existente. Office pueden ser expuestas como API TypeScript o como CLI montado desde el SDK. Selección de modelos, orquestación de tareas y habilidades permanecen en la aplicación. Los agentes reciben resultados de ejecución y retroalimentación de inspección, luego continúan su flujo de trabajo.

Cree contenido que se mantenga editable. Un agente lee la estructura de documentos, localiza el rango o párrafo que necesita y utiliza las API de Facade para crear y modificar hojas de cálculo, documentos, diapositivas y otros contenidos, incluyendo el cálculo de fórmulas. El resultado mantiene su estructura de contenido y sigue siendo editable, para que la gente pueda seguir refinando. operaciones de.

Inspeccione, luego revise. El agente lee los valores y los resultados de la fórmula e inspecciona una captura de pantalla de la página real. Para diapositivas, cheques de diseño también identifican el texto que se ejecuta fuera de la página, desbordamientos o superposiciones. El agente utiliza esta retroalimentación para revisar el contenido y verificarlo de nuevo, que completa la lectura → editar y calcular → inspeccionar el bucle. Ver inspección visual.

Con Server SDK, Worktree aísla los cambios intermedios realizados por un agente hasta que una persona revise y se fusione con la aplicación Web. Comience con el Vista general de AI SDK.

Flujo de trabajo de la aplicación

100%
  • Editor adjunto: Web SDK muestra y edita contenido dentro de una aplicación.
  • Aplicación colaborativa: Web SDK y Server SDK juntos permiten editar documentos compartidos.
  • Colaboración humana y agente: los agentes editan y verifican los borradores a través de AI SDK, Server SDK gestiona versiones y fusiones, y la aplicación Web proporciona visualización, comparación y revisión humana. El flujo de trabajo de revisión completo implica los tres.

Fundamentos y dependencias compartidos

Web SDK funciona independientemente, como editor o como motor de contenido sin cabeza. Server SDK y AI SDK dependen de las capacidades sin cabeza de Web SDK: correr sin un navegador UI todavía requiere el tiempo de ejecución de contenidos. Una aplicación permite los servicios y módulos que necesita, y un flujo de trabajo humano-agente completo normalmente combina los tres SDKs.

Comience con su caso de uso

quieroEmpieza aquí
Insertar un editor de hojas de cálculoWeb SDK inicio rápido
Elija otro editor de OfficeDocumentos, diapositivas, tablas relacionales, tableros, o PDF
Permitir que varios usuarios editen el mismo documentoInicio rápido de colaboración
Importar o exportar archivos de OfficeConversión de archivos Server SDK
Operar documentos a través de un agente o CLIDescripción general de AI SDK
Revisar los cambios de un agente en un documento compartidoAI SDK Worktree

Próximos pasos

Comience con el tiempo de ejecución de contenidos Web SDK. Server SDK y AI SDK completan el primer flujo de trabajo de aplicaciones, y se pueden añadir módulos adicionales según sea necesario. Mantenga las versiones relacionadas Univer paquetes alineados, y prepare el medio ambiente, autorización y licencias que los módulos elegidos requieren.

Ejemplos recopila aplicaciones de código abierto, integraciones de agentes, demos y repositorios. También puede probar los productos de Office en el escaparate en línea.

¿Cómo es esta guía?

© 2026 DreamNum Co., Ltd.