---
url: /univer/introduction.md
description: >-
  Univer是什么？国产开源Office SDK「给AI
  Agent的Office运行时」，表格/文档/幻灯片/白板/多维表/PDF六合一单一运行时，2026年9月24日发布1.0，Apache
  2.0可商用。SpreadsheetBench以68.86%登顶，超Excel Copilot。五分钟搞懂怎么把Office塞进你的产品
---

# 认识Univer —— 给AI Agent造的Office运行时，1.0刚刚发布

先说个我踩过的坑。

上周让 AI 帮我做季度复盘：读三张表的数、算增长率、出图、最后整成一份 PPT。它干得挺卖力，最后甩给我一个 `.xlsx` 和一句"已完成"。

我满怀期待打开——公式全是字符串 `"=SUM(B2:B10)"` 压根没算，图表是一张糊了的 PNG，单元格错位得像被人踩了一脚。那一刻我意识到：它不是不会算，它是**没法验证自己算得对不对**——它在一片漆黑里闭着眼写 Office 文件。

这不是个例，这是有榜单的。SpreadsheetBench 真实表格任务评测里：

* **人类：71.3%**
* **Copilot in Excel（Agent Mode）：57.2%**
* **Shortcut.ai：59.25%**
* **Bluebox：62.9%**
* **Univer：68.86%**

最强的 AI 和最弱的人类之间差了十几个点——这道坎就是"能不能真的上手干活"。而 Univer 那个 68.86%，是 2025 年 12 月刷出来的，**离人类只差 2.44 个点**。

> 大模型不是不会算 Excel，是它没有地方"算完之后看一眼"。给 Agent 一个能跑、能改、能截图的 Office 运行时，比给它的 prompt 里再塞一百遍"请仔细检查"有用得多。

就在**2026 年 9 月 24 日**，Univer 一口气切了 **v1.0.0、v1.0.1、v1.0.2** 三个版本（八小时内），把六个编辑器塞进同一个运行时，同时甩出了 **Server SDK** 和 **AI SDK**。当天冲上 GitHub Trending，单日涨星 1000+。

这个项目，值得你知道。

## 什么是 Univer

Univer 是一个**开源 Office SDK**——注意，是 SDK，不是软件。它的 slogan 现在挂在 GitHub 仓库最上面，写得极其嚣张：

> **The Office Harness for AI Agents**
> Spreadsheets · Documents · Presentations · Bases · Boards · PDFs

翻译过来：**给 AI Agent 用的 Office 马具。**

"Harness"这个词选得很妙。Agents 需要 harness（OpenAI 有 Codex Harness、DeepSeek 有 dsh），意思是"把模型套进去才能干活的那套缰绳和鞍"。Univer 给自己定位的不是"又一个在线表格"，而是**Agent 干活时踩的那块地板**。

前任视角更容易理解：**Univer 是 Luckysheet 的官方继任者**。如果你七八年前搞过国产在线表格，大概率用过 Luckysheet——创始人刘洋业余时间写的开源项目，GitHub 上一万六千多颗星，当年几乎是中文互联网唯一的自研网页表格答案。

后来刘洋去了飞书做电子表格技术负责人（透视表、图表这些核心模块是他做的），干完之后出来创办**上海梦数科技（DreamNum）**，2023 年立项重做，于是有了 Univer。团队几张牌很硬：

* **刘洋（CEO）**：前飞书电子表格技术负责人，Luckysheet 作者
* **沈伟敏（服务端负责人）**：华为核心网出身，飞书深圳前 20 号员工，帮飞书云盘 DAU 从 0 做到 100 万
* **闵成成（表格技术专家）**：8 年电子表格研发，原葡萄城 SpreadJS 技术负责人、飞书表格团队

官方说创始团队在办公这件小事上**专注了 10 年以上**，Luckysheet + Univer 家族累计 GitHub Star **3 万+**（其中 univer 主仓库 1.7 万+）。

### 一句话划清界限

> Excel 和 WPS 是整车，Univer 是发动机加底盘。

它不给你一个成品 App，它给你一套零件，让你在自己产品里造车——长什么样、卖多少钱、要不要登录，全你说了算。所以它的典型用户从来不是普通办公人员，而是**要在自家系统里嵌 Office 能力的厂商和平台团队**。

### 硬指标（截至 2026 年 9 月 27 日）

* **最新版本**：`v1.0.2`（1.0 系列于 2026-09-24 发布，同日连发 v1.0.0 / v1.0.1 / v1.0.2）
* **GitHub Star**：univer 主仓库 1.7 万+，家族累计 3 万+；9 月 24 日登 GitHub Trending
* **许可证**：**Apache 2.0**，商用免费（存在独立的商业层 Univer Pro）
* **开发语言**：TypeScript（98%+），Canvas 渲染引擎 + Web Worker
* **出生**：Luckysheet 作者团队，2023 年立项，主打 AI 原生网页表格

⚠️ **一个必须提醒的坑**：从 **0.25 升上来是大版本**，官方明确写了"有 API 移除和包名变更"，现有集成**必须先读 Breaking changes 和迁移指南**再升。别手贱一路 `pnpm up`。

## 1.0 到底发了什么：六个编辑器，一套运行时

这是本次最值得说的事。过去"六合一"是 PPT 上的愿景，**1.0 真的把它做出来了**，而且它们共用同一套插件系统、同一套命令系统、同一套数据模型：

| 编辑器 | 1.0 里新了什么 |
| --- | --- |
| **Sheets 表格** | 重做的公式引擎，支持 3D 引用与跨工作簿引用、公式驱动的图形、增强的透视表分析与 PivotChart |
| **Docs 文档** | 现代/传统两种编辑模式，章节与分页改进，目录、脚注、内容控件、LaTeX、行内计算公式 |
| **Slides 幻灯片** | 重写的编辑流：母版、版式、表格、图表、可编辑 SmartArt、演示模式 |
| **Boards 白板** | **全新**：画布式流程图与脑图，图形、连接线、容器，支持导入 Mermaid |
| **Bases 多维表** | **全新**：结构化数据工作区，网格/看板/日历/甘特四种视图，关联记录、层级、透视视图、仪表盘 |
| **PDFs** | **全新**：PDF 查看与编辑器，页面管理、文本、图片、表格、批注、导出、打印 |

真正让我愣住的倒不是上面这张清单，而是写在它旁边的一条：**嵌入进去的文档，还可以继续编辑**。

一份 Doc 里嵌一张 Sheet，这张表不是截图，是可继续改单元格、继续跑公式的活表；一页 Slide 里嵌一块 Board，脑图工具照样能用。文档还能作为工作簿的标签页、幻灯片页列表里的一条、多维表记录里的一项。**嵌入文档各自保留自己的数据模型，靠引用互相挂在一起。**

> 过去 Agent 处理复合文档的流程是「读格式 A → 转成中间层 → 拼成格式 B → 祈祷」。Univer 把这个链条砍成一句话：它们在同一个运行时里，本来就是活的。

顺带一提，我觉得 **Boards 支持导入 Mermaid** 这个细节特别聪明。让 Agent 直接用 Mermaid 语法把图生成好，一秒钟变成可拖拽的结构图——这才是给 Agent 用的接口该有的样子。

## Univer 的核心特点

* **六个编辑器，一个集成模型**：选你需要的编辑器，接到你自己的导航、账号、业务数据上，不用一家家买 SDK
* **官宣 Excel 级性能**：官网口径是 Rust 版公式运行时、**500+ 内置函数**、**100 万条公式秒级算完**、**1000 万单元格浏览器渲染流畅滚动**、**百万行透视表毫秒级聚合**
* **浏览器 / Node.js 双栖同构**：浏览器里渲染编辑器，Node 里 headless 跑同一套代码；表单批改、批量换算这类重活扔服务端就行
* **Canvas 渲染而非 DOM**：老一代网页表格卡在哪？单元格一多 DOM 节点爆炸，滚动掉帧。Univer 把整张表画在一块 Canvas 上，配合虚拟滚动只画视口
* **Facade API**：Office 应用的复杂度高得离谱，官方包了一层高层门面 API，常用操作不用你去啃内核
* **命令（Command）驱动**：所有数据修改必须走命令，这也是撤销/重做和协同编辑能落地的根因
* **三种 SDK 分层**：Web SDK（嵌编辑器 + 插件扩展）、**Server SDK**（协同与文件转换，对接你自己的身份、权限、存储）、**AI SDK**（TypeScript 写 Office CLI 与 Agent 工作流）
* **给 Agent 的配套设施**：`univer-mcp`（MCP Server，让自然语言直接驱动 Univer Sheets）与 `univer-sdk-skills`（可复用的 Agent Skills）
* **Worktree 多智能体并行**：多个 Agent 各自在隔离的工作树上改同一份文件，人来 review 后合并
* **Git 式版本历史**：每次改动可追溯、可回滚、可控合并
* **Agent 自验证**：Agent 自己设校验条件、自己测试输出、不达标就迭代
* **人机共编**：人和 Agent 同时改同一份文件，官方口径协作支持 **200 人同时在线编辑**（表格走的是专门为表格设计的 OT 算法）
* **高保真导入导出**：XLSX、DOCX、PPTX、CSV、TSV、PDF 等
* **自托管优先**：部署在你自己的基础设施上，不要第三方账号，数据不出你的环境
* **可白标**：无水印，主题、裁剪、国际化、NPM 包全开放

## 谁在用、用在哪

### 先放一组硬数据

前面提过 **SpreadsheetBench**：真实世界表格任务准确率，**Univer 68.86%（pass@1）**，力压 Bluebox（62.9%）、Shortcut.ai（59.25%）和 Copilot in Excel 的 Agent 模式（57.2%），距人类（71.3%）只差 2.44 个点。榜单日期是 2025 年 12 月，官方标注 #1。

第二组是 **GDPval**：1,320 个真实任务、横跨 44 个职业，其中 220 个开放任务、**75 个是表格相关**。Univer 明确说这个评测**用于内部持续迭代**——意思是它不是一次性 PR 素材，是日常回归跑分。这种态度我挺买账的。

至于**性能数字**（500+ 函数、百万公式秒级、千万单元格流畅滚动、百万行透视毫秒级），老实说这是厂商自己跑的分，**听听就好，别写进招标文件**。但方向没问题：网页表格想追桌面体验，Canvas 这条路绕不开。

### 四个典型场景，按推荐度排

* **Agent 产物载体（最推荐的用法）**：你做了个数据分析 Agent，别再让它吐 xlsx 了。让它直接写进 Univer 的实例里——**公式能重算、图表能改、还能截图自己看一眼对不对**。这就是 AI SDK 存在的全部理由。
* **BI / 内部中台 / 数据看板**：这是 Univer 最舒服的位置。用户再也不用"导出成 Excel → 本地改完 → 再传回来"，直接在页面上改，顺带省掉一轮极易出错的手工同步，还能把"散落在员工电脑里的几千张业务表格"收拢进系统统一管理。创始人刘洋当年在保险公司做数据分析师时，痛的就是这件事。
* **AI 原生 SaaS 产品**：梦数自己的商业产品叫「表答」（biaoda.me），走的就是"数据采集 + 表格计算 + AI 推理"一体化——社媒爆款归集、脚本生成、竞品收集这类活儿，几分钟跑完一条本来纯人工的流水线。
* **私有化 / 信创办公**：数据不出内网、可深度定制、Apache 2.0 没有版权雷。这个场景 Univer 比"套壳 OnlyOffice"轻太多。

反过来说，**纯静态报表渲染就别上 Univer 了，那是重炮打蚊子**。它值得你付的那份复杂度，只有在你也确实需要"可编辑、可协同、可扩展"的时候才回本。

### 但有句实话必须说

但我劝人上 Univer 之前，一定会先把三件事说清楚：

1. **开源版不是全功能**。官方 README 的能力矩阵写得很清楚：**实时协同、编辑历史、导入导出、打印、图表、透视表、形状、数据连接器、服务端计算**这些，标在 **Univer Pro** 商业层。（注意 1.0 Release Notes 里也提到了图表和透视的增强，**开源到底覆盖到哪，请以仓库 README 的能力矩阵和包名上的 License 为准，别在采购前想当然**。）
2. **1.0 是破坏性升级**。从 0.25 上来有 API 移除和包结构调整，老集成必须读迁移指南。
3. **别一上来就插件模式**。虽然精细可控，但十几行 `registerPlugin` 会让你在还没跑通之前就耗尽耐心。Preset 模式先用起来。

> 开源商业化的规矩从来是"核心免费，企业功能收费"，Univer 走的是"核心开源 + Pro 商业扩展"这条明路。这没什么不好——总比某天突然把协议换成 AGPL、让全行业的法务一起加班强。

## 初体验：两条命令跑起来

最快的方式是官方给的 StackBlitz 在线 playground，**不用装任何东西**：[📊 Univer Sheets](https://stackblitz.com/edit/univer-sheets-vite)。想先看看再决定，点开就行。

要在自己项目里集成，**Preset 模式**是官方推荐路径——装两个包，调一次 `createUniver`：

```bash
pnpm add @univerjs/presets @univerjs/preset-sheets-core
```

```ts
import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
import UniverPresetSheetsCoreZhCN from '@univerjs/preset-sheets-core/locales/zh-CN'
import '@univerjs/preset-sheets-core/lib/index.css'

const { univer, univerAPI } = createUniver({
  locale: LocaleType.ZH_CN,
  locales: {
    [LocaleType.ZH_CN]: mergeLocales(UniverPresetSheetsCoreZhCN),
  },
  presets: [
    UniverSheetsCorePreset({
      container: 'app',
    }),
  ],
})

univerAPI.createWorkbook({})
```

页面里留一个容器就够了，**记得给高度，不然你会看到一个高度为 0 的表格然后怀疑人生**（别问我怎么知道的）：

```html
<div id="app" style="height: 100vh"></div>
```

跑起来之后，我建议你做的第一件事是把 API 挂到全局：

```ts
// 打开浏览器控制台，直接用 univerAPI 试着改单元格、订阅事件
window.univerAPI = univerAPI
```

对着控制台玩 Facade API，比翻文档快十倍。玩上十分钟你就会发现，`univerAPI` 返回的就是官方说的**面板 API（Facade API）**——常用能力基本都从这里进（具体方法名以官方 Facade API 参考为准）。

再往前一步是 Node 里的 headless 模式：不开 UI，服务端直接打开工作簿、跑公式、改数据、导出。批处理报表、夜间批量换算这类脏活累活，放这儿最合适。**要求 Node.js >= 18.17.0。**

最后提醒两个兼容性细节：浏览器目标编译到 **Chrome 88**，Edge ≥ 88、Firefox ≥ 90、Safari ≥ 14.1、Electron ≥ 12；某些运行时缺 `Intl.Segmenter`，需要补 `@formatjs/intl-segmenter` 这类 polyfill。构建工具官方推荐 **Vite / esbuild / Webpack 5**（Webpack 4 不支持 `package.json` 的 `exports` 字段会折腾你一把）。视图层基于 **React 18**，支持 18/19。

想深挖就看 [docs.univer.ai](https://docs.univer.ai/)，觉得有意思顺手给 `dream-num/univer` 点个 Star——Luckysheet 那批人的下一个十年，值得看一眼。

> 入门别贪多：先把它当成"能在你自己网页里跑的、可二次开发的 Excel 内核"用起来。等吃透了命令系统和 Facade API，再谈让 Agent 接管。

## 进阶

更多开源技术干货和学习资料，关注公众号「遇码」，领取专属福利。