用途:通过 univer-workspace-cli 让智能体连接远程 Univer Workspace,创建、编辑、审阅文档内容。
安装与配置:安装前先检查是否已可用。缺失时在智能体运行环境中执行:npm install --global univer-workspace-cli@latest。默认服务为 https://space.univer.ai/,除非任务指向其他服务,否则保留已有 origin。指定部署时配置实际 origin,勿照搬占位符:univer-workspace-cli config set workspace.origin <origin>,随后用 univer-workspace-cli whoami --json 检查。
认证:需要时执行 univer-workspace-cli login --json 启动浏览器授权登录,将返回的验证 URL 和 code 交给用户,然后停止并等待回复,不要在审批期间轮询。用户确认后执行一次 univer-workspace-cli login --complete --json。不要索取用户密码或复制浏览器 Cookie;失败时按诊断处理,不要循环。
加载操作指南:操作前读取已安装核心 Skill,可执行 univer-workspace-cli skills get core 与 skills list。创作前按内容类型加载 Unit Skill(sheet、doc、slide、base 或 board)。其他内容可加载 blob 或 html-view;组合 Unit 时可加载 embed 或 cross-unit-formula。用 skills get <name> --full 获取全部引用,或用 skills read <name> <resource-path> 读取。
执行任务:确认目标 Space 与文件,使用返回 ID。新建可编辑 Unit 时创建新 Worktree;只读检查无需草稿。按加载的 Skill 创作并核验,读回存储内容,外观相关检查渲染输出。指向 Issue 时先用 issue get 读取。完成后交付含审阅 URL 的结果,合并或丢弃由用户决定。Blob 与 Space 组织写入为直接操作,不走 Worktree 审阅。
诊断与升级:用 --help 查看语法,用 doctor --json 诊断。升级需完成当前工作后用 npm 安装新包,本 CLI 无 update 命令,升级后重载 core 与相关 Skill。具体命令细节以已安装 CLI 对应版本的 Skill 为准;其余限制资料未提供。