一个让人类与 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 源安装(明细见下方安装检查)
状态速览
判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态信任档位:已验证
图例:✓ 通过! 需注意— 未判定 / 无数据· 「未判定」= 本站尚无数据,不代表插件有问题
档位由哪些信号合成
本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。
给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个
界面预览
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 许可证。预览分享卡片长什么样 ↓
分享 · DeepSeek Harness Hub
dream-num/univer-workspace
一个让人类与 AI Agent 共同创作、协作和审阅的开源 Office 工作空间。
相关插件 · 其他
逆向分析桥接Fanqi89/dsh-rea
REA(Reverse Engineer Anything)MCP 桥接,用来把 REA 逆向工具接入 DSH 插件
★ 161已汉化DSH
78.5
模型破甲清洗HunYiSage/dsh-purge
⚔️ DeepSeek Harness 网络安全红队工具dsh-purge
★ 20,482已汉化DeepSeek 客户端
73.1
语音女友beiyege-01/dsh-voice-ai-girlfriend
语音 AI 女友Voice AI girlfriend for DeepSeek Harness:Whisper…
★ 888已汉化DSH
71.6
红队越狱测试套件Minglink/dsh-infinite-gen-5
DeepSeek v4.1 flash 最强逆向工具无限五代 求 Star 收藏 ⭐欢迎大家提交项目的改进
★ 4,143已汉化DSH
71.6
破甲评测WoYun520/dsh-purge
在本机分离宿主拦截与模型拒绝,做受控红队评测
★ 199已汉化DSH
69.7
手机智能助手jackwener/DSH-Android
免 ROOT 免 Termux,一个 APK 在安卓手机上跑 DeepSeek Harness。引擎内嵌 App 进程…
★ 840已汉化DSH
69.4
这个插件是你维护的吗?
作者本人可认领并核对本条目;认领通过后,详情页会显示「作者已认领」标记。