huashu-image-upload

SKILL.md

图片配图与上传

为公众号文章自动生成配图、上传到图床、插入Markdown链接的专业能力。

何时使用此Skill

当检测到以下场景时，自动加载此skill：

用户说"现在配图"、"帮我配图"、"添加图片"

文章审校完成后提到配图需求

检测到文章内容完整但缺少图片

核心功能

分析配图需求：根据文章内容确定需要5-8张配图

获取图片源：

公共领域作品（Wikimedia Commons、Google Arts & Culture）

AI生成图片（火山引擎 doubao-seedream API）

免费图库（Unsplash、Pexels）

自动上传图床：调用ImgBB图床，获取永久链接

插入Markdown：将图片链接插入文章对应位置

验证显示：确保所有图片链接有效

配图数量规范

推荐：5-8张

最少：3张（题图 + 2张正文图）

最多：不超过10张（避免过度打断阅读）

配图位置策略

必配图位置：

✅ 题图（封面图）：标题下方，必须

✅ 核心章节：每个重点章节配1张

可选配图位置：

理论支撑（如引用经典著作）

数据可视化（对比图、图表）

案例补充（产品截图、示例）

图片来源优先级

1️⃣ 公共领域作品（最优先）

来源：Wikimedia Commons、Google Arts & Culture

适用：经典艺术作品、历史人物肖像、古籍封面

优点：免费、无版权问题、高质量

示例：梵高《星空》、康德肖像

操作：WebFetch获取Wikimedia Commons图片链接

2️⃣ AI生成（推荐）

来源：火山引擎 doubao-seedream-4-0-250828

适用：题图、概念图、抽象主题

优点：原创、可定制、快速

操作：调用API生成图片，返回临时URL

3️⃣ 免费图库

来源：Unsplash、Pexels、Pixabay

适用：题图、概念图、背景图

优点：免费、高质量、商业可用（CC0）

操作：WebFetch搜索 + 下载

4️⃣ 截图/官方素材（需注明来源）

来源：YouTube、B站、产品官网、电影海报

适用：案例图（产品截图、视频截图）

注意：注明来源，合理使用原则

操作：提醒用户自行截图，或生成AI概念图替代

图床上传流程

核心脚本

使用项目已有的 /tools/upload_image.py 脚本

上传方式

# 调用上传脚本（在Bash中）
python3 /Users/alchain/Documents/写作/tools/upload_image.py <图片URL或本地路径>

# 处理网络图片（如AI生成的临时链接）
python3 /Users/alchain/Documents/写作/tools/upload_image.py "https://example.com/ai-generated.jpg"

# 处理本地图片
python3 /Users/alchain/Documents/写作/tools/upload_image.py "/Users/alchain/Pictures/image.png"

# 脚本自动返回ImgBB永久链接

容错机制

✅ 优先上传到ImgBB图床（永久有效）

⚠️ 上传失败时，自动使用原链接作为fallback

📌 详见 /tools/README.md - 图片上传脚本说明

Markdown插入格式

![图片描述](https://i.ibb.co/xxxxx/image.jpg)

使用永久网络链接（不是本地路径）

填写有意义的图片描述（alt text）

图片描述要简洁，突出图片内容

图片规范

尺寸规范

封面图：1200x600px (16:9)

正文图：800-1200px宽

人物/产品：800x800px (1:1)

文件规范

格式：JPG（照片）/ PNG（插画）

大小：< 500KB

命名：小写、语义化、英文（如 mrbeast.jpg, starry-night.jpg）

路径规范

✅ 网络链接：https://i.ibb.co/xxxxx/image.jpg（推荐，永久有效）

❌ 本地路径：不再使用本地路径（复制到公众号会失效）

版权注意事项

✅ 公共领域作品（作者去世70年以上）

✅ CC0许可的图片（Unsplash等）

✅ AI生成的图片（确认工具许可）

⚠️ 截图/官方素材需注明来源

配图检查清单

执行配图任务前，确认以下事项：

 文章已审校完成，内容稳定

 确定配图数量（5-8张）

 确定配图位置（题图+核心章节）

 所有图片已获取（AI生成/公共领域/免费图库）

 所有图片已上传到ImgBB图床

 图片链接为永久网络链接（https:// 开头）

 已在Markdown中插入图片（使用网络链接）

 图片描述（alt text）已填写

 所有图片链接验证通过（可正常访问）

执行步骤（5步标准流程）

Step 1: 分析文章，确定配图需求

通读全文，标记重点章节

列出配图需求清单（6-8项）

确定每张图的位置和作用

Step 2: 获取/生成图片

根据图片来源优先级获取图片：

公共领域作品 → WebFetch获取

AI生成 → 调用API生成

免费图库 → WebFetch搜索

截图素材 → 提醒用户提供

Step 3: 上传到图床，获取永久链接

# 对每张图片调用上传脚本
python3 /Users/alchain/Documents/写作/tools/upload_image.py <图片URL>

Step 4: 在文章中插入图片

![图片描述](https://i.ibb.co/xxxxx/image.jpg)

Step 5: 验证显示

# 检查所有图片引用
grep -n "!\[" "文章路径.md"
# 所有图片链接应该是 https:// 开头的网络链接

参考资源

/tools/README.md - 图片上传脚本使用说明

/tools/upload_image.py - 图片上传脚本

/公众号写作/AI文生图API调用.md - AI文生图API说明

/公众号写作/images/useless-content/配图Best Practice总结.md - 配图最佳实践

常见问题

Q1: AI生成的图片临时链接会失效吗？

A: 会。所以必须调用upload_image.py上传到ImgBB，获取永久链接。

Q2: 如果图床上传失败怎么办？

A: 脚本有容错机制，会自动fallback到原URL。但建议检查ImgBB API配置。

Q3: 每篇文章必须配图吗？

A: 推荐配图，特别是长文（3000字以上）。但短文（1000字以下）可以只配题图。

Q4: 可以使用本地图片路径吗？

A: 不推荐。本地路径在复制到公众号编辑器后会失效，必须使用网络链接。

技术依赖

Python脚本: /tools/upload_image.py（已有）

API配置: ImgBB API key（已配置在 ~/.zshrc）

AI生成API: 火山引擎 doubao-seedream（可选）

工具: WebFetch（获取公共领域图片）

成功案例

《为什么最好的内容都是无用的》：6张配图（2张公共领域 + 4张AI生成）

《DeepSeek-OCR深度评测》：5张配图，全部上传到ImgBB，复制到公众号无压力

最后更新: 2025-11-07
适用项目: 公众号写作
维护者: 花生

花叔出品 | AI Native Coder · 独立开发者
公众号「花叔」| 30万+粉丝 | AI工具与效率提升
代表作：小猫补光灯（AppStore付费榜Top1）·《一本书玩转DeepSeek》