ARTICLE · 1395284
一周新增7539星,这个开源SDK把Office搬进你的产品
这一年,AI 办公格外热闹。模型能写文档、能算表格,可真要把这些能力塞进自己的产品里,真正卡住的是那个能让人点、能改、能协作的 Office 界面。
做一个能编辑的表格,光公式计算和撤销重做就够一个小团队喝一壶。单元格样式、合并单元格、冻结窗格这些看着不起眼的能力,堆起来也是一笔不小的工程量。多数团队卡在这儿:产品需要一个办公模块,自己写不起,用现成的又拼不进自己的数据权限体系。
最近翻到一个开源项目 Univer,它把表格、文档、幻灯片这些编辑能力做成了一套 SDK,让你直接嵌进自己的产品,数据和权限都归你。这周它新增了 7539 颗星。
GitHub:https://github.com/dream-num/univer
它是一个开源的 Office SDK,为人和 AI Agent 提供编辑、计算、协作和文件处理能力。目前已斩获 31001 星、2828 个 Fork,用 Apache-2.0 协议开源,更新很勤,11 月 7 日到 21 日就发了五个版本。

▍装上依赖,跑起表格
先看最想知道的:能不能快速跑起来。
打开一个用 Vite 构建的浏览器项目,终端里敲一行 pnpm add @univerjs/presets @univerjs/preset-sheets-core。在页面上放一个装编辑器的容器,再写几行初始化代码,指定语言、挂上 Sheets 核心预设、把容器 id 传进去,最后建一个空工作簿。
刷新页面,一个能编辑的表格就出现了。选单元格、改内容、输入公式,都能用。单元格样式、合并单元格、冻结窗格这些基础能力也都在,日常用到的编辑操作基本齐了。这个例子只用开源包,不需要商业授权,也不需要 Server SDK。

起步这道门槛确实低,十几行代码就能把编辑器装进页面。不过它也只给了你一个空壳,真正值钱的是后面怎么接上自己的东西。
▍接通数据,改出结果
表格跑起来之后,下一步是让它和业务数据连起来。
Univer 提供了一层叫 Facade 的接口,专门给应用调用。拿活跃的工作簿和工作表,选中 A1 到 D4 这一片区域,把表头、数量、单价和金额写进去,金额那一列直接写成公式,比如 B2 乘 C2。数据验证、条件格式、筛选排序这些能力,也能通过同一层接口调用。
这里有个坑:新建的工作簿不能立刻动手写,得先等公式控制器进入稳定阶段,否则写入可能不生效。README 里专门用一段代码演示怎么监听生命周期事件,说明确实有人在这儿栽过。
等写完再读回来,数量一改,金额会自动重算。整个过程不用你手写计算逻辑,编辑器自己算好了。
有了 Facade,你的应用只管调用接口,不用碰内容模型、命令系统这些内部实现。只想快速接一个编辑器的人,能省不少事。
▍堆齐品类,一次编辑
只做表格不算办公。Univer 的产品家族铺得挺全:表格、文档、幻灯片、关系表、画布和 PDF 都覆盖到了。
它把能力拆成三块。Web SDK 是底座,管内容模型、渲染、公式计算和 Facade 接口;Server SDK 补上实时协作、编辑历史和文件导入导出;AI SDK 负责把办公能力接到现成的 Agent 和工作流上。这次刚发的 v1.6.0,给 Base 甘特图加上了计划排期和前置依赖,拖动条形图两端就能连出一条前置关系,还支持撤销和多人协作,遇到循环依赖会直接拒绝;移动端也能查看和编辑 PDF 了。
我挨个点开在线 demo 看了下,表格能排序筛选、文档能改段落格式、幻灯片能直接编辑,PDF 也能批注。这些界面不是效果图,是能上手点的真东西。



不过要留意,demo 展示的是完整的产品能力,比默认开源配置要多。哪些开源、哪些要商业授权,后面会说清楚。
▍拆开内核,按需扩展
如果你不只是想嵌一个编辑器,而是要改它、扩它,这层才是重点。
Univer 把内容模型、快照格式、插件和依赖管理、命令系统、公式引擎和渲染引擎都拆成了独立模块,自定义功能有自己的边界,外层应用通过 Facade 接口和事件跟它打交道。你想加一个自己的功能,不用把整个编辑器翻个底朝天,按插件的边界挂上去就行。
一个让我印象深的细节是跨功能的撤销重做。比如在一个带筛选的区域里插入一行,基础内容和筛选范围其实变了两个地方,撤销时得一起还原。它的命令系统会把各部分的改动和执行历史编排到一起,撤销一次就都回去了。
这套架构还允许在 Node.js 里做无界面处理——复用同样的内容插件、模型和计算能力,不挂编辑器也能批量改文件、跑自动化任务。
代价是概念不少。刚上手得先弄明白预设和插件的关系,把版本对齐——所有 @univerjs/* 包必须保持同一版本,混着用会出奇怪的问题。
▍看清边界,别踩坑
这篇最该讲清楚的一点,是开源到底开到哪。
这个仓库在 Apache-2.0 下开放的是 Web SDK 的核心架构和引擎:内容模型和快照格式、插件管理、命令系统、公式与渲染引擎、Facade 接口、UI 基础,加上表格和文档的编辑能力。
商业的 Web SDK 插件、Server SDK 和 AI SDK 扩展,是单独分发和授权的。前面提到的幻灯片、PDF、关系表这些 demo,展示的是完整产品能力,不等于你装完开源包就能全用上。这次更新还收紧了客户端和协作服务里的编辑、评论权限,团队用的话得连权限这一块一起看。
"开源 Office SDK"不等于整套办公套件免费。真正要上协作服务或者那些高级品类,得先去官网的功能对比页和授权条款里核一遍。这是我用下来最真实的一条限制——基础表格文档确实开源且能打,但别以为边界之外也白送。
▍写在最后
把 Office 编辑能力做成能嵌进产品的开源零件,这件事以前基本是大厂内部才玩得起。Univer 把它拆成了可以一行命令装上的 SDK,还把 Apache-2.0 的核心摆在了台面上。
如果你是个人开发者,想给自己的小工具加个能编辑的表格,从快速开始那十几行代码起步就够,先跑通再谈别的。
如果你在带团队搭内部的 AI 办公平台,建议照着它的参考应用 Univer Workspace 摸清结构,再把开源和商业的边界提前算明白,别等做了一半才发现某个能力要单独授权。
最近正在给 Agent 产品找一层"能落在真实文件上"的编辑能力、或者被自研表格编辑器折磨过的团队,值得花半小时跑一遍它的在线 demo。
GitHub 项目地址:https://github.com/dream-num/univer 官网:https://univer.ai 文档:https://docs.univer.ai 功能对比:https://univer.ai/compare/
今天的分享到此结束,感谢大家抽空阅读,我们下期再见,Respect!
















































































