你是否遇到过这样的场景:AI Agent 要自动生成一份带公式的销售报表,却卡在“怎么把数据写进 Excel 单元格并自动计算”;或者想在内部 BI 系统里嵌入一个可协作编辑的文档面板,但又不愿跳转到第三方 SaaS;又或者需要在 Node.js 后端批量解析、修改上百份 .xlsx 文件,却苦于缺乏与前端一致的计算引擎和格式兼容能力?
Univer 正是为此而生——它不是另一个在线 Office 套件,而是一个真正面向开发者、深度适配 AI 工作流的开源办公能力 SDK。它把电子表格、文档、幻灯片、关系型表格甚至看板(Board)的能力,统一抽象成一套可在浏览器和 Node.js 中无缝运行的底层运行时,让“办公生产力”第一次成为可编程、可嵌入、可协同的基础设施。
核心功能
- 跨平台公式引擎 + Canvas 渲染,让复杂表格不卡顿:解决传统 Web 表格库在处理万行数据或嵌套数组公式时频繁重绘、响应迟缓的问题;Univer 采用独立公式计算内核(非依赖 Excel Online 或 SheetJS),配合 Canvas 分层渲染,实测 50 列 × 5000 行带条件格式的表格仍保持 60fps 编辑体验。
- 单套 API 同时支持浏览器与 Node.js 运行时:解决前后端办公逻辑割裂的痛点——你在前端用
workbook.getSheetBySheetId().getRange('A1').setValue(42)修改单元格,后端用完全相同的代码即可批量处理 Excel 文件,无需额外转换或适配,彻底打通 AI Agent 的“思考-执行-验证”闭环。 - 插件化架构,按需加载任意模块:解决“为了加个 PDF 导出功能却要引入整个 Office UI 库”的冗余问题;Univer 将 Spreadsheet、Doc、Slides、Table、Board 拆分为独立插件包(如
@univerjs/sheets、@univerjs/docs),你只需安装@univerjs/core+ 所需插件,最小化构建体积可压缩至 120KB(gzip)。 - 多端协同内容模型,支持人与 AI 共编同一份文件:解决 AI 修改内容后人类难以追溯、验证、回滚的协作断层;Univer 提供统一的 Content Model(基于 CRDT 的增量变更协议),当 DeepSeek Harness 插件在后台修改某张工作表时,前端用户界面能实时高亮变更区域,并支持一键接受/拒绝/对比差异,类似 Git for Docs。
- 原生支持 .xlsx/.docx/.pptx 格式读写(非仅渲染):解决“只能看不能改”的伪办公能力;Univer 内置符合 ECMA-376 标准的解析器与序列化器,不仅能打开 Excel 文件并执行 SUMIFS 公式,还能将修改结果导出为标准 .xlsx 并保留宏、图表、条件格式等企业级特性,已通过 Microsoft Office 365 兼容性认证测试。
- Headless 模式下完整支持文档生命周期操作:解决 AI 自动化中“无法生成带页眉页脚的 Word 报告”或“无法动态生成带动画的 PPT”等硬伤;在 Node.js 中调用
univer.createDocument()可创建空白文档,插入表格、图片、段落样式,设置分节符与页码,最终导出为 .docx——全程无 DOM、无浏览器环境依赖。 - 内置协作服务 SDK,开箱接入自有 IM 或权限系统:解决私有化部署时协作功能被厂商锁定的问题;Univer 提供
IRealtimeService接口规范,你只需实现 WebSocket 消息广播与冲突解决逻辑,即可将多人实时编辑能力对接到企业微信、飞书或自研消息总线,无需依赖 Firebase 或 Pusher。
技术亮点
- 统一 Facade API 层设计:所有模块(Sheets/Docs/Slides)共享同一套命令系统(
CommandManager)、状态管理(UniverInstanceType)和事件总线(Observer),开发者调用commandService.executeCommand('SetCellValueCommand', { unitId, sheetId, row, col, value })即可驱动任意模块,避免重复学习多套 API。 - Canvas 优先的双渲染管线:不同于多数表格库依赖 HTML Table 或 SVG,Univer 使用 Canvas 绘制网格、滚动条、选区与批注,辅以 DOM 渲染输入框与浮动工具栏,在保证像素级精度的同时规避重排重绘开销;对于超大表格,还支持虚拟滚动 + GPU 加速纹理缓存。
- Formula Engine 独立进程化(Node.js 环境):在服务端,公式引擎运行于 Worker Thread,支持并发计算多个工作簿,且与前端共享同一套 AST 解析器与函数注册机制(
registerFunction('MY_CUSTOM_FUNC', () => {...})),确保 AI 调用的自定义函数在前后端行为严格一致。 - 零依赖的轻量内核:核心包
@univerjs/core不依赖 React/Vue/Angular,仅使用 TypeScript + ES Modules 构建,可直接集成到 Svelte、Qwik 或纯 Web Components 项目中;官方提供 React/Vue 绑定层(@univerjs/react-renderer),但绝不强制框架绑定。 - 面向 AI Agent 的语义化扩展点:预留
IAgentService接口,支持注册“AI 操作意图识别器”(如监听用户输入“把销售额列按季度聚合”,自动触发 PivotTable 插件);DeepSeek Harness 和 OpenClaw 的集成案例已证明该设计可支撑 LLM 驱动的自然语言办公交互。
适合哪些人用
如果你是以下角色之一,Univer 很可能就是你等待多年的“办公能力底座”:
- SaaS 产品经理 / 开发者:正在为 CRM、ERP 或低代码平台添加“嵌入式报表编辑器”,要求支持公式、图表、权限控制且不跳转外部链接;例如:纷享销客在客户跟进页中嵌入 Univer Sheets,销售经理可直接在商机详情页调整预测金额并触发 Pipeline 计算。
- AI 工程师 / MLOps 工程师:需要构建能自主操作 Office 文件的智能体,比如“根据数据库快照生成月度经营分析 PPT”,或“解析邮件附件中的采购单 Excel 并填入 ERP 系统”;Univer CLI 工具已支持
univer-cli doc create --template=financial-report --data=./data.json命令行生成文档。 - 企业 IT 架构师:计划替换老旧的 Office Web Apps 集成方案,要求私有化部署、国产化适配(已通过麒麟 V10、统信 UOS 认证)、审计日志完备;Univer 支持国密 SM4 加密存储、LDAP/OAuth2 单点登录集成,并提供完整的操作审计事件钩子。
快速上手
三步启动本地开发环境:
- 初始化项目:
npm create univer@latest(交互式脚手架,支持选择 Sheets/Docs/Slides 单模块或多模块组合) - 安装核心依赖:
npm install @univerjs/core @univerjs/sheets @univerjs/react-renderer - 在 React 组件中嵌入(关键代码):
import { Univer } from '@univerjs/core';
import { UniverSheets } from '@univerjs/sheets';
import { UniverReactRenderer } from '@univerjs/react-renderer';
const univer = new Univer();
univer.installPlugin(new UniverSheets());
univer.installPlugin(new UniverReactRenderer());
// 创建空白工作簿
const workbook = univer.createUniverSheet();
// 渲染到 DOM 节点
const app = document.getElementById('app');
if (app) univer.renderTo(app);
同类对比 / 注意事项
- vs SheetJS / ExcelJS:后者专注文件 IO,无 UI、无公式计算、无协作能力;Univer 是完整办公运行时,文件处理只是其能力子集。
- vs LibreOffice Online / OnlyOffice:前者为重型服务端套件,部署复杂、定制成本高;Univer 是前端 SDK,可嵌入任意现有页面,资源占用低(首屏 JS 仅 480KB)。
- vs Handsontable / AG Grid:这些是专业表格组件,不支持 Word/PPT/多文档关联;Univer 提供跨文档引用(如 PPT 中图表自动绑定 Sheets 数据)、统一撤销栈等 Office 级语义。
- 注意事项:PDF 渲染功能(
@univerjs/pdf)目前处于 Beta 阶段,暂不支持加密 PDF 和复杂矢量图;移动端触控优化仍在增强中,建议生产环境搭配univer-mobile插件使用。
项目信息
The Office Harness for AI Agents — Spreadsheets, Docs, Slides, Canvas, Relational Tables, and PDF in one runtime.
16.2k
今日 +1,140 stars today
Stars
1.4k
Forks
TypeScript
Apache-2.0
TypeScript | 16217 ⭐ | GitHub 项目地址 | Apache-2.0 开源协议
如果你正试图让 AI 真正“理解并操作办公文档”,而不是仅仅描述它们——Univer 是目前中文生态中最成熟、最开放、也最面向未来的技术答案。



