OfficeCLI:AI Agent的文档操作利器

仓库:OfficeCLI/officecli  |  ⭐ 28.9k  |  语言:C#  |  协议:Apache-2.0

项目简介

OfficeCLI 是一个单二进制命令行工具,让AI Agent能够创建、读取和修改Word、Excel、PowerPoint文档。它通过简单的命令行接口封装了复杂的Office文档操作,内置可视化渲染引擎,支持文档预览和格式转换。作为AI Agent的工具层,OfficeCLI填补了Agent与Office文档之间的交互鸿沟,无需安装Microsoft Office即可完成全套文档操作。

如果你需要将文档转换为Markdown供AI处理,可以参考 MarkItDown文档转换教程 了解更多文档处理方案。

核心功能与架构

命令组功能支持格式
doc create创建Word文档.docx
doc edit修改Word文档内容.docx, .doc
doc read提取Word文档文本.docx, .doc, .rtf
sheet create创建Excel工作簿.xlsx
sheet edit修改单元格、公式.xlsx, .xls
sheet pivot生成数据透视表.xlsx
slide create创建PPT演示文稿.pptx
slide edit修改幻灯片内容.pptx, .ppt
render文档可视化渲染全格式
convert格式转换全格式互转

安装指南

OfficeCLI是单二进制文件,下载即用:

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/OfficeCLI/officecli/releases/latest/download/officecli-win-x64.exe" -OutFile "officecli.exe"
# 添加到PATH
Move-Item officecli.exe C:\Windows\officecli.exe

# macOS
brew install officecli

# Linux
curl -L https://github.com/OfficeCLI/officecli/releases/latest/download/officecli-linux-x64 -o /usr/local/bin/officecli
chmod +x /usr/local/bin/officecli

# 验证安装
officecli --version
officecli --help

使用示例

以下展示AI Agent如何通过OfficeCLI操作文档:

# 1. 创建Word报告
officecli doc create --output report.docx --content "季度销售分析报告

## 摘要
本季度销售额同比增长15%..."

# 2. 读取Word文档内容
officecli doc read --input report.docx --format json
# 输出: {"paragraphs": [...], "tables": [...], "images": [...]}

# 3. 修改Word文档(添加表格)
officecli doc edit --input report.docx \
  --add-table "[[产品,销量,收入],[产品A,1200,36000],[产品B,800,24000]]" \
  --output report-updated.docx

# 4. 创建Excel数据表
officecli sheet create --output sales.xlsx \
  --data '[{"month":"1月","sales":150000},{"month":"2月","sales":180000}]' \
  --headers '["月份","销售额"]'

# 5. 添加公式和图表
officecli sheet edit --input sales.xlsx \
  --formula "C2=C2*1.1" \
  --chart "bar" --range "A1:C13" \
  --output sales-chart.xlsx

# 6. 创建PPT
officecli slide create --output presentation.pptx \
  --template "corporate-blue" \
  --slides '[
    {"title":"2026年Q1报告","subtitle":"销售分析"},
    {"title":"关键指标","body":"营收增长15%\\n利润率提升3%"}
  ]'

# 7. 文档可视化预览
officecli render --input report.docx --format png --output preview.png

# 8. AI Agent集成(MCP工具调用)
officecli serve --port 8080  # 启动MCP服务端

与同类工具对比

特性OfficeCLIMarkItDownAnyDoc
创建文档✅ 全格式❌ 仅读取❌ 仅转换
修改文档✅ 完整编辑
渲染预览✅ 内置
语言C#PythonRust
MCP集成原生支持支持不支持
依赖零依赖需Python需Rust

📚 常见问题

OfficeCLI是什么?

OfficeCLI 是一个单二进制命令行工具,让AI Agent能够创建、读取和修改Word、Excel、PowerPoint文档。它通过简单的命令行接口封装了复杂的Office文档操作,内置可视化渲染引擎,支持文档预览和格式转换。作为AI Agent的工具层,OfficeCLI填补了Agent与Office文档之间的