夜雨聆风一、项目名称
OfficeCLI · GitHub ⭐ 17,743 · C# · Apache-2.0
首个专为 AI Agent 读写自动化 Word/Excel/PowerPoint 设计的 Office 套件。一条命令让 AI 看见文档、编辑文档、生成文档，无需安装 Microsoft Office。
二、项目介绍
AI Agent 现在能写代码、能搜网页、能跑终端，但一遇到 Word、Excel、PowerPoint 就抓瞎。为什么？因为传统 Office 自动化接口是给程序员用的，不是给 AI 用的。程序员能写代码调用 COM 接口，AI 不会，它只能接受结构化的指令，不能直接操作 GUI 应用。
这个问题在 AI Agent 井喷的 2026 年变得格外突出。Claude Code 要帮用户改一份报告，Cursor 要生成一份 PPT，它们都得绕道调用 Python-docx 或者手动打开文件。效率低，稳定性差，格式还容易跑偏。每次改完都要人工检查一遍，AI 的优势根本没发挥出来。
OfficeCLI 就是来解决这个问题的。它专为 AI Agent 设计，不是一款给人类用的办公软件。给 AI 用的办公接口，这是它的定位。微软自己那套 Office 自动化接口是给程序员设计的，AI 用不了，这是行业长期存在的问题，OfficeCLI 第一次正面解决了这件事。
核心思路很简单：让 AI 先「看见」文档，再「操作」文档。它内置了一个 HTML 渲染引擎，把 docx/xlsx/pptx 渲染成 HTML 或者 PNG。AI 看见了文档长什么样，才能告诉 Agent 下一步该怎么改。这个「render → look → fix」的循环，是整个工具设计的核心逻辑。
三、架构设计
OfficeCLI 的架构分三层。
第一层：格式转换引擎。 核心是这个渲染器，用 C# 重写了微软 Office Open XML 规范，把 docx/xlsx/pptx 转成 HTML 或者 PNG。转出来的 HTML 保留了原始文档的布局、字体、颜色，AI 看到的就是用户将会看到的。这个渲染步骤是整个链路的关键，没有这一步，AI 只能收到一堆 XML 压缩包，根本不知道文档长什么样。
第二层：结构化数据提取。 除了视觉渲染，OfficeCLI 还能提取文档的结构化信息：Word 的段落和标题树、Excel 的单元格数据和公式、PowerPoint 的幻灯片序列和备注。这让 AI 不只是看到「图片」，还能读出表格列数、PPT 标题、Sheet 排序方式这些结构信息。结构化数据比像素图更精确，AI 操作起来误差更小。
第三层：Agent 接口层。 支持命令行调用，也支持作为 SDK 集成进各种 Agent 框架。官方已经做了 Claude Code、MCP、OpenClaw 的适配，拿来直接用，不需要自己写粘合代码。如果你在用的是其他 Agent 框架，用命令行调用也完全没问题。
整个项目是单文件二进制，Windows/macOS/Linux 全平台支持，不需要安装 .NET 运行时，也不需要安装 Office 软件。这一点很重要，部署到服务器上完全没有微软依赖，不用担心 Windows Server 上装不了 Office 这种尴尬事。
四、快速上手
安装方式是最简单的那种：
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex装完直接用命令行操作，不需要写代码：
# 把 Word 转成 HTML，AI 就能看了
officecli render input.docx --output html
# 把 Excel 转成 PNG
officecli render budget.xlsx --output png
# 让 AI 生成一份 PPT
officecli create pptx --prompt "一份技术分享PPT，主题是LLM原理，10页"如果要集成进自己的 Agent 框架，官方提供了 npm 包：
npm install @officecli/sdk然后在代码里调用：
import { OfficeCLI } from '@officecli/sdk';
const cli = new OfficeCLI();
const html = await cli.render('report.docx', { format: 'html' });五、实战场景
场景一：Claude Code 自动生成项目文档
以前用 Claude Code 写项目，README 是手动整理的，接口文档是复制粘贴的。现在可以让 Agent 直接生成一份 Word 格式的项目报告：先让 AI 分析代码结构，整理出模块关系和 API 接口，再调用 officecli create docx 生成文档，整个流程不需要人类介入。格式统一，不用担心复制粘贴后字体走样，交给 AI 的工作从「写内容」变成了「审内容」。
场景二：定时报表生成
数据团队每天要出一份 Excel 报表，以前是用 Python 脚本操作 openpyxl，依赖环境多，格式还容易出错。现在改成 Agent 驱动：Agent 从数据库拉数据，调用 officecli create xlsx 生成文件，邮件发送。全程可观测、可干预，哪一步出了问题可以随时介入。格式稳定性比纯代码脚本高很多，因为底层调用的是 Office 文件规范本身。
场景三：PPT 批量生成
市场团队每周要更新一次产品介绍 PPT，10 多页，手动改要半小时。现在 Agent 读产品数据，调用 officecli create pptx 生成初稿，人工微调 5 分钟完成。以前是设计师的活，现在变成了 AI 的活，设计师只做最后把关。OfficeCLI 生成的是真正的 PPTX 文件，不是截图或者 HTML，体验和手动制作的一致。
场景四：跨格式文档转换
有时候需要把 Word 里的内容转成 PPT，或者把 Excel 数据嵌进 Word 报告。传统做法是手动复制粘贴，格式容易乱。OfficeCLI 可以让 Agent 读懂源文档的结构，再按目标格式的要求重新生成，中间不需要人工干预。AI 理解了语义，转换的时候就知道哪些内容该放首页、哪些该放附录。
总结
OfficeCLI 解决的不是「人类怎么用 Office」的问题，是「AI 怎么用 Office」的问题。这是一个还没被很好解决过的场景，Agent 要读写文档，但文档格式是给人类设计的，天然有壁垒。传统方案要么依赖 COM 自动化，要么依赖 Python 库，部署麻烦、环境要求高、AI 还看不懂文档的结构。
OfficeCLI 的思路是把文档「翻译」成 AI 能理解的格式，即 HTML、PNG、或者结构化数据。这一步打通了，后面的事就顺了。AI 看见了结构，才能操作结构；操作的是结构，输出才是真正可用的文件。
从 3 月上线到现在，17k stars，Agent 相关 topics 占了 8 个，官方已经适配了 Claude Code、MCP、OpenClaw 这几个主流框架。路线很清晰：先让 Agent 能用，再让用 Agent 的人越来越多。这个方向在 2026 年的 Agent 爆发期里会越来越重要。
如果你在做 Agent 相关的开发，绕不开文档处理这个环节，OfficeCLI 值得放进技术栈里试一下。项目开源，文档完整，踩坑成本低。
📌 数据来源：GitHub Trending，2026-07-16
