Univer 完全指南：15.8k star 开源 Office SDK，让 AI Agent 和你在同一个表格里干活

📅 2026-09-23 · ☕ 9 分钟阅读

先说结论：Univer 不是「又一个在线表格」，而是一套 Office SDK。它的官方定位写得很直白——The Office Harness for AI Agents（AI Agent 的 Office 层）。截至 2026-09-23，项目在 GitHub 上有 15,883 star、1,406 fork，Apache-2.0 协议，主语言 TypeScript，最近一次提交就在今天，最新版本 v0.25.2（2026-09-17 发布）。

如果你在做 SaaS、内部工具、BI 看板或 AI 应用，并且需要一个「能嵌进自己产品里」的表格/文档编辑器，那 Univer 值得花十分钟了解。它解决的不是"我该用哪个表格软件"，而是"我怎么把表格能力搬进自己产品，并且让 AI Agent 也能在这张表上干活"。

🔥 为什么 Univer 值得关注？

官方主打 AI Agent 场景 — 不是事后贴上一个「AI 助手」按钮，而是从头把"人和 agent 协作编辑同一份 Office 文件"当作设计目标
同一套运行时，浏览器和 Node.js 都能跑 — 前端渲染、服务端无头处理共用一套架构和 Facade API（等构设计）
插件化 + Canvas 渲染 + 自带公式引擎 — 能力按需组合或懒加载，不用为了一个表格背上整包
Apache-2.0 开源，可自托管 — 核心 SDK 在 GitHub 公开，另有 Pro/商业部分（见下文注意事项）
已经有人拿它做 agent 工作流 — 官方周边里就有 CLI、工作区和面向 agent 框架的集成项目

一、Univer 到底是什么

按官方 README 的说法：Univer 是用来在你的产品内部创建 Office 应用的 SDK。它给你的是构建块——表格、文档、演示、Bases、看板、PDF（标注为即将支持）——而不是一个固定 UI 的托管应用，也不强迫你把数据放到别人服务器上。

官方列出的适用场景很具体：

把表格/文档编辑能力嵌入 SaaS 产品、内部工具、BI 流程或 AI 应用；
在服务端跑工作簿/文档处理，且与浏览器端使用同一套架构；
用插件只组合自己需要的功能，或用 preset 快速起步；
通过自定义插件、命令、服务、UI 组件和 Facade API 扩展行为。

官方还特意澄清了一句：「Univer 不只是一个表格文件查看器，它是构建你自己生产力界面的框架。」这句话基本决定了它的定位——它不是给你用的成品软件，是给你开发用的基础设施。

二、为什么把它叫「AI Agent 的 Office 层」

这是 Univer 和同类开源表格项目最不一样的地方。官方在 README 里单独开了一节 Office Workflows for AI Agents，讲了三条 agent 协作能力：

能力	做什么
Programmatic editing（编程式编辑）	Agent 通过结构化 API 检查并修改 Office 内容，而不是"模拟人点鼠标"
Output verification（输出校验）	Agent 用内容检查、渲染截图、布局诊断来确认自己改对了
Worktree collaboration（工作树协作）	Agent 在隔离草稿里改，人审阅后决定合并哪些改动——像代码 PR 一样审表格

更直观的证据是官方周边项目清单（都由 Univer SDK 搭建）：

项目	定位
`univer-workspace`	面向人与 AI Agent 的 Office 工作区，支持共享编辑与审阅 agent 的改动
`univer-cli`	给 agent 用的本地命令行工作区：创建、编辑、检查、交付 Office 内容
`dsh-univer-office`	DeepSeek Harness 的 Office 插件，带内容连通、校验和隔离工作树
`workbuddy-univer-office`	WorkBuddy 的本地 Office 集成（开发预览版）
`openclaw-univer-office`	在 OpenClaw 里创建、审阅、交付 Office 内容的工具

可以看出他们的路线很明确：把"Office 文件"从一个只给人看的产物，变成 agent 能读、能改、能校验、能被审阅的工作对象。如果你的产品正在接 AI 能力，这层抽象迟早要用到，而现成能用的开源选项并不多。

三、核心能力一览

官方 README 里列出的几个关键特性：

技术特性

Built for large surfaces — Canvas 渲染 + 专用公式引擎，让复杂工作簿保持流畅
Plugin-shaped by default — 能力以插件形式交付，可增删替换、可懒加载
Headless for AI infrastructure — 在 Node.js 里跑工作簿和文档逻辑，支撑 agent、自动化和服务端流程
Unified Facade API — 工作簿、区域、公式、文档用同一套 API，浏览器和 Node.js 通用
Framework adapters — 可对接 React、Vue、Web Components
Dark-mode ready — UI 组件与渲染引擎都适配明暗主题

四、Preset 模式 vs Plugin 模式

Univer 提供两种集成粒度，这是它设计上比较讨巧的一点：

选哪种	适合什么情况
Preset 模式	想用最少配置快速跑起一个可用的表格/文档/Node 环境——安装 preset 包，样式和 Facade API 注册都打包好了
Plugin 模式	需要对包、依赖、懒加载、运行时组合做精细控制——按需装 `@univerjs/*` 各个包，自己注册插件

Preset 模式的起步代码大致是这样（官方 README 示例）：

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

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({})

页面里记得留一个容器：

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

需要精细控制时再切到 Plugin 模式——手动安装 @univerjs/core、@univerjs/sheets、@univerjs/engine-formula、@univerjs/ui 等包，逐个注册插件和样式。完整步骤见官方文档的 Installation & Basic Usage 指南。

五、和常见方案差在哪

方案	定位差异
Google Sheets / 飞书表格	成品在线协作产品，靠 API 或嵌入使用；Univer 给你 SDK 自己搭
OnlyOffice / Collabora	完整的 Office 套件（文档服务器），部署即用但定制空间有限；Univer 是前端框架级的可组合 SDK
Excel / WPS	桌面客户端与文件格式的事实标准；Univer 关注的是"把表格能力嵌进你的产品"
其余开源表格组件	多为"表格组件"单一形态；Univer 覆盖表格/文档/幻灯片/看板等多形态，并共用一套运行时

换句话说：如果你要的是一个能用的在线表格，直接用现成产品更省事；如果你要的是把表格能力做进自己产品、并且要给 agent 留接口，Univer 才是对的那一层。

六、优点与注意事项

👍 优点

Apache-2.0 开源，可自托管，不绑定托管服务
浏览器 + Node.js 同构，服务端无头处理不用另找方案
插件化 + preset 双模式，小项目快速起步、大项目精细裁剪
Canvas 渲染 + 自带公式引擎，面向大表场景设计
官方明确在做 agent 协作层（编辑/校验/工作树审阅），方向清晰
社区活跃：15.8k star、1.4k fork，近期几乎每天有提交

👎 注意

版本仍在 0.x（最新 v0.25.2），API 存在变动可能，生产接入要留升级余量
它是 SDK 不是成品应用——需要前端工程能力，不是装完即用的在线表格
开源范围与 Pro/商业能力有边界，实时协作、Web SDK、AI 等能力按官方说明另计授权
官方文档、示例以英文为主，中文资料较少
PDF 支持官方标注为"即将支持"，暂不可用

🎯 总结

Univer 的价值不在"又一个开源表格"，而在它把Office 内容变成了可编程、可校验、可审阅的对象——这正好是 AI Agent 落地时最缺的一层。做 SaaS 内嵌编辑器、内部工具、或者正在给 agent 找"能干活的工作台"，值得进候选清单；只是想找个在线表格用，那它不是为你准备的。

FAQ

Q: Univer 是免费的吗？

核心 SDK 在 GitHub 上以 Apache-2.0 开源，可自托管。官方 README 同时区分了开源与 Pro 范围，部分能力（如实时协作、Web SDK、AI 相关）按官方说明需要相应授权，接入前建议先看清各项目的许可说明。

Q: 它能替代 Excel 或 Google Sheets 吗？

不是同一层的东西。Excel/Google Sheets 是给终端用户的成品产品；Univer 是给开发者的 SDK，用来把表格能力做进自己的产品。两者可以共存——很多团队是用 Univer 做一个"自己的表格界面"。

Q: 需要什么技术栈？

TypeScript/JavaScript。前端可用 React、Vue 或 Web Components；服务端逻辑可在 Node.js 里跑同一套运行时。官方提供 preset 模式降低起步成本。

Q: 怎么让 AI Agent 在表格里干活？

官方提供三层能力：agent 通过结构化 API 编程式编辑内容、用渲染截图与布局诊断校验结果、在隔离工作树里改动再由人审阅合并。集成细节见官方 AI SDK 文档。

Q: 现在适合上生产吗？

项目迭代非常活跃（最近提交就在当天），但版本号为 0.x，接口仍在演进。建议先做 PoC 验证核心场景，并把 SDK 版本锁定，再考虑逐步放量。