想让 AI 帮你处理 Office 文档?这个工具可以实现。
今天介绍一个开源项目 —— OfficeCLI,它是一个通过命令行操作 Office 文档的工具。
📌 什么是 OfficeCLI?
一句话概括:用命令行操作 Word、Excel 和 PowerPoint。
主要特性
🚀 快速上手
第一步:安装(Windows 用户)
打开 PowerShell,运行:
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex或者从 GitHub Releases 下载 officecli-win-x64.exe。
第二步:验证安装
officecli --version# 输出: v1.0.x.x第三步:创建你的第一个 PPT
# 1. 创建空白演示文稿officecli create deck.pptx# 2. 添加一页幻灯片officecli add deck.pptx / --type slide --prop title="Hello, World!"# 3. 在幻灯片上添加文本框officecli add deck.pptx '/slide[1]' --type shape \ --prop text="这是AI生成的PPT!" \ --prop x=2cm --prop y=5cm \ --prop font=Arial --prop size=28 --prop color=FF5733# 4. 浏览器实时预览officecli watch deck.pptx就这么简单。 浏览器会自动打开 http://localhost:26315,你每执行一条命令,预览都会自动刷新。
💡 核心功能详解
1️⃣ 内置渲染引擎 —— 让 AI 能"看到"文档
这是 OfficeCLI 比较实用的功能。
传统方案中,AI 生成 PPT 时只能读写文件内容,看不出排版是否美观、文字是否溢出、元素是否重叠。
OfficeCLI 可以把文档渲染成 HTML 或截图:
# 渲染为独立 HTML(可在任何浏览器查看)officecli view deck.pptx html -o preview.html# 渲染为 PNG 截图(供多模态 AI 分析)officecli view deck.pptx screenshot -o slide.png# 实时预览服务(每次编辑自动刷新)officecli watch deck.pptx2️⃣ 公式与数据透视引擎
350+ Excel 函数写入即自动求值,无需打开 Office 重算:
# 写入公式,立即得到计算结果officecli add data.xlsx '/Sheet1/A1' --type cell --prop formula='=SUM(B2:B100)'# 一条命令创建数据透视表officecli add sales.xlsx '/Sheet1' --type pivottable \ --prop source='Data!A1:E10000' \ --prop rows='Region,Category' \ --prop cols=Quarter \ --prop values='Revenue:sum,Units:avg'支持的函数包括:
✅ 动态数组: FILTER/SORT/UNIQUE/SEQUENCE✅ 查找函数: VLOOKUP/XLOOKUP/INDEX/MATCH✅ 财务函数: XIRR/PRICE/YIELD/DURATION✅ 统计函数: NORM.DIST/T.TEST/LINEST
3️⃣ 模板合并 —— 批量生成文档的工具
设计一次模板,填充 N 次数据:
# 模板中有 {{client}} {{total}} 等占位符officecli merge invoice-template.docx output.docx \ --data '{"client":"Acme公司","total":"¥52,000","date":"2026-07-23"}'适用场景:
📄 批量生成发票、合同 📊 批量填充报告数据 🎫 批量制作证书、邀请函
4️⃣ 三层架构 —— 从简单到专业
| L1:读取层 | ||
| L2:DOM 层 | ||
| L3:XML 层 |
# L1 — 查看文档大纲officecli view report.docx outline# L2 — 修改特定段落officecli set report.docx '/body/p[1]/r[1]' --prop bold=true# L3 — 直接操作 XML(终极兜底)officecli raw-set doc.pptx document \ --xpath "//w:p[1]" --action append \ --xml '<w:r><w:t>注入的文本</w:t></w:r>'🤖 AI 集成功能
MCP 服务器支持
OfficeCLI 内置了 MCP (Model Context Protocol) 服务器,一条命令即可接入各种 AI 工具:
# 接入 Claude Codeofficecli mcp claude# 接入 Cursorofficecli mcp cursor# 接入 VS Code / GitHub Copilotofficecli mcp vscode# 接入 LM Studioofficecli mcp lmstudio# 查看注册状态officecli mcp list给 AI Agent 一行指令
把下面这行发给任何 AI 助手,它会自动学会使用 OfficeCLI:
curl -fsSL https://officecli.ai/SKILL.mdOfficeCLI 会自动检测你安装的 AI 工具(Claude Code、Cursor、Windsurf、Copilot 等),并完成配置,无需手动设置!
🛠️ 典型应用场景
场景一:自动化报告生成
import subprocess, jsondefofficecli(*args):return json.loads(subprocess.check_output(["officecli", *args, "--json"], text=True))# 从数据库获取数据 → 生成 Word 报告data = fetch_report_data()officecli("create", "report.docx")officecli("add", "report.docx", "/", "--type", "paragraph","--prop", f"title={data['title']}")officecli("add", "report.docx", "/", "--type", "table","--prop", f"rows={len(data['rows'])}")# ... 更多操作场景二:批量处理文档
# 批量替换所有 Word 文档中的公司名称for file in *.docx; do officecli set"$file"'/body' --find "旧公司名" --replace "新公司名"done# 批量更新 Excel 中的价格officecli batch prices.xlsx --input updates.json --json场景三:CI/CD 文档流水线
# .github/workflows/generate-docs.yml-name:GenerateReportrun:| officecli create report.pptx officecli add report.pptx / --type slide --prop title="${{ github.event.head_commit.message }}" officecli merge report.pptx final.pptx --data '${{ steps.data.outputs.json }}' officecli validate final.pptx🌟 适用人群
对开发者
🔥 上手简单:命令直观,参数语义化( --prop font=Arial,--prop color=FF0000)📦 一个程序就够用:不需要 Python / .NET 运行时 🔌 任何语言都能调用:CLI 方式,Python / Node / Go / Rust 都能用 🐳 适合 Docker:无头模式,可用于 CI/CD 和容器化部署
对 AI 工程师
🤖 JSON 输出:所有命令支持 --json输出,方便解析📍 路径寻址系统: /slide[1]/shape[2]直观定位元素🔄 错误提示友好:返回建议和有效范围,方便 Agent 修正 👁️ 可视化反馈:内置渲染引擎,Agent 能看到效果
对普通用户
🎨 有配套 GUI:AionUi 桌面应用,可以用自然语言操作 📱 跨平台:Windows / macOS / Linux 都支持 💰 免费开源:Apache 2.0 协议,可以商用 📚 文档齐全:Wiki + 社区支持
📞 资源链接
| officecli.ai | |
| iOfficeAI/OfficeCLI | |
| Wiki | |
| 加入讨论 | |
| AionUi | |
| SKILL.md |
🎬 总结
OfficeCLI 是一个实用的 Office 文档命令行工具,它的主要优点:
✅ 不用安装 Microsoft Office✅ 不用写复杂的 Python 代码✅ 不用在服务器上配置 COM 组件✅ 可以把文档转成 HTML 或截图,方便查看效果
适用人群:
🧑💻 开发者 —— 构建文档自动化流程 🤖 AI 工程师 —— 让 Agent 能操作 Office 文档 👨💼 普通用户 —— 用 AionUi 自然语言生成文档
如果觉得有用,欢迎点赞 与 在看,分享给有需要的朋友们。
关注我,分享更多有用的开源项目。

夜雨聆风