SuperAPI AI 工具集

univer-office

办公与效率

查看项目

更新于 10-17 17:01

技能介绍

该技能用于通过 Univer Office 连接器提供的 univer_* MCP 工具,在本地处理 Univer Office 的多种内容类型,包括电子表格、文档、幻灯片、Base 数据表和 Board 画布。使用前需确认连接器已安装并连接;本技能自身不安装 Office 运行时,也不应改用全局 Univer CLI,或把未连接的连接器当作可用。

主要能力覆盖创建、编辑、检查、比较和导出。用户可按内容类型查阅内部参考:电子表格涉及公式、图表、透视表与 XLSX/CSV/TSV;文档涉及富文本、表格、分页与 DOCX/PDF;幻灯片涉及页面、SVG 编写与 PPTX/PDF;Base 涉及表、字段、记录、视图与导出;Board 涉及对象、连接线与图表;另有跨 Unit 嵌入与跨 Unit 公式的说明。

使用方式上,先用 univer_status 确认当前文件与 Unit。创建新内容可用 univer_new 建立 .univer 容器,用 univer_worktree 建立草稿,再用 univer_unit 指定内容类型。已有 Office 输入格式可通过 univer_import 导入 XLSX、CSV、TSV、DOCX 和 PPTX。写代码前用 univer_api 查看已安装的公开 Facade 方法;univer_execute 提供 workbook、doc、presentation、base、board 以及 api/univerAPI,并需显式选择工作表、页面或表格,不能按显示顺序推断。所有 Agent 写入都针对可编辑草稿,不直接写主干或已冻结的 ready 内容;应检查权威返回结果并提交后再报告成功。结果未知时应先检查当前状态再重试,不能盲目重复追加式修改。返回值需为 JSON 兼容值,不能是 Facade 对象、函数、循环引用或 undefined;序列化错误不能说明写入是否已提交。编辑后应回读实际内容与计算结果,用 SDK 截图做视觉验证,对变更的幻灯片页面用 univer_lint 检查。

预览与审阅方面,首次确认可见内容后、完成编辑后或用户要求时可调用 univer_preview;纯读取不应自动打开预览。Worktree 视图与比较始终只读;ready 表示冻结并等待人工审阅,重新打开仅允许 Agent 编辑;人工编辑仅在确认完整合并后的主干上通过限定编辑会话进行。合并与丢弃需明确人工审阅,应如实报告待审状态,不得提取仅用于界面的启动凭据来批准自己的工作。

交付方面,可用 univer_export 或 univer_print_pdf 在授权工作区生成新文件,不覆盖源文件或已有交付物。PDF 支持 Sheet、Doc、Slide 和 Board;Base PDF 与 Board 文件导出不受支持,Base 导出需解析并传入 baseSelection: {tableId, viewId?}。导出保真度重要时,应在独立的兼容阅读器中打开代表性 Office 导出文件检查;截图成功或文件存在不代表导出保真。复杂内容、跨 Unit 嵌入或公式、宿主完整安装与审阅仍在验收测试中,应说明实际执行的检查和具体缺口,不宣称完全支持。