OfficeCLI

项目概述

OfficeCLI 把一行终端命令变成一份可交付的 Word、Excel 或 PowerPoint 文件，全程不需要安装 Office，也不依赖 Python 文档库。它被打包成单一自包含的 .NET 可执行文件，文档引擎、渲染引擎与公式/透视引擎都内嵌其中，元素通过稳定路径定位而不是 XML 命名空间。当前发行版 v1.0.160，源码以 Apache-2.0 许可开放，六个平台的二进制文件按架构分别发布。

项目	内容
平台	Windows、macOS、Linux，x64 与 ARM64
运行时	自包含 .NET，无需单独安装
支持格式	.docx、.xlsx、.pptx
许可	Apache-2.0
最新发行版	1.0.160

智能体用命令行写文档、看渲染、再改一版，这个循环全在一个二进制里完成。

核心命令

命令	作用
create	新建空白 docx、xlsx 或 pptx
add	按路径追加元素，例如 / --type slide
set / remove	修改或删除指定路径上的元素
view	输出 text、outline、html、screenshot 等视图
get / query	读取元素 JSON，或按选择器查找
merge	用 JSON 数据填充 {{key}} 占位符
batch	一次性执行多条命令，可加 --force
watch	在 http://localhost:26315 提供实时预览
mcp	把 MCP 服务器注册到 Claude、Cursor、VS Code 或 LM Studio

主要功能

• 三格式覆盖：docx、xlsx、pptx 均可读取、修改与创建
• 路径寻址：/slide[1]/shape[2] 这类从 1 开始的路径定位元素，不必理解 XML 命名空间
• 三层操作：L1 用 view 看语义视图，L2 用 DOM 命令增删改，L3 用 raw 与 raw-set 直接改 XML
• 内置渲染：view html 生成内联资源的独立 HTML，view screenshot 按页出 PNG，watch 提供自动刷新
• 公式求值：150 多个 Excel 函数写入即算，动态数组函数自动补 _xlfn. 前缀
• 原生透视表：add ... --type pivottable 直接生成写入 OOXML 的透视表缓存与定义
• 模板合并：merge 可替换段落、表格单元格、形状、页眉页脚与图表标题中的占位符
• 结构化输出：所有命令支持 --json，错误码如 not_found、invalid_value 附带建议与有效范围
• 常驻与批量：open 把文档留在内存，batch --force 遇错继续执行后续命令

适用人群

• 开发 AI 智能体与工具调用的工程师
• 编写文档自动化脚本的开发者
• 维护 CI/CD 文档流水线的团队
• 无法安装 Office 的服务器与容器用户
• 需要批量生成报表的数据团队

快速上手

1. 运行 install.sh（Windows 用 install.ps1），或下载二进制后执行 officecli install 放入 PATH
2. 新建演示文稿：officecli create deck.pptx
3. 启动预览：officecli watch deck.pptx，浏览器访问 http://localhost:26315
4. 另开终端加一页：officecli add deck.pptx / --type slide --prop title='Q4 Report'
5. 查看大纲：officecli view deck.pptx outline
6. 取元素 JSON：officecli get deck.pptx '/slide[1]/shape[1]' --json

系统要求

项目	要求
操作系统	macOS（Apple Silicon、Intel）、Linux x64/ARM64、Windows x64/ARM64
运行时	已内嵌 .NET，无需安装 Office 或 Python
渲染截图	view screenshot 依赖本机无头浏览器
安装方式	install.sh、install.ps1 或 Releases 中的单文件二进制

注意事项

• 配置文件：位于 ~/.officecli/config.json，可用 officecli config autoUpdate false 关闭自动更新
• 发行文件名：按 officecli-mac-arm64、officecli-mac-x64、officecli-linux-x64、officecli-linux-arm64、officecli-win-x64.exe、officecli-win-arm64.exe 区分
• 不是 XPath：路径语法为 1-based 索引加元素本地名，需要 XPath 时改用 raw 与 raw-set
• 截图依赖浏览器：view screenshot 通过无头浏览器截取渲染后的 HTML，纯容器环境需自行提供
• 单次跳过更新：默认后台检查更新，临时关闭可用环境变量 OFFICECLI_SKIP_UPDATE=1