uid13 Pinterest 图片画廊技能
本技能用于从 Pinterest 搜索图片并展示为瀑布流画廊。Agent 负责调用 gallery-dl 获取图片、生成数据文件、打开浏览器展示。
🔄 核心工作流 (Workflow)
Phase 1: 环境检查
检查 gallery-dl 是否已安装：
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 命令，每次使用不同的搜索词：
# 第一次搜索
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
文件格式：
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 执行步骤：
检查 gallery-dl 是否安装
理解意图并构造搜索词：
- 用户想要：成都美食
- 构造搜索词：
["Chengdu food", "Sichuan street food"]
执行第一次搜索：
gallery-dl --get-urls --http-timeout 10 --range 1-15 "https://www.pinterest.com/search/pins/?q=Chengdu food"执行第二次搜索：
gallery-dl --get-urls --http-timeout 10 --range 1-15 "https://www.pinterest.com/search/pins/?q=Sichuan street food"汇总去重：
- 合并 2 次搜索的 URL
- 去重、过滤 .heic 格式
- 保留 15-20 张图片
生成 pp-data.js 并确认保存后，在浏览器中打开 index.html
回复用户：
️ 画廊已为您打开，请您欣赏~
已为您准备好 成都美食 的精选美图 🍜✨
💡 小贴士：
- 点击任意图片可进入全屏查看模式
- 全屏查看时，点击 ▶️ 播放按钮可开启幻灯片自动播放
- 支持缩放、旋转、翻页等操作
祝您观赏愉快