OfficeCLI
让 AI 智能体通过命令行创建、读取、编辑并检查 Word、Excel 和 PowerPoint 文件。
构建工作流默认仅授予 contents: read，并将发布写权限限制在发布作业；macOS 产物经过签名、权限检查和公证，npm 使用短期 OIDC、provenance，发布还生成 SHA-256 清单。文档明确说明文件写入、驻留会话延迟落盘、本地预览服务器、自动更新、PATH 与代理技能安装等外部效果，并提供关闭自动更新的方法。扣分在于：裸运行即可触发安装，文档未展示覆盖文件、修改 PATH、安装代理技能或自动更新前的逐项确认；未完整说明更新、安装、MCP、外部图片或渲染资源的数据流；对敏感文档的日志、临时文件、网络隔离和清理策略未说明。批处理默认原子回滚是强证据，但普通单命令编辑、安装和更新没有通用撤销或备份机制。Apache-2.0、项目名称、网站和仓库组织提供了来源线索，但发布者身份仍未获企业注册验证，具体维护主体也不完全明确。
README、构建矩阵和发布流程对平台名称、安装渠道和基本命令大体一致，并有多平台创建、编辑、读取、关闭及安装烟雾测试。安装脚本还验证生产镜像和 GitHub 回退，支持自包含二进制及多种包管理器，因此普通环境的依赖可用性证据较好。扣分在于大量功能没有对应的源内测试证据；“无依赖、随处运行”等绝对表述与浏览器渲染、网络安装及平台限制之间缺少细化。工作流包含明确的版本校验、文件存在检查和失败退出，但未提供 CLI 错误格式、诊断指南或常见失败信息的系统说明。
资料分别覆盖 AI 代理、普通用户、开发者和团队，并列出报告生成、批处理、CI/CD、容器、模板填充和质量检查等具体场景，受众与场景说明充分。三层架构、格式能力表、平台二进制矩阵、环境变量以及 resident、batch、MCP 和原始 XML 回退展示了良好的环境适配。扣分在于能力边界主要以广泛支持清单表达，对不支持或部分支持的 OOXML 特性、兼容性差异和资源上限说明不足；路径选择器与操作命令较精确，但面向代理的自动触发条件、危险操作约束和何时必须请求用户确认没有完整定义。
README 按受众、快速开始、能力、用例、安装、架构和集成组织，示例丰富，并提供多语言入口和大量专题文档链接。安装渠道、平台文件名、版本验证、配置位置和更新关闭方式都很具体；完整 Apache-2.0 文本与元数据一致。扣分在于命令和包名存在 officecli、@officecli/officecli 与 @aionui/officecli 多入口，兼容和弃用策略未说明；已知限制只零散出现在驻留落盘、签名和 npm 注释中，没有集中限制清单或 FAQ。标签触发、自动生成 release notes 和版本命令构成更新路径，但所给材料没有独立 changelog、版本支持周期或明确维护者名单；安全报告由仓库私密渠道接收，却只承诺在“合理时间”响应。
文本、结构化 JSON、HTML、PNG、实时预览、模板合并、可重放批处理以及细粒度 DOM/XML 操作为代理和自动化管线提供了直接可消费的输出，示例清楚展示了典型结果。将三种 Office 格式、渲染、公式和透视表能力集中到单一 CLI，相比多个格式专用库具有明显的潜在边际价值。扣分在于“第一、最好、高保真、任意元素、随处运行”等效益主张主要是项目自述；二进制体积、启动与渲染成本、大文件性能、资源消耗、兼容损失及采用风险没有量化，因此成本收益只能评为充分但不完整。
具体安装、发布、签名、公证、校验和、平台矩阵及烟雾测试主张可在工作流与安全、许可文件间交叉核对，README 也为许多功能指向专题资料。扣分在于本次材料未包含实现代码、专题文档正文、测试结果或生成样例的可审计来源，因而大部分细粒度格式能力只能追溯到 README 声明。多份文件对发布和安装流程形成一定互证，但功能正确性、高保真度和覆盖范围缺少独立源内佐证；营销性事实与推断未严格区分，尤其“世界第一和最好”“所有文档完全由 AI 创建”等说法没有给出证明方法。
- 不要在未审阅固定版本脚本的情况下直接执行 README 中的 curl|bash、irm|iex 或远程 SKILL.md 安装指令。
- 裸运行 officecli 可能触发自安装，officecli install 还会写入 PATH 位置并向检测到的代理安装技能；在受管环境中应先隔离验证。
- 自动更新默认在后台检查；需要可重复或离线运行时，应固定版本、校验 SHA-256，并禁用自动更新。
- 处理机密 Office 文件前，应确认临时文件、日志、截图、HTML 输出、本地预览服务器、外部资源和 MCP 的数据暴露行为。
- 驻留模式可能延迟写盘；交付、上传或交给其他工具读取前应显式 save 或 close，并保留原文件备份。
- README 中关于第一、最好、高保真、全功能和随处运行的主张没有在所给材料中得到充分独立验证。
这个 Agent 能做什么，适合哪些场景？
OfficeCLI 是面向 AI 智能体和自动化流程的 Office 文档命令行套件，核心支持 .docx、.xlsx 与 .pptx。它以自包含的原生二进制发布，可在 macOS、Linux 和 Windows 上运行，使用时不要求安装 Microsoft Office 或单独配置 .NET 运行时。产品同时提供 CLI、JSON 输出、常驻管道 SDK 和内置 MCP 服务器，并能为 Claude Code、Codex、Cursor、VS Code 等工具安装技能文件。其三层接口包括语义化的 view、基于稳定路径的 DOM 操作，以及作为兜底方案的 raw/raw-set XML 访问。内置渲染器可以生成独立 HTML、逐页 PNG 截图和自动刷新的浏览器预览，使智能体能够执行“渲染—观察—修正”流程。
典型流程从 officecli create 创建文档开始，再通过 add、set、remove、move、swap 等命令操作段落、单元格、工作表、幻灯片、形状、表格、图表和图片。get 与 query 可按路径或选择器读取元素，并用 --json 返回结构化结果；view 可输出文本、提纲、批注视图、问题报告、HTML、SVG 或截图。validate 检查 OpenXML 结构，view <file> issues 枚举文本溢出、缺少替代文本和公式错误等问题。batch 可原子执行多项修改，open/save/close 通过常驻模式减少多步工作流的启动开销。merge 使用 JSON 数据替换三种格式中的 {{key}} 占位符，dump 将文档或子树序列化为可由 batch 重放的 JSON。对于 Excel，它还会在写入时计算所支持的公式并生成原生 OOXML 数据透视表；对于智能体集成，可通过 officecli mcp 启动或注册 JSON-RPC 工具服务。
- 开发团队在 CI/CD 或容器环境中依据测试结果生成 Word 报告、Excel 工作簿或 PowerPoint 汇报，不在服务器上安装 Office。
- AI 应用开发者需要让 Claude Code 或 Codex 读取现有文档、修改指定元素，并以确定性的 JSON 接收结果和错误信息。
- 运营或财务团队需要批量填充统一的发票、季度报告或演示文稿模板，同时避免逐份重新生成版式。
- 数据团队需要把 CSV/TSV 导入工作表、写入并计算公式、创建图表或数据透视表，再交付为 .xlsx 文件。
- 内容制作人员希望让多模态智能体生成演示文稿，并通过 HTML、PNG 或 watch 实时预览检查遮挡和文本溢出。
- 维护人员需要批量查找替换、更新样式、验证文档结构，或从现有文件 dump 出可修改和重放的文档蓝图。
这个 Agent 有哪些优点和局限？
- 一个跨平台、自包含二进制同时处理 Word、Excel 和 PowerPoint，无需安装 Office 或分别组合 python-docx、openpyxl、python-pptx。
- CLI 的稳定元素路径、统一 --json 输出、结构化错误码和属性纠错建议，适合智能体自动导航与自我修正。
- 内置 HTML、PNG 和实时预览能力为无界面环境提供可视化检查闭环，而不只是读取文档 XML。
- merge、dump/batch、原子批处理和常驻模式覆盖模板复用、大批量生成及低延迟连续编辑。
- 同时提供技能文件、MCP 服务以及 Python/Node.js 常驻管道 SDK，接入方式不局限于单一模型提供商。
- 核心格式范围是 .docx、.xlsx 和 .pptx；旧版 .doc/.xls/.ppt 未列为原生支持，PDF 导出等能力需要插件。
- 高级文档特性可能要求使用复杂的路径、选择器，甚至 raw/raw-set 和 OpenXML 知识，采用成本高于简单的模板填充工具。
- 常驻模式会延迟磁盘写入；若外部程序立即读取文件，流程必须显式调用 save/close 或配置 OFFICECLI_RESIDENT_FLUSH。
- 从源码构建要求 .NET 10 SDK，虽然发布的自包含二进制在运行时不需要单独安装 .NET。
- 安装、自动更新以及通过软件包管理器获取二进制依赖网络；在隔离环境中需要预先下载并分发对应平台文件。
如何安装或部署这个 Agent？
macOS 或 Linux 可运行：
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bashWindows PowerShell 可运行：
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex也可使用 brew install officecli、scoop install officecli 或 npm install -g @officecli/officecli。安装包是包含运行时的自包含二进制，无需安装 Microsoft Office；从源码编译才需要 .NET 10 SDK。安装后运行 officecli --version 验证。下载和后台更新检查需要网络，文档操作需要对目标文件具有读写权限。
如何使用这个 Agent？
创建并预览一个可工作的演示文稿：
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
officecli add deck.pptx '/slide[1]' --type shape --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm --prop size=24 --prop color=FFFFFF
officecli view deck.pptx outline
officecli view deck.pptx html
officecli get deck.pptx '/slide[1]/shape[1]' --json
officecli close deck.pptx实时预览可运行 officecli watch deck.pptx。注册集成可使用 officecli mcp claude、officecli mcp cursor 或 officecli mcp vscode。常驻模式中的修改在交给其他程序读取前，应执行 officecli save <file> 或 officecli close <file> 将内容刷新到磁盘。
这个 Agent 与同类方案有什么区别？
与 Microsoft Office 相比，OfficeCLI 不依赖桌面应用或 COM/Add-in，并面向命令行、JSON、无界面和 CI 场景，但不提供传统 Office GUI。与 LibreOffice 相比，它强调 AI 原生的路径寻址、结构化输出、模板合并、文档 dump/batch 重放和内置实时预览。与 python-docx、openpyxl、python-pptx 相比，它用一个跨语言 CLI 覆盖三种格式，并提供渲染和原始 XML 兜底；Python 库方案则通常需要分别安装库并自行编排。