content-illustration-strategy

# 文章配图决策

这不是“随便找几张图填空”的 skill。
这是把**文章可信度、信息密度、点击感**，映射成正确图片来源的决策流程。

## 核心原则

**配图不是固定配额，而是为“证明这篇文章在说什么”服务。**

判断顺序永远是：
1. 这篇文章靠什么建立可信度？
2. 什么图片最能证明这件事？
3. 哪种图片会稀释主轴？

## 快速工作流

```
输入：文章标题 + 核心观点 + 平台 + 可用素材
  ↓
Step 1: 判断文章的证据类型
  ↓
Step 2: 选择图片来源（截图 / 官网图 / 生成图 / 流程图）
  ↓
Step 3: 决定图片数量与插入位置
  ↓
Step 4: 判断是否需要 Telegram 真实对话证据图
  ↓
Step 5: 输出可执行配图方案
```

## Step 1：先判断文章的证据类型

把文章先归到下面四类之一（必要时可混合，但要分主次）：

### A. 真实工作流证据型
适用：
- OpenClaw 技巧
- Agent 协作
- 自动化工作流
- “我真的这样跑起来了”的实战文

这类文章的可信度来自：**真实过程与真实结果**。

优先图片：
- Telegram 对话截图
- 后台执行截图
- 工作流节点截图
- 发布前后对比截图

### B. 产品实测 / 工具横评型
适用：
- AI 工具评测
- 软件横评
- 功能对比
- 使用体验总结

这类文章的可信度来自：**产品本身 + 实测判断**。

优先图片：
- 工具界面截图
- 官网/产品页图
- 功能对比图
- 自制评分/定位图

### C. 观点分析 / 趋势判断型
适用：
- 行业趋势
- 方法论
- 批判文
- 认知升级文

这类文章的可信度来自：**逻辑结构与观点表达**。

优先图片：
- 自生成概念插图
- 流程图 / 对比图 / 结构图
- 关键结论卡片图

### D. 混合证据型
适用：
- 一边讲工具，一边讲真实使用方式
- 一边讲平台技巧，一边展示自己实操案例

这类文章必须先定主轴：
- 主轴是工具 → 工具图为主，证据截图为辅
- 主轴是工作流 → 证据截图为主，工具图为辅

## Step 2：选择图片来源

按证据类型选来源，不要倒过来。

### 图片来源优先级

| 证据需求 | 首选图片来源 | 说明 |
|---|---|---|
| 证明“真的发生过” | Telegram / 后台真实截图 | 最强真实性 |
| 证明“真的测过产品” | 工具界面图 / 官网图 / 产品截图 | 最强相关性 |
| 解释“概念或结构” | 自生成示意图 / 流程图 | 最强表达力 |
| 增强阅读节奏 | 结论卡 / 对比卡 / 小结图 | 最强结构感 |

### 反向约束

不要这样配：
- 工具测评文，全塞聊天截图
- 工作流实战文，只放抽象插画
- 方法论文，硬塞无关官网图
- 为了“看起来丰富”塞没有证据价值的图

## Step 3：什么时候该用 Telegram 真实对话截图

只有当截图本身能增强“证据链”时才用。

### 应该用 Telegram 图的情况
- 文章在讲你和 agent 的真实协作过程
- 文章在讲 OpenClaw / 自动化 / 工作流技巧
- 文章需要证明“这不是纸上谈兵，而是实际在跑”
- 对话本身就是案例的一部分

### 不必强行用 Telegram 图的情况
- 纯产品横评
- 纯行业分析
- 纯概念解释
- 聊天截图不能提供额外信息，只会打断阅读

## Step 4：Telegram 截图脱敏规则

默认不要原样暴露私人信息。

### 三档处理
- **A 完整保留**：仅适合用户明确要求
- **B 半脱敏**：保留关键对话，弱化头像/时间/名称
- **C 强脱敏（默认推荐）**：只保留对话气泡内容，不保留账号身份特征

### 强脱敏原则
- 保留：能证明案例成立的关键对话内容
- 弱化/移除：头像、昵称、账号、精确时间、无关上下文
- 截图只截有价值的区域，不做聊天记录全屏搬运

## Step 5：图片数量与插入位置

不要先定“这篇必须 5 张图”。
先看文章结构。

### 默认规则
- 1000-2000 字：2-4 张图
- 2000-3500 字：3-6 张图
- 3500+ 字：按章节分布，但仍然宁少勿滥

### 插图位置
优先插在：
1. 开头 20% —— 建立主题感
2. 第一段结论后 —— 给读者证据
3. 章节切换处 —— 打断疲劳
4. 复杂判断后 —— 给可视化支撑

避免：
- 连续堆两三张相似图
- 图文无关
- 文章尾部才突然塞图

## Step 6：输出格式

输出时直接给可执行方案，不要只说“可以配一些图”。

```markdown
🧩 文章类型：[真实工作流 / 工具横评 / 观点分析 / 混合]
🎯 主证据类型：[真实截图 / 工具界面 / 概念图 / 混合]
🖼️ 配图方案：
1. [图类型] - [用途] - [建议位置]
2. [图类型] - [用途] - [建议位置]
3. ...
🔐 脱敏策略：[A/B/C]
⚠️ 不要加入的图：[列出应避免的图]
```

## 当前最实用的判断模板

### 模板 1：OpenClaw / Agent 技巧文
- 主图：Telegram 对话证据图 / 后台执行图
- 辅图：流程图 / 节点图
- 不要：无关产品官图

### 模板 2：AI 工具横评文
- 主图：工具界面图 / 官网图 / 对比图
- 辅图：少量真实案例截图
- 不要：大量聊天截图抢主轴

### 模板 3：观点 / 方法论文
- 主图：概念插图 / 信息结构图 / 结论卡
- 辅图：必要时加 1 张真实案例图
- 不要：为了真实感乱塞截图

## 真实素材截图采集标准

当需要从网页/社交媒体截取真实素材图时，必须遵循以下标准：

### 截图原则

1. **正文居中裁剪** — 截图必须聚焦正文内容区域，裁掉侧边栏、导航栏、广告、空白
2. **单张高度 ≤ 1600px** — 公众号单张图不宜过长，超长内容分段截取
3. **宽度统一 900px** — 公众号标准阅读宽度
4. **JPEG 质量 85-90** — 平衡清晰度和文件大小
5. **内容可读** — 截图中的文字必须清晰可辨认

### Playwright 精确定位裁剪流程

```
Step 1: 打开目标页面，viewport 设为 900x900
Step 2: 用 page.locator('text=关键词') 定位目标段落
Step 3: 获取 bounding_box() 得到精确坐标
Step 4: window.scrollTo(0, target_y - padding) 滚动到目标位置
Step 5: page.screenshot(full_page=False) 截取当前视口
Step 6: 如需更精确裁剪，用 PIL 从截图中二次裁剪
```

### 关键技术细节

- **长页面定位**：先用 `locator('text=xxx').count()` 确认文本存在，再用 `bounding_box()` 获取页面绝对坐标
- **滚动截图**：`window.scrollTo(0, y)` 后等 1 秒再截图，确保内容渲染完成
- **clip 截图**：`page.screenshot(clip={'x':0,'y':top,'width':900,'height':h})` 只能在当前视口范围内使用，超出视口的坐标会报错。必须先 scrollTo 再 full_page=False 截取
- **社交媒体镜像**：X/Twitter 用 xcancel.com 镜像，可能部分推文无法渲染，需要检查内容是否为空

### GZH 配图裁剪模板

| 来源类型 | 裁剪方式 | 要点 |
|---------|---------|------|
| 推文/社交媒体 | 定位正文 → 滚动 → 截视口 | 去掉侧栏头像区，只保留文字内容 |
| 新闻文章标题 | 定位 h1 → 截标题+导语区 | 去掉顶部导航栏 |
| 新闻文章正文段落 | 定位关键词 → 滚动到该位置 → 截视口 | 确保目标段落完整可见 |
| 代码/命令截图 | 定位 code/pre 元素 → 精确裁剪 | 加适当 padding，背景对比度要好 |

### 输出命名规范

```
v{版本}-{序号}-{描述}.jpg
例: v3-01-crane-tweet-hook.jpg
    v3-02-ai-confession.jpg
```

## 这类 skill 应该怎么配合其它 skill

- 如果任务是**封面生成**：先用 `content-cover-gen`
- 如果任务是**封面标题版式**：先用 `content-typography`
- 如果任务是**正文中间该插什么图、图从哪里来**：优先用本 skill

需要具体例子时，再读：
- `/home/aa/clawd/skills/content-illustration-strategy/references/article-image-playbooks.md`
- `/home/aa/clawd/skills/content-illustration-strategy/references/telegram-evidence-rules.md`