OfficeCLI
一句话定义
OfficeCLI 是面向 AI Agent 的 Office 文档 CLI，允许 Agent 以结构化命令创建、读取、验证和修改 Word、Excel、PowerPoint 文件，并通过 HTML/PNG 渲染形成“render → look → fix”的闭环。
摘要
Office 文档一直是 Agent 自动化的高摩擦领域：Python 库能改 OpenXML，但模型很难稳定理解真实版式；GUI 自动化能看见结果，但修改路径脆弱；Office 本体又依赖桌面安装和平台差异。OfficeCLI 的定位是给 Agent 一个单二进制、无 Office 依赖、可读可写可渲染的中间层。它把 .docx、.xlsx、.pptx 暴露为路径化 DOM，支持 create/view/get/query/add/set/remove/validate/watch 等命令，并提供静态 HTML、截图、实时预览和浏览器点击选择，让 Agent 可以先读结构，再改节点，再看渲染，再修正。
详情
起源与背景
README 把 OfficeCLI 称作“designed for AI agents”的 Office suite，强调它不是给人替代 Office GUI，而是给 Agent 读写 Word、Excel、PowerPoint 的能力层。其 SKILL.md 更清楚：使用策略是 L1 读取、L2 DOM 编辑、L3 raw XML；遇到不确定属性、值格式或命令语法时先跑 officecli help，避免模型猜参数。这体现了典型 Harness 思维：让确定性 schema 和 CLI 承担格式细节，模型只做判断和规划。
核心机制 / 工作原理
OfficeCLI 以文件扩展名识别文档类型，提供统一命令面。view outline/stats/issues/text/annotated/html 用于读取；get 和 query 用路径或 CSS-like selector 定位元素；set 修改属性或执行 find/replace；add 新增元素；validate 做 OpenXML 校验；watch 启动本地预览服务并支持浏览器选择元素。常驻 resident mode 会自动启动，减少反复文件 I/O 和文件锁冲突。
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
officecli view deck.pptx outline
officecli get deck.pptx '/slide[1]/shape[1]' --json
officecli watch deck.pptx应用 / 使用场景
- 让 Claude Code、Codex、OpenClaw 等 Agent 直接生成 PPT、报告、表格和图表。
- 在 CI 或无人值守环境中批量校验文档结构、格式问题和内容问题。
- 从 Office 文件抽取结构化 JSON 给 Agent 分析，再把修改精确写回节点。
- 通过 HTML/PNG 渲染验证视觉结果，减少“结构正确但版式坏掉”的盲点。
局限与争议
OfficeCLI 的强项是结构化文档自动化，不等于替代所有设计判断。Agent 仍需要懂内容层级、视觉审美和交付场景；复杂排版最好配合截图/HTML 预览反复验证。另一个边界是 schema 面广：Word、Excel、PowerPoint 的属性空间巨大，必须让 Agent 养成先查 officecli help 的习惯，否则容易用错属性名或单位。
与其他实体的关系
- Claude-Code —— OfficeCLI 以 skill 形式教 Claude Code 安装和使用命令。
- OpenClaw —— README 列出 OpenClaw 作为支持安装/使用的 Agent 环境之一。
- Cua —— Cua 解决桌面操作，OfficeCLI 解决 Office 文件结构化编辑，两者共同补 Agent 的非代码工作能力。
- Ponytail —— Ponytail 倡导少写不必要代码，OfficeCLI 则把复杂 Office 操作压缩成少量可验证命令。