OfficeCLI：给 AI Agent 的 Office 命令行套件

项目简介

OfficeCLI 是一个专为 AI Agent 设计的 Office 套件，通过命令行读写和自动化 Word、Excel、PowerPoint 文件。项目用 C# 编写，单一二进制文件，不需要安装 Office，也没有额外依赖，可跨平台运行，采用 Apache-2.0 开源协议。

它内置 HTML 渲染引擎，可以把 .docx / .xlsx / .pptx 渲染成 HTML 或 PNG，让 AI 能"看到"文档的渲染结果，从而完成 渲染 → 查看 → 修正 的闭环。官网上展示的 PPT、Word、Excel 示例，都是由 AI Agent 使用 OfficeCLI 从零生成的。

官网：https://officecli.ai

主要功能

• 创建：从零生成空白或带内容的文档
• 读取：读取文本、结构、样式、公式，可输出纯文本或结构化 JSON
• 分析：检查格式问题、样式不一致和结构问题
• 修改：改文字、字体、颜色、布局、公式、图表、图片
• 重组：添加、删除、移动、复制元素，支持跨文档操作

此外还有：

• 实时预览：officecli watch 启动本地预览，之后每次 add / set / remove 都会即时刷新浏览器
• Word 能力：i18n 与 RTL 排版、表格、页眉页脚、图片、LaTeX 公式、mermaid 图表转原生可编辑形状、批注、脚注、水印、书签、目录、图表、超链接、分节、表单域、内容控件、OLE 对象、修订与修订接受/拒绝等
• HTML 预览：officecli view 可直接渲染文档，无需额外服务器

安装与使用

交给 AI Agent 自动安装

把下面这条命令交给 AI Agent，它会读取 skill 文件并自动完成安装：

curl -fsSL https://officecli.ai/SKILL.md

手动安装

从 GitHub Releases 下载对应平台的二进制，然后运行：

officecli install

该命令会把二进制复制到 PATH，并把 officecli skill 安装到检测到的 AI 编码工具中（Claude Code、Cursor、Windsurf、GitHub Copilot 等）。也可以使用 brew install officecli 或 npm install -g @officecli/officecli。

30 秒体验

# 创建一个空白 PowerPoint
officecli create deck.pptx

# 启动实时预览，浏览器打开 http://localhost:26315
officecli watch deck.pptx

# 另开终端添加一页幻灯片，浏览器会即时更新
officecli add deck.pptx / --type slide --prop title="Hello, World!"

其他常用命令：

officecli view deck.pptx outline
officecli view deck.pptx html
officecli get deck.pptx '/slide[1]/shape[1]' --json
officecli close deck.pptx

图形界面

不想用命令行的话，可以安装桌面应用 AionUi，用自然语言创建和编辑 Office 文档，底层由 OfficeCLI 驱动。

注意事项

• 使用前不需要在本机安装 Microsoft Office。
• officecli watch 的本地预览默认地址是 http://localhost:26315。
• officecli close 会把驻留会话的内容写回磁盘，编辑完成后记得关闭。
• 各格式的详细参数和属性请参考仓库 Wiki 与 README。

本作品整理自 GitHub 开源项目 iOfficeAI/OfficeCLI，原作者 @iOfficeAI，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。