iOfficeAI/OfficeCLI

OfficeCLI – 面向 AI 的命令行办公套件

是什么 – 一个单一的自包含二进制文件，允许程序（尤其是基于大语言模型的智能体）在无需安装 Microsoft Office 的情况下创建、读取、编辑和渲染 Microsoft Word、Excel 和 PowerPoint 文件。所有操作均通过简单的 CLI 命令暴露（officecli create …、officecli add …、officecli view …）。

对 AI 为何重要 – 该工具自带高保真 HTML/PNG 渲染引擎，因此大语言模型可以 准确看到 文档的实际外观，检测布局问题，并在“渲染 → 查看 → 修复”的紧密循环中进行修正。它还为任意元素提供结构化 JSON 输出，使智能体能轻松推理文档内容。

核心功能

• 创建 – 从零开始创建新的 .docx、.xlsx、.pptx 文件。
• 读取 – 以纯文本或详细 JSON 格式读取文本、样式、公式、图表、表格、图片、注释等。
• 修改 – 通过 add、set、remove 命令修改任意元素（文本、字体、颜色、布局、公式、图表、形状、视频、3D 模型等）。
• 渲染 – 将文档渲染为 HTML、PNG 截图，或实时刷新的本地网页预览（officecli watch）。
• 模板合并 – 将模板中的 {{key}} 占位符替换为 JSON 数据。
• 批量导出/回放 – 将整个文档或子树序列化为 JSON，用于可复现的编辑流水线。
• Excel 引擎 – 无需打开 Excel 即可评估 350 多个内置函数、动态数组、数据透视表、切片器、条件格式等。
• 完整格式支持 – Word、Excel 和 PowerPoint 均支持 读取-修改-创建（表格中的 ✓）。

典型工作流

# 安装（一行命令）
curl -fsSL https://officecli.ai/SKILL.md   # 用于 AI 智能体
# 或 curl …/install.sh | bash               # 用于人类

# 创建演示文稿并添加幻灯片
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 报告"

# 在该幻灯片上添加文本框形状
officecli add deck.pptx '/slide[1]' \
  --type shape --prop text="收入增长了 25%" \
  --prop x=2cm --prop y=5cm --prop font=Arial --prop size=24

# 在浏览器中即时预览
officecli watch deck.pptx   # http://localhost:26315 在每次命令后自动更新

Word（officecli add report.docx …）和 Excel（officecli add budget.xlsx '/Sheet1' --type cell …）也适用相同模式。

安装方式 – 以包含 .NET 运行时的单个二进制文件分发。可通过以下方式安装：

• 一行脚本（curl … | bash 或 PowerShell 等效）
• Homebrew、Scoop、npm（brew install officecli、scoop install officecli、npm i -g @officecli/officecli）
• 直接下载对应平台的二进制文件。

谁会受益

• AI 智能体（Claude Code、Cursor、GitHub Copilot 等）可使用单条命令生成或编辑 Office 文件，并获得视觉反馈。
• 开发者 可自动化报告生成、批量样式更新、CI/CD 文档流水线，或在容器中运行无头 Office 自动化。
• 团队 可克隆模板、填充数据，并自动验证文档。

了解更多 – 官方网站：https://officecli.ai，Discord 社区，以及各格式的详细 Wiki 页面（例如：Word 段落、Excel 数据透视、PowerPoint 动画）。