夜雨聆风让 AI 生成一份 PPT，已经不稀奇了。真正折磨人的，是第二轮。
第 6 页标题挤出文本框，Excel 公式引用错了，Word 表格还要补一列。你只想改三个地方，AI 却重新生成了一份，原来的版式又乱了。
OfficeCLI 解决的就是这段麻烦：让 Agent 能找到 Office 文件里的具体对象，改完以后渲染出来检查，发现问题再继续修。
这个项目 2026 年 3 月才创建，截至 7 月 20 日已经接近 2 万颗星。我下载了最新的 1.0.139，在 Windows 上实际生成并修改了 Word、Excel 和 PPT，还专门做了两个失败实验。
先说结论：OfficeCLI 还不能替你决定一份报告该怎么写，但它补上了 Agent 操作 Office 文件时最缺的验收环节。
它给 Agent 的，不只是三个文件转换器
OfficeCLI 是一个命令行工具。一个独立可执行文件，就能直接读写 docx、xlsx 和 pptx，核心功能不要求电脑安装 Microsoft Office。
它把三种文件都变成了 Agent 容易理解的路径。比如第 1 页幻灯片里的第 3 个形状、Word 正文的第 2 段、Excel 的 Sheet1!A1，都能被单独读取和修改。执行结果还能统一返回 JSON，Agent 不必靠猜测判断命令有没有成功。
如果只做到这里，它和 python-docx、openpyxl、PptxGenJS 的区别还不算大。OfficeCLI 更值得关注的地方，是它围绕 Agent 补了 view、render、issues、validate、batch、dump、replay 这些能力，还能安装成 Skill 或启动 MCP Server。
也就是说，它考虑的不只是“把文件写出来”，还考虑 Agent 下一步怎么知道自己写得对不对。
真正有用的，是改完以后还能看
我故意做了一页有问题的 PPT：把 8 行文字塞进一个只有 1.1 厘米高的文本框，字号设成 22。
修复前：文字已经挤出文本框
OfficeCLI 的 issues 检查没有只告诉我“可能溢出”，而是给出了具体结果：8 行文字需要 176pt，高度只剩 14pt，并建议把文本框增高到 6.85 厘米。
我按这个提示把文本框调到 7 厘米、字号降到 18，再次检查，问题数量从 1 变成 0。
修复后：重新渲染并检查，issues 为 0
这才是它最有价值的工作方式：定位对象，修改文件，渲染预览，检查问题，再继续修。Agent 不再交出文件就结束，而是有机会完成一次最基本的自检。
批量改到一半失败，文件会不会毁掉
Office 自动化还有一个很现实的问题：一批修改执行到一半，后面的命令报错了，前面已经写进去的内容怎么办？
我先在 Excel 的 A1 写入“原始值”，再提交一组批处理。第一步把它改成“不应留下”，第二步故意访问一个不存在的工作表。
第二步按预期失败，返回结果明确标记 atomicRolledBack: true。重新读取 A1，仍然是“原始值”；文件修改前后的 SHA256 也完全相同。
这听着不如“AI 自动做 PPT”吸引眼球，却更接近生产需求。改十个地方，成功九个、悄悄坏一个，往往比全部失败更难处理。
能修文件，不等于会做设计
OfficeCLI 的维护者在 issue 里说得很直接：它是工具箱，不是那个替你判断 60 页报告该删什么、留什么、怎么排版的“大脑”。
Agent 的任务拆错了，OfficeCLI 会很准确地执行错误命令；版式缺乏审美，它也不会凭空变成设计师。它能查出文本溢出、引用异常和部分结构问题，但 validate 通过，也不代表 Excel、PowerPoint 或 WPS 打开后一定毫无问题。
项目近期刚修过一个很典型的问题：删除 Excel 工作表后遗留了无效引用，OpenXML Schema 校验通过，Excel 却拒绝打开。1.0.139 已增加对应检查，但它也提醒我们，格式合法和软件真正可用不是一回事。
目前还有几类边界没有完全解决：Mac PowerPoint 对个别形状的兼容问题、Excel 截图遗漏浮动图表、单元格图片 dump 后无法完整 replay。高风险文件交付前，仍然应该在目标 Office 或 WPS 里打开验收。
谁值得用它
如果你已经有一套稳定的 Excel 脚本，只处理固定模板，没有必要为了新名词重写。
但如果 Agent 需要同时处理 Word、Excel 和 PPT，要读取现有文件、精确修改局部内容，还要在交付前渲染、检查、修复，OfficeCLI 目前是一条很完整的开源路线。
最省事的尝试方法，是把项目地址发给 Codex 或 Claude Code，让它下载对应平台的 release，安装 OfficeCLI，再让它修改一份副本。运行 officecli install 后，还可以把内置 Skill 和 MCP 一起装进检测到的 Agent。
Windows 预编译文件目前没有数字签名。我下载的 1.0.139 官方文件与 release 提供的 SHA256SUMS 一致。介意这一点，可以先核对哈希，或者直接从源码构建。
OfficeCLI 最值得关注的，不是又多了一套操作 Office 的命令，而是它开始让 Agent 对自己的交付结果负责：改了哪里，文件有没有坏，画面有没有溢出，失败后能不能退回去。
AI 真正进入办公流程，靠的不会只是“生成”，而是生成以后还能检查、修正和追责。
项目地址：https://github.com/iOfficeAI/OfficeCLI
