面向 AI Agent 设计的 Office 套件命令行工具，10.1k stars。单一二进制，无需安装 Office，让 Agent 直接创建、读取、修改 Word/Excel/PowerPoint 文件，并内置 HTML/PNG 渲染引擎让 Agent”看见”输出效果，形成 渲染→查看→修正 闭环。
概览
- 定位：AI Agent 原生 Office 自动化 CLI + MCP Server
- Star 数：10,105（2026-07-08）
- 语言：C#
- License：Apache 2.0
- 支持格式：Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx)，均支持读/改/建三种操作
三层架构
| 层级 | 用途 | 命令 |
|---|---|---|
| L1 Read | 语义化视图 | view（text/annotated/outline/stats/issues/html/svg/screenshot） |
| L2 DOM | 结构化元素操作 | get/query/set/add/remove/move/swap |
| L3 Raw XML | XPath 直接访问，通用兜底 | raw/raw-set/add-part/validate |
Agent 从只读视图起步，逐步升级到 DOM 操作，L2 不够用才回退到 L3 原始 XML，最小化 token 消耗。
核心能力
- 实时预览：
officecli watch deck.pptx起本地 HTTP 服务，浏览器自动刷新，每次add/set/remove即时可见；Excel watch 支持单元格内联编辑和图表拖拽 - Resident 模式：多步操作时文档常驻内存，避免重复读写磁盘；
OFFICECLI_RESIDENT_FLUSH=each可让每次操作立即落盘 - 确定性 JSON 输出：所有命令支持
--json，无需正则解析 stdout - 路径式寻址：
/slide[1]/shape[2]稳定路径，Agent 无需理解 XML 命名空间 - 内置公式/透视表引擎：350+ Excel 函数写入时自动求值（含动态数组溢出），原生 OOXML 透视表一条命令生成
- 自愈工作流：
validate、view issues返回结构化错误码（not_found/invalid_value/unsupported_property）和修正建议 - Round-trip dump：
dump把任意 docx/pptx/xlsx 转成可重放的 batch JSON，Agent 从人工样例学习结构而非裸读 OOXML
AI 集成方式
- 一行安装：
curl -fsSL https://officecli.ai/SKILL.md，Agent 读取 Skill 文件自动完成安装 - CLI 直接调用：
officecli install自动检测并向 Claude Code / Cursor / Windsurf / GitHub Copilot 等注入 skill - MCP Server：
officecli mcp claude/officecli mcp cursor/officecli mcp vscode一键注册，把所有文档操作暴露为 JSON-RPC 工具
特点
- 无需 Office：单文件二进制，Docker/CI/headless 环境可直接跑
- 多语言/RTL 全面支持：Word 侧支持复杂脚本字体、BCP-47 语言标签、RTL 级联（段落/字符/节/表格/样式全覆盖）
- 配套 GUI：AionUi 桌面应用基于 OfficeCLI 提供自然语言编辑 Office 文档的界面
- 官方 Skill 生态位：topics 显式标注 claude-code/codex/openclaw/skills，定位为多 Harness 通用能力扩展
相关页面
- markitdown — 文件转 Markdown（单向读取），与 OfficeCLI 的双向读写形成互补