Catalogue des paquets
Choisir les paquets AI SDK selon les tâches de contenu, collaboration, compilation, rendu, processus et application.
AI SDK publie actuellement 25 paquets indépendants. Installez uniquement les paquets de base nécessaires, puis ajoutez le préréglage de commande de la même ligne si son interaction terminal convient au produit.
Deux rôles de paquets
| Rôle | Fournit |
|---|---|
| Paquet de base | API TypeScript structurées, sans dépendance à Commander ni choix des noms de commandes, des sorties ou du comportement de fin |
| Paquet de préréglage de commande | Un Command Commander natif reposant sur un paquet de base, avec arguments, aide et interaction terminal par défaut |
Les préréglages de commandes se terminent généralement par -command. Tous les paquets de base n’ont pas besoin d’un préréglage correspondant.
Runtimes de contenu et de collaboration
| Tâche | Paquet de base | Paquet de préréglage de commande |
|---|---|---|
| Créer un Univer standard sans interface | @univer-cli/headless-univer | — |
| Rechercher hors ligne dans l’API Facade Univer | @univer-cli/api-reference | @univer-cli/api-reference-command |
| Préparer et lier l’exécution Facade | @univer-cli/content-execution | — |
| Lire le contenu Sheet, Doc ou Slide | @univer-cli/content-inspection | @univer-cli/content-inspection-command |
| Exécuter une Unit collaborative | @univer-cli/univer-collaboration-runtime | — |
| Réutiliser les runtimes collaboratifs dans des workers | @univer-cli/univer-collaboration-runtime-pool | — |
Compilation de contenu
| Tâche | Paquet de base | Paquet de préréglage de commande |
|---|---|---|
| Convertir un SVG en code Slide Facade | @univer-cli/svg-facade | @univer-cli/svg-facade-command |
| Convertir un bundle Typst en code Doc Facade | @univer-cli/doc-typst-facade | @univer-cli/doc-typst-facade-command |
Rendu et diagnostic
| Tâche | Paquet de base | Paquet de préréglage de commande |
|---|---|---|
| Capturer une Unit en PNG | @univer-cli/unit-screenshot | @univer-cli/unit-screenshot-command |
| Vérifier la mise en page des Slides | @univer-cli/unit-layout-lint | @univer-cli/unit-layout-lint-command |
| Héberger une Render Page et piloter un navigateur | @univer-cli/univer-render-runtime | — |
| Composer et construire une Render Page | @univer-cli/univer-render-page | — |
Processus et cycle de vie
| Tâche | Paquet de base | Paquet de préréglage de commande |
|---|---|---|
| Acquérir exclusivement, mettre en cache et retirer des objets avec état par clé | @univer-cli/generic-keyed-instance-pool | — |
| Partager un processus résident local entre plusieurs processus CLI | @univer-cli/daemon | @univer-cli/daemon-command |
Utilitaires d’application
| Tâche | Paquet de base | Paquet de préréglage de commande |
|---|---|---|
| Déclarer, lire et conserver la configuration | @univer-cli/config | @univer-cli/config-command |
| Rechercher, mettre en cache et exporter des ressources visuelles | @univer-cli/resource-library | @univer-cli/resource-library-command |
Comment choisir
- Commencez par le paquet de base correspondant à la tâche métier.
- Ajoutez son préréglage uniquement si l’interaction Commander par défaut convient au produit.
- Si CLI, Web et Server partagent une Unit, utilisez un runtime collaboratif plutôt qu’un accès direct à la base de collaboration.
- Ajoutez pool, daemon ou Render Runtime seulement pour la réutilisation, l’accès interprocessus ou le rendu navigateur.
- Lisez le README du paquet pour ses API publiques, sa propriété des ressources et sa libération.
Consultez Chargement et opérations de contenu, Inspection visuelle et Réutilisation du Runtime et Daemon pour les concepts et usages essentiels.
Que pensez-vous de ce guide ?