diff --git a/.vitepress/config.mts b/.vitepress/config.mts
index 2389baa..c2c9fe2 100644
--- a/.vitepress/config.mts
+++ b/.vitepress/config.mts
@@ -25,6 +25,7 @@ export default defineConfig({
           text: '行业研究',
           items: [
             { text: 'Aspose AI 产品能力分析', link: '/research/aspose-ai' },
+            { text: 'OfficeCLI：为 AI Agent 而生的 Office 工具', link: '/research/officecli' },
           ],
         },
       ],
diff --git a/research/index.md b/research/index.md
index 54867ff..bf7702d 100644
--- a/research/index.md
+++ b/research/index.md
@@ -5,3 +5,4 @@
 ## 文章列表
 
 - [Aspose AI 产品能力分析](./aspose-ai) — 老牌文档处理公司的 AI 转型之路
+- [OfficeCLI：为 AI Agent 而生的 Office 工具](./officecli) — 开源命令行 Office 套件，AI-first 设计
diff --git a/research/officecli.md b/research/officecli.md
new file mode 100644
index 0000000..91f05f5
--- /dev/null
+++ b/research/officecli.md
@@ -0,0 +1,273 @@
+# OfficeCLI：为 AI Agent 而生的 Office 工具
+
+> 调研时间：2026 年 5 月 | 作者：沙洲工作室
+
+## 项目概况
+
+| 项目 | 信息 |
+|------|------|
+| 名称 | OfficeCLI |
+| 定位 | 全球首个专为 AI Agent 设计的 Office 命令行套件 |
+| 组织 | iOfficeAI（品牌名 AionUi） |
+| GitHub | [iOfficeAI/OfficeCLI](https://github.com/iOfficeAI/OfficeCLI) |
+| Stars | 2,900+（截至 2026.5） |
+| 许可证 | Apache 2.0 |
+| 语言 | C#（内嵌 .NET 运行时，单二进制分发） |
+| 平台 | macOS / Linux / Windows，均支持 ARM64 和 x64 |
+| 团队 | 核心开发者 1-2 人，极高频提交（几乎每天） |
+| 关联产品 | AionUi（23.8k stars，桌面 GUI 应用） |
+
+OfficeCLI 是一个开源命令行工具，让 AI Agent 通过 shell 命令直接操作 Word、Excel、PowerPoint 文件——创建、读取、编辑、自动化，全部不需要安装 Microsoft Office。
+
+---
+
+## 为什么值得关注
+
+OfficeCLI 和传统的文档处理库（如 Aspose、python-docx）有本质区别：**它不是给开发者写代码用的 SDK，而是给 AI Agent 直接调用的命令行工具**。
+
+这意味着：
+- Claude Code 可以直接执行 `office word add paragraph "Hello"` 来编辑文档
+- Cursor/Windsurf 等 AI 编辑器可以在终端中操作 Office 文件
+- 任何能执行 shell 命令的 AI Agent 都能立即获得 Office 能力
+
+不需要写 Python 脚本，不需要安装依赖，不需要理解 API。一行命令就是一个操作。
+
+---
+
+## 技术架构：三层设计
+
+OfficeCLI 的架构设计很有意思，分为三层，对应不同的操作粒度：
+
+### L1：语义视图层（Read）
+
+用 `view` 命令获取文档的结构化视图，AI 可以快速理解文档内容：
+
+| 视图模式 | 作用 |
+|---------|------|
+| text | 纯文本内容 |
+| annotated | 带元素编号的标注视图（AI 用编号定位元素） |
+| outline | 文档大纲结构 |
+| stats | 统计信息（字数、段落数等） |
+| issues | 文档问题检测 |
+| html | HTML 渲染预览 |
+
+**设计巧思**：`annotated` 视图给每个元素标上编号（如 `[P1]`、`[T2]`），AI Agent 在后续操作中可以直接引用编号，不需要描述"第三段第二个表格"这样模糊的定位。
+
+### L2：DOM 操作层（Write）
+
+结构化的元素级操作：
+
+| 命令 | 作用 |
+|------|------|
+| get | 获取元素属性 |
+| query | 查询匹配元素 |
+| set | 修改元素属性 |
+| add | 添加新元素 |
+| remove | 删除元素 |
+| move | 移动元素位置 |
+| swap | 交换两个元素 |
+
+这层覆盖了 Office 文档的几乎所有元素——段落、表格、图片、图表、样式、页眉页脚、批注、书签、目录、公式、水印、超链接、表单字段、内容控件……
+
+### L3：Raw XML 层（底层）
+
+直接操作 Office 文件的 XML 结构：
+
+| 命令 | 作用 |
+|------|------|
+| raw | XPath 查询 XML |
+| raw-set | 直接修改 XML 节点 |
+| add-part | 添加 XML 部件 |
+| validate | 验证文档结构 |
+
+**为什么需要这层**：Office 格式的 XML 极其复杂（一个 docx 文件解压后可能有几十个 XML 文件）。当 L2 的高层命令覆盖不到某个冷门功能时，AI Agent 可以降级到 XML 层直接操作。
+
+---
+
+## 性能设计
+
+### 驻留模式（Resident Mode）
+
+通过命名管道保持文档在内存中。普通模式下每次命令都要打开/解析/保存文件，驻留模式下文档只打开一次，后续操作近乎零延迟。
+
+**场景**：AI Agent 连续执行几十条编辑命令时，驻留模式可以将总耗时从分钟级降到秒级。
+
+### 批处理模式（Batch Mode）
+
+单次打开/保存周期内执行多条命令。适合确定性操作序列（如"创建文档 → 添加标题 → 插入表格 → 设置样式 → 保存"）。
+
+### 实时预览（Watch Mode）
+
+启动本地 HTTP 服务器，浏览器中实时刷新查看修改效果。支持 PPT 的 Morph 动画、3D 模型、图表等复杂元素的渲染。
+
+**场景**：AI Agent 边修改 PPT 边在浏览器中预览效果，形成"修改 → 预览 → 调整"的交互式工作流。
+
+---
+
+## 功能覆盖
+
+### Word（.docx）
+
+段落、运行文本、表格、样式、页眉页脚、图片、公式、批注、脚注尾注、水印、书签、目录、图表、超链接、分节符、表单字段、内容控件、OLE 对象。完整 i18n 和 RTL（从右到左）支持。
+
+### Excel（.xlsx）
+
+单元格读写、150+ 内置公式函数、工作表管理、表格、排序、条件格式、图表（含箱线图/帕累托图等高级图表）、数据透视表、切片器、命名范围、数据验证、迷你图、批注、自动筛选、形状、CSV/TSV 导入。
+
+### PowerPoint（.pptx）
+
+幻灯片、形状、图片、表格、图表、动画、Morph 过渡效果、3D 模型（.glb）、缩放导航、公式、主题、连接器、视频/音频嵌入、分组、演讲者备注、占位符。
+
+---
+
+## AI-First 设计哲学
+
+OfficeCLI 最大的差异化不是功能多，而是**为 AI Agent 的思维方式优化了交互设计**：
+
+### SKILL.md 技能文件
+
+项目内置 `SKILL.md` 文件，AI Agent 读取后自动学会如何使用 OfficeCLI。这意味着：
+- 在 Claude Code 中输入"帮我做一份 PPT"，Claude 读取 SKILL.md 后直接执行命令
+- 不需要人类写 prompt 教 AI 怎么调用，工具自己教 AI
+
+### 元素编号定位
+
+`annotated` 视图给每个元素标号，AI 通过编号精确操作。这比"修改第三段"或 XPath 路径更符合 AI 的交互模式。
+
+### JSON 输出
+
+所有命令支持 JSON 输出格式，方便 AI 解析结果。
+
+---
+
+## 生态与关联产品
+
+| 产品 | Stars | 说明 |
+|------|-------|------|
+| AionUi | 23.8k | 桌面 GUI 应用，支持 20+ AI CLI 工具协同工作 |
+| OfficeCLI | 2.9k | 本项目，命令行 Office 套件 |
+| aionrs | 83 | Rust 写的多供应商 AI Agent CLI |
+| aioncli | 22 | fork 自 google-gemini/gemini-cli |
+
+AionUi 是 OfficeCLI 的"门面"——它提供了一个漂亮的桌面界面，背后调用 OfficeCLI 等命令行工具。23.8k stars 说明市场对"AI + Office"这个方向有很强的需求。
+
+---
+
+## 场景分析
+
+### 场景一：AI Agent 端到端文档生成
+
+**典型流程**：用户对 AI 说"帮我做一份 Q2 销售报告 PPT"
+
+AI Agent 的操作序列：
+1. 分析用户需求，规划 PPT 结构
+2. `office pptx create report.pptx` — 创建文件
+3. `office pptx add slide --layout title` — 添加标题页
+4. `office pptx set title "Q2 销售报告"` — 设置标题
+5. 循环添加内容页、图表、表格
+6. `office pptx add chart --type bar --data ...` — 插入图表
+7. `office pptx set transition --type morph` — 设置过渡动画
+
+**对比现有方案**：
+- python-pptx：需要写 Python 脚本，AI 要生成代码再执行，链路长
+- Aspose MCP Server：通过 MCP 协议，需要配置 MCP 客户端
+- OfficeCLI：直接在终端执行命令，最短路径
+
+### 场景二：文档批量处理与质检
+
+**场景**：企业有 500 份 Word 合同模板需要统一修改格式
+
+AI Agent 可以用 shell 脚本 + OfficeCLI 批量处理：
+- `view --mode issues` 检测每份文档的格式问题
+- `set` 命令批量统一字体、边距、页眉
+- `validate` 验证修改后的文档结构完整性
+
+### 场景三：PPT 交互式制作
+
+借助 Watch Mode，AI Agent 可以实现"边做边看"的 PPT 制作体验：
+- 用户在浏览器中实时看到 PPT 变化
+- 对 AI 说"把标题字号调大"、"这页加个图表"
+- AI 执行命令，浏览器秒级刷新
+
+这比"AI 生成一个文件然后下载打开看看"的体验好得多。
+
+### 场景四：Excel 数据自动化
+
+AI Agent 可以直接操作 Excel 进行数据处理：
+- 读取数据并分析
+- 添加公式列（150+ 内置函数）
+- 生成数据透视表
+- 创建可视化图表
+- 设置条件格式高亮异常值
+
+**对比**：传统方式需要 pandas + openpyxl + matplotlib，OfficeCLI 在原生 Excel 文件上操作，输出的就是可以直接打开的 xlsx。
+
+### 场景五：文档内容审阅与修改
+
+AI Agent 读取文档后进行智能审阅：
+- `view --mode annotated` 获取带编号的全文
+- AI 分析内容，找出问题
+- `set [P3] text "修改后的内容"` 精确修改特定段落
+- `add comment [P5] "这里数据需要更新"` 添加批注
+
+---
+
+## 与 Aspose 的对比
+
+| 维度 | OfficeCLI | Aspose |
+|------|-----------|--------|
+| 定位 | AI Agent 的 Office 工具 | 开发者的文档处理 SDK |
+| 使用方式 | 命令行，一行一操作 | API 调用，写代码集成 |
+| 目标用户 | AI Agent / AI 编辑器用户 | 企业开发团队 |
+| AI 集成方式 | 天然适配（就是 CLI） | 需要通过 SDK 或 MCP Server |
+| 内置 AI 能力 | 无（纯工具，AI 在外部） | 有（摘要/翻译/语法检查） |
+| 格式覆盖 | Word + Excel + PPT | 100+ 种格式 |
+| 价格 | 免费开源 (Apache 2.0) | SDK $999+ |
+| 成熟度 | 新项目，快速迭代中 | 20+ 年老牌 |
+| 团队 | 1-2 人 | 商业公司 |
+
+**核心差异**：Aspose 是"把 AI 放进文档处理"（SDK 内置 LLM 调用），OfficeCLI 是"把文档处理放进 AI"（让 AI Agent 直接操作文档）。思路完全相反。
+
+---
+
+## 产品策略分析
+
+### 开源 + GUI 双轨
+
+OfficeCLI（开源命令行）负责获取开发者和 AI 社区的信任，AionUi（桌面 GUI，23.8k stars）负责面向更广泛的用户群。两者互相导流。
+
+### AI Agent 生态卡位
+
+OfficeCLI 的 SKILL.md 设计是一步好棋——当 Claude Code、Cursor、Windsurf 等 AI 编辑器的用户需要操作 Office 文件时，OfficeCLI 是最自然的选择。不需要配置 MCP、不需要写代码、不需要安装依赖。
+
+### 潜在风险
+
+1. **团队太小**：核心就 1-2 人，开发节奏虽快但 bus factor 极高
+2. **商业模式不清晰**：Apache 2.0 开源，尚未看到变现路径
+3. **功能正确性待验证**：Office 格式极其复杂，边缘情况非常多，小团队能否保证质量是疑问
+4. **竞争来自上游**：如果微软/Google 在 Office 产品中原生集成 AI Agent 接口，OfficeCLI 的价值会大幅缩水
+
+---
+
+## 总结与洞察
+
+### OfficeCLI 代表的趋势
+
+OfficeCLI 的出现印证了一个正在发生的范式转移：**软件工具的用户正在从人类变成 AI Agent**。
+
+传统的 Office 工具为人类设计——GUI、菜单、鼠标点击。开发者工具为程序员设计——API、SDK、写代码。OfficeCLI 为 AI Agent 设计——命令行、JSON 输出、技能文件。这是第三种交互范式。
+
+### 关键启示
+
+1. **CLI 是 AI Agent 的原生接口**——比 API 更轻量，比 MCP 更成熟，任何能执行 shell 命令的 Agent 都能用
+2. **SKILL.md 是一种新的"文档"形式**——不是写给人看的，是写给 AI 看的使用手册
+3. **"零依赖单二进制"是 AI 工具的理想分发形式**——AI Agent 环境各异，安装步骤越少越好
+4. **AI 不需要 GUI**——AionUi 的 23.8k stars 说明人类仍然需要 GUI，但 AI Agent 时代的核心是 CLI
+
+### 与 Aspose 的互补关系
+
+两者不是替代关系，而是互补：
+- **OfficeCLI 适合**：AI Agent 实时交互式编辑、小团队快速原型、开源项目
+- **Aspose 适合**：企业级大规模文档处理、需要 AI 内置能力（摘要/翻译）、复杂格式兼容性要求高的场景
+
+未来最有可能的格局是：OfficeCLI 成为 AI Agent 的"手"（执行操作），Aspose 成为企业的"引擎"（底层处理），两者在不同层面服务于"AI + Office"这个大趋势。