OfficeCLI

OfficeCLI 快速入门

首个专为 AI Agent 打造的 Office 套件——单二进制文件，零依赖，AI Agent 原生读写 Word/Excel/PPT。

这是什么？适合谁？

OfficeCLI 是一个专为 AI Agent 设计的 Office 文档处理工具。它不需要安装 Microsoft Office 或 LibreOffice——一个单二进制文件就包含了完整的 Word/Excel/PPT 读写能力。AI Agent 可以直接通过 CLI 命令行调用它来创建报告、生成表格、制作演示文稿。

传统方案中，让 AI 生成 Office 文档需要依赖 python-docx、openpyxl 等 Python 库，需要编程环境和大量代码。OfficeCLI 把这一切简化为一组命令行指令，AI Agent 可以直接调用。

适合：需要 AI Agent 自动生成 Office 文档的开发者、批量文档处理自动化、Agent 驱动的报告生成工作流、CI/CD 中的文档自动化。

准备工作

• 下载二进制文件：访问 officecli.io 下载对应平台版本
• 系统：Windows / macOS / Linux 均支持
• 无需安装 Microsoft Office 或任何依赖
• External Mode（免费）：自带模型，本地运行
• Hosted Mode（按量付费）：云端处理，适合复杂文档

3 步快速上手

第 1 步：下载并安装

# macOS/Linux
curl -L https://officecli.io/install.sh | bash

# 或直接下载二进制
# 从 https://officecli.io/download 获取对应平台版本
chmod +x officecli
sudo mv officecli /usr/local/bin/

第 2 步：验证安装

officecli --version

应该显示版本号和可用模块（Word/Excel/PPT）。

第 3 步：生成第一个文档

# 创建 Word 文档
officecli word create --title "月度报告" --content "这是 AI 自动生成的报告内容"

# 创建 Excel 表格
officecli excel create --data '[["姓名","分数"],["张三",95],["李四",87]]' --output scores.xlsx

# 创建 PPT 演示文稿
officecli ppt create --title "项目汇报" --slides 5 --template business

进阶用法

AI Agent 集成

OfficeCLI 设计为 AI Agent 友好，Claude Code、Codex、Copilot 等 Agent 可直接调用。示例 prompt：

请使用 officecli 帮我生成上周的销售数据报告：
1. 从 sales.csv 读取数据
2. 用 officecli excel 分析数据
3. 用 officecli word 生成报告文档
4. 用 officecli ppt 生成汇报 PPT

External Mode（免费，本地运行）

External Mode 不需要任何 API Key，完全本地运行，数据不出设备：

officecli --mode external word create --title "机密文档" --content "本地处理的内容"

Hosted Mode（云端，按量付费）

处理复杂文档（如 100 页+的 Word 或含大量公式的 Excel）时，Hosted Mode 提供更强的处理能力：

officecli --mode hosted --api-key YOUR_KEY excel create --data @large-dataset.json

格式转换

# Word 转 PDF
officecli convert --from report.docx --to report.pdf

# Excel 转 CSV
officecli convert --from data.xlsx --to data.csv

# PPT 转图片
officecli convert --from slides.pptx --to slides-images/

常见问题 FAQ

Q1：OfficeCLI 真的不需要安装 Microsoft Office 吗？

A：是的。OfficeCLI 是一个独立的二进制文件，内置了完整的 Office 文档格式处理引擎，不依赖任何外部 Office 软件。

Q2：External Mode 和 Hosted Mode 有什么区别？

A：External Mode 完全免费，本地运行，自带模型处理文档，数据不出设备。Hosted Mode 按量付费，使用云端更强的处理能力，适合处理超大或复杂文档。

Q3：生成的文档兼容性如何？

A：OfficeCLI 生成的 .docx、.xlsx、.pptx 文件完全兼容 Microsoft Office、Google Docs、LibreOffice 等主流办公软件，遵循 Office Open XML 标准。

Q4：AI Agent 如何调用 OfficeCLI？

A：OfficeCLI 提供标准 CLI 接口，任何能执行 shell 命令的 AI Agent 都可以直接调用。同时提供 JSON 输出模式（--output json）方便 Agent 解析结果。

参考链接

• OfficeCLI 官网
• GitHub 仓库
• Apache-2.0 License