OfficeCLI 开源 Office 智能体工具：Word、Excel、PPT 能做什么，怎么验收
编辑标准与来源政策: 编辑标准, 团队. 内容均链至原始来源，见 方法论.
核对日期：2026-07-28。
先看关键数字
截至 2026-07-28，官方仓库约 2.27 万 stars、1532 forks，Apache-2.0；项目创建于 2026-03-15。单文件二进制支持 macOS Intel/Apple Silicon、Linux x64/ARM64、Windows x64/ARM64，不要求安装 Microsoft Office；支持 docx、xlsx、pptx 的读取、修改、创建，并可渲染 HTML/PNG。
这类基准最有价值的地方，不是再造一张总榜，而是把任务拉长以后，暴露模型在搜索、记忆、规划、导航和工具调用上的断点。分数来自发布方给定的环境和配置，适合用来决定是否值得复测，不适合直接替代你自己的任务验收。
它到底测了什么
公开结果至少要拆成四层看：题目或环境怎样构造、允许模型调用什么工具、一次任务能走多少步、最后如何判分。只比较最终百分比，会漏掉调用次数、重试、延迟和外部搜索费用。对生产团队来说，同样的准确率，如果一个方案要 60 次工具调用，另一个只要 20 次，预算和故障面完全不同。
它和 python-docx、openpyxl、python-pptx 有什么不同
传统自动化通常要为 Word、Excel、PowerPoint 分别接库，再自己补渲染和视觉检查。OfficeCLI 把三种格式统一成路径选择器和 create、add、get、set、remove 等命令，并内置 HTML/PNG 渲染。对 Agent 来说，关键增量是能形成“修改文件 → 渲染 → 看结果 → 再修”的闭环，而不是只操作文档 XML。
官方 README 的最小流程是创建 deck.pptx，用 officecli watch deck.pptx 在本地 26315 端口预览，再用 officecli add 添加幻灯片或形状。officecli view deck.pptx outline 可读结构，officecli get ... --json 返回指定元素的结构化属性。安装可走 Homebrew、npm、Scoop 或 Releases 中的原生二进制。
支持范围很大，但要按文件类型分别验收
Word 覆盖段落、样式、表格、页眉页脚、图片、批注、脚注、目录、修订等；Excel 覆盖公式、表、图表、透视表、切片器、条件格式和数据验证；PowerPoint 覆盖形状、图片、表格、图表、动画、切换、备注和主题。功能列表长不代表每一种复杂文件都能无损往返。
含宏的 xlsm、第三方字体、旧版二进制格式、复杂 SmartArt、外部链接、受密码保护文件和企业模板，都应单独列入回归。项目宣称无需安装 Office，意味着解析与渲染由自己的引擎完成，也意味着最终输出仍应在目标办公套件中打开检查。
Agent 安装方式需要多看一步
README 提供让 Agent 读取远程 SKILL.md、一行脚本安装或运行 officecli install 的快捷方式。方便不等于无需审查。企业环境应固定 release 版本和校验值，先查看脚本，再在无生产凭据的容器或测试账号里安装。自动更新可用 OFFICECLI_SKIP_UPDATE=1 或配置关闭，便于把回归结果和二进制版本对应起来。
Apache-2.0 允许较宽松使用，但文档内容、字体、模板、图片和输出中的第三方素材仍有各自权利。开源许可证解决的是工具代码许可，不会自动清理输入文件的版权或隐私责任。
怎么把公开结果变成自己的测试
先挑 20 到 60 个已有标准答案的任务，按单步、多步、冲突信息分层。锁定模型版本、工具、最大步数和预算，保存完整轨迹。除了成功率，还记录错误动作、无效搜索、引用是否可打开、恢复次数、耗时和总费用。公开榜单只能帮助选候选，是否上线仍由这组任务决定。
实际案例
财务运营团队拿一份 18 页季度 PPT、一个含 6 张表和 42 个公式的 Excel，以及一份 12 页 Word 模板做回归。Agent 只修改副本：更新 14 个数字、两张图表和三段说明，再渲染 PNG 对比。验收要求公式不丢、图表数据一致、字体替换不超过 2 处、文件可在 Microsoft Office 和 LibreOffice 打开。出现宏丢失、公式结果变化、版式越界或安装脚本未经审查，就回滚到原文件。
读结果时最容易犯的错
- 把发布方成绩写成独立复现。
- 把模型名称相同视为推理配置完全相同。
- 只看成功率，不看调用数、失败轨迹和成本。
- 用静态问答成绩推断动态环境里的持续行动能力。
- 在来源、版本或运行参数缺失时仍做采购结论。