univer-cli

Univer CLI

面向终端的创作与检查工具，适用于包含多个 Unit 的 .univer 文件。CLI 提供隔离的工作树、与版本匹配的 Facade 指引、模型回读和浏览器审阅。

安装：

npm install -g univer-cli
univer doctor

保持 CLI 更新

使用以下命令，将已安装的 CLI 与最新公开版本进行比较：

univer --version
npm view univer-cli@latest version --registry=https://registry.npmjs.org/

发现新版本时，请先完成当前 Univer 任务，再进行更新：

univer update
univer doctor --json
univer skills get core

如果 univer update 提示必须停止共享守护进程，请确认停止守护进程是安全的，然后使用 --force 重新运行。每次更新后，重新加载 core 和目标 Unit Skill。

从这里开始

此文件是发现入口，并非操作指南。使用 Univer 命令执行任务前，请从已安装的 CLI 加载完整的 core Skill：

univer skills get core          # shared model, workflow, evidence, and handoff
univer skills get core --full   # include direct references and templates

运行时 Skills 随 CLI 一同提供，因此其中的命令和 Facade API 与已安装版本匹配。

Core Model

• .univer 路径是包含多个 Unit 的权威目标。始终明确指定文件路径。
• Unit 是顶层的 Sheet、Doc、Slide、Base 或 Board，由 unitId 标识；工作表名称、页面、表格、范围、形状和记录都位于该 Unit 内。
• trunk 是经过审阅的主线。工作树是 Agent 变更的隔离范围；不存在隐式的当前工作树。
• 命令成功并不能证明结果正确。请回读目标模型、验证任务特定的断言，并在外观重要时检查渲染输出。

使用公开的 CLI 和 Facade 接口。工作树提交路径是持久写入边界，合并仍须经过明确的审阅决策。

Unit Skills

加载 core 后，在创作前加载与目标顶层 Unit 匹配的 Skill：

univer skills get sheet
univer skills get doc
univer skills get slide
univer skills get base
univer skills get board

使用 univer skills list 查看已安装的 Skills。每个 Unit Skill 负责其创建流程、Facade 入口、回读指南和视觉验证要求。

进行跨 Unit 组合时，在宿主和子 Unit Skills 之后加载额外的 Topic Skill：

univer skills get embed

在 Sheet 单元格或由公式驱动的 Shape 中使用跨 Unit 公式时，在 Host 和 Sheet 或 Base Source Unit Skills 之后加载其 Topic Skill：

univer skills get cross-unit-formula

任务路由

任务	加载并使用
检查或编辑电子表格值、公式、格式、图表或表格	core + sheet
创建或润色文档段落、富文本、表格、图表或页面布局	core + doc
创建或审阅演示文稿页面、形状、文本或图像	core + slide
创建或编辑结构化 Base 表格、字段、记录或视图	core + base
创建或编辑 Board 画布、图表及其他元素	core + board
在一个 Unit 中嵌入另一个 Unit	core + 宿主 Unit + 子 Unit + embed
从 Sheet 单元格或由公式驱动的 Shape 中读取 Sheet 范围或 Base 表格列	core + Host Unit + Source Unit + cross-unit-formula

为什么使用 Univer CLI

• 一个 .univer 目标可以包含 Sheet、Doc、Slide、Base 和 Board Units，并通过 unitId 指定。
• 工作树会隔离 Agent 变更，直至审阅和合并。
• 离线 api show / api find 可解析已安装 SDK 中的确切 Facade 符号。
• 运行时回读和查看器可验证已存储的模型及渲染结果。
• 导入、导出和截图使用产品运行时，而非无关的文件写入工具。

请勿直接编辑 .univer 存储，也不要替换为无关的写入工具。请遵循已加载的 core 和 Unit Skills，使用受支持的路径。

诊断

univer --help
univer doctor
univer skills list
univer skills path

使用 univer help <command> 查看准确语法。如果 CLI 不可用，或 doctor 报告了阻塞性运行时故障，请停止并报告诊断结果，而不要改用其他工具。