iOfficeAI OfficeCLI

好的，这是您要求的英文文章的中文翻译，已按照规范处理格式、保留技术术语和代码块。

OfficeCLI 是全球首个也是最好的、专为 AI 智能体设计的 Office 套件。只需一行代码，即可让任何 AI 智能体完全控制 Word、Excel 和 PowerPoint。开源。单一二进制文件。无需安装 Office。无依赖。随处运行。

OfficeCLI 内置的 HTML 渲染引擎能够高保真地重现文档——这赋予了 AI 一双“眼睛”。它能将 .docx / .xlsx / .pptx 文件渲染为 HTML 或 PNG，从而闭环实现“渲染 → 查看 → 修正”的流程。

English | 中文 | 日本語 | 한국어 🌐 网站: officecli.ai | 💬 社区: Discord

在 AionUi 上使用 OfficeCLI 创建 PPT 的过程 PowerPoint 演示文稿 — Word 文档 — Excel 电子表格以上所有文档均由 AI 智能体使用 OfficeCLI 完全自主创建——无需模板，无需手动编辑。

面向 AI 智能体 — 一行代码开始使用

将此命令粘贴到您的 AI 智能体聊天中——它将读取技能文件并自动完成所有安装：

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

就这么简单。该技能文件会教会智能体如何安装二进制文件以及如何使用所有命令。

面向人类用户

选项 A — 图形界面： 安装 AionUi —— 一款桌面应用程序，让您可以通过自然语言创建和编辑 Office 文档，其底层由 OfficeCLI 驱动。只需描述您的需求，AionUi 会处理其余一切。

选项 B — 命令行界面： 从 GitHub Releases 下载适用于您平台的二进制文件，然后运行：

officecli install

这会将二进制文件复制到您的 PATH 环境变量中，并将 officecli 技能安装到它能检测到的所有 AI 编码智能体中——包括 Claude Code、Cursor、Windsurf、GitHub Copilot 等。您的智能体可以立即代表您创建、读取和编辑 Office 文档，无需额外配置。

面向开发者 — 30 秒内亲眼见证

# 1. 安装 (macOS / Linux) — 或者: brew install officecli / npm install -g @officecli/officecli
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. 创建一个空白演示文稿
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

# 保存并关闭 — 将常驻会话刷新到磁盘
officecli close deck.pptx

{
  "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 行 ...
prs.save('deck.pptx')

现在只需一个命令：

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

OfficeCLI 能做什么：

创建文档——从空白开始或包含内容
读取文本、结构、样式、公式——以纯文本或结构化 JSON 形式
分析格式问题、样式不一致和结构问题
修改任何元素——文本、字体、颜色、布局、公式、图表、图片
重组内容——跨文档添加、删除、移动、复制元素

| 功能 | 格式 | 读取 | 修改 | 创建 | | :--- | :--- | :--- | :--- | :--- | | Word (.docx) | ✅ | ✅ | ✅ | ✅ | | Excel (.xlsx) | ✅ | ✅ | ✅ | ✅ | | PowerPoint (.pptx) | ✅ | ✅ | ✅ | ✅ |

Word — 完整的国际化与从右到左支持（按脚本的字体槽、按脚本的 BCP-47 语言标签 lang.latin/ea/cs、复杂脚本的粗体/斜体/字号、通过段落/运行/节/表格/样式/页眉/页脚/docDefaults 级联的 direction=rtl、rtlGutter + pgBorders 简写、针对印地语/阿拉伯语/泰语/中日韩文字的区域感知页码；create --locale ar-SA 自动启用 RTL）、段落（framePr、制表符简写、基于字符的缩进）、运行（underline.color、半磅单位的 position）、表格（虚拟列操作：添加/删除/移动/从复制、hMerge）、样式、文本框/形状（文本框：旋转、textDirection eaVert / vert270、渐变、阴影、透明度）、页眉/页脚、图片（PNG/JPG/GIF/SVG）、公式（LaTeX 输入）、图表（Mermaid → 原生可编辑形状，或任何 Mermaid 类型作为全保真 PNG）、批注、脚注、水印、书签、目录、图表、超链接、节、表单域、内容控件（SDT）、域（22 种零参数类型 + MERGEFIELD / REF / PAGEREF / SEQ / STYLEREF / DOCPROPERTY / IF）、OLE 对象、修订/跟踪更改（revision.type=ins|del|format|moveFrom|moveTo + revision.action=accept|reject，按目标 /revision[@author=Alice] 选择器，跟踪的查找替换）、页面背景颜色、文档属性

Excel — 单元格（添加时支持拼音指南/振假名，删除时支持 Excel 风格的 --shift left|up，添加时支持 shift=right|down）、公式（350+ 内置函数，支持自动求值、溢出动态数组并自动添加 _xlfn. 前缀、财务/债券和统计函数族、OFFSET/INDIRECT、解析时内联已定义名称的公式体、在插入行/列时重写公式引用）、工作表（可见/隐藏/深度隐藏、打印边距、printTitleRows/Cols、RTL sheetView、级联感知的工作表重命名、打开时过滤空单元格膨胀）、布尔值