@office-kit/pptx

项目简介

Office Kit 的 @office-kit/pptx 是一个用于读取、编辑和写入 .pptx 演示文稿文件的 TypeScript 库。它通过单一 ESM 构建在 Node.js 和浏览器中运行，并在往返过程中保留 SmartArt、OLE 对象等未知部件。该库使用 Open XML SDK 和 ECMA-376 架构校验输出。

核心功能

• 支持在 Node.js 和浏览器中通过单一 ESM 构建读取、编辑和写入 .pptx 文件。在往返过程中保留 SmartArt、OLE 对象、视频和供应商扩展等未知部件。在 CI 中通过 Open XML SDK 的 OpenXmlValidator 和 ECMA-376 架构校验输出。支持全部 16 种 ECMA-376 图表类型，以及形状、表格、图片、文本和审阅功能。采用可摇树优化的自由函数 API 和无副作用导出，仅有一个运行时依赖 fflate。

适用场景

• 通过令牌替换或占位符编辑，把数据填入设计师制作的 .pptx 模板。编辑来自 Keynote、Google Slides 或其他应用的现有演示文稿并保存回去。审计演示文稿：列出布局、查找超链接或检查空标题。使用 Claude Code 或 Codex，通过 TSX 编写与实时预览创建幻灯片。

快速开始

• 使用 npm install @office-kit/pptx 安装。若要编辑模板，用 loadPresentation 加载文件，修改后再用 savePresentation 保存。若要使用 AI 辅助编写，运行 npx --yes @office-kit/pptx-dev@latest init my-slides 创建一个带实时预览的项目；需要 Node.js 22.18 或更高版本。

部署与要求

• 该库在 Node.js 和现代浏览器中运行，不需要原生模块。AI 编写工作流需要 Node.js 22.18 或更高版本，以及配合 Claude Code 使用的 Git。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。