🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

协同办公空间 dream-num/univer-workspace

DeepSeek Harness
dream-num0 天前有提交已提供中文文档扫描:含敏感能力

一个让人类与 AI Agent 共同创作、协作和审阅的开源 Office 工作空间。

70.8/100
综合分
2,281
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/11/15 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过:缺少 main/exports/bin 入口声明;engines.node 要求 >=24,不满足 Node 22.19.0;仓库 package.json 标记 private,未发布到 npm,需从源码安装。以下命令仍可尝试,但可能失败。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add dream-num/univer-workspace
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么[目录]—
dsh 原生插件 · other
暂无时间戳·判据 →
装得上吗[实装验证]✓
本站已在 dsh 0.2.2-rc.1 下真实安装成功
非静态推断
L4 · 真实安装等级说明 →
数据截至 2026/11/11·判据 →
安全吗[自动扫描]—
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
数据截至 2026/11/14·判据 →
还在维护吗[仓库]✓
活跃:最近一次提交在 0 天前
暂无时间戳·判据 →
图例:✓ 通过! 需注意— 未判定 / 无数据· 「未判定」= 本站尚无数据,不代表插件有问题
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →

可信度证据

安装兼容性检查需源码安装

缺少 main/exports/bin 入口声明;engines.node 要求 >=24,不满足 Node 22.19.0;仓库 package.json 标记 private,未发布到 npm,需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包univer-workspace(未发布到 npm,仅可源码安装)
✗Node 引擎要求 >=24 · 基线 Node 22.19 不满足
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明

源码安装时若 pnpm 拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/12 23:11:57

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

读写/删除本地文件读取剪贴板或密钥环境变量发起外部网络请求
查看扫描证据(共 94 处,展示前 90 条)
  • 读取本地文件
    apps/agent/src/connection-state.ts:68
    raw = await readFile(path, "utf8");
  • 读取本地文件
    apps/agent/src/connection-state.ts:80
    return parseConnectionState(JSON.parse(readFileSync(path, "utf8")) as unknown);
  • 写入本地文件
    apps/agent/src/connection-state.ts:136
    await mkdir(parent, { recursive: true, mode: 0o700 });
  • 写入本地文件
    apps/agent/src/connection-state.ts:138
    await writeFile(temporary, `${JSON.stringify(state, undefined, 2)}\n`, {
  • 写入本地文件
    apps/agent/src/connection-state.ts:142
    await rename(temporary, path);
  • 写入本地文件
    apps/agent/src/desktop-client-artifact.ts:20
    await mkdir(directory, { recursive: true });
  • 写入本地文件
    apps/agent/src/desktop-client-artifact.ts:37
    await writeFile(join(directory, file), script);
  • 写入本地文件
    apps/agent/src/desktop-client-artifact.ts:55
    await writeFile(join(directory, "manifest.json"), JSON.stringify(artifact));
  • 读取本地文件
    apps/agent/src/desktop-client.ts:18
    readFileSync(join(config.directory, "manifest.json"), "utf8"),
  • 读取本地文件
    apps/agent/src/desktop-client.ts:54
    const bytes = await readFile(join(config.directory, file));
  • 发起网络请求
    apps/agent/src/device-authorization.ts:37
    const response = await fetch(new URL(WORKSPACE_DEVICE_START_PATH, origin), { method: "POST" });
  • 发起网络请求
    apps/agent/src/device-authorization.ts:84
    const response = await fetch(new URL(WORKSPACE_DEVICE_EXCHANGE_PATH, pending.origin), {
  • 发起网络请求
    apps/agent/src/oauth-authorization.ts:30
    const response = await fetch(new URL("/api/auth/token", entry.origin), {
  • 发起网络请求
    apps/agent/src/workspace-auth-provider.ts:170
    return fetch(new URL(path, origin), { ...init, headers });
  • 写入本地文件
    apps/agent/src/workspace-auth-provider.ts:187
    await mkdir(runtimeHomeFor(process.env.UWH_DSH_DATA_HOME ?? dirname(this.config.connectionStatePath), next), { recursive: true, mode: 0o700 });
  • 发起网络请求
    apps/agent/src/workspace-change-feed.ts:23
    const response = await client.request("/universer-api/user/session-ticket", {
  • 写入本地文件
    apps/agent/src/workspace-migration.ts:24
    await mkdir(dirname(currentPath), { recursive: true });
  • 读取本地文件
    apps/agent/src/workspace-migration.ts:26
    await lstat(currentPath);
  • 读取本地文件
    apps/agent/src/workspace-migration.ts:33
    legacy = await lstat(legacyPath);
  • 写入本地文件
    apps/agent/src/workspace-migration.ts:40
    await rename(legacyPath, currentPath);
  • 读取本地文件
    apps/cli/src/command.ts:143
    if (file !== "-") return await readFile(file, "utf8");
  • 发起网络请求
    apps/cli/src/program.ts:139
    await (await auth.authenticatedHttp("client")).request(path, { acceptEncoding: "identity" }),
  • 发起网络请求
    apps/cli/src/program.ts:239
    return (await daemon.request("sheet-lens.run", {
  • 读取本地文件
    apps/space-plugin/src/blob-tool.ts:47
    const bytes = await readFile(source.path, { signal });
  • 写入本地文件
    apps/space-plugin/src/blob-tool.ts:59
    await mkdir(dirname(output.path), { recursive: true });
  • 写入本地文件
    apps/space-plugin/src/blob-tool.ts:60
    await writeFile(output.path, result.bytes, { flag: 'wx', signal });
  • 读取本地文件
    apps/space-plugin/src/blob-tool.ts:66
    const bytes = await readFile(source.path, { signal });
  • 发起网络请求
    apps/space-plugin/src/creation-tools.ts:31
    const client = { request: (path: string, init: RequestInit = {}) => workspace.request(path, {
  • 读取本地文件
    apps/space-plugin/src/editing.ts:600
    code = await readFile(source.path, 'utf8');
  • 读取本地文件
    apps/space-plugin/src/exchange-tools.ts:42
    const imported = await importUnitData(new Uint8Array(await readFile(source.path)), basename(source.path), (args.unitType ?? (args.type === 'auto' ? un
  • 发起网络请求
    apps/space-plugin/src/exchange-tools.ts:45
    const client = { request: (path: string, init: RequestInit = {}) => workspace.request(path, { ...init, signal: init.signal ? AbortSignal.any([signal,
  • 写入本地文件
    apps/space-plugin/src/exchange-tools.ts:85
    await mkdir(dirname(destination.path), { recursive: true });
  • 写入本地文件
    apps/space-plugin/src/exchange-tools.ts:86
    await writeFile(destination.path, bytes);
  • 读取本地文件
    apps/space-plugin/src/html-view-tool.ts:29
    const html = await readFile(source.path, { encoding: 'utf8', signal });
  • 发起网络请求
    apps/space-plugin/src/index.ts:45
    async fetch() {
  • 读取本地文件
    apps/space-plugin/src/index.ts:46
    return new Response(await readFile(new URL('./base-editor-worker.js', import.meta.url), 'utf8'), {
  • 发起网络请求
    apps/space-plugin/src/index.ts:53
    async fetch(request) {
  • 发起网络请求
    apps/space-plugin/src/index.ts:71
    async fetch(request) {
  • 发起网络请求
    apps/space-plugin/src/index.ts:367
    async fetch(request) {
  • 读取本地文件
    apps/space-plugin/src/markdown-tools.ts:85
    const sourceMap = mapPath ? parseDocMarkdownSourceMap(JSON.parse(await readFile(mapPath.path, 'utf8'))) : undefined;
  • 读取本地文件
    apps/space-plugin/src/markdown-tools.ts:140
    sourceMap: parseDocMarkdownSourceMap(JSON.parse(await readFile(source.path, 'utf8'))),
  • 发起网络请求
    apps/space-plugin/src/oauth.ts:96
    const response = await fetch(new URL('/api/session', origin), {
  • 发起网络请求
    apps/space-plugin/src/oauth.ts:145
    const revoke = cookie ? fetch(new URL('/api/auth/logout', origin), {
  • 发起网络请求
    apps/space-plugin/src/oauth.ts:204
    const response = await fetch(new URL('/api/auth/token', entry.origin), {
  • 读取密钥环境变量
    apps/space-plugin/src/runtime-license.ts:5
    environment = process.env.UNIVER_LICENSE_KEY,
  • 读取本地文件
    apps/space-plugin/src/runtime-license.ts:10
    const config = JSON.parse(readFileSync(file, 'utf8'));
  • 读取本地文件
    apps/space-plugin/src/runtime-license.ts:24
    text = readFileSync(file, 'utf8');
  • 发起网络请求
    apps/space-plugin/src/tools.ts:404
    const client = { request: (path: string, init: RequestInit = {}) => workspace.request(path, {
  • 发起网络请求
    apps/space-plugin/src/workspace.ts:173
    const response = await fetch(new URL('/api/session', next), {
  • 发起网络请求
    apps/space-plugin/src/workspace.ts:215
    const response = await fetch(new URL(path, this.endpoint), {
  • 发起网络请求
    apps/space-plugin/src/workspace.ts:252
    return fetch(target, { ...init, redirect: 'error', signal,
  • 发起网络请求
    apps/space-plugin/src/workspace.ts:256
    return (await this.request(path, init)).json();
  • 发起网络请求
    apps/space-plugin/src/workspace.ts:264
    const response = await this.request('/api/auth/password/login', {
  • 发起网络请求
    apps/space-plugin/src/workspace.ts:457
    const response = await fetch(target, {
  • 发起网络请求
    packages/client-core/src/auth.ts:38
    response = await http.request("/api/auth/cli/password/login", request);
  • 发起网络请求
    packages/client-core/src/auth.ts:44
    response = await http.request("/api/auth/password/login", request);
  • 发起网络请求
    packages/client-core/src/auth.ts:53
    const response = await http.request("/api/auth/cli/authorizations", {
  • 发起网络请求
    packages/client-core/src/auth.ts:109
    const response = await http.request("/api/auth/cli/authorizations/exchange", {
  • 发起网络请求
    packages/client-core/src/auth.ts:143
    await http.request("/api/auth/logout", { method: "POST" });
  • 发起网络请求
    packages/client-core/src/blob.ts:315
    ).request(`/api/blob-resources/${encodeURIComponent(view.resource.resourceId)}/download`, {
  • 发起网络请求
    packages/client-core/src/blob.ts:371
    await http.request(`/api/blob-upload-sessions/${encodeURIComponent(uploadId)}/content`, {
  • 读取本地文件
    packages/client-core/src/files.ts:108
    metadata = await stat(resolvedPath);
  • 读取本地文件
    packages/client-core/src/files.ts:134
    for await (const chunk of createReadStream(source.path)) {
  • 写入本地文件
    packages/client-core/src/files.ts:246
    await rename(this.options.temporaryPath, this.outputPath);
  • 删除本地文件
    packages/client-core/src/files.ts:256
    await unlink(this.options.temporaryPath);
  • 删除本地文件
    packages/client-core/src/files.ts:276
    await unlink(this.options.temporaryPath).catch(() => undefined);
  • 读取本地文件
    packages/client-core/src/files.ts:332
    await access(path);
  • 写入本地文件
    packages/client-core/src/html-view.ts:202
    await writeFile(stagedPath, source.bytes, { mode: 0o600, flag: "wx" });
  • 删除本地文件递归
    packages/client-core/src/html-view.ts:208
    await rm(directory, { recursive: true, force: true });
  • 发起网络请求
    packages/client-core/src/http.ts:51
    const response = await this.request(path, options);
  • 发起网络请求
    packages/client-core/src/issue.ts:278
    await http.request(`/api/issue-labels/${encodeURIComponent(id!)}`, { method: "DELETE" });
  • 发起网络请求
    packages/client-core/src/markdown-assets.ts:26
    const sign = await options.request(`${prefix}/sign-url`, init);
  • 发起网络请求
    packages/client-core/src/markdown-assets.ts:48
    const response = await options.request(url.pathname, init);
  • 写入本地文件
    packages/client-core/src/print-pdf.ts:102
    await mkdir(dirname(path), { recursive: true });
  • 写入本地文件
    packages/client-core/src/print-pdf.ts:105
    await writeFile(temporary, bytes, { flag: "wx", mode: 0o600 });
  • 删除本地文件
    packages/client-core/src/print-pdf.ts:116
    await unlink(temporary).catch((error: unknown) => {
  • 写入本地文件
    packages/client-core/src/screenshot.ts:76
    await mkdir(directory, { recursive: true });
  • 读取本地文件
    packages/client-core/src/screenshot.ts:101
    await access(path);
  • 写入本地文件
    packages/client-core/src/screenshot.ts:115
    await writeFile(temporary, bytes, { flag: "wx", mode: 0o600 });
  • 删除本地文件
    packages/client-core/src/screenshot.ts:126
    await unlink(temporary).catch((error: unknown) => {
  • 读取本地文件
    packages/client-core/src/svg.ts:54
    svg: readFileSync(file, "utf8"),
  • 读取本地文件
    packages/client-core/src/svg.ts:55
    assetResolver: (href) => ({ bytes: readFileSync(resolve(dirname(file), href)) }),
  • 写入本地文件
    packages/client-core/src/typst.ts:132
    await mkdir(dirname(target), { recursive: true });
  • 写入本地文件
    packages/client-core/src/typst.ts:133
    await writeFile(target, bytes, { flag: "wx" });
  • 删除本地文件递归
    packages/client-core/src/typst.ts:137
    await rm(directory, { force: true, recursive: true });
  • 发起网络请求
    packages/dsh-univer-workspace-plugin/src/session-context.ts:181
    response = await client.request(`/api/resources/${encodeURIComponent(resourceId)}`, {
  • 读取本地文件
    packages/dsh-univer-workspace-skin-plugin/src/index.ts:23
    .update(readFileSync(new URL("./client.css", import.meta.url)))
  • 读取本地文件
    packages/dsh-univer-workspace-skin-plugin/src/index.ts:63
    const css = await readFile(new URL("./client.css", import.meta.url));
  • 发起网络请求
    packages/workspace-agent-runtime/src/worker-http.ts:18
    const response = await this.request(path);
  • 发起网络请求
    packages/workspace-agent-runtime/src/worker-http.ts:56
    return await fetch(new Request(request, { headers, redirect: "manual" }));
扫描于 2026/11/14(2 天前) · 范围 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

社区实装还没有人打卡 · 装过的第一个就是你
给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

界面预览

2 张 · 点击查看大图

功能亮点

  • 人机共同创作
  • 协作与审阅
  • 开源办公空间

开源 Office 工作空间,人和 AI 智能体在这里一起创作、协作、审阅。

README

由 DeepSeek 最新模型翻译生成
Univer Workspace 一个让人类与 AI Agent 共同创作、协作和审阅的开源 Office 工作空间。 Univer 文档 · Server SDK 文档 · CLI 指南 · Workspace Agent · Issues Univer Workspace 是一个基于 Univer Office SDK 构建、可独立部署的知识管理与团队协作产品。你可以使用 Workspace Browser 直接编辑,通过 Workspace Agent 对话并审查变更,也可以使用 CLI 自动化处理任务。三个入口连接同一个负责文档存储和权限的 Workspace Server,让人类与 AI Agent 共同处理 Sheet、Doc、Slide、Base 与 Board。 Agent 在隔离的 Worktree 中工作、验证修改,再把结果交给人类审阅;只有经过确认的内容才会合入共享 trunk。
展开完整文档(README 剩余 1 节)
Univer Workspace

一个让人类与 AI Agent 共同创作、协作和审阅的开源 Office 工作空间。

Univer 文档 · Server SDK 文档 · CLI 指南 · Workspace Agent · Issues

Univer Workspace 是一个基于 Univer Office SDK 构建、可独立部署的知识管理与团队协作产品。你可以使用 Workspace Browser 直接编辑,通过 Workspace Agent 对话并审查变更,也可以使用 CLI 自动化处理任务。三个入口连接同一个负责文档存储和权限的 Workspace Server,让人类与 AI Agent 共同处理 Sheet、Doc、Slide、Base 与 Board。

Agent 在隔离的 Worktree 中工作、验证修改,再把结果交给人类审阅;只有经过确认的内容才会合入共享 trunk。

Univer Workspace 中文团队空间,展示 Sheet、Board、Doc、Slide、Base 与文件夹示例

为什么选择 Univer Workspace

| 面向人类 | 面向 Agent | 面向运维 |
| 使用个人与团队 Space 组织内容 | 通过 Univer Facade API 创建、修改丰富的 Office 内容 | 部署一套 Browser 与 Server 应用 |
| 共同编辑 Sheet、Doc、Slide、Base 与 Board | 检查数据、渲染截图/PDF 并执行布局检查 | 自主管理产品数据、协同数据与 Blob 数据 |
| 通过角色与 Node 级权限控制分享和访问 | 离线发现版本匹配的 Skill 与 API | 接入密码、GitHub、Discord 或应用 OAuth 登录 |
| 使用最近访问、回收站、文件导入导出与审阅视图 | 多轮修改而不影响 trunk | 运行具备明确恢复边界、文档完备的 HTTP API |

基于电子表格的 Mini App · 观看演示

- Agent 可以生成基于电子表格的 Mini App,例如决策看板、交互式报告和业务看板。
- 网页上的指标、图表和控件与单元格绑定,支持数据读取、写入和协同更新。
- 查看 HTML View 效果展示:10 种页面风格、实时编辑,以及支持访客试算的公开分享。

Workspace Mini App 与其关联的电子表格并排显示,指标、图表和控件绑定到单元格

选择操作入口

| 入口 | 适用场景 | 开始使用 |
| Workspace Browser | 直接编辑文档、协同、组织 Space 和审阅变更 | 启动 Workspace |
| Workspace Agent | 在文档旁与 Agent 对话、引用本地或远程文件与文件夹、审查 Worktree 变更 | 安装和使用 Agent |
| Workspace CLI | 从终端、脚本或已有 Agent 环境自动化处理文档 | CLI 安装与使用 |
| Workspace MCP | 用一个 URL 让 Claude、ChatGPT、Cursor、VS Code、Codex 等 AI 助手操作 Workspace | 连接 AI 助手 |

Workspace Agent 是基于 DSH(DeepSeek Harness)的本地 Web 应用。
它的本地文件引用指向运行 Agent 的机器,Workspace 文档仍由连接的服务管理。
Agent 和 CLI 都可以连接现有的 Workspace 部署,或在本地启动的 Workspace。

连接 AI 助手(MCP)

Workspace 提供远程 MCP 服务。连上它的 AI 助手可以查找你的文件、开 PR、编辑 Sheet、Doc 和 Slide、读回结果,再把 PR 标记为 ready,交给你在浏览器里审阅。本机不需要安装任何东西。

Install in Cursor

| 项目 | 值 |
| 服务 URL | https://space.univer.ai/mcp。自己部署时为 https://<你的 Workspace>/mcp(见 MCP 服务说明) |
| 传输方式 | Streamable HTTP |
| 登录 | 在浏览器中完成 OAuth。同意页列出 read、write、publish 和 worktree:merge,不想授予的可以取消勾选 |
| toolset | 默认 core。加 ?toolsets=core,files 启用 Blob、Asset、Markdown、Typst、SVG、HTML View 工具,admin 用于仓库与 Label 管理,all 启用全部 |

不支持 OAuth 的客户端可以把个人访问令牌放在 Authorization: Bearer <token> 中发送,令牌在 Workspace 账号菜单的 访问令牌里创建。space.univer.ai 目前只对受邀账号开放编辑类工具(execute、inspect、导入和导出),所有账号都可以浏览、搜索、管理 Issue 和 PR。

Claude Code

claude mcp add --transport http univer-workspace https://space.univer.ai/mcp

在 Claude Code 会话中运行 /mcp,选择 univer-workspace 并登录。加 --scope user 可在所有项目中使用。配置了 Authorization 请求头时 Claude Code 不会走 OAuth,两者不要同时设置。

Claude.ai 与 Claude Desktop

打开 Customize → Connectors,选择 + Add → Add custom connector,填入 Univer Workspace 和 https://space.univer.ai/mcp,然后登录。Claude Desktop 使用同一个连接器列表。Team 与 Enterprise 方案需要 Owner 先在 Organization settings → Connectors 中添加,成员再点 Connect。这类连接器从 Anthropic 的云端发起连接,自己部署的 Workspace 需要能从公网访问。

ChatGPT

在网页版 ChatGPT 中打开应用设置(不同版本显示为 Apps、Plugins 或 Connectors),方案需要时先开启 Developer mode,再用 https://space.univer.ai/mcp 和 OAuth 创建自定义 MCP 应用。新对话里用 @ 选中它。
是否可用取决于方案,Business 与 Enterprise 可能需要管理员先允许自定义 MCP 应用。

Codex

codex mcp add univer-workspace --url https://space.univer.ai/mcp
codex mcp login univer-workspace

codex mcp add 可能会自动开始登录。CLI、IDE 插件和桌面应用共用 ~/.codex/config.toml:

[mcp_servers.univer-workspace]
url = "https://space.univer.ai/mcp"

Cursor

点上面的按钮,或在 ~/.cursor/mcp.json(项目内为 .cursor/mcp.json)中加入下面的配置。Cursor 首次连接时会提示登录。

{
"mcpServers": {
"univer-workspace": { "url": "https://space.univer.ai/mcp" }
}
}

VS Code(GitHub Copilot)

点上面的按钮,或运行:

code --add-mcp '{"name":"univer-workspace","type":"http","url":"https://space.univer.ai/mcp"}'

然后运行 MCP: List Servers,启动 univer-workspace,在浏览器中登录。远程 OAuth 需要 VS Code 1.101 或更高版本。
只在一个工作区使用时,把服务写进 .vscode/mcp.json 的 servers,并设置 "type": "http"。

Gemini CLI

gemini mcp add --transport http --scope user univer-workspace https://space.univer.ai/mcp

运行 /mcp auth univer-workspace 登录。在 settings.json 中,Streamable HTTP 服务使用 httpUrl,url 表示 SSE。

opencode

opencode mcp add univer-workspace --url https://space.univer.ai/mcp --global
opencode mcp auth univer-workspace

Windsurf

在 Windsurf Settings 中打开 MCP 配置文件(Add Server 或 Open MCP config file),加入下面的服务后刷新。连接时 Windsurf 会提示登录。

{
"mcpServers": {
"univer-workspace": { "serverUrl": "https://space.univer.ai/mcp" }
}
}

WorkBuddy

打开 连接器 → 自定义连接器 → 配置 MCP,加入下面的服务,保存并启用。显示需要认证时点 连接 并登录。

{
"mcpServers": {
"univer-workspace": { "type": "streamableHttp", "url": "https://space.univer.ai/mcp" }
}
}

Grok

在 grok.com 打开 Connectors → New Connector → Custom,填入 https://space.univer.ai/mcp 并登录。
Grok 从 xAI 的云端发起连接,自己部署的 Workspace 需要能从公网访问。

其他客户端

支持 Streamable HTTP 和 OAuth 2.1 的客户端都可以直接使用服务 URL。Workspace 支持 Client ID Metadata Documents 和动态客户端注册。只能运行本地 stdio 服务的客户端可以通过 npx -y mcp-remote https://space.univer.ai/mcp 之类的桥接使用。

客户端反复要求登录时,先在该客户端中退出这个服务(例如 claude mcp logout univer-workspace、 opencode mcp logout univer-workspace,或 Gemini CLI 中的 /mcp auth),再重新登录。缺少预期的工具时,检查 URL 中的 ?toolsets=。

Space Preview(预览版)

Space 是面向 Univer Workspace 的概念验证插件,安装在官方 DeepSeek Harness(DSH)中。
它连接你的 Workspace 服务,让你浏览文件、编辑 Univer Docs 与 Sheets,并在打开的文档旁边与 AI 对话。

Space 在 DeepSeek Harness 中的预览:文件导航、Univer 文档与对话输入框

安装包、安装步骤与已知限制见 Space 插件指南。
Space 是可选的,不替代 Workspace Agent。评估此预览版期间请使用非关键文档。

工作原理

flowchart LR
Human([人类]) --> Browser[Workspace Browser]
Agent([AI Agent]) --> CLI[Workspace CLI]
Human --> AgentApp[Workspace Agent:本地对话与审查]
AgentApp --> Server
Browser --> Server[Workspace Server]
CLI --> Server
Server --> Product[(产品数据)]
Server --> Collaboration[(协同数据)]
Server --> Blobs[(Blob 与 Asset 字节)]

Browser 提供直接编辑和协同界面;Workspace Agent 将对话、文档预览和 Worktree 审查放在一起; CLI 为 Agent 提供加载、理解、修改、验证和渲染同一份内容的结构化入口。
Server 解析权威身份与权限、拥有 Workspace 产品 workflow,并组合 Univer Collaboration SDK。

Worktree 将 Agent 编辑转化为边界清晰的审阅流程:

创建 Worktree → Agent 编辑并验证隔离草稿 → Ready → 人类在 Browser 或 Workspace Agent 中审阅 → Merge 或 Reopen → trunk

在人类接受之前,中间修改不会进入共享内容。完整产品 workflow 见 CLI 指南。

快速开始

以下命令启动 Workspace 服务与 Browser。如需对话界面,继续按照 Workspace Agent 指南安装。

环境要求

- Node.js 24 或更高版本
- pnpm 11

安装依赖并准备应用配置:

pnpm install
cp apps/workspace/.env.example apps/workspace/.env

启动 Server:

pnpm workspace:dev:server

在另一个终端启动 Browser 开发服务器:

pnpm workspace:dev:web

打开 <http://127.0.0.1:5173>。Vite 提供热更新,并将 API 与 WebSocket 流量代理到 <http://127.0.0.1:3020> 的 Server。

当 apps/workspace/dist/public 存在时,Server 也可以在 3020 端口提供最近一次构建的 Browser。
产品 API 文档位于 <http://127.0.0.1:3020/api-docs> 和 <http://127.0.0.1:3020/openapi.yaml>。

配置、认证、存储、Docker 与数据库迁移的详细说明见 Workspace 应用指南。

一键部署

Deploy on RepoCloud

使用 Workspace Agent

Workspace Agent 是基于 DSH、专为 Univer Workspace 构建的桌面应用。通过 @ 引用 Workspace 文件,在对话中创建和编辑文档,审核改动并决定合入或丢弃。

Agent 指南提供可以直接交给编程 Agent 的安装提示词,尚未克隆仓库也能使用,同时包含手动安装与使用说明。
指南会引导你选择或启动自己的 Workspace 服务、注册 OAuth 回调、配置模型凭据,并打开本地启动器打印的完整 token URL。

使用 Workspace CLI

如果想配合 Claude、Codex、Kimi Work 等现有 Agent 软件使用,请在 Agent 的运行环境中安装 CLI 和 Workspace CLI Skill:

npm install --global univer-workspace-cli@latest
npx skills add dream-num/univer-workspace --skill univer-workspace-cli -g

先把 CLI 指向你自己的 Workspace 部署,再开始需要 Browser 确认的登录流程:

uvw config set workspace.origin <origin>
uvw auth login

用户确认命令输出的 URL 与验证码后,完成一次性交换:

uvw auth login --complete

安装包包含版本匹配的 Skill、结构化 JSON 输出、Facade API 发现、内容检查、PNG/PDF 渲染、Office 文件交换与 Worktree workflow。完整用法和登录合同见 CLI 指南。

仓库结构

apps/workspace Workspace Browser、Server、HTTP contract 与部署应用 apps/cli 面向 Agent 的远程 Workspace 自动化应用 apps/agent 用于文档对话与 Worktree 审查的 Workspace Agent 应用 packages/client-core 私有的 Node-hosted Workspace Agent Client 能力 packages/reference-provider 仅供 Browser 使用的私有 referenced-Unit policy packages/dsh-univer-workspace-plugin Workspace Agent 的 Workspace 能力与浏览器 UI packages/dsh-univer-workspace-skin-plugin Workspace Agent 的 Workspace 视觉皮肤 scripts SDK 版本与 CLI 本地发布工具

本仓库是产品的 composition root,不重新实现上游 SDK。Univer Runtime 拥有 Unit 模型、渲染、 Facade API 与 Office 内容能力;Univer Collaboration SDK 拥有 snapshot、revision、OT、实时协同与 Worktree 协议合同;Univer CLI SDK 拥有可复用的 headless runtime、执行、检查与渲染能力。

Workspace 拥有产品身份、Space、目录层级、ACL、分享、回收站、最近访问、Blob 存储策略、远程 workflow 与部署。Client Core 在仓库应用之间共享存储无关的认证、Workspace workflow、本机 Node-hosted Blob/Asset 传输与 worker-backed 内容 runtime,包括 Node-hosted Office exchange、Markdown 编译/创建/原生读取/局部更新、Typst 编译/materialize/apply、render Unit 装配、截图、PNG/PDF 输出、Slide 和 Board layout lint、render-page 源码与 SVG 编译/测量/apply workflow;reference-provider package 仍只供 Browser 使用。两者都是私有实现模块,不是额外的公开应用或 SDK。

架构原则

- 一个权威 Server。 不把客户端提供的 User、Role、Resource、Unit、Worktree 或 revision 当作权威信息。
- 分离存储边界。 产品数据、协同状态与 Blob 字节各有明确所有者,并通过持久化、幂等的 Operation 协调。
- 只使用已发布的 SDK 合同。 仓库只消费 package 的公开 export,不依赖相邻源码 checkout。
- 一个精确 SDK baseline。 所有版本耦合的 @univer-cli/、@univerjs/ 与 @univerjs-pro/* package 始终一起升级。
- HTTP contract first。 OpenAPI 源文件、生成类型、Server route、Browser 与 CLI 必须描述同一行为。

修改这些边界前,请阅读技术架构、应用层设计与数据模型。

开发与验证

迭代时先运行最小相关检查。提交 PR 前,在 Linux 或 macOS 使用与 CI 相同的验证入口:

pnpm verify
pnpm verify --stage test-mcp

六个阶段为 static、test-workspace、test-cli、test-mcp、test-rest 和 package。
它们覆盖 HTTP contract 生成校验、类型检查、已安装 SDK 的依赖与类型身份检查、workspace 测试、构建、真实 CLI tarball 的隔离安装 smoke,以及 Workspace 生产导入与迁移检查。
pnpm check 仍是较短的类型检查与测试循环。

已有安装可能掩盖依赖解析问题。验证已提交代码时,使用 Node 24 和仓库固定的 pnpm 版本,在独立 worktree 中重新安装,避免复用 node_modules 和 TypeScript 构建状态:

git worktree add --detach ../univer-ci-check HEAD
cd ../univer-ci-check
node scripts/verify.mjs --install

--install 会先执行并记录 pnpm install --frozen-lockfile。CI 在干净 checkout 中调用相同入口。
此 worktree 检查 HEAD,不包含原目录的未提交改动。普通本地运行会记录源码是否有未提交改动,但不代表依赖图来自干净安装。

.verification/ 按每次调用分别保存命令日志、退出码和信号、Vitest 与 node:test 结构化结果,以及带提交、执行次数、阶段、文件和测试名称的摘要。进程失败时,即使没有测试报告也不会判绿。
CI 按运行、执行次数和阶段分别上传 artifact,保留 30 天;重跑不会覆盖首次结果。
验证入口之前的 setup 失败或 runner 被强制终止可能没有完整 artifact,统计仍会读取 workflow 状态。

gh 登录后,可以查看近期首次通过率与重复失败:

pnpm ci:reliability --limit 20

首次通过率的分母排除首次执行被取消或尚未结束的运行。失败签名只分析首次失败的执行,并另列证据覆盖率。
旧运行或过期 artifact 无法还原具体失败测试。报告可能含测试 fixture 数据,应保持仓库现有的访问边界。

使用仓库脚本统一更新 Univer SDK 版本与 lockfile:

pnpm update:univer-sdk --sdk_version <exact-sdk-version>

交付模型

CLI 与 Workspace 部署基于同一份源码,但各自独立交付:

- 在 main 包含的稳定 vX.Y.Z tag 上手动触发 CLI 发布 workflow,并显式设置 dry_run=false,才会发布 univer-workspace-cli@X.Y.Z。创建、推送 tag 不触发 CI 或发布。
- Workspace 使用独立的手动部署 workflow,构建已有稳定 tag,或把精确 commit 标记为 sha-<commit>。推送 release tag 不会部署 Server。

稳定版 CLI 发布会检查整个仓库的 SDK baseline,并在发布前验证实际 package artifact。

文档

| 资源 | 范围 |
| Univer Web SDK 文档 | Browser Runtime、Preset、Plugin、Facade API 与编辑器能力 |
| Univer Server SDK 文档 | Server SDK:协同、导入导出、部署与 license |
| Workspace 应用指南 | 配置、认证、存储、Docker 与升级 |
| Workspace CLI 指南 | 安装、登录、Agent workflow 与 package 合同 |
| Workspace Agent 指南 | 本地 Profile、浏览器 OAuth、会话、文件、Worktree 与身份切换 |
| Client Core package | 私有 Node-hosted client 能力边界 |
| 技术架构 | Browser、Server、存储、OpenAPI 与模块边界 |
| HTTP contract | 产品 API 源文件与生成流程 |
| Reference-provider package | Browser 私有 referenced-Unit policy |

参与贡献

欢迎提交 Issue 与 Pull Request。修改代码前,请阅读 AGENTS.md 和目标附近的 README 或设计文档;保留无关改动,不手工编辑生成文件,并完成受影响边界要求的验证。

Runtime 开发 License

Browser、Workspace Server、CLI 与 DSH 插件包含内容同步、经过批准的 runtime 开发凭据,用于本地开发。该凭据每 90 天轮换一次,并不是本仓库的软件许可证。服务端 Collaboration 与 Exchange SDK 还需要 license key 校验,缺少任一值时降级为免费额度。Browser 构建可以通过 VITE_UNIVER_LICENSE 覆盖,Server 与 CLI 可以通过同时设置 UNIVER_LICENSE 和 UNIVER_LICENSE_KEY 覆盖。轮换时用生成脚本一次更新全部副本:

pnpm update:univer-license --license <license.txt> --license-key <licenseKey.txt>

License

Univer Workspace 使用 Apache-2.0 许可证。
预览分享卡片长什么样 ↓dream-num/univer-workspace
分享 · DeepSeek Harness Hub
dream-num/univer-workspace

一个让人类与 AI Agent 共同创作、协作和审阅的开源 Office 工作空间。

这个插件是你维护的吗?
作者本人可认领并核对本条目;认领通过后,详情页会显示「作者已认领」标记。
认领条目 →
回到顶部