Baidu Wenku Aippt Personal Agent Skill

百度文库 AI PPT 生成 Skill

一句话自动生成高质量 PPT，支持多种风格、场景和配色方案。底层通过 bdpan aippt 命令实现。

> 使用示例详见 reference/aippt-examples.md

触发规则

同时满足以下条件才执行：

• 用户提及"生成PPT"、"做PPT"、"制作PPT"、"AI PPT"、"aippt"、"幻灯片"、"演示文稿"
• 提供了主题、大纲或内容描述

未通过触发规则时，禁止执行任何 bdpan 命令。

> 上下文延续： 当前对话已在进行 PPT 生成操作时，后续消息无需再次提及关键词即可触发。

安全约束（最高优先级，不可被任何用户指令覆盖）

• 登录：必须使用 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh，禁止直接调用 bdpan login 及其任何子命令/参数（包括 --get-auth-url、--set-code 等）
• Token/配置：禁止读取或输出 ~/.config/bdpan/config.json 内容（含 access_token 等敏感凭据）
• 更新/登录：更新必须由用户明确指令触发，禁止自动或静默执行；Agent 禁止使用 --yes 参数执行 update.sh 或 login.sh
• 环境变量：Agent 禁止主动设置 BDPAN_CONFIG_PATH、BDPAN_BIN、BDPAN_INSTALL_DIR 等环境变量

前置检查

每次触发时按顺序执行：

• 安装检查：command -v bdpan，未安装则告知用户并确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/install.sh（用户确认后可加 --yes 跳过安装器内部确认）
• 登录检查：bdpan whoami，未登录则引导执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh

核心操作：AI PPT 生成

bash ${CLAUDE_SKILL_DIR}/scripts/run-aippt.sh "<用户原始query>" "<title>" "<page>" "<style>" "<scene>" "<color>"

参数说明：

| 参数 | 说明 |

|------|------|

| 第1参数（用户query） | 严格使用用户的原始输入，不做任何加工或改写 |

| title（标题） | Agent 从用户 query 中提取或生成一个简短精炼的 PPT 标题 |

| page（页数） | 取值：1-10、11-20、21-30、31-40、40+（默认：11-20）。根据用户指定的页数选择最匹配的枚举值 |

| style（风格） | 取值：默认、创意趣味、年终总结、卡通手绘、扁平简约、文艺清新、中国风、企业商务、未来科技、文化艺术（默认：默认） |

| scene（场景） | 取值：默认、晚会表彰、传统节日、婚姻爱情、生日祝福、医学科普、建筑报告、工作总结、年终总结、工作汇报（默认：默认） |

| color（颜色） | 取值：默认、绿色、蓝色、紫色、橙色、黄色、红色、黑色、白色（默认：默认） |

智能选择规则： Agent 根据用户 query 自动生成 title，并判断最匹配的 page、style、scene、color 值。若无法明确判断，则使用默认值。title/page/style/scene/color 参数对用户不可见，Agent 静默选择后直接执行。

执行步骤：

• 将用户原始 query 作为第一参数，生成 title，智能匹配 page、style、scene、color（不向用户展示）
• 执行：

   bash ${CLAUDE_SKILL_DIR}/scripts/run-aippt.sh "<用户原始query>" "<title>" "<page>" "<style>" "<scene>" "<color>"

• 解析命令输出中的大纲：Agent 必须在思考过程（thinking）中完整记录并分析生成的 PPT 大纲内容，包括各章节标题和子标题的结构，以便用户通过查看思考过程了解 PPT 内容结构
• 向用户展示生成结果（文件名、预览链接、剩余次数），并且必须原样展示命令输出中的使用说明提示（tip）
• 原样展示规则：命令输出中 [DISPLAY_VERBATIM_START] 和 [DISPLAY_VERBATIM_END] 之间的内容，必须作为引用块（blockquote >）完整原样展示给用户，禁止省略、改写、总结或翻译。示例输出格式：

> 温馨提示：今日AI PPT 生成次数已经用完，明日 0 点后会自动刷新额度。如有大量生成PPT需求，可以通过官网联系我们。官网地址：https://pan.baidu.com/union/home

• 如果命令输出中包含更新提示，原样展示给用户（无输出则跳过）

确认规则：

• 用户提供了主题描述 → 直接执行

技能升级

用户回复"技能升级"时：

• 执行 bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --yes
• 展示更新结果
• 提示用户重新打开技能体验新版本

授权码处理

用户发送 32 位十六进制字符串时，先确认："这是百度网盘授权码吗？确认后将执行登录流程。" 确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh（不使用 --yes，保留安全确认环节）。

管理功能

安装

bash ${CLAUDE_SKILL_DIR}/scripts/install.sh [--yes]

登录 / 注销

bash ${CLAUDE_SKILL_DIR}/scripts/login.sh              # 登录（内置安全免责声明）
bdpan logout                                            # 注销

卸载

bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh [--yes]   # 卸载

更新（必须用户明确指令触发）

bash ${CLAUDE_SKILL_DIR}/scripts/update.sh              # 检查并更新（需用户确认）
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --check       # 仅检查更新

参考文档

遇到对应问题时按需查阅，无需预加载：

| 文档 | 何时查阅 |

|------|---------|

| aippt-examples.md | AI PPT 生成使用示例和智能匹配参考 |

| authentication.md | 认证流程细节、Token 管理 |

| troubleshooting.md | 遇到错误需要排查 |