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：输出格式

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

🧩 文章类型：[真实工作流 / 工具横评 / 观点分析 / 混合]
🎯 主证据类型：[真实截图 / 工具界面 / 概念图 / 混合]
🖼️ 配图方案：
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