OfficeCLI

AI 智能体的
Office 套件

开源免费,单一可执行文件,零依赖。一行命令创建、读取、修改 Word、Excel 和 PowerPoint,内置渲染引擎让 AI 看见自己的产出。

bash
$ officecli create deck.pptx 已创建 deck.pptx $ officecli add deck.pptx / \ --type slide \ --prop title="Q4 Report" \ --prop background=1A1A2E $ officecli watch deck.pptx 预览运行中: localhost:26315
localhost:26315
watch 模式下每次 add、set、remove 都即时刷新

三种格式,读写改一网打尽

创建、读取、分析、修改、重组,五类操作覆盖每一份文档。所有能力内置在单个二进制里,无需安装 Office。

格式 读取 修改 创建
Word.docx
Excel.xlsx
PowerPoint.pptx

全部由 AI 智能体自动生成

以下文档由智能体使用 OfficeCLI 全自动创建,无模板、无人工编辑。左右滑动查看更多。

四个内置引擎

自包含,无需 Office。渲染、求值、合并、往返,全在二进制里完成。

高保真渲染引擎

从零实现的 HTML 渲染引擎,让智能体「看见」渲染后的文档,而不是凭 DOM 猜。形状、图表、公式、3D 模型、morph 过渡全覆盖,CI、Docker、无显示器服务器都能跑。

view html 独立 HTMLview screenshot 按页 PNGwatch 实时预览
$ officecli view deck.pptx screenshot \ -o deck.png 第 1-8 页已导出,交给多模态模型检查 $ officecli watch deck.pptx 浏览器自动打开,改动即时刷新

公式与透视引擎

350+ 函数写入即求值,写 =SUM(A1:A2) 立刻能读到结果。动态数组、财务债券、统计检验全覆盖,一条命令生成原生 OOXML 数据透视表。

$ officecli add sales.xlsx '/Sheet1' --type pivottable \ --prop values='Revenue:sum' \ --prop showDataAs=percentOfTotal

模板合并

设计一次版式,填充 N 次。段落、表格、形状、页眉页脚里的 {{key}} 占位符由 JSON 数据替换,零 token 成本,版式永远一致。

$ officecli merge invoice.docx out-001.docx \ --data '{"client":"Acme"}'
$ officecli dump existing.docx \ -o blueprint.json $ officecli batch new.docx \ --input blueprint.json 整个文档序列化为可重放的 batch JSON

Dump 往返

给智能体一份想模仿的范本,它读结构化规格而不是原始 OOXML。任意子树都可导出,修改后重放,打通「现成模板」到「一百份变体」的链路。

三层架构,按需深入

从简单开始,仅在需要时深入。智能体逐层升级,最大限度节省 token。

L1 读取

内容的语义视图:大纲、纯文本、统计、问题清单、HTML、PNG 截图。

officecli view report.docx annotated
L2 DOM

结构化元素操作,基于稳定路径增删改查、移动、交换。

officecli query report.docx "run:contains(TODO)"
L3 原始 XML

XPath 直接访问,L2 不够时的通用兜底。

officecli raw deck.pptx '/slide[1]'

智能体接入,一条命令

内置 MCP 服务器,自动检测 Claude Code、Cursor、VS Code 等工具并安装技能文件,零配置。

确定性 JSON 输出

每条命令支持 --json,schema 一致,无需正则解析 stdout。

稳定路径寻址

每个元素都有稳定路径,智能体不必理解 XML 命名空间。

渐进式复杂度

从只读视图到 DOM 操作,必要时才降到 raw XML,节省 token。

自愈式错误恢复

结构化错误码带 suggestion 和有效范围,智能体自行纠错。

接入示例
# 注册 MCP 服务器 $ officecli mcp claude 已注册到 Claude Code # 或者:让智能体自己读技能文件 $ curl -fsSL https://officecli.ai/SKILL.md # 场景:生成演示文稿 $ officecli add deck.pptx / --type slide \ --prop title="Q4 报告"
数据库报告自动生成 批量查找替换与样式更新 CI/CD 文档流水线 Docker 无头自动化 交付前质量校验 文档提取结构化 JSON

和现有方案比一比

以前需要 50 行 Python 和三个独立库,现在一条命令。

OfficeCLIMicrosoft OfficeLibreOfficepython-docx 系
开源免费Apache 2.0付费授权开源开源
AI 原生 CLI + JSON 输出
零安装,单一可执行文件
任意语言调用CLICOM/Add-inUNO API仅 Python
基于路径的元素访问
内置渲染引擎,HTML/PNG 输出部分支持
跨格式模板合并
Dump 到 batch JSON 往返
实时预览自动刷新
无头 / CI 环境部分支持
Word + Excel + PowerPoint需要多个库

安装

单一自包含可执行文件,.NET 运行时已内嵌,无需安装任何依赖。装完跑 officecli install,技能文件自动进入检测到的所有 AI 编程助手。

一键脚本

脚本
# 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

包管理器

包管理器
# Homebrew brew install officecli # Scoop scoop install officecli # npm 全平台 npm i -g @officecli/officecli

手动下载

六个平台的原生二进制,从 GitHub Releases 获取,下载即用:

  • officecli-mac-arm64
  • officecli-mac-x64
  • officecli-linux-x64
  • officecli-linux-arm64
  • officecli-win-x64.exe
  • officecli-win-arm64.exe
GitHub Releases
快速上手
# 30 秒看到效果:创建幻灯片并启动实时预览 $ officecli create deck.pptx $ officecli add deck.pptx / \ --type slide \ --prop title="Hello, World!" $ officecli watch deck.pptx 浏览器自动打开 localhost:26315

命令参考

二十余条命令按用途分三组,点击任意命令查看 Wiki 详细指南。拿不准属性名时跑 officecli help pptx set shape

觉得好用,点个 Star

帮助更多人发现 OfficeCLI。Bug 与贡献欢迎提交 GitHub Issues。