用途
OfficeCLI 是一款专为 AI 智能体设计的 Office 套件，用于从命令行创建、读取和编辑 Word（.docx）、Excel（.xlsx）和 PowerPoint（.pptx）文件。它采用单一二进制文件形式，无需安装 Office 即可运行，提供统一的 CLI 接口，并内置将文档渲染为 HTML/PNG 的能力。
主要能力
文件操作
- 创建空白或带初始内容的文档：
officecli create document.docx、officecli create spreadsheet.xlsx、officecli create presentation.pptx - 查看文档内容，支持 outline（树状结构）、text（纯文本）、html（浏览器打开）、json（JSON 结构）四种视图
- 获取特定元素详情：
officecli get document.docx '/paragraph[1]' --json - 实时预览：
officecli watch presentation.pptx启动本地预览服务器（默认 http://localhost:26315），编辑后自动刷新浏览器
Word 文档（.docx）
- 路径语法：
/paragraph[N]、/paragraph[N]/run[M]、/table[N]、/table[N]/row[R]/cell[C] - 添加段落、run（内联格式）、表格、图片、页眉页脚
- 设置段落与 run 属性（文本、样式、对齐、加粗、斜体、字体、字号、颜色、间距等）
- 删除段落或表格
- 支持 RTL（阿拉伯语、希伯来语）及多语言字体设置
Excel 表格（.xlsx）
- 单元格寻址：
$SheetName:A1、$Sheet1:B2:D4、/sheet[1]/cell[A1] - 添加工作表、单元格（值、数字格式、公式、日期）、表格、图表（柱状图、饼图等）、数据透视表
- 修改单元格值与格式、工作表属性
- 内置 150+ 函数并自动求值（SUM、IF、VLOOKUP、TODAY 等）
- 数据排序（单键/多键）、条件格式（色阶等）
PowerPoint 演示文稿（.pptx）
- 路径语法：
/slide[N]、/slide[N]/shape[M]、/slide[N]/table[M] - 添加幻灯片（可设标题、背景色）、形状（文本框）、图片（可设亮度、对比度、阴影）、表格、图表、3D 模型
- 设置幻灯片切换效果与动画
- 修改形状与幻灯片属性
- 添加演讲者备注
使用方式
安装
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
手动安装：从 GitHub Releases 下载对应平台二进制文件，运行 officecli install 加入 PATH。
验证：officecli --version
典型模式
- 批量文档生成：用 shell 循环创建多份报告
- CSV 转 Excel：
officecli add data.xlsx '$Sheet1' --type import --prop src=data.csv --prop format=csv - 基于模板生成多页演示文稿
- 带图表的自动化报表
- 提取与转换：读取 Word 文本、处理后生成新文档
脚本集成
提供 Python 与 Node.js 集成示例，通过 subprocess/execSync 调用 officecli 命令，实现程序化文档生成与数据读取。
适用场景
- AI 智能体自动化生成办公文档
- 批量报告、发票、合同等文档生成
- 数据报表与图表自动化
- 演示文稿批量构建
- 文档内容提取与格式转换
限制
- 公式自动求值支持 150+ 函数，不支持函数会显示 #NAME? 错误
- 路径为 1 起始索引（/paragraph[1]、/slide[1]）
- 文件被其他程序占用时可能出现权限错误
- 具体收费、价格、平台支持范围等资料暂未提供