PowerPoint

当使用User需要Microsoft PowerPoint作为一个实时应用程序进行控制，而不是作为一个.pptx文件格式。Agent处理应用程序附加、活动演示状态、幻灯片操作、笔记、导出、幻灯片控制和干净的关闭通过官方的osascript CLI。如果主要的工件是离线PPTX生成或结构文件编辑，请使用powerpoint-pptx代替。

架构 内存存储在~/powerpoint/中。如果~/powerpoint/不存在，请运行setup.md。请参阅memory-template.md以获取结构。 ~/powerpoint/ ├── memory.md # 环境事实、安全默认值和最后的工作控制路径 ├── incidents.md # 可重用的故障和已验证的恢复步骤 └── deck-notes.md # 关于可信赖的幻灯片、布局和导出目标的非敏感笔记

快速参考 仅加载与当前PowerPoint任务和风险级别匹配的最小文件。 主题 文件 设置指南 setup.md 内存模板 memory-template.md 接口选择 execution-matrix.md 实时控制模式 live-control-patterns.md 破坏性操作防护栏 safety-checklist.md 调试和恢复 troubleshooting.md

要求 Microsoft PowerPoint安装在本地。 macOS具有osascript可用。 在进行破坏性演示操作之前进行显式确认。

核心规则

• 选择应用程序控制路径根据演示状态

使用osascript通过应用程序的脚本字典进行实时PowerPoint控制。将自动化保持在实时PowerPoint会话中，而不是回退到仅文件PPTX工具。 不要在请求的工作依赖于当前实时应用程序状态时切换到离线演示库。

• 确定确切的演示、幻灯片和窗口然后采取行动

确认目标是否为活动演示、命名的打开的幻灯片或现在打开的路径。 在修改内容或导出之前，阅读当前幻灯片索引、视图模式和幻灯片状态。 永远不要假设最前面的幻灯片是预期的。

• 读取然后写入，然后验证最终状态

在修改之前，预读演示名称、活动幻灯片、笔记状态或导出目标。 在编辑、幻灯片操作、导出或幻灯片命令之后，重新读取受影响的状态并报告结果。 如果PowerPoint没有达到请求的状态，请停止并诊断，而不是堆叠操作。

• 将幻灯片顺序和布局操作视为高风险

移动、复制、删除或重新排序幻灯片可能会破坏引用、动画和演示者流程。 在可能的情况下，目标是显式的幻灯片编号或幻灯片ID，而不是仅仅依赖于当前选择。 如果幻灯片身份不明确，请先澄清。

• 将可逆的视图操作与破坏性的幻灯片清理分开

更改视图模式、启动幻灯片和导出通常是可逆的。 删除幻灯片、覆盖保存目标、批量替换笔记、关闭而不保存以及幻灯片范围的清理需要显式确认。 除非用户明确要求更改，否则保留幻灯片设置、笔记和演示者流程。

• 保持来源明确

指出目标幻灯片是否已经打开或仅为此任务而打开。 报告哪个演示被修改、哪个幻灯片是活动的以及导出被写入哪里。 保留用户拥有的打开的幻灯片，这些幻灯片不在任务范围内。

• 恢复干净并避免孤立的应用程序会话

如果您仅为此任务打开了PowerPoint，请保持所有权明确并仅关闭您创建的内容。 如果您附加到现有的会话，请不要在未获得明确批准的情况下关闭无关的幻灯片或退出PowerPoint。 在失败时，记录确切的阻塞器：缺少幻灯片、模态对话框、受保护的文件、不支持的布局或幻灯片状态不匹配。

PowerPoint 陷阱 将实时幻灯片视为静态.pptx文件 -> 笔记、演示者状态、动画和导出上下文会分离。 在未验证活动幻灯片的情况下重新排序或删除幻灯片 -> 修改了错误的演示。 仅通过当前选择编辑 -> 操作落在错误的幻灯片或形状上。 在未验证笔记、幻灯片编号或最终视图状态之前导出 -> 交付了过时的输出作为最终结果。 在自动化后关闭附加的用户会话 -> 中断了无关的演示工作。 忽略幻灯片状态 -> 命令失败或影响编辑视图而不是演示者视图。

安全性和隐私 本地存储的数据：演示路径、环境笔记和~/powerpoint/中的可重用修复。 通过本地PowerPoint自动化访问的演示内容。 可能离开您的机器的数据：默认情况下，此技能本身没有任何数据。 演示的自身链接媒体、云备份的自动保存或添加项可能会联系外部系统。 此技能不： 使用云幻灯片API或OAuth流。 默默禁用演示警告。 在未获得明确确认的情况下删除幻灯片或应用破坏性的幻灯片范围更改。 绕过PowerPoint保护提示。

相关技能 如果用户确认，请使用clawhub install 安装：office - 跨文档、电子表格和演示的更广泛的Office任务路由