Workspace
Un espace de travail open source avec Univer Office SDK : essai en ligne, auto-hébergement, agents via Workspace CLI et expérience Desktop.
Univer Espace de travail est un espace de travail bureau open-source construit sur Univer Office SDK, dans lequel les personnes et les agents travaillent ensemble. Le contenu de bureau modifiable et les applications Web liées aux données sont organisés en espaces personnels et d'équipe, ainsi que le partage, la collaboration, les versions, et l'examen du changement. dépôt source contient l'application, la configuration de déploiement, le CLI, et le client de bureau.
Vous pouvez déployer Workspace sur votre propre infrastructure ou commencer avec le essai en nuage. Un agent existant se connecte à travers Workspace CLI. Workspace Desktop apporte une conversation d'agent et le même espace de travail dans une application locale. Toutes ces routes fonctionnent sur le même service et les mêmes fichiers.
Essai en ligne · Connecter un agent · Auto-hébergement · Expérience Desktop · Code et personnalisation
Commencer par Workspace dans le cloud
Ouvrez le essai en nuage, connectez-vous et entrez votre Espace personnel ou un Espace d'équipe que vous pouvez accéder. Créez ou ouvrez un document, puis essayez l'édition directe, l'organisation de fichiers et le partage. Le service Workspace est déjà en cours, de sorte qu'un agent peut également se connecter à celui-ci via le CLI décrit ci-dessous. L'essai est destiné aux données d'échantillon, et ces données peuvent être réinitialisées.
Serveur d'espace de travail gère l'identité, les espaces, les permissions, le stockage, la collaboration et les versions. Site Web est l'interface du navigateur pour l'édition et la révision.
Connecter votre agent au Workspace cloud
Installez le CLI et la découverte Skill dans l'environnement où votre agent fonctionne. Node.js 22.12 ou plus récent est nécessaire, et Node.js 24 est recommandé. Un agent qui peut exécuter des commandes utilise ces outils tout en continuant à fournir son propre modèle et conversation.
npm install --global univer-workspace-cli@latestnpx skills add dream-num/univer-workspace --skill univer-workspace-cli -guvw --versionuvw config set workspace.origin https://space.univer.aiPremière connexion : se connecter une fois dans le navigateur
Cette étape peut être ignorée lorsqu'une session valide existe déjà. Si une connexion est requise, exécutez :
uvw auth loginOuvrez le lien retourné, connectez-vous et validez le code dans le navigateur. Après que l'utilisateur confirme l'achèvement, exécutez :
uvw auth login --completeCette étape n'est requise que lors de l'établissement d'une session. Le Guide de l'ICL sur l'espace de travail documente l'ensemble complet de la commande et l'authentification.
Après que le navigateur autorise la CLI une fois, la CLI réutilise cette session pour des tâches ultérieures. Aucune page de connexion ou intégration d'authentification spécifique à un agent n'est requise. Donnez à l'agent connecté une tâche, puis ouvrez le lien qu'il retourne dans Web : le contenu est le même, et les modifications natives Office de l'Agent peuvent être examinées avant la fusion.
Commencer avec un document calculable et révisable
Crée dans mon espace personnel Workspace une feuille de dépenses mensuelles en anglais avec dates, catégories, montants et cinq exemples. Ajoute un total par formule et un graphique par catégorie.Garde les modifications dans un brouillon isolé, vérifie données, formules et rendu, puis donne-moi un lien d’aperçu ou de revue. Ne fusionne pas avant ma confirmation.Envoyer ce texte à un agent connecté ou l'utiliser dans Desktop. L'agent crée et vérifie le document, et vous demandez des modifications, examinez le résultat et décidez s'il faut fusionner. Le même contenu s'ouvre également dans l'édition en ligne.
Transposer le même parcours sur votre infrastructure
Le dépôt open-source contient le serveur et le Web. Construisez l'application avec le guide de déploiement, puis configurez le domaine, connectez-vous, stockage persistant et paramètres d'exécution. Le développement à partir de la source utilise Node.js 24 et pnpm 11; le guide maintient les détails de déploiement de la production.
Avant le déploiement, préparer quatre parties :
| Élément | Configuration |
|---|---|
| Service | Une URL de Workspace accessible et l'application Server + Web. Desktop et CLI se connectent à ce déploiement. |
| Données persistantes | La base de données produit, la base de données de collaboration et les fichiers téléchargés, conservés ensemble. Le déploiement par défaut les stocke sous .data; pour Docker, monter un volume persistant. |
| Identité | Configurez l'ouverture de session. Lorsque Desktop se connecte, enregistrez le client Agent OAuth avec une URL de rappel exacte. |
| Licence SDK | Fournissez VITE_UNIVER_LICENSE lors de la construction du Web pour le domaine de déploiement, et configurez séparément la licence requise par le contenu Node.js. |
Les identifiants de modèle appartiennent à l'hôte Agent et sont configurés séparément à partir de la connexion Workspace. Les guide de déploiement et Configuration de l'agent décrivent les paramètres actuels.
Configurer le même CLI pour utiliser le déploiement privé et autoriser un compte sur ce service. Remplacer l'adresse d'exemple ci-dessous par l'origine du service :
uvw config set workspace.origin https://workspace.example.comuvw auth loginL'agent conserve les mêmes outils et compétences et fonctionne maintenant sur les fichiers et les autorisations du service privé. Desktop peut également se connecter à ce service. Le Guide de connexion de l'agent documente l'enregistrement client et la configuration de callback.
Retrouver Workspace dans un client Desktop local
Bureau de l'espace de travail combine Workspace, un agent runtime, des outils Office et des prévisualisations de contenu dans un client local. Le travail de bureau suit le modèle de conversation et de prévisualiser familier de Codex ou de Cowork : décrire le résultat souhaité, inspecter le document ou l'application Web à côté de la conversation, demander une révision et examiner le résultat.
Desktop peut se connecter au cloud Workspace décrit ci-dessus, à un déploiement privé, ou à un service Workspace fonctionnant sur la machine locale. Modèles et conversations passent par l'hôte d'agent configuré, tandis que le Workspace connecté gère les fichiers et l'accès. Les exemples de bureau ci-dessous montrent comment la création, la gestion et la collaboration se connectent.
Installer et connecter · Première tâche : réviser un budget avec deux documents
Un workflow d’agent pour le travail Office quotidien
Le travail de bureau continue après une conversation renvoie un fichier téléchargeable. Les gens continuent à éditer, calculer à partir de données réelles, travailler avec des coéquipiers, et décider quels changements accepter. Desktop place ces activités dans un environnement de travail.
- Les conversations, fichiers, références locales et matériel Workspace Conservez le contexte : restent disponibles.
- Contenu Office natif et Web Apps : créer, prévisualiser et modifier des feuilles de calcul, documents, présentations, Relational Tables et Canvases, ainsi que des pages interactives fondées sur les données Office.
- Voir et réviser le résultat: ouvre le contenu à côté de la conversation, inspecte les formules et la mise en page, puis demande un changement spécifique.
- Exécuter par l'examen : les modifications natives Office de l'Agent restent dans un Worktree jusqu'à ce qu'une personne les examine et les fusionne dans l'espace de travail partagé.
De la demande au livrable révisable
Les documents Office et les applications Web sont générés et révisés dans la conversation ordinaire, puis gérés et partagés dans Space. Les modifications Native Office passent par l'examen Worktree avant de fusionner. Publication HTML et les écrits de liaison suivent leurs propres flux de sauvegarde et d'autorisation. Les conversations ultérieures peuvent renvoyer aux mêmes fichiers et données.
Ce que le bureau réunit
| Fonction | Expérience |
|---|---|
| Sessions agent | Conversations et contexte des tâches, avec le fournisseur et la configuration du modèle gérés localement. |
| Fichiers et références | Parcourez les espaces auxquels vous pouvez accéder. Utilisez @ pour référencer les fichiers ou dossiers Workspace et le matériel local. |
| Aperçu du contenu | Ouvrez des fichiers Office natifs ou des applications Web à côté de la conversation pour vérifier le contenu, les interactions et les données. |
| Revue et livraison | Voir les documents qui documentent un Worktree ajouté, modifié ou supprimé, puis demander des révisions, fusionner ou jeter. |
| Workspace local ou hébergé | Connectez-vous au service en ligne de l'équipe, ou exécutez le service Workspace sur une machine locale. |
| Gestion et collaboration dans Space | Organisez les conversations de fichiers produire, gérer le partage et éditer le même contenu avec les coéquipiers. |
Workspace et l’agent en pratique
Les captures d'écran ci-dessous montrent un vrai bureau macOS connecté à un espace de travail local et utilisant des matériaux de lancement fictifs. Cette prévisualisation d'intégration combine un hôte Agent extensible, le plugin de capacité Space, et une peau de marque Univer ; la disponibilité suit les sorties du projet.
Créer et prévisualiser dans une conversation
Décrivez l'exigence dans une conversation ordinaire, et l'Agent crée ou révise des documents de bureau et des applications Web. Les prévisualisations apparaissent à droite, et d'autres améliorations se poursuivent par la conversation. Le contenu est sauvegardé dans Workspace, où Space gère les fichiers, le partage et la collaboration.
01 Budget de lancement combine les budgets, les dépenses réelles, les prévisions, les formules d'écart et les totaux en une seule feuille. Les graphiques comparent le budget aux dépenses réelles et montrent l'écart pour chaque secteur de travail.
02 Mémoire de lancement transforme l'objectif, le plan de lancement, les mesures de succès et les actions du propriétaire en un document modifiable.
03 Histoire de lancement transforme le plan en une présentation avec des étapes de lancement, une porte d'approbation, et des mesures de succès, prêts pour l'examen par l'équipe.
04 Plan de lancement suit les tâches par phase, état, priorité et propriétaire, et prend en charge la commutation entre la grille, le tableau d'état et les vues de phase au fur et à mesure que le travail progresse.
05 Carte de lancement relie les étapes de lancement sur une toile, plaçant les livrables, les propriétaires et les points de contrôle d'approbation dans un seul plan visuel.
Le même workflow de conversation produit également des applications Web. 06 Lancer le tableau de bord présente le budget, les dépenses réelles et la variance comme des cartes KPI, des graphiques et des détails de flux de travail. Les liaisons HTML View permettent à la page de lire les données du tableur, de sorte qu'une équipe peut utiliser un rapport interactif à côté de ses fichiers Office. Reliure reste expérimental.
Organiser les résultats dans Space
Les résultats de conversation deviennent des fichiers que l'équipe continue d'utiliser. L'espace contient du contenu Office et des applications Web en un seul endroit, avec des catégories de produits, des fichiers récents, des favoris et des espaces personnels ou d'équipe. La vue Tous ci-dessous recueille du matériel de Studio de lancement Aurora et Invitations de l'équipe.
Continuer à modifier et à collaborer depuis Space
Ouvrir 01 Budget de lancement Les lignes de budget, les formules et les totaux restent modifiables, et les commentaires, l'historique de modification et le partage sont disponibles dans la même vue. Web et bureau lisent les mêmes fichiers Workspace. Worktree jusqu'à révision.
Worktree et Compare : examiner avant de fusionner
Dans le Courbe de travail intelligente, Comparez place le budget officiel à côté des modifications proposées par l'Agent. Le projet ajoute deux éléments de ligne et met à jour les totaux, et la liste des changements et les points saillants identifient les cellules touchées. Inspecter le contenu, le formatage ou les formules, puis fusionner ou rejeter le projet. Worktree isole le projet, et Comparer montre les différences.
Partager le document ou la Web App avec l’équipe
Ouvrez Partager sur le tableau de bord pour vérifier qui peut accéder à la page et copier son lien. Dans cet espace d'équipe, la page hérite des permissions des membres depuis l'espace, et Gérer l'accès à l'espace ouvre l'emplacement où ces permissions sont gérées. Copier le lien n'accorde pas d'accès supplémentaire.
Installer et connecter
Si un bureau d'agent extensible est déjà utilisé, le chemin d'intégration est d'installer et d'activer le plugin de capacité Espace, de se connecter depuis Space, de configurer le modèle et d'ajouter une peau de marque. Les captures d'écran sur cette page utilisent cette composition. La version complète de Workspace Desktop et l'aperçu du plugin suivent des chemins de livraison séparés; utilisez la version publiée ou les instructions du dépôt pour la version installée.
-
Choisissez un installateur de bureau à partir de GitHub sort. Desktop libère l'utilisation des balises agent-v, alors sélectionnez l'artefact Windows x64, macOS Apple Silicon ou Linux x64 pour votre machine. La livraison de bureau est expérimentale, et la disponibilité suit les versions publiées.
-
Dans Paramètres → Espace de travail, choisissez le service Workspace, connectez-vous par le navigateur et autorisez l'accès. Connectez-vous à un service déployé ou suivez configuration locale pour exécuter un service localement.
-
Dans les paramètres Models, configurer un fournisseur, un modèle et des identifiants pris en charge. L'accès à l'espace de travail et au modèle sont configurés séparément; voir configuration du modèle.
-
Ajoutez un espace personnel ou d'équipe accessible, commencez une conversation et utilisez @ pour le matériel source de référence. Exécutez la tâche ci-dessous, puis ouvrez l'aperçu du contenu et la revue de changement.
L'installateur comprend l'application agent et les outils Office. Le service Workspace fonctionne séparément, localement ou à distance, et l'accès au modèle utilise le fournisseur configuré.
Première tâche : réviser un budget avec deux documents
Dans l’espace courant, crée une feuille anglaise Budget Review avec huit départements : Department, Budget, Actual, Variance. Utilise des formules pour les écarts et totaux et ajoute un graphique budget/réalisé.Crée aussi un court document résumant les dépassements, lié à la feuille. Garde les changements Office dans un seul Worktree, vérifie données, formules et résultat, ouvre aperçu et revue, et attends mon accord avant fusion.Suivez avec : -Reduce Marketing budget de 10% et mettez à jour le résumé.--Vérifiez les valeurs révisées et les changements de document avant d'accepter le projet.
Construire votre propre Workspace à partir du dépôt
L'application décrite ci-dessus est une composition Office SDK qui peut être adaptée. Commencez à partir de la Dépôt d'espace de travail, réutiliser les capacités d'exécution du contenu et de collaboration, et reconstruire les workflows, les compétences, les outils et l'interface autour des besoins de l'équipe.
Trouver la partie à personnaliser
| Emplacement | Responsabilité |
|---|---|
apps/workspace | Server, Web, API produit et configuration du déploiement. |
apps/cli | Connexion des agents à un Workspace déployé. |
apps/agent | Hôte de l’agent, cycle de connexion et client Desktop natif. |
skills/univer-workspace-cli | Compétence de découverte installée dans un agent existant. |
packages/client-core | Opérations Workspace communes aux hôtes Node. |
packages/dsh-univer-workspace-plugin | Outils Office, aperçus natifs et guides de tâches. |
packages/dsh-univer-workspace-skin-plugin | Identité visuelle et tokens de marque Workspace. |
packages/workspace-html-viewer | HTML View sandbox et serveur de fixation de données pour les applications Web. |
Skills : comprendre l’espace et réaliser les tâches
Ces compétences permettent à un agent existant de créer et de modifier du contenu Office et des applications Web dans un espace de travail connecté, puis de passer les modifications en revue. Connectez l'agent à l'espace de travail d'abord; les conseils ci-dessous fonctionnent sur les fichiers et les permissions de ce service.
Skills pour votre agent
Le Compétence univer-workspace-cli installé dans l'agent existant est le point d'entrée de la découverte. Il explique comment connecter, localiser la cible et charger le guide opérationnel. L'Exploitation complète de Compétences est livré avec le CLI et correspond à ses commandes et aux API Facade. Le plugin de capacité intégré dans Desktop fournit également des conseils et des outils de tâches.
| Guide | Couverture |
|---|---|
core | Localiser des espaces et des fichiers, travailler dans des ébauches de tâches, vérifier le contenu, et remettre pour examen. |
sheet · doc · slide · base · board | Feuilles de calcul, documents, présentations, Relational Table et Canvases. |
blob | Télécharger, télécharger et remplacer les fichiers originaux. |
html-view | Création et gestion de pages HTML en direct pour les applications Web interactives. |
embed · cross-unit-formula | Intégrer d'autres contenus, et connecter des données et des formules entre les types de contenus. |
uvw skills listuvw skills get coreuvw skills get sheetuvw skills get html-viewChargez d'abord core, puis le produit ou le sujet requis par la tâche. skills get liste les chemins de référence; lisez un document avec uvw skills read <name> <path> ou ajoutez --full pour les lire tous. Les agents existants utilisent ces capacités via le CLI, tandis que Desktop intègre les outils et les conseils dans le workflow de conversation.
Guides intégrés à Desktop
Le plugin de capacité Bureau comprend la compétence Tous les jours et ses références. Il décrit comment les espaces et les documents se rapportent, comment utiliser les API Office, et comment créer, vérifier et livrer un Worktree. Les instructions accompagnent les outils exécutables, afin que l'agent puisse rechercher une API, l'exécuter sur le contenu natif, et inspecter le résultat.
Le plugin de capacité combine la découverte de fichiers, l'édition de Facade sans tête, l'inspection structurée, l'importation et l'exportation, et les outils de cycle de vie Worktree. Cet aperçu prépare des ébauches pour examen; la publication passe par l'examen et fusionne le workflow de l'application déployée. Une application peut ajouter le domaine Compétences, modèles et outils d'affaires sur le même temps d'exécution Office.
Le plugin d'aperçu contient neuf Compétences. La Compétence courante couvre la découverte, l'identité et la livraison, et chaque Compétence produit couvre ses API et comment vérifier les résultats. L'agent lit les conseils requis par la tâche actuelle.
| Skill | Guide |
|---|---|
univer | Spaces, fichiers, cycle des brouillons et livraison |
univer-sheet | Formules, styles, graphiques et vérification des feuilles |
univer-doc | Structure du document, paragraphes et tableaux |
univer-slide | Création de diapositives et contrôle visuel |
univer-base | Champs, enregistrements et vues |
univer-board | Formes, connecteurs et disposition du canevas |
univer-embed | Intégrer un produit Office dans un autre |
univer-cross-unit-formula | Référentiel et calcul entre les unités |
univer-html-view | Construction et inspection de pages HTML liées aux données Office |
Comment Office SDK fait fonctionner Workspace
Workspace connecte les éditeurs natifs, les opérations de contenu d'agent et la collaboration d'équipe aux mêmes documents et permissions. Vous pouvez construire sur cette application open-source et sur Office SDK, et concentrer vos efforts sur les flux de travail d'affaires, l'interface et les intégrations.
Les agents opèrent sur le contenu de Node.js par l'intermédiaire de la CLI ou du Bureau, et les gens le voient, l'éditent et le examinent dans l'éditeur Web ou du Bureau. Workspace Server stocke des documents partagés, des brouillons et l'état de collaboration, et il peut fonctionner localement, sur des serveurs privés ou dans le cloud.
| Couche | Responsabilité |
|---|---|
| Web SDK | Modèles de contenu, formules, API Facade publiques et éditeurs natifs. |
| AI SDK | Recherche d’API, inspection structurée et exécution Facade sur un document précis. |
| Server SDK | Collaboration, révisions, brouillons Worktree et conversion de fichiers. |
| Application | Workspace gère Spaces, fichiers, permissions, partage et revue. L’hôte de l’agent gère conversations, appels au modèle et orchestration des outils. |
CLI et Desktop partagent une couche d'exploitation du contenu. Son pool d'exécution maintient les documents chargés en vie pendant toute la durée de vie de l'hôte et synchronise les versions avant l'exécution. réutilisation de l'exécution.
Contrôle visuel complète les vérifications structurées. Les captures d'écran proviennent du rendu du navigateur, et les diagnostics automatiques de mise en page détectent actuellement le dépassement de texte et le chevauchement dans les diapositives.
D’une modification de l’agent à une revue
Dans l'exemple de budget-révision, l'agent modifie un tableur qui contient des formules et des styles. Le chemin d'édition natif Office procède comme suit:
- Localiser et charger. L'agent sélectionne le document et Worktree, charge l'instantané et les modifications, et synchronise la révision sélectionnée. Une unité est une instance de document, comme un cahier de travail.
- Éditer par Facade. L'exécution Node.js exécute des appels publics Facade contre cette unité. Les modifications de contenu produisent des mutations, qui sont collectées dans un ensemble de modifications et soumises à l'ébauche.
- Vérifiez le résultat. L'agent lit les valeurs et les formules en retour et inspecte la sortie rendue si nécessaire. L'édition se poursuit dans la même ébauche jusqu'à ce que le résultat soit prêt à être examiné.
- Relire et fusionner. Une personne examine les différences avec Compare et décide de fusionner le Worktree dans la version partagée.
L'enregistrement d'un jeu de changements dans un projet ne le fusionne pas. Workspace rapporte un écrit comme réussi seulement après la confirmation de la soumission; conflits et les soumissions non confirmées retournent des erreurs. Dans le plugin Desktop, les outils de fusion et de rejet nécessitent également l'approbation de l'utilisateur, ce que le workflow de l'outil de l'application fait appliquer.
Relier les Web Apps aux mêmes données Office
Le tableau de bord de lancement utilise le même table de calcul que l'éditeur de budget. HTML View rend la page dans un iframe sandboxed. L'hôte Workspace résout les documents sources que l'utilisateur peut accéder et fournit leurs moteurs de contenu autorisés.
Lorsque l'utilisateur quitte la page, l'hôte attend la confirmation d'écriture et de collaboration en attente, et il signale les échecs d'enregistrement. L'édition et la reliure HTML des pages écrit utilisent leurs propres chemins de sauvegarde et ne suivent pas automatiquement le flux de fusion natif Office Worktree. Voir fixation des données expérimentales et Mise en œuvre de l'hôte de la vue HTML .
Adapter le parcours à votre activité
| Objectif | Point de départ |
|---|---|
| Documents et tâches métier | Ajouter le domaine Compétences, modèles et guide d'outils, et conserver le contenu et les vérifications visuelles. |
| Identité, stockage et partage spécifiques | Étendez l’application Workspace et ses politiques serveur. |
| Votre propre client de bureau basé sur un agent | Combinez l'hôte de l'agent, le plugin de capacité, et une peau de marque, puis connectez les modèles choisis et les outils d'affaires. |
Exemple : ajouter un Skill de revue budgétaire
Une compétence de domaine peut encoder les règles d'examen de l'équipe tout en réutilisant les outils Office existants :
- Localisez le cahier de travail source, la période et les colonnes du budget/réel, et demandez-vous toute définition d'entreprise manquante avant de modifier.
- Charger le guide des feuilles de calcul, créer un Worktree, mettre à jour les formules avec Facade et préparer le document de revue.
- Vérifiez les totaux, les résultats de la formule et la présentation, signalez les fichiers modifiés et les vérifications effectuées, puis remettez l'ébauche à une personne pour examen.
Pour connecter un ERP ou un CRM, ajoutez un outil d'application qui retourne les données requises et réutiliser le même flux d'édition et d'examen Office. Une exécution de Skills guide; il ne permet pas d'accéder à un fichier.
Explorer l’implémentation
Construction et distribution Desktop · Application agent et configuration · Tous les exemples
Que pensez-vous de ce guide ?