Workspace
Un espacio de trabajo de código abierto con Univer Office SDK: pruébalo en la nube, alójalo, conecta tus agentes por CLI o trabaja en Desktop.
Univer Workspace es un espacio de trabajo de oficina de código abierto construido en Univer Office SDK, en el que las personas y los agentes trabajan juntos. El contenido de oficina editable y las aplicaciones web con datos se organizan en espacios personales y de equipo, junto con el intercambio, colaboración, versiones y revisión de cambios. El repositorio de fuentes contiene la aplicación, la configuración de implementación, el CLI y el cliente de escritorio.
Usted puede desplegar Workspace en su propia infraestructura o comenzar con el prueba de nubes. Un agente existente se conecta a través de Workspace CLI. Workspace Desktop trae una conversación de agente y el mismo espacio de trabajo en una aplicación local. Todas estas rutas operan en el mismo servicio y los mismos archivos.
Prueba en línea · Conecta tu agente · Alojamiento propio · Experiencia Desktop · Código y personalización
Empieza con Workspace en la nube
Abra el prueba de nubes, inicie y entre en su Espacio Personal o en un Espacio de Equipo que pueda acceder. Cree o abra un documento, luego trate de edición directa, organización de archivos y compartir. El servicio Workspace ya está funcionando, por lo que un agente también puede conectarse a él a través del CLI descrito a continuación. El ensayo está destinado a datos de muestra, y que los datos pueden ser reajustados.
Servidor de espacio de trabajo gestiona identidad, espacios, permisos, almacenamiento, colaboración y versiones. Web es la interfaz del navegador para la edición y revisión. Un despliegue privado ejecuta la misma aplicación Server y Web.
Conecta tu agente al Workspace en la nube
Instala el CLI y el descubrimiento Habilidad en el ambiente donde se ejecuta su agente. Node.js 22.12 o más nuevo es necesario, y Node.js 24 es recomendado. Un agente que puede ejecutar comandos utiliza estas herramientas mientras continúa proporcionando su propio modelo y conversación. Establecer el servicio de la nube explícitamente para que el navegador y el agente funcionen en el mismo espacio de trabajo:
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.aiPrimera conexión: iniciar sesión una vez en el navegador
Este paso puede ser saltado cuando ya existe una sesión válida. Si se requiere el registro, ejecute:
uvw auth loginAbra el enlace devuelto, inicie sesión y confirme el código en el navegador. Después de que el usuario confirme la terminación, ejecute:
uvw auth login --completeEste paso sólo se requiere cuando se establece una sesión. El Workspace Guía CLI documenta el conjunto completo de comandos y la autenticación.
Después de que el navegador autorice el CLI una vez, el CLI reutiliza esa sesión para tareas posteriores. No se requiere ninguna página de inicio de sesión específica de agente o la integración de autenticación. Dar al agente conectado una tarea, a continuación, abrir el enlace que devuelve en Web: el contenido es el mismo, y los cambios de la Oficina nativa del Agente pueden ser revisados antes de fusionarse.
Empieza con un documento que puedas calcular y revisar
Crea una hoja de gastos mensuales en inglés en mi espacio personal Workspace con fechas, categorías, importes y cinco filas de ejemplo. Añade una fórmula de total y un gráfico por categoría.Trabaja en un borrador aislado, verifica datos, fórmulas y aspecto, y dame un enlace de vista previa o revisión. No integres antes de mi confirmación.Enviar este texto a un agente conectado o utilizarlo en el Escritorio. El agente crea y verifica el documento, y usted solicita cambios, revisa el resultado y decide si se fusiona. El mismo contenido también se abre en la edición en línea.
Lleva el mismo flujo a tu propio despliegue
El repositorio de código abierto contiene Server y Web. Construya la aplicación con el Guía para el despliegue, luego configure el dominio, registro, almacenamiento persistente y configuración de tiempo de ejecución. El desarrollo de la fuente utiliza Node.js 24 y pnpm 11; la guía mantiene los detalles de implementación de la producción.
Antes del despliegue, preparar cuatro partes:
| Elemento | Configuración |
|---|---|
| Servicio | Una URL del espacio de trabajo accesible y la aplicación Server + Web. El escritorio y CLI ambos se conectan a este despliegue. |
| Datos persistentes | La base de datos del producto, la base de datos de colaboración y los archivos cargados, se retuvieron juntos. El despliegue predeterminado los almacena bajo .data; para Docker, montar un volumen persistente. |
| Identidad | Configurar el registro. Cuando el Escritorio se conecta, registre el cliente Agente OAuth con un partido de URL de llamada exacto. |
| Licencia del SDK | Proporcione VITE_UNIVER_LICENSE cuando construya Web para el dominio de implementación, y configure la licencia requerida por el tiempo de ejecución de contenido Node.js por separado. |
Las credenciales modelo pertenecen al host del Agente y se configuran separadamente del registro del espacio de trabajo. El Guía para el despliegue y Configuración del agente describen la configuración actual.
Configurar el mismo CLI para utilizar el despliegue privado y autorizar una cuenta en ese servicio. Reemplazar la dirección de ejemplo a continuación con el origen real del servicio:
uvw config set workspace.origin https://workspace.example.comuvw auth loginEl agente mantiene las mismas herramientas y habilidades y ahora opera en los archivos y permisos del servicio privado. El escritorio también puede conectarse a ese servicio. El Guía de conexión del agente documenta el registro del cliente y la configuración de callback.
Lleva Workspace a un cliente Desktop local
Workspace Desktop combina espacio de trabajo, un agente de tiempo de ejecución, herramientas de oficina y previsiones de contenido en un cliente local. El trabajo de oficina sigue el patrón de conversación y vista previa familiarizado con Codex o Cowork: describir el resultado deseado, inspeccionar el documento o aplicación web junto a la conversación, solicitar una revisión y revisar el resultado.
El escritorio puede conectarse al espacio de trabajo de la nube descrito anteriormente, a un despliegue privado, o a un servicio Workspace que funciona en la máquina local. Modelos y conversaciones se ejecutan a través del host de agente configurado, mientras que el espacio de trabajo conectado gestiona archivos y acceso. Los ejemplos de escritorio a continuación muestran cómo se conecta la creación, la gestión y la colaboración.
Instalar y conectar · Primera tarea: revisar un presupuesto con dos documentos
El flujo del agente en el trabajo Office diario
El trabajo de oficina continúa después de que una conversación devuelve un archivo descargable. La gente sigue editando, calculando contra datos reales, trabaja con compañeros de equipo, y decide qué cambios aceptar. El escritorio coloca estas actividades en un entorno de trabajo.
- Mantener el contexto: conversaciones, archivos, referencias locales y material Workspace permanecen disponibles.
- Contenido Office nativo y Web Apps: crea, previsualiza y edita hojas de cálculo, documentos, presentaciones, Relational Tables y Canvases, además de páginas interactivas basadas en datos Office.
- Vea y revise el resultado: abre contenido junto a la conversación, inspeccionar fórmulas y diseño, y luego solicitar un cambio específico.
- Entrega mediante revisión: los cambios de la oficina nativa del agente permanecen en un Worktree hasta que una persona los revisa y los fusiona en el espacio de trabajo compartido.
De la petición al resultado revisable
Los documentos de oficina y las aplicaciones web se generan y revisan en la conversación ordinaria, luego gestionados y compartidos en el espacio. Los cambios de la Oficina Nativa pasan a través de la revisión Worktree antes de fusionarse. La publicación HTML y los escritos vinculantes siguen sus propios flujos de ahorro y autorización.
Lo que reúne el escritorio
| Función | Experiencia |
|---|---|
| Sesiones de agente | Conversaciones y contexto de tarea, con el proveedor y la configuración de modelo gestionado localmente. |
| Archivos y referencias | Explore los Espacios a los que puede acceder. Utilice @ para referencia archivos o carpetas del espacio de trabajo, y material local. |
| Vista previa de contenido | Abrir archivos nativos de Office o aplicaciones web junto a la conversación para comprobar contenido, interacciones y datos. |
| Revisión y entrega | Vea qué documentos un Worktree añadió, modificó o borró, a continuación, solicite revisiones, fusiones o descartes. |
| Workspace local o alojado | Conéctese al servicio en línea del equipo, o ejecute el servicio Workspace en una máquina local. |
| Gestión y colaboración en Space | Organizar las conversaciones de archivos producir, gestionar compartir y editar el mismo contenido con compañeros de equipo. |
Workspace y el agente en la práctica
Las capturas de pantalla a continuación muestran un MacOS Desktop real conectado a un espacio de trabajo local y utilizando materiales de lanzamiento ficticios. Esta vista previa de integración combina un host extensible de Agente, el plugin de capacidad espacial y una piel de marca Univer; la disponibilidad sigue las versiones del proyecto.
Crea y revisa el resultado en una conversación
Describir el requisito en una conversación ordinaria, y el Agente crea o revisa documentos de Office y aplicaciones web. Las vistas aparecen a la derecha, y las mejoras continúan a través de la conversación. El contenido se guarda en el espacio de trabajo, donde el Espacio administra archivos, compartir y colaborar.
01 Presupuesto de lanzamiento combina presupuestos, gasto real, pronósticos, fórmulas de varianza y totales en una sola hoja. Los gráficos comparan el presupuesto con el gasto real y muestran la varianza para cada flujo de trabajo.
02 Reunión informativa convierte el objetivo, el plan de lanzamiento, las medidas de éxito y las acciones del propietario en un documento editable.
03 Historia de lanzamiento convierte el plan en una presentación con etapas de lanzamiento, una puerta de aprobación y medidas de éxito, listos para la revisión del equipo.
04 Plan de lanzamiento realiza un seguimiento de tareas por fase, estado, prioridad y propietario, y apoya el cambio entre la red, el tablero de estado y las vistas de fase a medida que avanza el trabajo.
05 Mapa de lanzamiento conecta las etapas de lanzamiento en un lienzo, colocando los entregables, propietarios y puntos de control de aprobación en un plan visual.
El mismo flujo de trabajo de conversación también produce aplicaciones Web. 06 Lanzamiento de Dashboard presenta presupuesto, gasto real y variabilidad como tarjetas KPI, gráficos y detalle de flujo de trabajo. Los enlaces HTML View permiten que la página lea datos de hoja de cálculo, por lo que un equipo puede utilizar un informe interactivo junto a sus archivos Office. Binding sigue siendo experimental.
Organiza los resultados en Space
Los resultados de la conversación se convierten en archivos que el equipo sigue utilizando. El espacio tiene contenido de Office y aplicaciones web en un solo lugar, con categorías de productos, archivos recientes, favoritos y espacios personales o de equipo. La vista Todos a continuación recoge material de Aurora Launch Studio y Invitaciones de equipo.
Sigue editando y colaborando desde Space
Open 01 Presupuesto de lanzamiento de Space para continuar en el editor nativo de hojas de cálculo. Las líneas de presupuesto, fórmulas y totales siguen siendo editables, y los comentarios, historia de edición y compartir están disponibles en la misma vista. Web y Escritorio leen los mismos archivos Workspace. Más tarde Las revisiones del agente pueden permanecer en un Worktree separado hasta su revisión.
Worktree y Compare: revisa antes de integrar
En el Inteligente Workbench, Comparar coloca el presupuesto oficial al lado de los cambios propuestos por el Agente. El borrador añade dos artículos de línea y actualiza los totales, y la lista de cambios e identifica las células afectadas. Inspeccione el contenido, el formato o fórmulas, luego fusione o descarte el borrador. Worktree aisla el borrador, y Compare muestra las diferencias.
Comparte el documento o la Web App con el equipo
Abrir Compartir en el panel para comprobar quién puede acceder a la página y copiar su enlace. En este espacio de equipo, la página hereda permisos de miembro del Espacio, y Gestionar el acceso al espacio abre la ubicación donde se gestionan esos permisos. Copiar el enlace no otorga acceso adicional.
Instalar y conectar
Si un agente extensible de escritorio ya está en uso, la ruta de integración es instalar y habilitar el plugin de la capacidad espacial, conectarse desde el espacio, configurar el modelo, y añadir una piel de marca. Las capturas de pantalla en esta página utilizan esta composición. La versión completa del Workspace Desktop y la vista previa del plugin siguen caminos de entrega separados; use la versión publicada o las instrucciones del repositorio para la versión instalada.
-
Elija un instalador de escritorio de GitHub Releases. Las versiones de escritorio utilizan etiquetas agente-v, así que seleccione el dispositivo Windows x64, macOS Apple Silicon o Linux x64 para su máquina. La entrega de escritorio es experimental, y la disponibilidad sigue las versiones publicadas.
-
En Ajustes → Espacio de trabajo, elija el servicio Workspace, inicie sesión a través del navegador y autorice el acceso. Conéctese a un servicio desplegado o siga local setup para ejecutar un servicio localmente.
-
En la configuración de Modelos, configura un proveedor, modelo y credenciales compatibles. El registro de espacio de trabajo y el acceso de modelo se configuran por separado; véase configuración modelo.
-
Agregue un espacio personal o de equipo accesible, inicie una conversación, y utilice @ para material de referencia. Ejecute la tarea a continuación, a continuación, abra la vista previa del contenido y la revisión del cambio.
El instalador incluye la aplicación del agente y las herramientas de Office. El servicio Workspace funciona por separado, local o remotamente, y el acceso del modelo utiliza el proveedor configurado.
Primera tarea: revisar un presupuesto con dos documentos
En el Space actual, crea una hoja inglesa Budget Review con ocho departamentos: Department, Budget, Actual y Variance. Usa fórmulas para diferencias y totales y añade un gráfico de presupuesto frente a gasto real.Crea también un documento breve que resuma los excesos y enlace a la hoja. Mantén los cambios Office en un Worktree, verifica datos, fórmulas y resultado, abre vista previa y revisión y espera mi aprobación antes de fusionar.Seguir con: “Reducir el presupuesto de Marketing en un 10% y actualizar el resumen”. Revisar los valores revisados y los cambios de documento antes de aceptar el proyecto.
Construye tu propio Workspace desde el repositorio
La aplicación descrita anteriormente es una composición de Office SDK que se puede adaptar. Comience desde el Repositorio del espacio de trabajo, reutilizar las capacidades de programación y colaboración de contenidos, y reconstruir los flujos de trabajo, habilidades, herramientas e interfaz alrededor de los requisitos del equipo.
Encuentra la parte que quieres adaptar
| Ubicación | Responsabilidad |
|---|---|
apps/workspace | Server, Web, API del producto y configuración de despliegue. |
apps/cli | Conectar agentes existentes con un Workspace desplegado. |
apps/agent | Host del agente, ciclo de conexión y cliente Desktop nativo. |
skills/univer-workspace-cli | Discovery Skill instalado en un agente existente. |
packages/client-core | Operaciones de contenido Workspace compartidas por hosts Node. |
packages/dsh-univer-workspace-plugin | Herramientas Office, vistas previas nativas y guías de tareas. |
packages/dsh-univer-workspace-skin-plugin | Identidad visual y tokens de marca de Workspace. |
packages/workspace-html-viewer | HTML View sandbox and data-binding host for Web Apps. |
Skills: entender el espacio y completar tareas
Estas Habilidades permiten que un agente existente cree y edite contenido de Office y aplicaciones Web en un espacio de trabajo conectado, a continuación, desactivar los cambios para su revisión. Conectar el agente al espacio de trabajo primero; la guía a continuación funciona en los archivos y permisos de ese servicio.
Skills para tu agente
El univer-workspace-cli Habilidad instalado en el agente existente es el punto de entrada de descubrimiento. Explica cómo conectar, localizar el objetivo y cargar la guía operacional. El barco de Skills de tiempo completo con el CLI y coincide con sus comandos y APIs de Facade. El plugin de capacidad incorporado en Desktop también proporciona orientación de tareas y herramientas.
| Guía | Cobertura |
|---|---|
core | Localización de espacios y archivos, trabajando en proyectos de tareas, comprobando contenido y entregando para su revisión. |
sheet · doc · slide · base · board | Hojas de cálculo, documentos, presentaciones, Relational Table y Canvases. |
blob | Subir, descargar y reemplazar archivos originales. |
html-view | Creación y gestión de páginas HTML en vivo para aplicaciones web interactivas. |
embed · cross-unit-formula | Insertar otro contenido, y conectar datos y fórmulas a través de tipos de contenido. |
uvw skills listuvw skills get coreuvw skills get sheetuvw skills get html-viewCargar core primero, luego el producto o tema requerido por la tarea. skills get lista las rutas de referencia; leer un documento con uvw skills read <name> <path>, o añadir --full para leer todos ellos. Los agentes existentes utilizan estas capacidades a través del CLI, mientras que el Escritorio integra las herramientas y la guía en el flujo de trabajo de conversación.
Guías integradas en Desktop
El plugin de capacidad de escritorio incluye la habilidad univer y sus referencias. Describe cómo se relacionan los espacios y documentos, cómo utilizar API de Office, y cómo crear, comprobar y entregar un Worktree. Las instrucciones acompañan las herramientas ejecutables, de modo que el agente puede buscar una API, ejecutarlo en contenido nativo, e inspeccionar el resultado.
El capacidad plugin combina el descubrimiento de archivos, edición sin cabezas, inspección estructurada, importación y exportación, y las herramientas de ciclo de vida Worktree. Esta vista previa prepara borradores para su revisión; la publicación pasa por el flujo de trabajo de revisión y fusión de la aplicación desplegada. Una aplicación puede añadir dominio Habilidades, plantillas y herramientas de negocio en el mismo tiempo de oficina.
El plugin de previsualización contiene nueve Habilidades. La Habilidad común cubre el descubrimiento, la identidad y la entrega, y cada producto La Habilidad cubre sus API y cómo verificar los resultados. El agente lee la guía requerida por la tarea actual.
| Skill | Guía |
|---|---|
univer | Spaces, archivos, ciclo del borrador y entrega |
univer-sheet | Fórmulas, estilos, gráficos y verificación de hojas |
univer-doc | Estructura documental, párrafos y tablas |
univer-slide | Creación de diapositivas y revisión visual |
univer-base | Campos, registros y vistas |
univer-board | Formas, conectores y distribución del lienzo |
univer-embed | Insertar un producto de Office dentro de otro |
univer-cross-unit-formula | Referencias y cálculos entre las unidades |
univer-html-view | Construcción e inspección de páginas HTML vinculadas a datos de Office |
Cómo Office SDK hace funcionar Workspace
Workspace conecta editores nativos, operaciones de contenido de agente y colaboración de equipo con los mismos documentos y permisos. Puede aprovechar esta aplicación de código abierto y en Office SDK, y centrar su esfuerzo en los flujos de trabajo de negocios, la interfaz y las integraciones.
Los agentes operan en contenido en Node.js a través del CLI o Desktop, y la gente ve, edita y lo revisa en el editor Web o Desktop. Workspace Server almacena documentos compartidos, borradores y estado de colaboración, y puede funcionar localmente, en servidores privados, o en la nube.
| Capa | Responsabilidad |
|---|---|
| Web SDK | Modelos de contenido, fórmulas, API Facade públicas y editores nativos. |
| AI SDK | Búsqueda de API, inspección estructurada y ejecución Facade sobre un documento concreto. |
| Server SDK | Colaboración, revisiones, borradores Worktree y conversión de archivos. |
| Aplicación | Workspace gestiona Spaces, archivos, permisos, uso compartido y revisión. El host del agente gestiona conversaciones, llamadas al modelo y herramientas. |
CLI y Desktop compartir un capa de operaciones de contenido. Su piscina de tiempo de ejecución mantiene los documentos cargados vivos para la vida del anfitrión y sincroniza las versiones antes de la ejecución. Diferentes clientes por lo tanto reutilizan la misma lógica de edición y presentación. reutilización del tiempo de ejecución.
Inspección visual complementa cheques estructurados. Imágenes vienen de rendering del navegador, y el diagnóstico de diseño automático actualmente detectan el flujo de texto y superposición en diapositivas.
De una edición del agente a un cambio revisable
En el ejemplo de revisión presupuestaria, el agente edita una hoja de cálculo que contiene fórmulas y estilos. La ruta de edición de la Oficina nativa procede de la siguiente manera:
- Localizar y cargar. El agente selecciona el documento y Worktree, carga la instantánea y los cambios, y sincroniza la revisión seleccionada. Una unidad es una instancia de documento, como un libro de trabajo.
- Edita por Facade. El tiempo de ejecución Node.js ejecuta llamadas públicas Facade contra esa Unidad. Los cambios de contenido producen mutaciones, que se recogen en un cambio y se presentan al borrador.
- Revisa el resultado. El agente lee los valores y fórmulas de vuelta e inspecciona la salida cuando sea necesario. La edición continúa en el mismo borrador hasta que el resultado esté listo para su revisión.
- Revisar y fusionar. Una persona comprueba las diferencias con Compare y decide si fusiona el Worktree con la versión compartida.
Salvar un cambio a un borrador no es fusionarlo. Workspace reporta un escrito tan exitoso sólo después de que se confirme la presentación; conflictos y comunicaciones no confirmadas devuelven errores. En el plugin de escritorio, las herramientas de fusión y descarte también requieren la aprobación del usuario, que el flujo de trabajo de la herramienta de la aplicación impone.
Conectar las Web Apps a los mismos datos Office
El panel de lanzamiento utiliza la misma hoja de cálculo que el editor de presupuestos. HTML View hace la página en un iframe de sandboxed. El host Workspace resuelve los documentos fuente que el usuario puede acceder y abastecer sus motores de contenido autorizados. Tarjetas métricas y gráficos se suscriben a los datos de origen, por lo que no se requiere una segunda copia del presupuesto.
Para enlaces editables, una escritura requiere una identidad firmada y permiso de edición en el documento fuente. Cuando el usuario sale de la página, el host espera a los escritos pendientes y confirmación de la colaboración, e informa que ahorra fallos. La publicación de páginas HTML y los escritos vinculantes utilizan sus propios caminos de ahorro y no siguen automáticamente a la Oficina nativa Worktree flujo de fusión. de datos experimentales y el Aplicación del host HTML View.
Adapta el flujo a tu negocio
| Objetivo | Por dónde empezar |
|---|---|
| Documentos y tareas de tu sector | Añadir dominio Habilidades, plantillas y guía de herramientas, y conservar contenido y controles visuales. |
| Identidad, almacenamiento y uso compartido propios | Extiende la aplicación Workspace y sus políticas de servidor. |
| Su propio cliente de oficina basado en agentes | Combine el host de agente, el plugin de capacidad y una piel de marca, luego conectar los modelos y herramientas de negocio elegidos. |
Ejemplo: añadir un Skill de revisión presupuestaria
Una habilidad de dominio puede codificar las reglas de revisión del equipo mientras reutiliza las herramientas de Office existentes:
- Localice el libro de trabajo fuente, el período, y las columnas Presupuesto/Actual, y pregunte acerca de cualquier definición de negocio que falta antes de la edición.
- Cargar la guía de hojas de cálculo, crear un Worktree, actualizar las fórmulas con Facade y preparar el documento de revisión.
- Compruebe los totales, los resultados de las fórmulas y la presentación, reporte los archivos cambiados y los cheques realizados, luego entregar el borrador a una persona para su revisión.
Las reglas y plantillas de negocio pertenecen a la Habilidad. Los controles de acceso, el borrador de la persistencia y la fusión de la aprobación permanecen en la aplicación. Para conectar un ERP o CRM, agregue una herramienta de aplicación que devuelve los datos necesarios y reutiliza el mismo flujo de edición y revisión de la Oficina.
Explorar la implementación
Compilación y distribución Desktop · Aplicación agente y configuración · Todos los ejemplos
¿Cómo es esta guía?