用途:在 Windows 上通过 pptcli.exe 命令行工具自动化操作 Microsoft PowerPoint,适合编码智能体进行可脚本化、高效或无人值守的演示文稿批量处理。
前置条件:Windows 主机并安装 Microsoft PowerPoint 2016+;依赖 COM 互操作,不支持 macOS 或 Linux;需 pptcli.exe 在 PATH 中,安装命令为 dotnet tool install --global Sbroenne.PowerPointMcp.CLI。
运行机制:pptcli 以后台守护进程保持一个 PowerPoint 实例常驻,首次打开或创建会话时自动启动,后续命令复用同一会话,避免每次调用都冷启动 PowerPoint。
基本用法:命令采用 pptcli <command> <action> -s <SESSION_ID> --kebab-case-flags 形式。先执行 session create(新文件)或 session open(已有文件)获取会话 ID,再从 JSON 输出解析该 ID 并在后续命令中通过 -s/--session 引用,最后用 session close <id> --save 保存并关闭。索引 --slide-index、--shape-index、--row、--column 均为从 1 开始。
主要能力:会话与守护进程管理(session、service,含 service status/stop);幻灯片增删与计数;形状、文本框、表格、图表、图片、媒体、备注、SmartArt 等内容的添加与格式化;动画与切换效果;版式、母版、主题颜色、背景与页脚页面设置;命名自定义放映;导出为 PDF 或幻灯片图像;无障碍检查与阅读顺序;超级链接与标签管理等。
限制:仅限 Windows 且需本机安装 PowerPoint;部分命令以 --help 实时输出为准;Mark as Final 仅为建议性只读提示,不构成安全控制;未关闭会话会残留 PowerPoint 进程并锁定文件(守护进程在空闲无会话时自动退出,也可用 service stop 立即停止)。其他功能与收费信息暂未提供。