# Pp

> 从 Pinterest 搜索图片并在浏览器中展示瀑布流画廊。使用 gallery-dl 获取图片链接，生成数据文件，打开浏览器展示。

- Skill: `uid13/pp` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add uid13/pp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uid13/pp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: uid13 (https://skillmd.com/u/uid13)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/uid13/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. 回复用户：
   > ️ **画廊已为您打开，请您欣赏~**
   >
   > 已为您准备好 **成都美食** 的精选美图 🍜✨
   >
   > 💡 **小贴士**：
   > - 点击任意图片可进入全屏查看模式
   > - 全屏查看时，点击 ▶️ 播放按钮可开启幻灯片自动播放
   > - 支持缩放、旋转、翻页等操作
   >
   > 祝您观赏愉快