Univer：面向 AI Agent 的嵌入式办公 SDK，2 万星，v1.0 本周发布

开源仅供学习：本文所涉项目均来自公开仓库，分析仅供技术研究。

---

定位：不是 Google Sheets，是可嵌入的办公引擎

Univer 经常被描述为「开源 Google Sheets 替代」，这个描述是错的。Google Sheets 是一个 SaaS 产品；Univer 是一个 TypeScript SDK——你拉包进来，组装出自己的办公体验，嵌到自己的产品里。

更准确的对比对象是 Handsontable 或 AG Grid 这类表格组件库，但 Univer 的覆盖面宽得多：表格（Spreadsheet）、文档（Docs）、演示（Slides）、画布（Canvas）、关系表（Relational Table）、PDF，六种编辑器统一在一套运行时里。

仓库：github.com/dream-num/univer
Stars：~20,000 | License：Apache 2.0 | 语言：TypeScript | 创建：2022-09-29 | v1.0.2 发布：2026-09-24

作者：DreamNum，中国公司，2020 年 2 月成立，78 位贡献者，专业工程团队。npm 月下载量约 190 万（@univerjs/core），732 个 npm 版本（2023 年 1 月至今，约每 1.5 天一个版本）。

---

为什么 v1.0 重要

在 v1.0 之前，所有使用都是预发布状态。v1.0 发布于 2026-09-23，DreamNum 的博文标题是「Six Editors, One Programmable Office SDK」，标志着 API 稳定性承诺的开始。Univer 的项目有 docs/API_STABILITY.md 文件，区分 Stable/Experimental/Internal API 三层，v1.0 的 Stable API 层正式进入破坏性变更有序管理。

---

架构：60 个包，逻辑与 UI 分离

monorepo 下 60 个 npm 包，每个功能均采用「逻辑包 + UI 包」分离模式：

@univerjs/sheets         ← 无头逻辑（Node.js 可运行）
@univerjs/sheets-ui      ← 浏览器 UI（依赖 React）
@univerjs/docs           ← 无头逻辑
@univerjs/docs-ui        ← 浏览器 UI
...

这个拆分是「等构架构」（Isomorphic）设计的核心——Agent 在 Node.js 里跑 @univerjs/sheets 处理数据，浏览器里渲染 @univerjs/sheets-ui 给用户看，两边使用同一套 Facade API。

技术栈：Canvas 自定义渲染引擎（不是 DOM 渲染）、独立公式计算引擎、依赖注入容器 + 插件注册表（VS Code 风格）。

集成方式：

• Preset Mode（推荐入门）：@univerjs/preset-sheets-core 打包好常用插件，最少配置
• Plugin Mode（完全控制）：手动导入 14+ 包，精确控制功能范围和 bundle 体积
• Headless Mode：仅逻辑包，Node.js 服务端处理

---

AI Agent 的三个实际接入点

1. 无头 Node.js 运行时

Agent 可以在 Node.js 里加载工作簿、跑公式、读写单元格、处理文档——不需要浏览器。同一套 Facade API 在浏览器和 Node.js 上行为一致。

import { Univer, UniverInstanceType } from "@univerjs/core";
import { defaultTheme } from "@univerjs/design";
import { UniverSheetsPlugin } from "@univerjs/sheets";
import { FUniver } from "@univerjs/sheets/facade";

const univer = new Univer({ theme: defaultTheme });
univer.registerPlugin(UniverSheetsPlugin);
const univerAPI = FUniver.newAPI(univer);

2. Facade API 程序化操作

Agent 通过 FUniver 获得类型安全的操作接口：工作簿、工作表、范围选择、公式、命令监听、事件订阅。不需要解析 HTML 或操纵 DOM。

3. Worktree（工作树）隔离编辑

这是 Univer 为 Agent 场景设计的最独特功能：Agent 在文档的独立草稿分支上编辑，人类审批后合并。类似 git worktree 的概念应用于办公文档。

注意：Worktree 需要协作套件，是 Pro 付费功能。

---

关键数字与采用信号

指标	数值
Stars	~20,000
Forks	1,696
Contributors	78
npm 月下载（@univerjs/core）	~190 万
npm 版本数	732 个（2023-01至今）
v1.0.2 发布	2026-09-24
关系表字段类型	22 种
图表类型（Pro）	31 种
公式支持	500+

下游采用信号：

• dsh-univer-office（DeepSeek Harness 插件，420 stars）：DSH 用户把 Univer 作为 AI Agent 的办公层
• univer-workspace（1,659 stars，2026-08 开源）：基于 Univer 的自托管协作工作区参考实现
• Luckysheet 迁移路径：Luckysheet 是曾经流行的中文开源表格项目，已停止维护；DreamNum 发布了 Luckysheet→Univer 的迁移指南，接收这部分用户

---

四个核心红旗

1. xlsx 导入/导出是 Pro 付费功能

这是最重要的限制。如果你想打开一个真实的 .xlsx 文件，或者把编辑结果保存成 Excel 格式——这需要 Univer Pro。开源核心给你编辑器，但最基础的格式互通是付费的。

对大多数生产场景，这是一个严重的实用门槛。

2. Worktree（AI Agent 隔离编辑）需要 Pro

项目对外宣传的核心 AI 场景——Agent 在独立工作树编辑、人类审批合并——需要协作套件，是 Pro 功能。开源版本的 Agent 可以读写，但缺少隔离草稿 + 人类审批的完整工作流。

3. Slides 仍在开发中

六种编辑器里，演示文档（Slides）是最不成熟的。功能页面列了丰富特性，但开源包里只有基础数据模型。

4. v1.0 刚发布三天

所有此前的使用都是预发布状态。API 稳定性承诺刚刚开始生效，Experimental 和 Internal API 仍有可能变化。v1.0 是里程碑，不是历史验证的稳定版本。

---

Plugin Mode 的安装现实

如果你选 Plugin Mode（完全控制），基础 Spreadsheet 功能需要手动导入 14+ 个包：

import { Univer, UniverInstanceType } from "@univerjs/core";
import { defaultTheme } from "@univerjs/design";
import { UniverDocsPlugin } from "@univerjs/docs";
import { UniverFormulaEnginePlugin } from "@univerjs/engine-formula";
import { UniverRenderEnginePlugin } from "@univerjs/engine-render";
import { UniverSheetsPlugin } from "@univerjs/sheets";
import { UniverSheetsFormulaPlugin } from "@univerjs/sheets-formula";
import { UniverSheetsFormulaUIPlugin } from "@univerjs/sheets-formula-ui";
import { UniverSheetsNumfmtPlugin } from "@univerjs/sheets-numfmt";
import { UniverSheetsUIPlugin } from "@univerjs/sheets-ui";
import { UniverUIPlugin } from "@univerjs/ui";
// ... 更多包

这是 bundle 体积的直接成本。Preset Mode 把这些打包好，牺牲控制粒度换取简单性。

---

综合判断

Univer 是目前开源世界里唯一一个在 TypeScript 生态中认真做「可嵌入 + 可无头 + 为 AI Agent 设计」的全面办公 SDK。Canvas 渲染引擎、同构架构、Facade API——这套技术体系建立了 6.5 年，不是 AI 浪潮来了之后的应急改造。190 万月下载量说明它已经在生产中被使用。

使用前需要接受两个前提：xlsx 互通和 Worktree AI 工作流都是 Pro 的，开源核心是编辑引擎，不是完整的 AI Agent 工作流平台。如果你在做需要嵌入表格/文档功能的 B 端 SaaS，开源核心够用；如果你想让 Agent 走完整的「编辑→审批→合并」流程，需要评估 Pro 成本。

---

开源仅供学习，商业使用请仔细核查许可证条款。

---

Univer: AI-Native Embedded Office SDK, 20K Stars, v1.0 Released This Week

Open source for learning only: All projects discussed are from public repositories.

---

What It Is: Not Google Sheets — An Embeddable Office Engine

Univer is not a Google Sheets replacement. Google Sheets is a SaaS product; Univer is a TypeScript SDK — you pull in packages and assemble your own office experience, embedded into your own product.

Six editors in one runtime: Spreadsheet, Docs, Slides, Canvas, Relational Table, PDF.

Repo: github.com/dream-num/univer
~20,000 stars | Apache 2.0 | TypeScript | v1.0.2 released 2026-09-24

DreamNum, Chinese company founded 2020, 78 contributors, professional engineering team. ~1.9M monthly npm downloads (@univerjs/core). 732 npm versions since 2023.

---

Why v1.0 Matters

All prior use was pre-release. v1.0 (Sept 23, 2026) marks the beginning of API stability promises, with explicit Stable/Experimental/Internal API tiers documented in docs/API_STABILITY.md.

---

Architecture: 60 Packages, Logic Separated From UI

Every feature splits into a headless logic package + browser UI package:

• @univerjs/sheets — runs on Node.js
• @univerjs/sheets-ui — browser only

This isomorphic design is what enables AI agents to run the same formula engine on a Node.js server that browsers use to render spreadsheets.

Tech stack: custom Canvas rendering engine (not DOM), dedicated formula engine, DI container + plugin registry (VS Code style).

---

Three Real AI Agent Integration Points

1. Headless Node.js runtime — agents load workbooks, run formulas, read/write cells in Node.js. No browser.

2. Facade API for programmatic editing — FUniver.newAPI(univer) gives typed, structured access to workbooks, worksheets, ranges, formulas, commands, and events. No HTML scraping.

3. Worktree for isolated editing — agent edits go into a draft branch of the document; a human reviewer merges. Git worktree semantics applied to office documents. Requires Pro.

---

Four Critical Red Flags

1. xlsx import/export is Pro-only. Opening a real .xlsx file or saving to Excel format requires Univer Pro. The OSS core gives you the editor; the most fundamental interop feature is paywalled.

2. Worktree (the core AI agent workflow) requires Pro. The isolated edit → human approval → merge workflow requires collaboration packages. OSS agents can read/write but lack the full workflow story.

3. Slides still under development. The least mature of the six editors despite appearing prominently in marketing.

4. v1.0 shipped 3 days ago. All prior usage was pre-release. Experimental API changes are still possible.

---

Adoption Signals

• dsh-univer-office (420 stars): DeepSeek Harness users actively using Univer as office layer for AI agents
• univer-workspace (1,659 stars): reference self-hosted workspace implementation
• Luckysheet migration path: DreamNum published migration guide from the now-abandoned popular Chinese OSS spreadsheet, capturing that user base

---

Numbers

Metric	Value
Stars	~20,000
Monthly npm downloads	~1.9M
npm versions (3 years)	732
Contributors	78
v1.0.2	Released 2026-09-24
Formulas supported	500+

---

Verdict

Univer is the only serious “embeddable + headless + AI-agent-oriented” comprehensive office SDK in the TypeScript ecosystem. The Canvas engine, isomorphic architecture, and Facade API were built over 6.5 years — this is infrastructure repositioned for AI, not an AI rebrand bolted onto a weekend project.

Accept two premises before using it: xlsx interop and Worktree AI workflows are Pro features. The OSS core is the editing engine, not a complete AI agent workflow platform. If you’re building B2B SaaS that needs embedded spreadsheet/doc functionality, the OSS core is capable. If you want agents to do the full edit → review → merge loop, evaluate Pro pricing.

---

Open source for learning only. Verify license terms before commercial use.