OfficeCLI

OfficeCLI 是全球首款且最优秀的专为 AI Agent 设计的 Office 套件。

让任何 AI Agent 都能通过一行代码，完全掌控 Word、Excel 和 PowerPoint。

开源、单一二进制文件、无需安装 Office、零依赖、可在任何环境下运行。

内置 AI 友好型渲染引擎 —— Agent 可以“看见”它们所创建的内容，完全无需安装 Office。支持将 .docx / .xlsx / .pptx 渲染为 HTML 或 PNG，在二进制文件运行的任何地方实现“渲染 → 查看 → 修复”的闭环。

English | 中文 | 日本語 | 한국어

💬 社区: Discord

---

为 AI Agent 设计 — 一行代码开启使用

将以下代码粘贴到你的 AI Agent 对话框中，它将自动读取技能文件并完成安装：

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

只需这样。该技能文件会教会 Agent 如何安装二进制文件以及如何使用所有命令。

面向个人用户

选项 A — GUI： 安装 AionUi —— 这是一款桌面应用，支持通过自然语言创建和编辑 Office 文档，底层由 OfficeCLI 驱动。只需描述你的需求，剩下的交给 AionUi 即可。

选项 B — CLI： 从 GitHub Releases 下载对应平台的二进制文件，然后运行：

officecli install

这将把二进制文件复制到你的 PATH 中，并将 officecli 技能 安装到它检测到的每一个 AI 编码 Agent 中 —— 包括 Claude Code、Cursor、Windsurf、GitHub Copilot 等。你的 Agent 将立即能够代表你创建、读取和编辑 Office 文档，无需额外配置。

面向开发者 — 30 秒快速上手

# 1. 安装 (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# Windows (PowerShell): irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex

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

# 3. 开启实时预览 — 在浏览器中打开 http://localhost:26315
officecli watch deck.pptx

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

完成。你执行的每一个 add、set 或 remove 命令都会实时刷新预览。继续尝试吧 —— 浏览器就是你的实时反馈环。

快速开始

# 创建演示文稿并添加内容
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
officecli add deck.pptx '/slide[1]' --type shape \
  --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
  --prop font=Arial --prop size=24 --prop color=FFFFFF

# 查看大纲
officecli view deck.pptx outline
# → Slide 1: Q4 Report
# →   Shape 1 [TextBox]: Revenue grew 25%

# 查看 HTML — 在浏览器中直接打开渲染后的预览，无需服务器
officecli view deck.pptx html

# 获取任何元素的结构化 JSON
officecli get deck.pptx '/slide[1]/shape[1]' --json

{
  "tag": "shape",
  "path": "/slide[1]/shape[1]",
  "attributes": {
    "name": "TextBox 1",
    "text": "Revenue grew 25%",
    "x": "720000",
    "y": "1800000"
  }
}

为什么选择 OfficeCLI？

过去需要 50 行 Python 代码和 3 个独立库才能完成的任务：

from pptx import Presentation
from pptx.util import Inches, Pt
prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[0])
title = slide.shapes.title
title.text = "Q4 Report"
# ... 45 more lines ...
prs.save('deck.pptx')

现在只需一条命令：

officecli add deck.pptx / --type slide --prop title="Q4 Report"

OfficeCLI 的功能：

• 创建：从零开始创建文档 —— 空白或包含初始内容
• 读取：读取文本、结构、样式、公式 —— 支持纯文本或结构化 JSON
• 分析：分析格式问题、样式不一致及结构性错误
• 修改：修改任何元素 —— 文本、字体、颜色、布局、公式、图表、图像
• 重组：重组内容 —— 在文档间添加、移除、移动、复制元素

格式	读取	修改	创建
Word (.docx)	✅	✅	✅
Excel (.xlsx)	✅	✅	✅
PowerPoint (.pptx)	✅	✅	✅

Word —— 全面支持 i18n 与 RTL（支持脚本内字体槽、BCP-47 语言标签 lang.latin/ea/cs、复杂脚本的加粗/斜体/字号、以及在段落/行内/节/表格/样式/页眉/页脚/默认文档设置中级联的 direction=rtl）。