Workspace

基于 Univer Office SDK 的开源工作区:云端试用、私有部署,通过 Workspace CLI 接入已有 Agent,或在 Desktop 中完成对话式办公。

Univer Workspace 是基于 Univer Office SDK 构建的开源办公空间,供人与 Agent 协同工作。可编辑的 Office 内容与绑定数据的 Web App 放在个人与团队 Space 中,分享、协同、版本和变更审阅也一并在这些空间中提供。开源仓库包含应用、部署方案、CLI 和桌面客户端。

你可以把 Workspace 部署在自己的基础设施上,也可以先从云端在线试用开始。已有 Agent 通过 Workspace CLI 接入。Workspace Desktop 把 Agent 对话和同一套工作区整合进本地应用。这几种方式使用的是同一个服务和同一批文件。

云端试用 · 连接已有 Agent · 私有部署 · Desktop 体验 · 仓库与定制

先在云端体验完整的 Workspace

打开云端在线试用,登录后进入个人空间或有权限访问的团队 Space。创建或打开文档,体验直接编辑、整理文件和分享。该 Workspace 服务已经在运行,因此也可以用下文的 CLI 接入 Agent。试用面向示例数据,这些数据可能被重置。

Workspace Server 管理身份、空间、权限、存储、协同和版本。Web 是浏览器中的编辑与审阅界面。私有部署运行同一套 Server 与 Web 应用。

100%

让已有 Agent 连接云端 Workspace

在 Agent 的运行环境中安装 CLI 和发现入口 Skill。需要 Node.js 22.12 或更新版本,推荐 Node.js 24。能执行命令的 Agent 可以使用这些工具,模型和对话仍由该 Agent 提供。请显式设置云端服务地址,使浏览器和 Agent 操作同一个 Workspace:

Bash
npm install --global univer-workspace-cli@latestnpx skills add dream-num/univer-workspace --skill univer-workspace-cli -guvw --versionuvw config set workspace.origin https://space.univer.ai
首次连接:完成一次浏览器登录

已有有效会话时可以跳过这一步。如果需要登录,执行:

Bash
uvw auth login

打开返回的链接,在浏览器中登录并确认验证码。待用户确认完成后,执行:

Bash
uvw auth login --complete

这一步只在建立会话时需要。完整命令与认证说明见 Workspace CLI 指南。

浏览器完成首次授权后,CLI 会在后续任务中复用该会话。不需要为特定 Agent 编写登录页面或鉴权集成。给已连接的 Agent 下达任务,打开它返回的链接,即可在 Web 中看到同一份内容,并在合入前审阅 Agent 对原生 Office 内容的修改。

从一份可计算、可审阅的文档开始

text
在我的 Workspace 个人空间中创建一个英文月度开销表,包含日期、类别、金额和 5 条示例数据,添加总额公式及分类图表。把修改放在独立草稿中,检查数据、公式和显示效果,给我预览或审阅链接,在我确认前不要合入。

可以把这段文字发给已连接的 Agent,或在 Desktop 中使用。Agent 负责创建并检查文档,你提出修改、审阅结果,再决定是否合入。同一份内容也可以在在线版中打开。

把同样的工作流程迁到私有部署

开源仓库包含 Server 和 Web。按照部署指南构建应用,再配置自己的域名、登录方式、持久化存储和运行参数。从源码开发使用 Node.js 24 和 pnpm 11,生产部署细节以该指南为准。

部署前需要准备四个部分:

部分需要配置什么
服务可访问的 Workspace 地址,以及 Server + Web 应用。Desktop 和 CLI 都连接这套部署。
持久化数据产品数据库、协同数据库和上传文件需要一起保留。默认部署将它们存放在 .data 下;使用 Docker 时需要挂载持久化卷。
身份配置登录方式。接入 Desktop 时,注册 Agent OAuth 客户端,回调地址必须完全匹配。
SDK 许可证为部署域名构建 Web 时提供 VITE_UNIVER_LICENSE,并单独配置 Node.js 内容运行时所需的许可证。

模型凭据由 Agent 宿主管理,与 Workspace 登录分开配置。当前设置见部署指南和 Agent 接入说明。

继续使用同一个 CLI,把服务地址指向自己的部署,并在该服务中授权一个账号。把下面的示例地址替换为实际的服务地址:

Bash
uvw config set workspace.origin https://workspace.example.comuvw auth login

Agent 使用的工具和 Skills 不变,操作对象变为私有服务中的文件和权限。Desktop 也可以连接该服务。客户端注册和回调配置见 Agent 连接指南。

把 Workspace 装进本地 Desktop 客户端

Workspace Desktop 把 Workspace、Agent 运行时、Office 工具和内容预览整合进一个本地客户端。办公过程采用与 Codex 或 Cowork 类似的对话与预览配合方式:描述所需结果,在对话旁查看文档或 Web App,提出修改,再审阅结果。

Desktop 可以连接前文试用的云端 Workspace、私有部署,也可以连接本机运行的 Workspace 服务。模型和对话通过配置好的 Agent 宿主运行,文件和访问权限由所连接的 Workspace 管理。下面的桌面案例展示生成、管理与协作如何衔接。

安装并连接工作区 · 体验任务:用两份原生内容完成预算审阅

把 Agent 工作方式带进日常办公

办公工作不会在对话返回一个可下载文件后结束。人还需要继续编辑、基于真实数据计算、与同事协作,并决定接受哪些修改。Desktop 把这些环节放在同一个工作环境中。

  • 保持上下文: 对话、文件、本地引用和工作区资料始终可以访问。
  • 原生 Office 内容与 Web App: 可以创建、预览和编辑电子表格、文档、演示文稿、Relational Tables 和 Canvases,也可以构建由 Office 数据支撑的交互页面。
  • 查看并修改结果: 在对话旁打开内容,检查公式和排版,再提出具体修改。
  • 经审阅后交付: Agent 对原生 Office 内容的修改保留在 Worktree 中,直到有人审阅并合入共享工作区。

从需求到可审阅的办公成果

在普通对话中生成和修改 Office 文档与 Web App,再到 Space 中统一管理和分享。原生 Office 变更先经过 Worktree 审阅,再合入。HTML 页面发布和绑定写回遵循各自的保存与授权流程。后续对话可以引用同一份文件和数据。

100%

一个桌面应用中有哪些能力

能力使用体验
Agent 会话对话和任务上下文保存在本地,模型服务商与模型也在本地配置。
文件与资料引用浏览有权限访问的空间。使用 @ 引用 Workspace 文件或文件夹,以及本地资料。
内容预览在对话旁打开原生 Office 文件或 Web App,检查内容、交互和数据。
审阅与交付查看 Worktree 新增、修改或删除的文档,然后提出修改、合入或放弃。
本地与在线空间连接团队的在线服务,或在本机运行 Workspace 服务。
Space 管理与协作整理对话生成的文件,管理分享,并与同事编辑同一份内容。

工作区与 Agent 的实际配合

下面的截图来自一台真实的 macOS Desktop,连接的是本地 Workspace,使用的是虚构的发布项目资料。该集成预览由可扩展的 Agent 宿主、Space 能力插件和 Univer 品牌皮肤组合而成,可用功能取决于项目发布的版本。

在正常会话中生成内容并查看结果

在普通对话中说明需求,Agent 会创建或修改 Office 文档和 Web App。预览显示在右侧,后续可以通过对话继续完善。内容保存在 Workspace 中,由 Space 负责文件管理、分享和协同。

01 Launch Budget 把预算、实际支出、预测、差额公式和合计放进同一张表。图表对比预算与实际支出,并显示每条工作流的差额。

同样的对话流程也可以生成 Web App。06 Launch Dashboard 用指标卡、图表和工作流明细展示预算、实际支出和差额。HTML View 绑定让页面可以读取表格数据,团队可以在 Office 文件旁使用交互式报告。双向绑定仍为实验性功能。

在 Space 中管理生成的成果

对话成果会成为团队持续使用的文件。Space 把 Office 内容和 Web App 集中存放,提供产品分类、最近文件、收藏以及个人和团队空间。下图的 All 视图汇总了 Aurora Launch Studio 和 Team Invitations 的资料。

从 Space 继续编辑与协作

从 Space 打开 01 Launch Budget,即可在原生表格编辑器中继续工作。预算明细、公式和合计都可以编辑,评论、编辑历史和分享也在同一视图中提供。Web 和 Desktop 读取同一套 Workspace 文件。Agent 后续的修订可以保留在独立 Worktree 中,等待审阅。

Worktree 与 Compare:审阅后再合入

在 Intelligent Workbench 中,Compare 把正式预算与 Agent 的修改稿并排展示。草稿新增两条明细并更新合计,变更列表和高亮标出受影响的单元格。检查内容、格式或公式后,可以合入或放弃草稿。Worktree 负责隔离草稿,Compare 展示差异。

将文档或 Web App 分享给团队

在仪表盘上打开 Share,查看谁能访问该页面并复制其链接。在这个团队 Space 中,页面继承 Space 的成员权限,Manage Space access 会打开这些权限的管理入口。复制链接不会额外授予访问权限。

安装并连接工作区

如果已经在使用可扩展的 Agent 桌面,集成方式是安装并启用 Space 能力插件,从 Space 连接服务、配置模型,再添加品牌皮肤。本页截图使用这套组合。完整的 Workspace Desktop 发行版和插件预览遵循不同的交付路径,请按所安装版本的发布内容或仓库说明操作。

  1. 从 GitHub Releases 选择 Desktop 安装包。桌面版使用 agent-v 标签,按平台选择 Windows x64、macOS Apple Silicon 或 Linux x64 构建产物。桌面交付仍为实验性,可用版本以已发布的内容为准。

  2. 在 Settings → Workspace 中选择 Workspace 服务,通过浏览器登录并授权。可以连接已部署的服务,也可以按照本地运行说明在本机运行一个 Workspace 服务。

  3. 在 Models 设置中配置支持的服务商、模型和凭据。Workspace 登录与模型访问分开配置,详见模型配置说明。

  4. 添加有权限访问的个人或团队 Space,开始对话,并使用 @ 引用源资料。运行下面的任务,然后打开内容预览和变更审阅。

安装包包含 Agent 应用和 Office 工具。Workspace 服务独立运行,可以在本机或远程服务器上;模型访问使用所配置的服务商。

体验任务:用两份原生内容完成预算审阅

text
在当前空间创建英文 Budget Review 电子表格,包含 8 行部门示例数据:Department、Budget、Actual、Variance。差异和合计使用公式,添加预算与实际支出的对比图。再创建一份简短文档,总结超支情况,并链接到这份表格。原生 Office 内容的修改放在同一个 Worktree 中,检查数据、公式与结果,打开预览和变更审阅,等待我确认后再合入。

随后可以补充:“将 Marketing 的预算减少 10%,并更新总结。”检查调整后的数值和文档变更,再决定是否接受草稿。

基于仓库构建适合自己的 Workspace

前面使用的应用是一套可调整的 Office SDK 组合。从 Workspace 仓库开始,复用内容运行时和协同能力,再围绕自己的团队重建工作流程、Skills、工具和界面。

找到你要改造的部分

仓库位置负责什么
apps/workspaceServer、Web、产品 API 与部署配置。
apps/cli把已有 Agent 接入已部署的 Workspace。
apps/agentAgent 宿主、连接生命周期和原生 Desktop 外壳。
skills/univer-workspace-cli安装到已有 Agent 的发现入口 Skill。
packages/client-coreNode 宿主共享的 Workspace 内容操作。
packages/dsh-univer-workspace-pluginAgent 宿主的 Office 工具、原生预览和任务指引。
packages/dsh-univer-workspace-skin-pluginWorkspace 品牌外观与视觉令牌。
packages/workspace-html-viewerWeb App 的 HTML View 沙箱与数据绑定宿主。

Skills:让 Agent 理解工作区并完成任务

这组 Skills 让已有 Agent 在已连接的 Workspace 中创建和编辑 Office 内容与 Web App,再把修改交付审阅。请先把 Agent 连接到 Workspace;下面的指引操作该服务中的文件,并遵循其权限。

让已有 Agent 学会使用 Workspace

安装到已有 Agent 中的 univer-workspace-cli Skill 是发现入口,说明如何连接 Workspace、定位目标和加载操作指引。完整的运行时 Skills 随 CLI 发布,与命令和 Facade API 保持一致。Desktop 内置的能力插件也提供任务指引和工具。

指引覆盖内容
core定位空间和文件、在任务草稿中工作、检查内容并交付审阅。
sheet · doc · slide · base · board电子表格、文档、演示文稿、关系型表格(Relational Table)与画布(Canvases)。
blob原始文件的上传、下载与替换。
html-view创建和管理用于交互式 Web App 的实时 HTML 页面。
embed · cross-unit-formula嵌入其他内容,以及跨内容类型连接数据和公式。
Bash
uvw skills listuvw skills get coreuvw skills get sheetuvw skills get html-view

先加载 core,再按任务加载所需的产品或主题。skills get 列出参考路径;读取单份文档可使用 uvw skills read <name> <path>,添加 --full 可以全部读取。已有 Agent 通过 CLI 使用这些能力,Desktop 则把工具和指引整合进对话流程。

Desktop 内置的任务指引

Desktop 的能力插件包含 univer Skill 及其参考资料。它说明空间与文档之间的关系、如何使用 Office API,以及如何创建、检查并交付 Worktree。这些说明与可执行工具配套,Agent 可以查询 API、在原生内容上执行并检查结果。

能力插件把文件发现、Headless Facade 编辑、结构化检查、导入导出和 Worktree 生命周期工具组合在一起。当前预览把草稿准备到可审阅状态;正式发布经过所部署应用的审阅与合入流程。自己的应用可以在同一 Office 运行时上增加行业 Skills、模板和业务工具。

预览插件包含九个 Skills。通用 Skill 说明发现、身份和交付,各产品 Skill 说明其 API 和结果验证方式。Agent 按当前任务读取相应部分。

Skill操作指引
univer空间、文件、草稿生命周期与交付
univer-sheet公式、样式、图表与表格验证
univer-doc文档结构、段落与表格
univer-slide演示文稿创作与视觉布局检查
univer-base字段、记录与视图
univer-board形状、连接线与画布布局
univer-embed在一个 Office 产品中嵌入另一个产品
univer-cross-unit-formula跨 Unit 引用与计算
univer-html-view构建和检查绑定 Office 数据的 HTML 页面

Office SDK 如何支撑 Workspace

Workspace 把原生编辑器、Agent 对内容的操作和团队协同连接到同一套文档与权限上。可以基于这套开源应用和 Office SDK 开发,把精力集中在自己的业务流程、界面和集成上。

100%

Agent 通过 CLI 或 Desktop 在 Node.js 中操作内容,用户在 Web 或 Desktop 编辑器中查看、编辑和审阅。Workspace Server 保存共享文档、草稿和协同状态,可以运行在本机、自己的服务器或云端。

层次负责什么
Web SDK内容模型、公式、公开 Facade API 和原生编辑器。
AI SDKAPI 查询、结构化内容检查,以及针对指定文档执行 Facade 代码。
Server SDK协同、修订版本、Worktree 草稿和文件转换。
应用层Workspace 负责空间、文件、权限、分享和审阅。Agent 宿主负责会话、模型调用与工具编排。

CLI 和 Desktop 共用同一个内容操作层。它的运行时池在宿主运行期间保持已加载的文档,并在执行前同步版本。不同客户端因此复用同一套编辑与提交逻辑,详见运行时复用。

视觉检查补充结构化检查无法覆盖的内容。截图来自浏览器渲染,自动布局诊断目前能发现演示文稿中的文字溢出与重叠。

Agent 的修改如何成为可审阅的变更

以预算审阅为例,Agent 编辑的是一张包含公式和样式的电子表格。原生 Office 的编辑路径如下:

  1. 定位并加载。 Agent 选择文档和 Worktree,加载快照与 changeset,同步到选定的修订版本。Unit 指一个文档实例,例如一个工作簿。
  2. 通过 Facade 编辑。 Node.js 运行时对该 Unit 执行公开 Facade 调用。内容变更产生 mutation,这些 mutation 会被收集为 changeset 并提交到草稿。
  3. 检查结果。 Agent 读回数值和公式,必要时检查渲染结果。Agent 继续在同一草稿中编辑,直到结果可以交付审阅。
  4. 审阅并合入。 人在内容比较中检查变更,再决定是否将 Worktree 合入共享版本。

把 changeset 保存到草稿并不等于合入。 只有提交得到确认,Workspace 才报告写入成功;冲突和未确认的提交会返回错误。在 Desktop 插件中,合入和放弃工具也需要用户批准,这一要求由应用的工具流程执行。

Web App 如何连接同一份办公数据

发布仪表盘和预算编辑器使用同一份电子表格。HTML View 在沙箱 iframe 中渲染页面。Workspace 宿主解析用户可访问的源文档,并提供其已授权的内容引擎。指标卡和图表订阅源数据,因此不需要维护另一份预算副本。

对于可编辑绑定,写入需要已登录身份和源文档的编辑权限。离开页面时,宿主等待未完成的写入和协同确认,并报告保存失败。HTML 页面发布和绑定写回使用各自的保存路径,不会自动遵循原生 Office 的 Worktree 合入流程。详见实验性双向绑定和 HTML View 宿主实现。

沿着自己的业务流程继续扩展

你想实现的目标从哪里开始
行业文档与专属任务增加行业 Skills、模板和工具指引,并保留内容与视觉检查。
自己的身份、存储与分享方式扩展 Workspace 应用及其服务端产品策略。
自己的 Agent 办公客户端组合 Agent 宿主、能力插件和品牌皮肤,再接入所需的模型和业务工具。

例如:增加预算审阅 Skill

行业 Skill 可以承载团队的审阅规则,同时复用已有的 Office 工具:

  • 定位源工作簿、账期和预算/实际支出列,编辑前询问缺失的业务定义。
  • 加载表格操作指引,创建 Worktree,并使用 Facade 更新公式、准备审阅文档。
  • 检查合计、公式结果和展示效果,报告变更文件和已执行的检查,再把草稿交给审阅人。

业务规则和模板放在 Skill 中,访问检查、草稿保存和合入批准留在应用层。接入 ERP 或 CRM 时,增加一个返回所需数据的应用工具,然后复用同一套 Office 编辑与审阅流程。Skill 负责指导执行,不授予文件访问权限。

继续查看实现

Desktop 构建与交付 · Agent 应用与配置 · 全部示例

Office Lab

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.