夜雨聆风学习资料网

ARTICLE · 1367060

Univer:开源 Office SDK,让 Excel、Word 与 AI Agent 融入业务系统

Univer:开源 Office SDK,让 Excel、Word 与 AI Agent 融入业务系统

Univer:开源 Office SDK,让 Excel、Word 与 AI Agent 融入业务系统

在线表格、文档编辑器是企业软件中常见的基础能力。自行开发一套完整的 Office 系统,需要处理内容模型、公式计算、页面渲染、撤销重做、文件兼容和多人协作等复杂问题。

Univer 是 DreamNum 团队开源的 Office SDK,采用 TypeScript 和插件化架构,为开发者提供电子表格、文档、演示文稿等办公能力。它既可以嵌入现有 Web 应用,也支持在 Node.js 环境中进行无界面文档处理,还能通过结构化 API 接入 AI Agent。

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

一、亮点速览

  • • 多产品支持: 提供 Sheets、Docs、Slides、Boards 等办公组件。
  • • 插件化架构: 功能模块可以独立注册、组合和扩展。
  • • 统一内容模型: 使用结构化数据描述工作簿、文档和演示文稿。
  • • 公式计算引擎: 支持公式解析、依赖管理和增量计算。
  • • Headless 模式: 支持在 Node.js 环境中执行办公内容处理。
  • • AI Agent 集成: 通过 Facade API 提供结构化的文档读取与编辑入口。

二、核心架构:插件化与统一内容模型

Univer 的技术架构主要由 Core Framework、产品插件和功能插件组成。

Core Framework 提供依赖注入、插件生命周期、命令管理和基础数据模型;产品插件负责 Sheets、Docs 等具体办公产品;功能插件负责筛选、格式化、数据验证等独立能力。

例如,电子表格的筛选功能可以拆分为业务逻辑插件和 UI 插件。前者负责筛选规则与数据处理,后者负责菜单和交互界面。

这种设计允许开发者按需加载功能,也可以针对业务场景开发自己的插件。

1. Command、Mutation 与 Operation

Univer 建立了一套分层操作体系,负责管理用户交互、数据变更和撤销重做。

类型
主要职责
应用场景
Command
编排完整业务动作
插入行、删除列
Mutation
修改持久化数据
修改单元格内容
Operation
修改临时交互状态
打开面板、调整视图

例如,插入工作表行时,Command 可以协调单元格数据变更和筛选区域调整,相关 Mutation 被统一执行并纳入撤销重做记录。

这种机制有利于保持不同插件之间的协作关系,降低业务模块的耦合程度。

2. 统一内容模型

Univer 使用结构化数据描述不同办公内容,主要包括:

  • • IWorkbookData:电子表格工作簿。
  • • IDocumentData:文档内容。
  • • ISlideData:演示文稿。
  • • IBoardData:画布及图形内容。

内容模型可以序列化为快照,用于保存、恢复和后台处理。

前端编辑器负责交互与呈现,业务系统可以直接通过数据模型读取和修改内容。这也为服务端自动化处理和 AI Agent 集成提供了基础。

3. Facade API

Facade 是 Univer 面向业务开发者提供的统一接口层。

常用对象包括:

  • • FUniver:管理 Univer 实例。
  • • FWorkbook:操作工作簿。
  • • FWorksheet:操作工作表。
  • • FRange:操作单元格区域。

通过 Facade,开发者可以读取单元格数据、写入内容、设置公式和调整格式,无须直接操作底层插件内部实现。

对于企业应用,这意味着可以将 Univer 封装为业务服务,连接数据库、报表系统和审批流程。

三、核心技术能力

1. Sheets:在线电子表格

Sheets 是 Univer 的核心组件之一,提供常见电子表格编辑能力。

主要包括:

  • • 单元格编辑、合并、格式设置和冻结窗格。
  • • 公式解析与计算。
  • • 数据排序、筛选和验证。
  • • 条件格式、查找替换和超链接。
  • • 撤销重做及相关交互操作。

公式引擎负责处理公式解析、单元格依赖关系和计算结果更新。当数据发生变化时,可以识别受影响的公式,减少无关计算。

2. Docs:在线文档编辑

Docs 提供富文本编辑和文档结构管理能力,支持文字样式、段落格式、有序列表、无序列表、超链接和批注等功能。

Docs 与 Sheets 共用部分底层基础设施,包括插件管理、内容模型和渲染能力,降低不同办公产品之间的重复开发成本。

3. Slides 与 Boards

Univer 还提供演示文稿和画布类产品:

  • • Slides: 用于幻灯片内容编辑和演示文稿制作。
  • • Boards: 用于流程图、图形布局和可视化画布。

产品体系还包括 Bases 等结构化数据应用。

需要注意,部分高级图表、数据透视表、协作和专业编辑功能属于商业扩展,具体可用范围应以对应版本的授权说明为准。

4. Canvas 渲染引擎

Univer 使用 Canvas 构建办公编辑界面,将内容模型与视觉呈现分离。

电子表格通常包含大量单元格、文字、边框、合并区域和浮动对象。Canvas 渲染体系能够统一管理这些内容的绘制和交互。

其渲染基础设施还可以在不同办公产品之间复用。例如,电子表格中的富文本内容可以使用 Docs 相关的布局与渲染能力。

四、Headless:在服务端处理办公文档

Headless 是 Univer 很有实用价值的一项能力。

传统在线编辑器通常依赖浏览器完成内容操作。Univer 将内容模型、插件和计算能力设计为可在 Node.js 环境中复用的基础设施。

典型处理流程:

业务数据 / 文档快照        ↓加载 Univer 内容模型        ↓注册所需插件        ↓调用 Facade / Command        ↓执行内容修改与公式计算        ↓生成新的数据快照        ↓保存或交给业务系统

适用场景包括:

  1. 1. 自动生成报表: 从数据库读取数据,创建工作簿并填充公式。
  2. 2. 批量计算: 加载工作簿,执行公式计算并获取结果。
  3. 3. 文档自动化: 根据业务模板修改文档内容。
  4. 4. 后台任务: 定时生成报表、处理快照和执行数据校验。
  5. 5. AI 自动化: 通过 API 让 Agent 读取和修改办公内容。

Headless 模式减少了后台任务对完整浏览器编辑器的依赖,适合报表平台和企业自动化系统。

五、AI Agent:让智能体操作 Office

Univer 的内容模型和 Facade API 为 AI Agent 提供了结构化的办公操作入口。

传统自动化工具经常通过模拟鼠标点击和键盘输入操作 Office 界面,容易受到页面布局变化影响。通过结构化 API,Agent 可以直接定位工作簿、工作表和单元格区域。

主要应用方式包括:

  • • 内容读取: 获取工作簿、文档及单元格信息。
  • • 内容编辑: 修改数据、设置公式和调整格式。
  • • 结果检查: 获取执行结果,结合渲染截图检查排版。
  • • 布局检查: 对演示文稿进行元素重叠、文字溢出等检查。

典型工作流程:

用户提出任务     ↓Agent 理解需求     ↓发现可用 API     ↓读取文档内容     ↓调用接口执行修改     ↓检查计算与渲染结果     ↓人工审核

开发者可以将 Facade API 封装成 Agent Tool,接入 LangChain、Eino 或自研 Agent 框架,实现 Excel 报表生成、数据分析和文档自动化。

完整 AI SDK 的部分工具封装和工作流能力属于独立扩展,开源 Web SDK 已提供自行开发所需的基础接口。

六、文件兼容与多人协作

办公软件的实际应用还涉及 Office 文件转换和多人协作。

Univer 通过 Exchange 相关模块处理外部文件与内部内容模型之间的转换,涉及 XLSX、XLS、CSV、DOCX、PPTX 等格式。

多人协作则围绕 Mutation、Changeset 和 Snapshot 等机制展开:

  • • Mutation 描述具体的数据变更。
  • • Changeset 组织相关操作。
  • • Operational Transformation(OT)处理并发编辑冲突。
  • • Snapshot 保存特定时刻的文档状态。
  • • Revision History 用于重建历史版本。

需要说明的是,完整 Office 文件转换、实时协作和编辑历史等能力主要属于 Server SDK 商业扩展,不能直接视为开源 Web SDK 的默认功能。

七、最新版本进展

截至 2026 年 11 月,GitHub Releases 已发布 v1.5.2。近期版本主要围绕公式计算、图表和布局能力持续改进。

v1.5.0 的重点更新包括:

  • • 图表工作表: 支持将图表放在独立工作表中,并支持移动和撤销重做。
  • • 误差线: 柱状图、条形图、折线图和散点图支持误差线配置。
  • • 公式优化: 改进公式计算过程中的内存使用和数组溢出处理。
  • • Board 布局: 增加 planLayout() 和 applyLayoutPlan(),支持规划和应用图形布局。

v1.4.0 还改进了 Office 附件处理、数据透视表筛选及相关公式能力。

八、安装与快速上手

Univer 支持通过 npm 安装。以下以 Sheets Core 为例:

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

初始化编辑器:

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

页面中准备对应容器:

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

完成初始化后,即可获得基础电子表格编辑器。后续可以通过 Facade API 增加业务数据读写、公式处理和自定义功能。

九、开源情况与项目价值

Univer 采用 Apache-2.0 开源核心与商业扩展相结合的模式。

功能
开源与商业边界
Core、插件体系
开源
Sheets、Docs 基础能力
开源
公式与渲染基础设施
开源
Headless 基础能力
开源
完整实时协作
商业扩展
完整 Office 文件转换
商业扩展
部分高级图表和数据透视表
商业扩展
完整 AI SDK 工具链
部分商业扩展

项目地址:https://github.com/dream-num/univer

官方文档: https://docs.univer.ai/

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料