1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | OfficeCLI |
| 作者/维护者 | iOfficeAI（GitHub 组织账号） |
| 来源链接 | https://github.com/iOfficeAI/OfficeCLI |
| 许可证 | Apache License 2.0（GitHub API 获取） |
| GitHub Stars | 20,490（GitHub API 获取） |
| Forks | 1,375（GitHub API 获取） |
| 最新版本 | v1.0.139（2026-07-19，累计 133 个发行版，GitHub API 获取） |
| 安装方式 | 单文件可执行程序：curl/PowerShell 一键安装脚本，或 Homebrew / Scoop / npm |
2. 功能介绍与亮点
OfficeCLI 是一个用 C# 编写的单二进制命令行工具，让 AI agent 无需安装 Microsoft Office 即可直接创建、读取、修改 Word（.docx）、Excel（.xlsx）、PowerPoint（.pptx）文件。核心能力包括：
- 三层操作架构：L1 语义视图（outline/stats/issues/text 等）、L2 DOM 级增删改查、L3 原始 XML 访问，agent 可按需选择抽象层级
- 确定性 JSON 输出：每条命令都有固定 schema，不依赖正则解析终端输出，专为 agent 消费设计
- 稳定路径寻址：元素带 stable ID（如
@paraId=），多步编辑不受位置索引漂移影响 - 内置渲染引擎：可将文档转成 HTML/PNG/SVG 预览，
watch命令支持本地实时预览（localhost） - 公式与数据透视：350+ Excel 函数求值、原生数据透视表生成、
{{key}}模板合并 - 原生 MCP Server：
officecli mcp claude|cursor|vscode|lmstudio一条命令接入主流 agent 客户端
亮点：组织账号维护、迭代节奏极密（近一周内多次发版）、无需 Office 授权或云端账号、完全本地文件操作。
3. 适用场景
所属分类：文档与办公自动化
适合需要用 agent 批量生成或修改 Office 文档的初中级用户：自动生成周报/合同/发票等 Word 文档、批量填充 Excel 报表与公式、生成或改版 PowerPoint 幻灯片、CI/服务端流水线中无头生成文档、把已有文档转成 HTML/PNG 供 agent 读取和校对格式问题。
4. 跨 Agent 兼容性
- Claude Code：原生支持 ✅ —— 会自动检测本机配置目录并安装 SKILL.md，也可通过
officecli mcp claude接入 MCP - Codex：原生支持 ✅ —— README 明确列出自动检测对象包含 Codex
- OpenClaw：未验证 —— 已抓取材料未提及
- Hermes Agent：未验证 —— 已抓取材料未提及
补充：工具原生支持 MCP 协议（officecli mcp cursor|vscode|lmstudio），且 SKILL.md 是通用 Markdown 格式，理论上可被任何支持 Skill/MCP 标准的 agent 读取，但以上判断仅基于已抓取材料，未做额外验证。
5. 推荐理由
OfficeCLI 把三种最常见的办公文档格式统一到一个零依赖二进制里，agent 不再需要区分 python-docx / openpyxl / python-pptx 等不同库的 API 差异，输出又是结构化 JSON，出错率低于让 agent 直接读写 XML 或截图 GUI。对初中级用户来说，一条安装命令加一份 SKILL.md 即可跑通，几乎没有配置门槛。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 组织账号维护，20,490 stars，且获得 Gigazine、Winbuzzer 等独立科技媒体报道 |
| 可用性 | 9 | 单二进制零依赖，多渠道安装，133 个发行版体现的高频迭代，文档与 help 系统完整 |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 安装脚本走 curl|bash / irm|iex（业界常见模式），运行时命令仅限本地文档文件读写，无需系统级权限 |
| ② 运行时联网外发 | 核心命令为本地文件操作，未发现常驻联网或数据外传行为；watch 预览服务器仅监听本机 localhost |
| ③ API key/凭据 | 不需要任何账号、API key 或云端凭据，纯本地工具 |
| ④ 可疑指令排查 | 检索 SKILL.md 全文与 README，未发现 prompt injection 或隐蔽指令 |
| ⑤ 作者信誉 | 组织账号运营，配有官网 officecli.ai 与 Discord 社区，无刷星或 SEO 操纵措辞 |
| ⑥ License | Apache License 2.0，明确 |
| ⑦ 维护活跃度 | 最近一次发版为 2026-07-19，近一周内多次更新 |
扣分说明：curl|bash 一键安装脚本以及“自动检测并向其他 AI 工具配置目录写入 skill 文件”的行为，权限边界虽然清晰可审计，但仍属主动写入用户环境的操作，故未给满分。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 OfficeCLI 的差异 |
|---|---|---|
| Anthropic 官方 docx / pptx / xlsx skill | 三个独立 skill，各自处理单一 Office 格式，依赖 Python 库（如 python-docx） | OfficeCLI 用一个二进制统一覆盖三种格式，且不依赖 Python 环境或额外库安装 |
| python-docx / openpyxl 等传统库 | 面向开发者的编程库，需要写代码调用 API | OfficeCLI 是 CLI + agent skill，agent 直接执行命令即可，无需生成胶水代码 |
| LibreOffice headless 转换方案 | 依赖完整 LibreOffice 安装，主要做格式转换 | OfficeCLI 无需安装任何 Office 套件，专注结构化增删改查而非仅转换 |
8. 用户评价
在 GitHub Issues 中可见真实的 agent 工作流讨论：用户 mbegur 反馈了一个“agent 增量构建 .xlsx、每完成几个逻辑段落就需要向下游第三方 Excel 查看器输出当前字节快照”的具体场景，维护者 goworm 就是否新增顶层 save 命令与其展开了多轮技术讨论，最终追问具体的渲染差异以便修复。该往来体现出真实用户驱动的 agent 自动化需求与维护团队的响应速度。
9. 其他补充
项目附带桌面 GUI 版本 AionUi（同一维护团队），面向不想用命令行的用户；核心工具本身保持纯命令行与单二进制形态。
10. 安装使用方式
# macOS / Linux
curl -fsSL https://d.officecli.ai/install.sh | bash
# Windows PowerShell
irm https://d.officecli.ai/install.ps1 | iex
# 或通过包管理器
brew install iOfficeAI/tap/officecli # Homebrew
scoop install officecli # Scoop
npm install -g officecli # npm安装后执行 officecli --version 验证；首次在新终端窗口生效。在 Claude Code / Codex 等已支持的 agent 中，工具会自动检测配置目录并写入 SKILL.md，也可手动获取技能文件：curl -fsSL https://officecli.ai/SKILL.md。若需通过 MCP 协议接入，执行 officecli mcp claude（或 cursor/vscode/lmstudio）完成注册。
11. 注意事项
- OpenClaw、Hermes Agent 的兼容性尚未有直接证据，实际使用前建议先手动测试
- 一键安装脚本采用 curl/irm 管道执行模式，对安装脚本来源与完整性有顾虑的用户可改用 Homebrew/Scoop/npm 等包管理器安装
watch实时预览会在本机开启一个 localhost 端口的预览服务器，使用完毕后建议关闭- 项目主语言为 C#，对该语言技术栈不熟悉的用户如需自行编译或深入定制，需要一定学习成本