dream-num/univer-workspace

Univer Workspace – AI 增强型办公套件

是什么 – 一个基于 Univer Office SDK 构建的开源、可自托管办公环境。它结合了传统生产力工具（表格、文档、幻灯片、关系型数据表、看板等）与 AI 代理功能，这些代理可以通过对话界面读取、编辑和审阅文档。

关键组件

组件	角色
Workspace Browser	供人类创建、编辑和协作 Office 类型文件的 Web UI。
Workspace Server	存储文档、权限、二进制数据并执行 OpenAPI 合约的中央服务。
Workspace Agent	基于 DeepSeek Harness 构建的本地桌面应用程序，让 AI 代理能针对文件进行对话、在隔离的 Worktree 中进行草稿编辑，并呈现变更供人类审核。
Workspace CLI	供代理或脚本调用的命令行工具，用于以程序化方式加载、检查、修改、验证和渲染 Office 内容。

运作方式 – 服务器是所有数据的单一事实来源。人类通过浏览器交互，而代理则通过 CLI 或代理应用程序交互。代理在 Worktree（隔离的草稿）中进行编辑。一旦草稿准备就绪，人类会在浏览器或代理 UI 中审核变更，并决定合并或舍弃，从而保持主工作区的整洁。

主要使用场景

• 以人为本的协作 – 团队共同编辑表格、文档、幻灯片和看板，支持细粒度 ACL、回收站/最近查看以及文件导入/导出。
• AI 驱动的自动化 – 代理可以生成基于表格的微型应用程序（仪表板、报告）、渲染 PDF/PNG、执行布局检查，并在未经批准前执行多步骤编辑，而不影响正式主干。
• 自动化与脚本编写 – CLI 让现有的 LLM（Claude、Codex、Kimi 等）能够调用 Workspace CLI Skill，以可重现且版本控制的方式操作 Office 文件。
• 自托管部署 – 运营者可以运行单一浏览器 + 服务器实例，集成自定义验证（密码、GitHub、Discord、OAuth），并将产品、协作和二进制存储保持在自己的控制之下。

快速入门（来自 README）

# 前置需求
node >=24, pnpm 11

# 安装依赖
pnpm install
cp apps/workspace/.env.example apps/workspace/.env

# 运行服务器
pnpm workspace:dev:server

# 在另一个终端中，运行 Web UI
pnpm workspace:dev:web

# 在浏览器中打开 http://127.0.0.1:5173

服务器同时在 http://127.0.0.1:3020/openapi.yaml 公开 OpenAPI 规格。

添加 AI 代理 – 依照 apps/agent/README.md 安装桌面代理、配置 OAuth 回调并提供模型凭证。代理会与相同的服务器通讯、创建 Worktrees，并在聊天窗口旁显示文档预览。

CLI 使用方式 – 安装全局包 (npm i -g univer-workspace-cli) 后，配置目标工作区来源，运行 univer-workspace-cli login（依照 OAuth 流程），然后从任何由 LLM 驱动的代理调用指令或提供的 Skill。

架构亮点

• 权威服务器 – 所有身份、ACL、修订版本和二进制数据均集中存储；客户端绝不被信任为权威来源。
• 独立存储领域 – 产品数据、协作状态和原始二进制数据被独立管理，但通过幂等操作进行协调。
• 合约优先的 HTTP – OpenAPI 定义为服务器、浏览器和 CLI 生成类型，确保单一事实来源。
• Worktree 工作流程 – 隔离的草稿编辑 → Ready → 人类审核 → Merge/Reopen → 主干。
• 模块化包 – 核心客户端、HTML 查看器、Markdown 查看器、参考提供者和 DSH 插件均保留在私有包中；存储库仅负责组合它们。

许可 – Apache-2.0 (参阅 LICENSE)。

---

以上所有信息均直接取自存储库的 README；未推论出任何额外功能。