Headless et calcul serveur

Exécutez les opérations de contenu dans Node.js et les précalculs dans Rust pour les applications et agents.

Headless Univer est l'exécution du contenu Univer sans l'interface utilisateur de l'éditeur interactif. Il partage les modèles de contenu, les commandes, le calcul et les API Facade avec l'éditeur du navigateur. Une application peut l'exécuter en Node.js pour y traiter du contenu, ou dans un navigateur pour des tâches qui n'ont pas besoin d'interface utilisateur.

Le JavaScript/TypeScript runtime décrit sur cette page et univer-rs sont des implémentations séparées. univer-rs prend en charge le calcul côté serveur et la conversion de fichiers, et il participe aux workflows Headless sur les mêmes instantanés.

Ce que permet Headless

  • Lisez et modifiez le contenu et la structure. Créez ou chargez un instantané Univer, utilisez les API Facade pour lire et modifier les cellules, les paragraphes, les pages, les objets graphiques ou les enregistrements, puis enregistrez l'instantané mis à jour. Ces opérations supportent le traitement par lots, la génération de données, l'inspection du contenu et l'automatisation des agents.
  • Exécutez la logique d'affaires enregistrée. Formule calcul, tri, filtrage, validation et pivot plugins sont disponibles, et les applications peuvent modifier des ressources telles que des images, des graphiques, des formes et des commentaires. Les opérations disponibles dépendent du produit enregistré et des plugins de fonctionnalités et de leurs dépendances.
  • Connectez-vous à d'autres services. Ajoutez le client de collaboration Node.js pour charger des unités collaboratives, soumettre des modifications et attendre la synchronisation. Combinez les modules de conversion Server SDK avec le délai d'exécution pour importer et exporter des fichiers Office.

Headless ne fournit pas l'interface utilisateur de l'éditeur : pas de menus, de barres d'outils, de dialogues, d'interactions souris ou clavier, de captures d'écran ou d'impression. save() renvoie a Univer snapshot; il n'écrit pas dans une base de données ou n'exporte pas XLSX, DOCX ou PDF. rendu temps d'exécution, parce qu'un navigateur sans tête exécute toujours la couche de rendu.

Packages appartenant à Headless

Sélectionnez les paquets de contenu dont l'application a besoin, puis enregistrez les plugins et les dépendances de produit requis. Les fonctionnalités Pro exigent également que leurs licences soient configurées.

Modèles de contenu

Ces paquets fournissent des instances, des modèles de contenu, des commandes et des opérations de contenu de base.

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

Formules et formats numériques

Ces paquets fournissent l'exécution de la formule, l'intégration de la formule de feuille et le formatage des numéros. Sélectionnez le moteur open-source ou Pro selon les caractéristiques requises.

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

Données et règles des feuilles

Les données de feuille et les opérations de règle fonctionnent sans les panneaux ou l'interaction visuelle qui les accompagnent normalement. La validation des données nécessite également @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

Images, liens et commentaires

Ces paquets ajoutent des modèles, des ressources et des commandes pour les images, les liens et les commentaires. L'affichage, les téléchargements et les sources de données externes sont reliés séparément au besoin.

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

Fonctions avancées des feuilles

Les pivots, les graphiques, les formes, les lignes lumineuses, les contours et les trancheurs fournissent leur propre logique de contenu et de calcul. Les dépendances graphiques peuvent inclure @univerjs-pro/engine-chart et @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

Extensions des documents

Les blocs de documents, les tableaux, les colonnes, les formules et les formes supportent les opérations de contenu, mais pas les commandes de l'éditeur.

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

Modèles des autres produits

Ces paquets fournissent des modèles et des commandes pour les autres produits. pdfs-editor configure le cycle de vie de l'éditeur PDF et l'intégration de la collaboration; l'éditeur de mots dans un nom de paquet n'implique pas une interface utilisateur.

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

Réseau, processus de calcul et collaboration

@univerjs/network et @univerjs/rpc-node fournissent des processus de réseau et de calcul Node.js, et @univerjs-pro/license gère l'intégration des licences. @univerjs-pro/collaboration, @univerjs-pro/collaboration-client et @univerjs-pro/collaboration-client-node forment ensemble un client de collaboration Headless, et non un serveur de collaboration.

Packages hors du runtime de contenu seul

  • @univerjs/ui, @univerjs/design, et *-ui emballages pour un produit ou une caractéristique, tels que @univerjs/sheets-ui, @univerjs/docs-uiet @univerjs-pro/slides-ui, fournir l'interface utilisateur, rendre l'intégration, ou l'interaction. Node.js configuration qui ne traite que le contenu.
  • @univerjs/sheets-find-replace et @univerjs/sheets-crosshair-highlight n'ont pas de suffixe -ui mais dépendent toujours de @univerjs/sheets-ui, donc un nom de paquet ne signifie pas qu'il s'agit de plugins Headless.
  • Les préréglages @univerjs/preset-sheets-core et @univerjs/preset-docs-core par défaut enregistrent les plugins UI et ne sont pas des preréglages sans tête Node.js. Dans ce cas, utilisez le mode plugin pour sélectionner explicitement les dépendances de la couche de contenu.

@univerjs/engine-render doit être examiné séparément. L'actuel Node.js l'enregistrement du plugin ne crée pas de Toile ou de montage d'un éditeur. Il peut apparaître dans une composition Headless, mais le dessin, la mesure de police et les API screenshots ont encore besoin d'un environnement de rendu approprié. Node.js.

Facade est une API d'opération, pas un adaptateur d'environnement. Pour chaque plugin de contenu utilisé, importez son extension /facade, et enregistrez les plugins qui implémentent les capacités requises. Les extensions d'interfaces comme @univerjs/ui/facade et @univerjs/sheets-ui/facade nécessitent toujours l'interface utilisateur, de même que les menus, la défilement et les interactions de sélection visuelle qu'elles fournissent. Examinez les dépendances du plugin et le chemin d'appel réel plutôt que de compter sur un nom de paquet ou la présence d'API Facade.

Les compositions de plugins exécutables apparaissent dans le Feuilles Guide sans tête et le Docs Guide sans tête.

Calcul immédiat dans le navigateur, calcul serveur par révision

Les moteurs Formula fonctionnent à la fois dans le frontend et le serveur. Le frontend répond comme l'utilisateur modifie, et le serveur calcule une révision de contenu capturé quand il génère un instantané ou traite un fichier.

  • Lors de l'édition, le navigateur calcule localement les formules touchées, en option dans un worker, et affiche les résultats immédiatement. Le service de collaboration enregistre ces changements de contenu et les synchronise.
  • Lorsqu'un snapshot est généré, la politique d'instantané du serveur démarre le flux de travail de sauvegarde. Le serveur capture la révision du contenu pour cette opération, le calcule avec univer-rs, et enregistre le contenu et les résultats de cette révision ensemble.
  • Lorsque le document est réouvert, la façade réutilise les résultats valides dans l'instantané, applique les changements subséquents et continue de calculer, ce qui évite un recalcul complet.
100%

Les changements de contenu se synchronisent en continu. Le calcul du serveur s'effectue dans le cadre de la génération d'instantanés, et les résultats sont enregistrés pour cette révision de contenu.

Lors de la première charge, l'application configure comment le calcul initial utilise les résultats enregistrés:

  • WHEN_EMPTY : réutiliser les valeurs enregistrées et calculer uniquement les résultats manquants.
  • NO_CALCULATION : ignorer le calcul initial ; l’application fournit les résultats.
  • FORCED : recalculer toutes les formules pour actualiser les résultats.

Ces options ne régissent que le chargement initial. Après le chargement, l'édition continue de calculer dans la façade, et le serveur calcule sur demande lorsqu'il génère un instantané ou traite des fichiers en version. Voir configuration de la formule, la collaboration et conversion de fichier.

Performances du moteur de formules

Le Univer Formule moteur de référence couvre 10 cahiers de travail et inclut le chargement d'entrées Rust, les chronométrages d'étapes, les limites du format d'entrée et les téléchargements du cahier de travail.

Formules matricielles et plages déversées

Dans les fonctions et formats pris en charge, Rust suit la forme de tableau et la sémantique de déversement de Excel. Il retourne les valeurs calculées avec la plage d'ancrage et de déversement, et il gère à la fois les tableaux dynamiques et les gammes déclarées de formules de tableau.

Par exemple, =SEQUENCE(3,2) dans une cellule A1 vide produit :

AB
12
34
56

La formule reste dans A1, et les résultats occupent A1:B3. Lorsque le tableau se rétrécit, les valeurs de déversement précédentes sont effacées. Lorsqu'un déversement est bloqué, le résultat est #SPILL! . Le navigateur, un agent et le pipeline d'exportation peuvent tous réutiliser l'instantané calculé.

Les règles de fonction et d'intervalle correspondantes sont dans soutien à la formule et Comportement du tableau Excel.

Relier exécution et vérification à un agent

Gardez le modèle, la conversation et l'orchestration d'outils existants. Les outils AI SDK exposent les opérations de contenu Office à cet agent :

  1. Inspectez la structure et lisez le contenu cible.
  2. Appliquer les changements Facade et exécuter les calculs requis dans l'exécution sans tête.
  3. Attendez que le calcul et le commit soient confirmés, puis lisez l'état mis à jour.
  4. Vérifiez les valeurs et la structure, et ajoutez des captures d'écran ou des vérifications de mise en page lorsque la vérification visuelle est nécessaire.

Utilisez Opérations de contenu et Contrôle visuel ensemble. Lorsqu'une personne a besoin de revoir le travail, placez les modifications dans un Worktree d'abord, puis comparez-les et fusionnez-les. CLI Univer démontre comment assembler ces capacités dans une application qu'un agent peut piloter.

Parcours d’intégration

CapacitéUtilisation
Runtime de contenu Node.jsDémarrez avec headless Univer et activez les plugins produits et calcul requis.
Traitement de fichiersCombiner Rust et la conversion Node.js, puis enregistrer ou retourner le snapshot.
Édition partagée et agentsConnectez la collaboration et AI SDK afin que les personnes et les agents travaillent sur du contenu confirmé.

Toutes les fonctionnalités

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.