pp

# Pinterest 图片画廊技能 本技能用于从 Pinterest 搜索图片并展示为瀑布流画廊。Agent 负责调用 gallery-dl 获取图片、生成数据文件、打开浏览器展示。 ## 🔄 核心工作流 (Workflow) ### Phase 1: 环境检查 检查 gallery-dl 是否已安装： ```bash gallery-dl --version ``` 如果命令不存在或报错，提示用户安装： - 下载地址：https://github.com/mikf/gallery-dl/releases - 安装后将 gallery-dl.exe 添加到系统 PATH ### Phase 2: 搜索图片（智能双搜索策略） **步骤 2.1：理解用户意图并构造搜索词** 模型需要理解用户输入的主题/意图，构造 2 个不同角度的 Pinterest 友好搜索词： **搜索词构造规则**： - 优先使用英文（Pinterest 国际内容更丰富） - 中国明星/中国特色主题可保留中文 - 搜索词应简洁、具体，避免过长或过于抽象 - 2 个搜索词应从不同角度描述同一主题 **示例**： - "成都美食" → `["Chengdu food", "Sichuan street food"]` - "绚丽星空" → `["starry night sky", "milky way photography"]` - "鞠婧祎" → `["Ju Jingyi", "鞠婧祎"]` - "深圳美景" → `["Shenzhen skyline", "Shenzhen city view"]` - "猫咪" → `["cute cat", "kitten portrait"]` **步骤 2.2：执行 2 次搜索** 依次执行 2 次 `gallery-dl` 命令，每次使用不同的搜索词： ```bash # 第一次搜索 gallery-dl --get-urls --http-timeout 10 --range 1-15 "https://www.pinterest.com/search/pins/?q=<关键词1>" # 第二次搜索 gallery-dl --get-urls --http-timeout 10 --range 1-15 "https://www.pinterest.com/search/pins/?q=<关键词2>" ``` **参数说明**： - `--get-urls`：只获取图片 URL，不下载 - `--http-timeout 10`：HTTP 连接超时 10 秒 - `--range 1-15`：每次获取 15 条，2 次共约 30 条 **步骤 2.3：汇总去重** - 合并 2 次搜索的 URL 列表 - 按 URL 去重 - 过滤 `.heic` 格式（浏览器不支持） - 仅保留 `.jpg`、`.png`、`.jpeg` 格式 - 最终保留 15-20 张图片 ### Phase 3: 生成数据并打开画廊 ⚠️ **重要**：必须先完成数据文件写入，确认 pp-data.js 已保存后，才能打开浏览器。 **顺序错误会导致浏览器加载旧数据！** **步骤 3.1：生成数据文件** 将汇总去重后的图片 URL 列表转换为 JavaScript 格式，写入数据文件： **文件路径**：`<skill-dir>/pp-data.js` **文件格式**： ```javascript window.PP_IMAGES = [ { url: 'https://i.pinimg.com/originals/xxx.jpg', alt: '图片描述1' }, { url: 'https://i.pinimg.com/originals/yyy.jpg', alt: '图片描述2' }, // ... 更多图片 ]; ``` **注意**： - `alt` 字段可以是图片描述或留空字符串 - 最终生成 15-20 张图片 - **必须确认文件已保存** **步骤 3.2：打开浏览器** 确认 pp-data.js 已保存后，使用系统默认方式在浏览器中打开 `<skill-dir>/index.html`。 根据当前操作系统和 shell 环境选择合适的命令，例如： - Windows cmd：`start index.html` - Windows PowerShell：`Invoke-Item index.html` - macOS：`open index.html` - Linux：`xdg-open index.html` --- ## 💬 回复规范 打开画廊后，用轻松友好的语气向用户介绍，参考以下风格： **示例回复**： > 🖼️ **画廊已为您打开，请您欣赏~** > > 已为您准备好 **{主题}** 的精选美图 > > 💡 **小贴士**： > - 点击任意图片可进入全屏查看模式 > - 全屏查看时，点击 ▶️ 播放按钮可开启幻灯片自动播放 > - 支持缩放、旋转、翻页等操作 > > 祝您观赏愉快 🎨 **常用主题 emoji 参考**： - 人物/明星：🌟 👤 💫 - 风景/自然：🏞️ 🌄 🌸 🍃 - 动物/宠物：🐱 🐶 🦊 🐰 🦋 - 美食：🍰 🍜 🍕 ☕ - 艺术/设计： 🖌️ ✏️ 📐 - 建筑/城市：🏛️ 🏙️ 🌉 - 时尚/穿搭：👗 👠 💄 🕶️ - 动漫/游戏： 🎯 ⚔️ 🌸 --- ## 📋 技能目录结构 ``` skills/pp/ ├── index.html # 画廊页面入口 ├── icons/ # 图标文件 ── pp-data.js # 图片数据文件（运行时生成） └── SKILL.md # 本文件 ``` --- ## 📝 使用示例 **用户输入**： > 帮我搜索一些成都美食的图片 **Agent 执行步骤**： 1. 检查 gallery-dl 是否安装 2. 理解意图并构造搜索词： - 用户想要：成都美食 - 构造搜索词：`["Chengdu food", "Sichuan street food"]` 3. 执行第一次搜索： ```bash gallery-dl --get-urls --http-timeout 10 --range 1-15 "https://www.pinterest.com/search/pins/?q=Chengdu food" ``` 4. 执行第二次搜索： ```bash gallery-dl --get-urls --http-timeout 10 --range 1-15 "https://www.pinterest.com/search/pins/?q=Sichuan street food" ``` 5. 汇总去重： - 合并 2 次搜索的 URL - 去重、过滤 .heic 格式 - 保留 15-20 张图片 6. **生成 pp-data.js 并确认保存后**，在浏览器中打开 index.html 7. 回复用户： > ️ **画廊已为您打开，请您欣赏~** > > 已为您准备好 **成都美食** 的精选美图 🍜✨ > > 💡 **小贴士**： > - 点击任意图片可进入全屏查看模式 > - 全屏查看时，点击 ▶️ 播放按钮可开启幻灯片自动播放 > - 支持缩放、旋转、翻页等操作 > > 祝您观赏愉快