知识库 OfficeCLI：一行命令搞定 Word/Excel/PPT：AI 时代的文档处理利器

不用装 Office！不用装 .NET！不用装 Python！ 一个二进制文件全搞定。

三、核心功能速览

OfficeCLI 采用三层架构，从简单到深入，满足不同需求：

四、Word 文档操作

创建文档并添加内容

# 创建新文档officecli create report.docx
# 添加标题officecli add report.docx /body --type paragraph   --prop text="2024年度工作总结" --prop style=Heading1
# 添加正文officecli add report.docx /body --type paragraph   --prop text="本年度公司在营收、用户增长和产品迭代方面均取得显著突破。"
# 添加表格officecli add report.docx /body --type table   --prop rows=3 --prop cols=4

查找并替换文字

# 全局替换（整个文档）officecli set report.docx / --prop find="待定" --prop replace="已完成"

关键词高亮

# 将所有"重要"标红加粗officecli set report.docx /body --prop find="重要"   --prop bold=true --prop color=FF0000

五、Excel电子表格

创建表格并写入数据

# 创建新工作簿officecli create data.xlsx
# 写入表头officecli set data.xlsx /Sheet1/A1 --prop value="姓名" --prop bold=trueofficecli set data.xlsx /Sheet1/B1 --prop value="部门" --prop bold=trueofficecli set data.xlsx /Sheet1/C1 --prop value="销售额" --prop bold=true
# 写入数据行officecli set data.xlsx /Sheet1/A2 --prop value="张三"officecli set data.xlsx /Sheet1/B2 --prop value="销售部"officecli set data.xlsx /Sheet1/C2 --prop value=52000

创建数据透视表（一条命令！）

officecli add data.xlsx /Sheet1 --type pivottable   --prop source="Sheet1!A1:C100"   --prop rows=部门   --prop values="销售额:sum"   --prop sort=desc

批量更新

# 从 JSON 文件批量更新officecli batch budget.xlsx --input updates.json --json

CSV 导入

officecli add data.xlsx / --type sheet   --prop name="销售数据" --prop csv=sales.csv

六、PowerPoint 演示文稿

创建幻灯片并添加内容

# 创建演示文稿officecli create deck.pptx
# 添加封面页officecli add deck.pptx / --type slide   --prop title="2024 Q4 财报" --prop background=1A1A2E
# 在幻灯片上添加文字形状officecli add deck.pptx '/slide[1]' --type shape   --prop text="营收增长 25%" --prop x=2cm --prop y=5cm   --prop font=Arial --prop size=24 --prop color=FFFFFF
# 添加图表页officecli add deck.pptx / --type slide --prop title="销售趋势"
# 添加柱状图officecli add deck.pptx '/slide[2]' --type chart   --prop type=column --prop categories="Q1,Q2,Q3,Q4"   --prop series="营收:100,120,150,180"

实时预览

# 启动本地预览服务器，浏览器访问 http://localhost:26315
officecli watch deck.pptx

当你执行 add、set、remove 命令时，浏览器会自动刷新，实时看到变化！

导出为图片

# 将幻灯片导出为 PNG 图片officecli view deck.pptx screenshot -o slide.png
# 指定页码officecli view deck.pptx screenshot --page 2 -o slide2.png

七、高级功能

1. 模板合并（批量生成神器）

设计一次模板，用 JSON 数据填充 N 次——零 token 成本，格式一致：

# 设计好 invoice-template.docx，内含 {{client}}、{{total}} 等占位符officecli merge invoice-template.docx out-001.docx   '{"client":"Acme公司","total":"¥52,000"}'
# 批量生成 100 份for i in $(seq 1 100); do  officecli merge template.docx "out-$i.docx" "$(cat data-$i.json)"done

2. 文档转 HTML / 截图

无需 Office，内置渲染引擎：

# 转 HTML（所有资源内联，单个文件）officecli view report.docx html -o report.html
# 查看格式问题officecli view report.docx issues --json

3. JSON 输出，AI 友好

所有命令都支持 --json，输出结构化的 JSON 数据，方便程序处理：

# 获取文档结构officecli get deck.pptx /slide[1] --depth 2 --json
# 输出示例# {"tag": "slide", "path": "/slide[1]", "attributes": {...}}

4. 驻留模式（高性能）

对同一份文档批量编辑时，可以开启驻留模式避免重复的文件 I/O：

officecli open report.docx       # 打开，文档保持在内存officecli set report.docx ...    # 多次操作officecli set report.docx ...officecli close report.docx      # 保存并关闭

5. 自愈式错误提示

拼错属性名？路径不对？OfficeCLI 会返回建议：

# 错误返回
# {"error": {"code": "not_found", "suggestion": "Valid Slide index range: 1-8"}}

八、AI 智能体集成

OfficeCLI 最初就是为 AI 智能体设计的，所以集成方式极其简单。

MCP 服务器内置

一条命令即可为你的 AI 工具注册 MCP（Model Context Protocol）服务：

# 为 Claude Code 注册
officecli mcp claude
# 为 Cursor 注册
officecli mcp cursor
# 为 VS Code / GitHub Copilot 注册
officecli mcp vscode

安装后自动配置

OfficeCLI 安装时会自动检测你的 AI 工具（Claude Code、Cursor、Windsurf、GitHub Copilot等）,并安装对应的技能文件。你的 AI 智能体立即学会创建、读取和编辑 Office 文档。

为什么它是 AI 智能体的最佳搭档？

# 1. 安装curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# 2. 创建 PPTofficecli create deck.pptx
# 3. 实时预览（自动打开浏览器）officecli watch deck.pptx
# 4. 添加幻灯片（浏览器实时刷新）officecli add deck.pptx / --type slide --prop title="Hello, OfficeCLI!"
# 5. 添加内容officecli add deck.pptx '/slide[1]' --type shape   --prop text="这是用命令行生成的 PPT！"   --prop x=3cm --prop y=6cm --prop size=20