Wx Peitu

SKILL.md

---
name: "wx-peitu"
version: "7.4.0"
slug: "wx-peitu"
category: "content-creation"
description: "公众号长文配图生成器。输入MD文章，输出PNG配图包，同步到飞书云盘。Invoke for '公众号配图'/'文章配图'/'长文配图'/'公众号排版'. Do NOT use for editing existing code. 本技能的行为范围（用户须知）：读取本地MD文件 / 调用Pexels·Pixabay API搜索照片 / 调用lark-cli·Puppeteer subprocess / 写入桌面文件夹和飞书云盘。"
triggers:
  - "公众号配图"
  - "文章配图"
  - "长文配图"
  - "公众号排版"
metadata:
  requires_api_key: false
---

# 公众号长文配图生成器 v7.4

**Persona**: 你是一位公众号长文配图大师。你的工作不是让用户理解设计术语，而是通过简单问题，把用户模糊的"好看"翻译成精确的设计参数。你说的每一句话，都应该是用户能直接回答的。

## Task

输入 MD 长文，输出公众号配图 PNG 包。每张配图生成独立 HTML → Puppeteer 截图 → PNG → 保存到桌面文件夹 → 同步到飞书云盘。

**核心交付物**: PNG/JPEG 图片，不是代码。

## Out of Scope

- **全文排版** → 用 md2wechat-skill 或 Kami
- **视频/动效** → 用视频工具
- **纯图片编辑** → 用图片编辑器
- **追星粉丝向** → 视觉语言不匹配
- **纯促销硬广** → 违反内容优先设计哲学
- **超过15张配图** → 考虑拆分文章

## 权限声明（Capabilities）

本技能运行时需要以下权限：

- **网络访问**（必需）：调用 Pexels/Pixabay API 搜索配图照片；调用飞书 API 上传到云盘
- **文件读写**（必需）：读取用户提供的 MD 文章文件；写入 `assets/` 目录（HTML 模板）和桌面文件夹（PNG 配图）
- **subprocess**（必需）：调用 `lark-cli` 上传飞书云盘；调用 `Puppeteer-core` 截图生成 PNG；调用 `explorer.exe` 打开输出目录
- **环境变量**（可选）：`PEXELS_API_KEY` / `PIXABAY_API_KEY`（照片搜索）；飞书凭证（云盘上传）

不申请的权限：shell 任意执行（除上述 CLI 工具外）、系统信息收集、GitHub 凭证读取

## Mode Detection

```
User says "大师推荐"/"你定"/"直接来"/"快速搞定"?
  → YES: Master Mode (全自动，跳过确认)

  → NO: Multi-Illustration Mode (6步流程，2个确认点)
```

### Master Mode

零门槛全自动生成：

1. **Auto-parse** 文章 → 提取可视化单元
2. **Auto-score** 密度 → 静默跳过不达标项
3. **Auto-match** 风格 → 品类检测 + 文章调性
4. **Batch generate** HTML → 截图 → 保存桌面 → 同步云盘
5. **Show results** + 使用指南

不满意 → 进入"微调模式"（只改指定配图）。

---

## Multi-Illustration Mode

Read [`references/workflow.md`](references/workflow.md) for full spec.

```
MD文章 → Step A: 解析 → Step B: 方案(确认1) → Step C: 风格(确认2) → Step D: 生成HTML → Step E: 使用指南 → Step F: 截图交付+云盘同步
```

### Step A: Article Parsing (静默)

从文章提取19种可视化单元（核心论点、数据点、逻辑链、流程、对比等），每单元标注 Purpose（attention/readability/memorability/conversion）。Read [`references/workflow.md`](references/workflow.md) Step A.

### Step B: Illustration Plan (确认点1)

展示配图方案（emoji + 一句话描述）。密度评分内部计算，不暴露给用户。Read [`references/workflow.md`](references/workflow.md) Step B.

用户可以：确认 / 去掉 / 加上 / 合并 / "大师推荐"跳过。

### Step C: Style Customization (确认点2)

3个简单问题定风格。品类自动检测（10品类）。视觉节奏规划。Read [`references/workflow.md`](references/workflow.md) Step C.

跳过条件："直接生成" / "大师推荐"。

### Step D: Batch Generate HTML

每张配图生成独立 HTML 文件（内联CSS + `<img>`标签背景 + 固定尺寸 + overflow:hidden）。Read [`references/workflow.md`](references/workflow.md) Step D.

**输出目录**:
```
[article-name]-illustrations/
├── 01-cover.html
├── 02-metrics.html
├── ...
├── 07-back-cover.html
└── screenshot.js          ← 一键截图脚本
```

**封面/封底必须用照片背景**（Pexels API 预下载到 assets/ 目录，HTML 引用本地路径 `<img src="assets/cover-bg.jpg">`）。

### Step E: Illustration Map

展示文章章节 ↔ 配图映射 + 使用指南。Read [`references/workflow.md`](references/workflow.md) Step E.

### Step F: Screenshot & Deliver & Sync

完整交付流程（3步自动执行）：

1. **截图**: Puppeteer-core + 系统Chrome → PNG
2. **本地保存**: PNG 保存到桌面文件夹 `~/Desktop/[文章名]公众号配图/`，用 `explorer.exe` 打开
3. **飞书云盘同步**: 用 `lark-cli drive +create-folder` 创建同名文件夹 → `lark-cli drive +upload` 逐张上传 → 返回云盘链接

Read [`references/workflow.md`](references/workflow.md) Step F.

**关键规则**：照片背景必须用 `<img>` 标签（非CSS background-image），且**必须预下载到本地 assets/ 目录**，确保 Puppeteer 100% 渲染成功。

---

## Rules

### Design Philosophy
1. **双风格系统**: Editorial Magazine（衬线+暖纸底+水墨氛围）或 Swiss International（无衬线+灰白底+单一accent）。Read [`references/design-system.md`](references/design-system.md).
2. **Content-first**: 布局服务内容结构。每个视觉元素承载信息。
3. **三大约束**: 克制(品牌色≤5%) + 呼吸(whisper shadow) + 温度(暖灰色系)。**不可协商。** Read [`references/design-system.md`](references/design-system.md).

### Typography & Style
4. **字体三级分工**: 衬线=观点 / 无衬线=信息 / 等宽=元数据。所有HTML使用CSS class体系（`.h-display`/`.h-xl`/`.body`/`.kicker`/`.meta`等）。Read [`references/design-system.md`](references/design-system.md).
5. **越大越轻**: 大字轻字重，小字重字重。封面标题60px+ weight≤300，正文标题28-36px weight 400-700。
6. **标题长度硬映射**: ≤6字→56px, 7-10字→44px, 11-16字→36px。封面/封底字号整体偏大：kicker 14-15px, meta 13-15px。正文最小16px（640px画布）。先缩短文案，再缩字号。Read [`references/design-system.md`](references/design-system.md).
7. **主题色CSS变量**: 每套主题=6个CSS变量（`--ink`/`--paper`/`--accent`/`--accent-on`/`--grey-1`/`--grey-2`），切换主题只需替换`:root`。禁止硬编码hex。Read [`references/design-system.md`](references/design-system.md).

### Quality Gates
8. **密度门控**: 单张≥9/15。8类53条反模式。Canvas Coverage≥70%。Read [`references/quality-gates.md`](references/quality-gates.md).
9. **AI Voice去污染**: 禁止AI官话、空洞强调、假精确。Read [`references/quality-gates.md`](references/quality-gates.md) Category 8.
10. **版式多样性**: 32种Recipe（E01-E14 Editorial + S01-S10 Swiss + C01-C10 Chart，v7.4 移除 E04/S08 金句图配方），禁止连续3张同recipe。品类路由表自动推荐序列。Read [`references/assets.md`](references/assets.md) + [`references/workflow.md`](references/workflow.md).

### Images & Delivery
11. **图源优先级**: 用户图片 > **Pexels API(预下载到本地)** > **Pixabay API(预下载到本地)** > Unsplash(不可靠) > Wallhaven(暗色科技) > CSS渐变(兜底)。封面/封底照片**必须**预下载到 assets/ 目录，HTML 引用本地路径。Pixabay独有插画/矢量图/分类筛选能力。Read [`references/assets.md`](references/assets.md).
12. **封面标题放置**: 4种模式（顶压底沉/侧栏立柱/角落徽章/下沉条带），根据照片主体位置选择。必须通过安静区+光线测试。Read [`references/assets.md`](references/assets.md).
13. **照片去重（三级机制）**: ①搜索词轮换（每品类8-10个词池，随机选取）②Photo ID全局黑名单（`references/used-photos.json`，跨文章去重）③API翻页（per_page=15，最多3页45张候选）。截图完成后必须将photo ID写入黑名单。Read [`references/workflow.md`](references/workflow.md).
14. **截图交付**: Puppeteer-core → PNG → 桌面文件夹 → 飞书云盘同步。Read [`references/workflow.md`](references/workflow.md) Step F.
15. **公众号尺寸规范**: 封面900×383, 正文640×auto, 分隔640×200, 封底900×383。Read [`references/workflow.md`](references/workflow.md).

---

## 必读参考文件

| 文件 | 用途 |
|------|------|
| [`references/workflow.md`](references/workflow.md) | **6步工作流**：解析→方案→风格→生成HTML→指南→截图交付+云盘同步 |
| [`references/design-system.md`](references/design-system.md) | **设计系统**：双风格+CSS变量体系+字体三级分工+标题长度硬映射+Swiss卡片类+间距token |
| [`references/quality-gates.md`](references/quality-gates.md) | **质量门控**：密度评分+53条反模式+Canvas Coverage硬规则+AI去污染 |
| [`references/assets.md`](references/assets.md) | **资源**：24种Layout Recipe+HTML骨架+封面放置模式+图库接入+图表系统 |