OfficeCLI:让AI Agent替你写Office文档
单日新增 1700+ star,首个专为 AI Agent 打造的 Office 套件——免装 Office、单文件二进制、三件套全覆盖。

📌 项目名片
🤔 它解决什么问题
你有没有经历过这种痛苦:让 AI 帮你生成一份 PPT,它给你一段文字描述说"你可以这样排版";让它处理一个 Excel 表格,它只能输出 CSV 让你自己导入。AI 能写代码、能聊天,但面对 .docx/.xlsx/.pptx 这些办公文件格式,大多数 Agent 只能"望文件兴叹"。
传统做法是搬出 python-pptx、openpyxl、python-docx 三件套,几十行代码操作一个文件,还要在本地装 Office 或 LibreOffice 渲染。不仅繁琐,而且 Agent 无法"看见"文档效果——它只能盲写,不知道标题有没有溢出、两个形状是否重叠。
OfficeCLI 的思路很直接:把 Word/Excel/PPT 的完整操作能力压缩进一个二进制文件,同时内置 HTML 渲染引擎,让 AI 在操作文档时拥有"眼睛"——改完一条命令,浏览器立刻刷新预览,形成「渲染→查看→修正」的闭环。
✨ 核心亮点
🎯 一条命令,全能操作
以前用 Python 生成一张 PPT 需要 50 行代码 + 3 个库,现在一条命令搞定:
officecli add deck.pptx / --type slide --prop title="Q4 报告"
增删改查全部通过 CLI 完成,对 AI Agent 极其友好——Agent 天然擅长生成命令行调用。
👁️ 内置渲染引擎,AI 不再"盲写"
这是 OfficeCLI 最核心的设计:从零构建的 HTML 渲染引擎,支持形状、图表、公式、3D 模型、动画过渡。提供三种模式:
view html:导出独立 HTML,浏览器直接打开view screenshot:逐页 PNG 截图,多模态模型也能读watch:本地 HTTP 服务 + 热重载,每改一条命令浏览器自动刷新在 CI、Docker、无头服务器上都能运行——不需要安装 Office。
📊 Excel 公式引擎 + 透视表,开箱即用
内置 350+ Excel 函数(VLOOKUP、XLOOKUP、XIRR、FILTER 等),写入公式后自动求值。一条命令创建透视表:
officecli add sales.xlsx '/Sheet1' --type pivottable \
--prop source='Data!A1:E10000' --prop rows='Region,Category' \
--prop values='Revenue:sum,Units:avg'
🔄 模板合并——设计一次,批量生成
merge 命令支持将 JSON 数据灌入 .docx/.xlsx/.pptx 模板中的 {{key}} 占位符。Agent 花心思设计一次布局,生产环境批量填充 N 份,零 token 消耗、输出一致。
🧩 零依赖安装,自动注入 Agent
安装后执行 officecli install,自动检测 Claude Code、Cursor、Windsurf、GitHub Copilot 等工具,将 skill 文件注入进去。AI 立刻就能帮你创建和编辑 Office 文档,无需额外配置。
🚀 快速上手
# 一键安装(macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# 或通过包管理器
brew install officecli
npm install -g @officecli/officecli
# 创建一个 PPT 并实时预览
officecli create deck.pptx
officecli watch deck.pptx # 浏览器打开 http://localhost:26315
# 在另一个终端添加幻灯片
officecli add deck.pptx / --type slide --prop title="Hello, World!"
每一步 add/set/remove 都会在浏览器中即时刷新——所见即所得。
👥 适合谁
💡 小结
OfficeCLI 填补了 AI Agent 与 Office 文件格式之间的鸿沟。单文件、免安装、自带渲染引擎,让 AI 真正能"看见"和"编辑"文档。11.8k star 和单日 1700+ 的增长说明这个痛点踩得相当准。
点个 star,下次让 AI 直接帮你写 PPT → github.com/iOfficeAI/OfficeCLI
夜雨聆风