企业官网建设流程全解析

OfficeCLI 实战：一个二进制搞定 Word、Excel、PPT 的命令行操作 Office 指南

【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址: https://gitcode.com/GitHub_Trending/of/OfficeCLI

周五下班前，老板要一份把 200 份合同模板里客户名、金额、日期全部替换成实数据的交付件。手工改到第三十份你已经想辞职。用 OfficeCLI 的思路则完全不同：模板留好{{变量}}占位符，命令行一条条把数据填进去，再顺手生成一张带图表的 Excel 汇总。它就是专为这种场景设计的无头 Office 自动化工具——无需安装 Microsoft Office，单二进制、零依赖，用命令行完成对 Word / Excel / PowerPoint 的读取、修改与自动化，适合给 AI Agent 接上文档能力，也适合把文档环节塞进 CI/CD 流水线。

快速上手：从零到第一份文档

装二进制、跑命令、看结果，三步走完。

curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash officecli create deck.pptx officecli add deck.pptx / --type slide --prop title="Hello, World!" officecli watch deck.pptx

• install.sh负责下载跨平台二进制（Linux/macOS/Windows 都有），Windows 用 PowerShell 脚本，或直接npm install -g @officecli/officecli。
• create按扩展名决定文档类型，建出来的就是合法的空 .docx / .xlsx / .pptx。
• watch起一个本地实时预览，后面每敲一条add/set/remove，浏览器里的页面都会跟着刷新——改文档时你能看见结果，而不是盲改。

它能做什么：三大能力速览

📄 Word：把 200 份合同的标题批量换掉

add插入段落、表格、图片、公式，set改样式和文字，view issues还能把排版问题一条条列出来。批量场景里最常用的是先query选中目标、再set统一修改，几百份文档一个循环跑完。

officecli add contract.docx /body --type paragraph --prop text="客户签署区"

📊 Excel：填数据、算公式、出一张图表

单元格用ref=地址直接定位，公式写入即自动求值（内置 350+ 个 Excel 函数），图表一条add就能带上数据范围。数据导入、透视表、条件格式这些也都在同一套命令体系里。

officecli add budget.xlsx "/Sheet1" --type cell --prop ref=A1 --prop value=100

📽️ PPT：给演示文稿插一张带数据的图表

幻灯片、形状、表格、动画、转场都能用add/set操作。下面这条命令向幻灯片插入柱状图，数据直接引用工作表区域：

officecli add deck.pptx "/slide[1]" --type chart \ --prop chartType=bar --prop title="Department Performance — Q1" \ --prop dataRange="Sheet1!A1:B9" --prop x=0 --prop y=0

落地场景：选一个你正在做的事

CI 流水线里自动生成周报

• 背景：现在周报还停在"每周手写"阶段，数据其实早就躺在数据库导出的 CSV 里。
• 做法：把安装脚本加进 job，跑几条命令把 CSV 导进新建的 xlsx，产物直接上传。

officecli create weekly-report.xlsx officecli import weekly-report.xlsx "/Sheet1" sales.csv --header officecli validate weekly-report.xlsx

• 效果：PR 上多一个可下载的周报附件，全程没有人工参与，凌晨两点也能准时交付。

模板 merge：200 份合同一次填完

• 背景：上一节导语里的活——同一份合同模板，只有客户名和金额不一样，手工替换既慢又容易漏。
• 做法：合同留{{client}}、{{total}}占位符，用merge把 JSON 数据灌进模板。下面这条命令跑 200 次循环，每份合同一次调用，格式永远一致，因为模板只被设计了一次。

officecli merge contract-template.docx contract-001.docx \ --data '{"client":"Acme","total":"$5,200"}'

• 效果：200 份合同几分钟出齐，排版零偏差，改模板后重跑一遍即可全量刷新。

部署与集成：三条路径

三条路装的都是同一个自包含二进制，Office 和 .NET 运行时都不需要，差别只在谁来触发它。想深入集成细节，可以看仓库里的 plugins/plugin-protocol.md，了解插件如何把能力再往外扩。

踩坑笔记与实用建议

• 容器里中文渲染异常原因：镜像里根本没有中文字体，渲染引擎只能回退到缺字形。 解法：镜像加装 Noto CJK 字体（如 Alpine 的font-noto-cjk），文档字体别依赖 Windows 专有字体。

• 大文件多步操作越做越慢原因：每条命令都是独立进程，每次都完整读盘再写盘。 解法：officecli open让文档常驻内存，中间随意改，最后close落盘，省掉反复 I/O。

• 多任务并发时互相影响原因：多个进程同时改同一份文档，后写入的会覆盖先写入的。 解法：文件路径按任务隔离，一份任务一份文件，需要汇总时最后再合并。

如果只记一句话：把文件路径当参数、把 JSON 当输出，OfficeCLI 就能嵌进你任何脚本和 Agent 里。

最后

OfficeCLI 把"命令行操作 Office"这件事收敛成三件：装一个二进制、用路径加命令改文档、拿结构化结果。桌面套件不用装，Python 库不用挑版本，AI Agent 和多语言流水线都能直接接上。

• 可运行示例都在 examples/，每个场景配.sh脚本、Python 脚本和成品文档，照着敲一遍比读文档快。
• 给 Agent 用的技能文件见 skills/，装好二进制后会自动装进你本地的 AI 编码工具。

去敲第一条officecli create demo.pptx看看。

【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址: https://gitcode.com/GitHub_Trending/of/OfficeCLI