Univer:可嵌入自己产品里的开源 Office SDK
阅读时间: 大约 9 分钟
Univer:可嵌入自己产品里的开源 Office SDK

如果你在做企业 SaaS,多半遇到过这个需求:产品里要内嵌一个能编辑 Excel 的表格控件。自研不现实,直接套一个在线文档产品又被控得死死的。Univer(来自 DreamNum / 梦想数科)给的答案是一套可嵌入的 Office SDK——不是一个让你登录使用的在线 Office,而是一组让你把表格、文档、幻灯片等编辑能力直接编进自己产品里的构建块。2026 年 9 月 Univer 1.0 发布,把六类编辑器收进同一个可编程运行时,并把自己定位成”AI Agent 的 Office 机架(Office Harness for AI Agents)“。本文基于其官方站点与 1.0 发布说明,分析它的架构与边界。
一、背景:为什么需要”可嵌入”的 Office
在线文档(Google Docs、飞书、Office 365)解决的是”终端用户在哪办公”,但企业开发要的是”把表格能力嵌进自己的业务流程”——比如在风控后台里让用户在线编辑一张可计算的明细表、在 CRM 里嵌一个带公式的报价单。这要求的不是成品 App,而是可编程的引擎:能定制 UI、接自己的登录与数据库、改公式引擎。Univer 的开源核心(@univerjs/* 包,Apache-2.0)就是冲这个场景来的。
二、是什么:一个运行时,六类工具
Univer 1.0 的核心主张是”六类工具、一个运行时”,共享同一份存储与计算:

- Spreadsheet(电子表格):类 Excel 界面,官方称支持 500+ 函数、跨表引用、排序筛选、冻结行列、富文本单元格;
- Docs(文档)、Slides(幻灯片);
- Canvas / Boards(画布白板);
- Relational Table / Bases(多维表);
- PDF Editor(PDF)。
关键是它们活在同一个 .univer 文件里:一张幻灯片里能嵌一个实时表格、文档能引用其数据源、画布把它们布局在一起;数据源一变,引用处同步更新。人(humans)和 AI Agent 可以在同一文件里协同编辑,每次改动可追溯。
三、技术机制
Univer 的几个工程要点(官方与发布说明):
- Canvas 渲染:用画布而非 DOM 渲染复杂表格布局,以在大数据集下保持交互性能;
- 同构数据模型:同一套文档逻辑既能跑在浏览器里,也能跑在 Node.js 无头(headless)环境——这是它能提供 Server SDK、做服务端计算与导出的基础;
- 插件 + 命令系统 + Facade API:编辑器通过插件扩展,对外暴露统一的 Facade API;
- 协同算法:Spreadsheet SDK 使用面向表格的 OT(操作转换)协同算法,带冲突处理、历史记录,官方称支持 200 个同时在线编辑者;
- AI SDK / Multi-Agent Worktrees:1.0 新增 Server SDK 与 AI SDK,并支持多个 Agent 在同一文件的隔离 worktree 上并行工作、由人审阅合并。
四、关键事实
| 维度 | 官方口径 |
|---|---|
| 出品方 | DreamNum(梦想数科) |
| 开源协议 | 核心 @univerjs/* 为 Apache-2.0 |
| 1.0 编辑器数量 | 六类:Sheets、Docs、Slides、Boards(Canvas)、Bases(Relational Table)、PDF |
| 表格函数 | 500+ |
| 协同 | 表格 OT,官方称 200 人同时编辑 |
| 运行环境 | 浏览器 + Node.js 无头(同构数据模型) |
| 扩展 | 插件/命令系统、Facade API、主题、i18n、框架适配器 |
| 商业层 | Univer Pro 为商业扩展,与开源核心明确分层 |
五、口径与局限批判
选型 Univer 时要读清它的边界:
- 开源核心与 Univer Pro 是分层的:核心 SDK、插件系统、渲染/公式引擎、Facade API 属开源;更高级的能力(部分企业级协作、AI、特定插件)在商业 Pro 层。免费能用,但做完整产品要核对哪些能力在 Pro 里。
- “6 类工具一个运行时”是 1.0 的新承诺:1.0 刚发布,长文档排版、大表格计算、Office 文件兼容性、移动端编辑都是本次才改进的方向,成熟度需要真实项目检验。
- Excel 兼容不是 100%:500+ 函数不等于完整复现 Excel——复杂宏、VBA、老旧 .xls、特定图表,仍可能需要你自行适配;官方的定位是”类 Excel 体验”而非”Excel 克隆”。
- 可嵌入意味着可被折腾坏:高度可定制(自绘 UI、自接认证/数据库、改到引擎层)的另一面是集成工作量大,不是
npm i就能开箱成一个完整在线 Office。 - 200 人协同是官方指标:这是单表格 OT 场景的标称值,真实表现仍取决于你的后端同步架构与网络。
六、优势与局限
优势:
- 真·可嵌入:Apache-2.0 核心,可自托管、接自己的认证与数据,不被托管 SaaS 绑架;
- 一栈多端:表格/文档/幻灯片/多维表/PDF 同运行时、数据互通,对做”类 Notion/飞书”产品的团队省大量重复造轮子;
- 同构 + Server SDK:可在服务端无头计算与导出,适合自动化流水线;
- 面向 Agent 时代:worktree 多 Agent 协同与人审合并,切中 AI 办公新场景。
局限:
- 高级能力在 Pro 商业层,成本要单独评估;
- 1.0 刚发布,生产稳定性与生态插件仍在成熟;
- Excel 兼容性有缺口,宏/VBA/老格式需自行处理;
- 集成成本不低,高度可定制 = 大量工程投入。
七、谁该用
- 要在自家产品里嵌表格/文档编辑能力的企业开发者:这是它最直接的目标;
- 构建”类 Airtable/飞书”协作产品的团队:六类工具同运行时省去拼装;
- 想让 AI Agent 直接读写结构化表格/文档的应用:其 Agent 友好的设计是差异点。
如果你的需求只是”网页上展示一个只读表格”,Univer 太重;但当你需要用户在你产品里编辑、计算、协同一份在线文档,又不想把命门交给某个在线 Office 厂商时,Univer 是目前开源阵营里最完整的一块拼图——只是要为 1.0 的成熟度和 Pro 分层留出预算与验证时间。