dream-num univer
面向 AI Agents 的 Office 工具集
电子表格 · 文档 · 演示文稿 · 数据库 · 看板 · PDF(即将推出)
高性能、完全可定制的 Office SDK
通过插件架构、基于 Canvas 的渲染、公式引擎,以及一套可在浏览器和 Node.js 中运行的 Facade API,构建可嵌入的生产力体验。
English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español
🌐 官网 | 📖 文档 | ✨ 展示 | 📘 API 参考 | 📝 博客
✨ Univer 是什么?
Univer 是一个开源 SDK,用于在你自己的产品中创建 Office 应用。它为你提供电子表格、文档和演示文稿体验的构建模块,而不强迫你使用托管应用或固定 UI。
在以下场景中使用 Univer:
- 将电子表格或文档编辑嵌入 SaaS 产品、内部工具、BI 工作流或 AI 应用。
- 使用与浏览器中相同的架构,在服务器上运行工作簿/文档处理。
- 通过插件仅组合你需要的功能,或使用预设快速开始。
- 通过自定义插件、命令、服务、UI 组件和 Facade API 扩展行为。
Univer 不仅仅是电子表格文件查看器。它是一个用于构建你自己的生产力界面的框架。
在 Univer 产品家族中,Office 工具共享用于存储和计算的运行时。内容可以跨工具组合和嵌入,链接数据和引用会同步更新。人和 AI agents 可以在同一文件中协作。有关产品覆盖范围,请参阅能力矩阵;有关本仓库的范围,请参阅 Open Source 和 Pro。
使用 Univer Office SDK 构建协作工具
观看演示
使用 Univer Office SDK 构建
精选示例:Univer Workspace
Univer Workspace 是一个基于 Univer Office SDK 构建的开源、可自托管工作区,人们和 AI agents 可以在此创建、协作和审阅 Office 内容。开发者可以将完整实现作为参考,学习如何集成 SDK,并构建自己的产品。
Agents 可以生成基于电子表格的迷你应用,例如决策仪表盘、交互式报告和业务仪表盘。网页上的指标、图表和控件绑定到单元格,支持数据读取、写入和协作更新。
探索 Univer Workspace
其他示例
这些开源项目使用 Univer Office SDK 构建:
| 项目 | 描述 | | --- | --- | | Univer Office for DeepSeek Harness | 一个用于 DeepSeek Harness 的 Office 插件,具有连接内容、验证和用于 agent 协作的隔离 worktree。 | | Univer CLI | 一个本地命令行工作区,供 agents 创建、编辑、检查并交付 Office 内容。 | | Univer Office for WorkBuddy | 一个用于 WorkBuddy 的本地 Office 集成,具有 MCP 预览和草稿审阅。开发预览版。 | | Univer Office for OpenClaw | 用于在 OpenClaw 中创建、审阅和交付 Office 内容的工具。 |
每个项目都记录了自己的设置和 SDK 许可要求。
🌟 亮点
- ⚡ 为大型界面而生:基于 Canvas 的渲染和专用公式引擎让复杂工作簿保持流畅响应。
- 🧩 默认插件化形态:无需引入整个技术栈,即可组合、替换、懒加载或扩展能力。
- 🤖 面向 AI 基础设施的无头模式:在 Node.js 中运行工作簿和文档逻辑,为 agents、自动化和服务器端工作流提供支持。
- 🛠️ 产品级 SDK:框架适配器、Facade API、预设和无头运行时契合真实集成路径。
- 🌗 支持深色模式:UI 组件和渲染引擎均可适配浅色和深色主题。
- 🔌 统一 Facade API:在浏览器和 Node.js 中为工作簿、范围、公式和文档提供一致的 API 表面。
- 同构设计:在浏览器中运行 UI 应用,在 Node.js 中进行无头处理。
- 插件优先架构:每项能力都以可组合插件的形式交付,因此功能可以添加、移除、替换或懒加载。
- 预设模式实现快速集成:当你需要快速获得可用应用时,使用 presets/ 中精选的插件集合。
- 插件模式实现完全控制:当你需要自定义加载、更小包体或深度集成时,手动组合包。
- Facade API:通过更高级别的 API 处理工作簿、工作表、范围、文档、公式、命令和事件。
- Canvas 渲染引擎:通过跨文档类型共享的渲染层,支持大型可编辑文档界面。
- 可扩展 UI:与 React、Vue、Web Components 以及特定框架的应用外壳集成。
🚀 为什么选择 Univer?
🤖 面向 AI Agents 的 Office 工作流
Univer 的 AI 和协作能力将 agent 操作与交互式编辑和人工审阅连接起来:
- 程序化编辑:agents 通过结构化 API 检查和修改 Office 内容。
- 输出验证:agents 通过内容检查、渲染截图和布局诊断来检查结果。
- Worktree 协作:agents 在隔离草稿中工作,然后由人工审阅其更改并决定合并哪些内容。
有关集成细节,请参阅 AI SDK 文档。
实时编辑、共享修订和 Worktree 工作流需要相应的 Web SDK 和协作能力;包的可用性和许可因功能而异。
⚡ 快速开始
使用插件模式以获得完整产品覆盖和精确组合。对于受支持的 Sheets、Docs 和 Node 配置,预设模式提供了更短的精选设置。
插件模式
插件模式让你对包、样式导入、语言环境合并、Facade API 注册和插件配置拥有更低层级的控制。
pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui @univerjs/engine-formula @univerjs/engine-render @univerjs/sheets @univerjs/sheets-formula @univerjs/sheets-formula-ui @univerjs/sheets-numfmt @univerjs/sheets-numfmt-ui @univerjs/sheets-ui @univerjs/ui
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'
import { FUniver } from '@univerjs/core/facade'
import DesignEnUS from '@univerjs/design/locale/en-US'
import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverDocsUIPlugin } from '@univerjs