Univer Workspace CLI完全指南10个命令让Claude等AI智能体自动化办公任务【免费下载链接】univer-workspaceAn open-source Office workspace where people and AI agents create, collaborate, and review together.项目地址: https://gitcode.com/gh_mirrors/un/univer-workspaceUniver Workspace 是一个开源办公协作工作区让人与 AI 智能体在同一空间里创建、协作和审阅办公内容。其配套的命令行工具univer-workspace-cliUniver Workspace CLI把电子表格、文档、幻灯片、数据库和画板Sheet / Doc / Slide / Base / Board打包成一个专为 AI 智能体设计的操作环境让 Claude 等智能体能登录你的工作区、找到文件、编写内容、渲染验证并交付可审阅的成果。下面用 10 个核心命令带你快速跑通 AI 自动化办公的完整流程。为什么 AI 智能体需要这套办公 CLI传统对话式 AI 只能聊文档而 CLI 的设计哲学是人类定目标、看结果智能体走流程。整条链路如下人类提出需求例如把销售数据整理成表格并输出 PDF智能体读取版本匹配的操作指南Skills智能体调用 CLI 管理任务、编写内容CLI 验证数据与渲染结果返回可直接审阅的交付链接这套意图 → 执行 → 验证 → 审阅的闭环正是 Univer Workspace CLI 的核心价值官方说明见 apps/cli/README.md。快速安装3步搭建 AI 自动化办公环境第 1 步全局安装 CLInpm install --global univer-workspace-clilatest第 2 步安装配套的 Workspace CLI Skillnpx skills add dream-num/univer-workspace --skill univer-workspace-cli -gSkill 是智能体的操作手册随 CLI 版本匹配更新安装后即可发现智能体需要的工作流。第 3 步登录智能体友好的免密流程univer-workspace-cli login该命令会打印一个短时效的 Workspace URL 和验证码后立即退出——智能体把 URL 和验证码发给你你用自己的浏览器确认登录支持 GitHub、Discord 等一切已有登录方式再让智能体执行login --complete完成一次性的会话交换。全程智能体不接触你的密码或浏览器 Cookie登录逻辑见 apps/cli/src/features/auth/command.ts。 若部署了自己的 Workspace 服务先用univer-workspace-cli config set workspace.origin origin指向你的服务地址。10个核心命令速览#命令作用典型场景1config配置服务地址等参数对接自建 Workspace2login浏览器授权登录智能体首次连接3skills读取操作指南智能体学版本匹配的 API4space浏览个人/团队空间定位目标文件5worktree管理任务草稿区隔离编辑、审阅合并6unit创建办公单元新建表格/文档/幻灯片7import/exportOffice 文件互转Excel 导入导出8execute执行 Facade 代码智能体写入内容9screenshot渲染 PNG 截图视觉验证10print-pdf打印 PDF最终交付命令详解从找到文件到交付 PDF1️⃣space浏览空间找到目标文件univer-workspace-cli space list --json univer-workspace-cli space browse space-id --unit-type sheetspace browse支持按资源类型--resource-kind和单元类型sheet、doc、slide、base、board过滤space find则可按名称模糊搜索。智能体会用返回的 ID 而非名称来引用文件避免歧义。实现见 apps/cli/src/features/space/command.ts。2️⃣worktree用草稿区隔离任务安全可回退Worktree工作树是 CLI 最重要的协作概念智能体的所有修改都发生在独立的草稿分支上人类审阅满意后再合并不满意可丢弃——误操作不会污染正式文档。univer-workspace-cli worktree create --name Q4销售报表 --scope space --space id univer-workspace-cli worktree ready worktree-id # 标记就绪 univer-workspace-cli worktree merge worktree-id # 审阅后合并可用动作包括list、create、update、ready、reopen、merge、discard源码见 apps/cli/src/features/worktree/command.ts。3️⃣unit在草稿区创建五类办公单元univer-workspace-cli unit create --worktree id --space id --type sheet --name 销售明细--type支持五种sheet表格、doc文档、slide幻灯片、base数据库、board画板对应 apps/cli/src/features/unit/command.ts。4️⃣import/exportOffice 文件双向转换univer-workspace-cli import --file ./data.xlsx --worktree id --space id univer-workspace-cli export ./output.xlsx --worktree id --unit unit-idimport把 Excel 等 Office 文件导入为草稿区单元export再把成果导出为原始格式文件且保留原文件。命令实现见 apps/cli/src/features/exchange/command.ts。5️⃣execute智能体的手写笔——执行 Facade 代码这是 AI 写内容的核心命令。智能体通过 Univer Facade API 编写 JavaScript 代码对指定单元做读取或修改命令会自动提交变更修订univer-workspace-cli execute --worktree id --unit id --script ./write-report.js只读代码不会产生修订有写入时会返回committed revision。注意命令成功 ≠ 验证通过官方 Skill 明确要求读回存储内容、必要时检查渲染结果。实现见 apps/cli/src/features/content/command.ts。6️⃣screenshot渲染成 PNG让智能体用眼睛检查univer-workspace-cli screenshot --worktree id --unit id --out ./screenshots把表格/文档/幻灯片真实渲染为 PNG 图片智能体可以对比排版、对齐、溢出等问题这是渲染级验证而非仅数据级验证。7️⃣print-pdf一键打印 PDF 交付univer-workspace-cli print-pdf ./reports/q4.pdf --worktree id --unit id支持 Sheet、Doc、Slide、BoardBase 不可打印且已有输出文件永远不会被覆盖交付物安全可控。8️⃣skills智能体的版本匹配说明书univer-workspace-cli skills get core univer-workspace-cli skills get sheet --full univer-workspace-cli skills read sheet resource-pathSkills 随 CLI 一起安装并按版本匹配覆盖 Sheet、Doc、Slide、Base、Board、Blob、HTML View、嵌入单元与跨单元公式等主题确保智能体使用的 API 示例与本地安装的 SDK 完全一致从源头避免版本漂移。内置的 Skill 数据在 apps/cli/skill-data/ 目录下。9️⃣login与whoami连接诊断whoami --json快速确认当前身份与服务地址配合doctor --json可诊断运行时问题。智能体遇到阻碍时应报告具体问题而不是绕过 Workspace 工作流。config一切从这里开始config set workspace.origin origin指定 Workspace 服务地址默认为官方托管服务。自建部署的团队只需这一步即可把整套自动化流程接入自己的环境命令注册总览见 apps/cli/src/program.ts。一个完整的 AI 自动化办公工作流把上面的命令串起来就是一个典型的端到端任务用户把 sales.xlsx 做成幻灯片并给我 PDF ↓ AIspace find 定位文件 → worktree create 开草稿区 ↓ AIimport 导入表格 → unit create 建幻灯片 ↓ AIexecute 执行 Facade 代码填充内容 ↓ AIscreenshot 渲染截图自查 → print-pdf 生成交付文件 ↓ AIworktree ready 发送审阅链接 → 用户确认 → merge智能体负责跑完全部步骤人类只在最后审阅、合并——这正是人与 AI 智能体共同创建、协作与审阅的产品理念落地。新手避坑5条最佳实践⚠️先skills get core再动手不要依赖猜的 API以版本匹配的 Skill 为准。⚠️用 ID 而不是名称引用资源命令参数一律使用返回的spaceId/unitId/worktreeId。⚠️可编辑任务先开 Worktree只有只读检查才不需要草稿区。⚠️命令成功 ≠ 任务完成读回内容 渲染截图双重验证。⚠️合并权留给人类merge/discard应由用户决定智能体仅在有明确授权时执行。延伸阅读CLI 完整文档apps/cli/README.md智能体 Skill 入口SKILL.md命令注册与能力组合apps/cli/src/program.ts单元测试示例可学习命令契约apps/cli/test/Univer Workspace CLI 把 Univer SDK 的文档模型、协作、渲染与转换能力组合成一个智能体就绪的办公环境。装好它你的 Claude 就不再只是会聊天的助手而是一位能创建、编辑、验证并交付办公成果的数字同事。【免费下载链接】univer-workspaceAn open-source Office workspace where people and AI agents create, collaborate, and review together.项目地址: https://gitcode.com/gh_mirrors/un/univer-workspace创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考