项目详情

OfficeCLI

专为 AI Agent 打造的 Office 套件——一行命令读写编辑 Word / Excel / PowerPoint

iOfficeAI/OfficeCLI Apache-2.0 单二进制 · 零依赖 无需装 Office 跨平台

更新于 2026-08-09

← 返回汇总
项目速览

一句话定位

让 AI Agent 像写代码一样操作 Office 文档

号称「全球首个专为 AI Agent 设计的 Office 套件」。一个单二进制 CLI,给任意 AI Agent 完整控制 .docx / .xlsx / .pptx 的能力——创建、读取、修改、分析、重组,全程一行命令。核心杀手锏:内置 HTML 渲染引擎把文档渲染成 HTML/PNG,让 AI 有了「眼睛」,闭环「渲染 → 看 → 改」循环。无需安装 Office,跨平台。适合要让 AI 自动生成报告/演示/表格、或做文档自动化 pipeline 的开发者。

核心数据

仓库画像

26.8k
GitHub Stars
3
格式全覆盖
1
单二进制
30s
起跑时间

Word / Excel / PowerPoint 三格式读写改创建全覆盖。配套 GUI 桌面应用 AionUi(自然语言建/改文档)。安装方式:curl 脚本 / brew / npm / PowerShell,自动检测并把 officecli skill 装进 Claude Code / Cursor / Windsurf / Copilot 等所有发现的 AI coding agent。

为什么存在

传统 Office 自动化的三个痛点

代码冗长

用 python-docx / openpyxl / python-pptx 创建一个带标题的幻灯片要 50 行 + 3 个库。Agent 写这种代码易错且 token 浪费。

AI 看不见结果

传统库只能写文件,无法渲染。AI 不知道改完长什么样,无法自我修正——「盲改」导致大量返工。

依赖 Office 运行时

COM 自动化 / VBA 要装 Office,服务器/容器环境部署困难。跨平台更是噩梦。

OfficeCLI 的回答
一行命令替代 50 行 Python;内置 HTML 渲染引擎给 AI 眼睛;单二进制零依赖,无需 Office。
🔥 核心架构

三层操作策略

L1 · 读取层(优先) create / view / get / query / validate view outline · text · issues · html(渲染快照)· get 节点 + --json · CSS-like query L2 · DOM 编辑层(主战力) add / set / remove —— path 寻址 + --prop 键值对 支持 stable ID 寻址(@id / @paraId)· 多步工作流索引不漂移 · 跨文档移动/复制 L3 · 原始 XML 层(兜底) 直接操作 OpenXML(L1/L2 覆盖不到时) 仅在高级特性(如 Morph 动画)需要时降级 · 搭配 help 系统查 schema
主流程(优先使用) 兜底层(特殊情况降级)
🔥 杀手锏:渲染引擎

给 AI「眼睛」的 render → look → fix 闭环

内置 HTML 渲染引擎高保真还原文档,渲染成 HTML / PNG。这是 OfficeCLI 与传统库的根本差异——AI 终于能「看见」自己改完的效果。

add / set 修改→ view html / watch→ AI 看渲染结果→ 发现问题→ 再修改↺
watch 模式(实时)

officecli watch deck.pptx 开本地服务器(localhost:26315),每次 add/set/remove 自动刷新浏览器。AI 边改边看。

view html(一次性)

officecli view deck.pptx html 生成静态 HTML 快照,无需服务器。适合 CI 产物、归档、diff 对比。

还有 screenshot(无头浏览器 PNG)/ svg(PPT 单页)/ pdf(导出插件)/ forms(表单 JSON)等多种视图。

🔥 命令体系

9 个核心动词

命令作用典型用法
create创建空白文档create deck.pptx(扩展名定类型)
add添加元素add deck.pptx / --type slide --prop title="Q4"
set修改属性set data.xlsx /Sheet1/A1 --prop bold=true
get读取节点get report.docx '/body/p[3]' --depth 2 --json
queryCSS 式查询query(类选择器语法)
view多视图查看view deck.pptx outline / html / issues
remove删除元素remove deck.pptx '/slide[1]/shape[2]'
validate校验 OpenXML对照 schema 验证合法性
close保存释放把 resident 会话刷盘并关闭

寻址用 XPath 风格:/slide[1]/shape[@id=550950021]。优先用 stable ID(@id/@paraId/@name),多步工作流索引不漂移;无 ID 时回退位置索引。

快速上手

30 秒起跑

# 1. 安装(macOS / Linux)—— 或 brew install officecli / npm i -g @officecli/officecli
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash

# 2. 创建空白 PPT
officecli create deck.pptx

# 3. 开实时预览(浏览器自动开 localhost:26315)
officecli watch deck.pptx

# 4. 另开终端加一页 —— 浏览器即时刷新
officecli add deck.pptx / --type slide --prop title="Hello, World!"
AI Agent 一行接入
在 Agent 对话里贴 curl -fsSL https://officecli.ai/SKILL.md —— 它会读 skill 文件并自动安装二进制 + 所有命令。
性能机制

Resident Mode:常驻会话

每条命令首次访问自动启动 resident(60s 空闲超时),自动避免文件锁冲突。长会话建议显式 open/close。

何时显式 open/close
  • 长会话(12min 空闲)用 open 保活
  • 非 officecli 程序要读文件前必须 close
  • python-docx / Word / 渲染器 / 上传交付前
内部读无需保存
  • get/query/view/dump 总能看到最新编辑
  • 工作流中途不需要 save
  • 空闲会话秒级自动刷盘
  • OFFICECLI_RESIDENT_FLUSH=each 每次变更即刷
能力深度

Word / Excel / PPT 各自支持什么

格式核心能力亮点
Word段落 / run / 表格 / 样式 / 文本框 / 形状 / 页眉页脚 / 图片完整 i18n & RTL(按文字系统分配字体、BCP-47 lang 标签、RTL 级联、印地/阿拉伯/泰/CJK 本地化页码)
Excel单元格 / 公式 / 样式 / 图表公式读写、条件格式、跨表引用
PowerPoint幻灯片 / 形状 / 表格 / 图片 / 动画Morph 动画、smartArt、版式继承

另有 Specialized Skills(需 load_skill 加载):融资演示、学术论文、财务模型、仪表盘、Morph 动画——这些复杂场景有专门优化流程。

生态接入

三种使用入口

AI Agent
SKILL.md 一行接入
贴 curl 命令进对话,Agent 自动读 skill 装二进制。支持 Claude Code / Cursor / Windsurf / Copilot 等。
人类 GUI
AionUi 桌面应用
自然语言描述要什么,底层用 OfficeCLI 驱动。适合非技术用户。
开发者 CLI
直接跑命令
装二进制后 officecli install 自动把 skill 装进所有检测到的 coding agent。

还提供 MCP 接口(单 command 字符串参数透传)和 SDK,可集成进任意 Agent 框架。安装渠道:curl / brew / npm / PowerShell 全覆盖。

适用场景

适合谁用

风险提示

需要警惕

潜力评估

未来空间

「AI Agent 操作 Office」赛道的开创者。渲染闭环(render→look→fix)是真正解决 AI 文档盲改痛点的关键创新。若 Specialized Skills 生态成熟 + AionUi GUI 普及,可能成为 AI 时代的 Office 自动化基础设施——就像 ffmpeg至于视频。


上一个
Awesome LLM Apps
下一个
Hallmark
1 / 15