OfficeCLI：让 Agent 操作专业软件的另一条路
先澄清两件事：OfficeCLI 是 GitHub 上 iOfficeAI/OfficeCLI 这个 Apache-2.0 开源项目， 不是泛指的「用命令行操作 Office」，也不是微软出品，与微软没有从属或授权关系。 它和站内已经拆过的 Pascal Editor 是两条不同的路：后者在软件里开一个 MCP 口子， 前者干脆重写了一套文件读写器——不装 Office 也能改 .docx / .xlsx / .pptx， 连公式引擎、透视表、图表都自己实现。代价也写在明处：它改的是你磁盘上的真实文件， 有常驻进程与文件监听模式，按指令还可能拉取外部资源。 本专题共 30 篇，每篇都对着仓库里的真实文件写。项目仍在高频迭代，文中结论以 仓库最新代码与文档 为准。
OfficeCLI 是什么：给 AI Agent 用的开源文档读写套件
OfficeCLI 是一个 Apache-2.0 开源项目，把 Word、Excel、PowerPoint 的读写包成单个二进制，让 AI Agent 不装 Office 也能改文档。本篇给出仓库全景：目录怎么分、三层地址系统怎么用、渲染回路和常驻进程如何工作、它明确不管什么。不讲某一类文档的具体写法，也不做工具排名。
上手与使用
先让 Agent 调起来：装好、接 MCP、认清命令面与选择器、学会先查后改，再看批量、常驻、实时预览与自带技能包。
把开源项目 OfficeCLI 接进你的 Agent：内置 MCP 服务器与一键注册路径
OfficeCLI 是一个 Apache-2.0 的开源命令行套件，单个二进制就能读写 docx/xlsx/pptx。这篇拆它自带的 MCP 服务器：为什么只暴露一个工具一个参数，注册命令把哪条路径写进了哪个客户端配置，工具描述里塞进了什么，以及落盘时机、远程抓取、后台升级这些会咬人的边界。不讲文档格式细节，也不替你做选型。
读开源项目 OfficeCLI 的源码：批量执行为什么快，以及失败时整批回滚这道坎
拆开源项目 OfficeCLI 的 batch 命令：一次调用跑几十条文档修改，省掉的是反复开包和反复序列化的开销；但它的失败语义和逐条调用完全不同，默认是任何一项失败就整批回滚。本文讲清批量项的结构、原子回滚在非常驻与常驻两条通路上各自怎么实现、以及边界在哪。不涉及 Office 文档格式本身的教学。
开源项目 OfficeCLI 的 11 个技能包：里面写了什么，和命令行工具怎么分工
拆开 OfficeCLI 这个开源项目自带的 11 个技能目录，逐层看 SKILL.md 里到底写了哪几类内容：交付标准、领域约定、带坐标的版式配方、可直接跑的 QA 门。同时讲清技能包与 CLI 工具、与 schema 三者的边界。不讲怎么写 Word 排版，也不替你判断这套方案是否适合你的业务。
开源项目 OfficeCLI 的 watch 预览：让 Agent 改文档时你在浏览器里同步看到
拆解开源项目 OfficeCLI 的 watch 实时预览链路：改动命令怎么把渲染好的 HTML 经命名管道推给中继服务，中继服务怎么用块级与行级 diff 推给浏览器，以及这条链路的还原度边界在哪。读完你能判断它适合放进哪种 Agent 工作流，也知道它明确不管哪些事。不涉及价格与选型排序。
开源项目 OfficeCLI 的查询与转储：Agent 先读懂再动手
拆解开源项目 OfficeCLI 读侧的 get、query、dump 三个命令，讲清它怎么把 Word/Excel/PowerPoint 文档变成可寻址路径与可回放脚本，以及读完整性契约怎么设计。读完你能判断 Agent 改文档前该读什么、怎么核对读全了。不讲写侧细节。
开源项目 OfficeCLI 的两套 SDK：什么时候别直接调命令
OfficeCLI 是一个给 AI Agent 用的开源 Office 文档读写套件，除命令行外还带 Node 和 Python 两套 SDK。本文按仓库源码梳理这两套 SDK 各自包了什么、常驻进程加命名管道这条快路径怎么走、批量写入失败会回滚成什么样，以及判断该用 SDK 还是逐条调命令的那条线在哪。不讲 Office 文档格式本身，也不替你判断要不要引入它。
开源项目 OfficeCLI 的命令面全景：一套动词打通三种文档
拆解开源项目 OfficeCLI 的命令面：add/set/get/query/remove 这几个动词如何在三种文档格式里保持同一语义。读完能拿到命令与仓库位置对照表、写盘时机与失败残留的判断依据、一份避坑清单。不讲 OOXML 底层格式，也不教你写 C#。
开源项目 OfficeCLI 排障：用它自带的体检命令定位文档问题
开源项目 OfficeCLI 自带两条诊断通道：validate 做 OOXML schema 体检，view issues 按三个桶加十四个子类型给文档问题分类。这篇讲清报错该按什么顺序查、每层能查出什么、哪些它明确不管。不讲排版审美，也不讲文档生成技巧。
OfficeCLI 开源项目常驻模式：进程不退，文档改动何时落盘
拆解开源项目 OfficeCLI 的常驻模式：为什么它把文档留在内存里不急着写回磁盘，两条命名管道和两个看门狗各管什么，四种落盘策略分别在什么时刻把改动写进你的 .docx/.xlsx/.pptx。读完你能判断什么时候该开常驻、交付前该按哪个按钮。不解决文档格式本身的读写细节。
OfficeCLI 开源项目的选择器语法：三份解析实现与最常见的选错点
拆解开源项目 OfficeCLI 用来定位文档元素的那套选择器：路径式与选择器式两种写法、Word/Excel/PowerPoint 三份互相独立的解析实现、共用的顶层逗号扫描与尾部位置索引。读完你能判断一条选择器会命中什么、为什么明明写对了却选到别的元素，以及哪些写法在写操作上会被直接拒绝。不解决渲染、排版和模型侧提示词问题。
OfficeCLI 开源项目上手：三种装法怎么选，第一次跑前先懂这件事
OfficeCLI 是给 AI Agent 用的开源 Office 读写命令行工具，单文件二进制，也能走 npm 装。这篇读一遍它的仓库结构，讲清一键脚本、包管理器、手动下载三种装法各自的适用面与代价，以及第一次运行前必须弄明白的落盘时机。不讲元素属性怎么设，也不替它背书。
结构与机制
按层逐块读：schema 驱动的命令定义、统一文档节点模型、原子写入、三种文档各自的处理器，以及公式引擎、透视表、图表、Mermaid 编译与插件协议。
拆解开源项目 OfficeCLI：让 Agent 做出不土的 PPT 动画与平滑切换
从 OfficeCLI 这个开源 Office 读写套件的源码出发，讲清 Agent 做 PPT 动画到底卡在哪：切换字符串怎么被解析成三套不同的 XML、复杂动效为什么只能靠录制模板、跨页平滑切换为什么是命名纪律而不是命令参数。读完你能判断哪些动效值得交给 Agent、哪些不值得，不解决审美与内容质量问题。
拆解开源项目 OfficeCLI：PPT 处理器为什么比 Word 难做
从加一页幻灯片、定位一个形状、到把继承下来的字号字体解析出来，逐层读 OfficeCLI 仓库里的 PowerPoint 处理器源码，看清 PPT 相比 Word、Excel 多出来的三条难度轴，以及它明确不管的那部分。不讲怎么用命令做出漂亮的 PPT，只讲这套代码的分工和它的代价。
拆开源项目 OfficeCLI 的插件协议：第三方格式处理器如何以独立进程接进主程序
逐文件读 OfficeCLI 仓库里的插件协议与核心实现：三种插件形态、四条发现路径、空闲看门狗而非墙钟超时、代理层的严格回复形状。读完你能照着给自己的 CLI 设计一套跨进程扩展面，也能看清它明确不管的那几件事。
开源项目 OfficeCLI 的 Excel 透视表实现：五块难点拆解
拆解开源命令行工具 OfficeCLI 是怎么在不启动 Excel 的前提下写出真正能显示的透视表，把缓存、定义、参数解析、单元格渲染、回读五块分开讲，说清每块解决什么问题、放弃了什么。读完你能判断一个文档工具是不是真的写对了透视表，不解决 Excel 端的公式重算与图表联动。
开源项目 OfficeCLI 的 Mermaid 图形编译链路拆解
拆开开源项目 OfficeCLI 的 Core/Diagram 目录：一段 Mermaid 文本经解析、布局、样式、渲染四步，变成 Word 与 PPT 里可双击编辑的原生形状。读完能判断这条链路适合什么场景、放弃了什么、出问题该打开哪个文件。不讲 Mermaid 语法教程。
开源项目 OfficeCLI 的 Word 结构操作：章节、目录、页眉页脚与导航各自成块
从 OfficeCLI 仓库源码出发，拆开 Word 长文档的四类结构存储位置——章节断点、目录域、页眉页脚部件、路径导航，说明为什么它们必须各自成块，以及 Agent 在每一块上典型的失手方式。读完你能拿到一份可核对的机制地图和避坑清单。本文不讲怎么用大模型写正文，也不讲排版审美。
开源项目 OfficeCLI 的安全边界：四道防线挡住了什么、漏了什么
OfficeCLI 是一个给 AI Agent 用的开源 Office 文档读写套件，会直接改你磁盘上的 docx/xlsx/pptx，还会按指令拉外部资源。这篇逐个读它仓库里的 SsrfGuard、超链接 scheme 白名单、改写作用域闸门与资源上限，讲清每道防线的判定规则、落盘时机与失败残留，也讲清它明确不管的那几件事。不提供漏洞利用方法，也不替它做安全背书。
开源项目 OfficeCLI 的图表体系：两条线、七套预设与一个渲染器
拆开开源项目 OfficeCLI 的 Core/Chart 目录，讲清老图表与新式图表两条并行代码路径、七套硬编码预设，以及那个让 Agent 自己看结果的 SVG 渲染器；读完知道画图表要跨的坎在哪、哪些坑是设计取舍。不覆盖 Word 排版与表格读写。
开源项目 OfficeCLI 的文档节点模型：三类文档共用一套接口
拆开源项目 OfficeCLI 的核心抽象层：八字段的 DocumentNode、三层接口 IDocumentHandler、带 SDK 校验的类型化属性回退，以及落在属性字典上的选择器过滤。读完能判断这套抽象哪里省事、哪里有损、接入时盯住哪些坑。不涉及格式本身与渲染。
开源项目 OfficeCLI 给 Word 开的 Markdown 通道
拆解开源项目 OfficeCLI 里 docx 的 markdown 展开路径：解析器产出中立中间结构，Word 侧再落成原生段落、列表和表格。读完你能知道它支持哪些语法、编号和行内格式怎么拼出来、链接图片为何必然被压平。不解决往返编辑与图片导入。
开源项目 OfficeCLI 为何自研 Excel 公式引擎与求解器
拆解开源项目 OfficeCLI（不是微软产品）自己实现的 Excel 公式引擎：词法与递归下降解析、值模型与广播、溢出数组的锚点写盘、牛顿加二分的迭代求根，以及它在保存时对缓存值的取舍。读完你能判断哪些结果可以信、哪些必须回真 Excel 校。不涉及性能对比与版本选型。
开源项目 OfficeCLI 与 Pascal Editor：Agent 操作专业软件的两条路
同样是让 Agent 操作专业软件，OfficeCLI 把三种 Office 文件格式的读写与渲染重新实现一遍，Pascal Editor 在运行中的软件里开 MCP 口子。本篇逐层拆开 OfficeCLI 仓库里真实存在的分层，对照两种取向的代价、适用边界与落盘风险，不排座次，也不替你做选型决定。
开源项目 OfficeCLI 怎么读写 Word 的表单域、修订与批注
拆开开源项目 OfficeCLI 里三块和文档流转有关的代码：Word 表单域的多 run 结构、修订的创建与接受两套键、批注已解决状态藏在哪个 XML 部件。给你一份可核对的机制说明与避坑清单，不做工具横评，也不教你写 C#。
开源项目 OfficeCLI：152 份 json 撑起的文档即契约设计
拆解开源项目 OfficeCLI 的能力 schema 层：152 份 json 怎么同时供给帮助输出、属性校验与契约测试，CRC32 指纹怎么回答二进制能否盲升级，这套做法又放弃了什么。读完能拿到可照抄的目录结构和一份避坑清单；不讲 Office 文件格式细节。
OfficeCLI 开源仓库：Excel 处理器 47 个文件怎么分组
OfficeCLI 是不依赖本机 Office、让 AI Agent 直接读写 xlsx 的开源命令行项目。本篇拆它的 Excel 处理器：47 个文件怎么按增删改查分组、单元格写入路径与校验层各管什么、哪些限制是 Excel 的硬红线。不讲 OOXML 规范，也不做工具选型。
OfficeCLI 开源项目：往 PPT 里塞三维模型做到了哪一层
拆解开源项目 OfficeCLI 处理 PPT 三维模型的三块代码——GLB 模型插入、三维缩放与相机推算、Three.js 资源加载。读完你能看清它在 OOXML 里写了什么、哪些数值是算出来的、哪些是硬编码的，以及它明确不管的部分。不解决建模与渲染质量问题。
OfficeCLI 开源项目仓库导读：353 个 C# 文件的三层切法
逐层拆解 OfficeCLI 这个开源仓库的目录结构——命令层怎么用分部类摊成 18 个文件、三种文档各自一套处理器、核心层放了哪些跨格式的公共约束。读完你能自己定位任何一条命令的实现入口，并知道它改的是原文件还是副本。不讲怎么写 PPT 内容，也不评测它和其它文档库谁更强。
OfficeCLI 开源项目的写盘底线：原子包写入与临时目录守卫
拆解开源项目 OfficeCLI 怎么防止 Agent 改到一半毁掉真实 .docx/.xlsx/.pptx：同目录临时文件加一次性替换、批量全绿才落地，外加常驻进程的临时目录长度守卫。读完你能判断崩溃后盘上会剩什么、改动何时才真落盘；不解决掉电持久性与并发写。
想把 Agent 真正搭起来，而不只是会用？
从 Agent 工程实践到数字员工落地，站内有成体系的教程与课程。