19k Star 的 Univer:把 Excel、Word、PPT 装进你自己的应用,还给 AI Agent 留了位置

在自己的产品里嵌一个能用的表格编辑器，是很多团队干过的苦活。dream-num 开源的 Univer 用一套 SDK 把表格、文档、幻灯片、多维表格全塞进一个运行时，19.3k Star，Apache-2.0 协议，现在还专门为 AI Agent 设计了无头模式。

Univer 六大文档形态

嵌 Office 功能，到底有多难

做 SaaS 的团队几乎都遇到过这个需求：客户要求"像 Excel 一样"编辑数据，或者"像 Word 一样"写富文本。

真上手才知道水深。开源方案要么是纯查看器，改不了内容；要么性能拉胯，几千行数据就卡成幻灯片；商业方案按域名收费，还要过法务审。自己从零造一个？公式引擎、协同冲突、撤销重做，每一个都是无底洞。

Univer 的思路是不做产品、做底盘。它是一个 Office SDK：电子表格、文档、幻灯片、多维表格（Bases）、画板、PDF（开发中）共用同一个运行时，你要哪块就装哪块，全部插件化。

三个技术决策值得记住：

Canvas 渲染。Univer 没有用 DOM 渲染表格，而是自研 Canvas 渲染引擎，大规模工作簿依然流畅——这是它和一堆"网页表格库"拉开差距的地方。

同构设计。同一套架构，浏览器里跑带 UI 的编辑器，Node.js 里跑无头模式（headless），服务端照样能算公式、处理工作簿。

统一 Facade API。不管在浏览器还是 Node，操作工作簿、区域、公式、文档都是同一套高层 API，学习成本只付一次。

三个技术决策

给 AI Agent 留的位置

Univer 现在的官方口号是 The Office Harness for AI Agents，AI Agent 不是后补的，是设计进去的。

具体怎么配合？三条通路：

• 程序化编辑
  ：Agent 通过结构化 API 检查和修改 Office 内容，不碰 UI
• 输出验证
  ：Agent 干完活之后可以渲染截图、检查内容、跑布局诊断，自己确认结果对不对
• Worktree 协作
  ：Agent 在隔离的草稿区干活，人类审核后再决定合并哪些改动

生态也跟上来了：Univer Workspace（可自托管的协作空间）、Univer CLI（本地命令行工作台）、univer-mcp（用自然语言驱动表格），甚至有 DeepSeek Harness 和 OpenClaw 的官方 Office 插件。AI 应用要在文档表格里干活的场景，这条路线已经打通了。

AI Agent 三条通路

上手教程：两种姿势，都给你

项目地址 

https://github.com/dream-num/univer ，

文档 https://docs.univer.ai （有中文）。

上手三种姿势

姿势一：Preset 模式，五分钟跑起来

官方把常用插件打包成了 Preset，适合快速起步。以表格核心包为例：

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

页面放一个容器：

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

初始化代码总共十来行：

import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core' import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US' import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'  import '@univerjs/preset-sheets-core/lib/index.css'  const { univerAPI } = createUniver({   locale: LocaleType.EN_US,   locales: {     [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),   },   presets: [UniverSheetsCorePreset({ container: 'app' })], })  univerAPI.createWorkbook({})

跑起来就是一个能编辑、能写公式的表格，暗色模式都自带。

姿势二：Plugin 模式，精细控制

产品要上线时，Preset 可能带了你不需要的东西。Plugin 模式让你手动挑选每个包：

pnpm add @univerjs/core @univerjs/design @univerjs/ui \   @univerjs/sheets @univerjs/sheets-ui \   @univerjs/sheets-formula @univerjs/sheets-formula-ui \   @univerjs/engine-formula @univerjs/engine-render \   @univerjs/docs @univerjs/docs-ui

然后逐个 registerPlugin 注册渲染引擎、公式引擎、UI 插件，按需懒加载。包体积、加载时机、依赖关系全在你手里。两种模式可以混用：起步用 Preset，后面逐步替换成 Plugin 组合。

一个容易踩的坑：==所有 @univerjs/* 包必须保持同一版本号==，它们是同一条发版线上协调发布的，混版本会出诡异问题。

姿势三：无头模式，服务端跑

AI Agent、自动化报表、批量数据处理用这条路径，Node.js >= 18.17：

// Node 环境下创建工作簿、写公式、算结果，全程无 UI const { univerAPI } = createUniver({ presets: [/* Node preset */] }) const workbook = univerAPI.createWorkbook({})

想要本地体验完整功能的话，直接 clone 仓库：

git clone https://github.com/dream-num/univer.git cd univer pnpm install pnpm dev

pnpm dev 会启动一个包含表格、文档、幻灯片的 all-in-one 开发台。注意仓库本身开发要求 Node.js >= 22.18、pnpm >= 11。

开源 vs Pro 边界

开源免费，但有边界

这是用 Univer 前最该搞清楚的一张表：

开源部分在 Apache-2.0 下独立可用，Pro 不装也不影响公开 API。但如果你要的是"开源版顶替 Excel 全家桶"，实时协作和 xlsx 导入导出这两关绕不过去，选型前先想清楚。

写在最后

Univer 占的位置挺聪明：往下，它是性能过硬的表格/文档渲染底盘；往上，它把自己包装成 AI Agent 的 Office 工具层。两个浪潮——应用内嵌生产力场景、Agent 操纵文档——它都踩在浪尖上。

适合谁？要在产品里嵌表格或文档编辑、又不想被商业方案绑死的团队；要做 AI Agent 处理 Office 内容的团队。不适合谁？只想找个免费 xlsx 查看器的人——那是另一个需求。

项目地址：

https://github.com/dream-num/univer

文档：https://docs.univer.ai