alchaincyf/huashu-image-upload

图片配图与上传

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

何时使用此Skill

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

• 用户说"现在配图"、"帮我配图"、"添加图片"
• 文章审校完成后提到配图需求
• 检测到文章内容完整但缺少图片

核心功能

1. 分析配图需求：根据文章内容确定需要5-8张配图
2. 获取图片源：
   • 公共领域作品（Wikimedia Commons、Google Arts & Culture）
   • AI生成图片（火山引擎 doubao-seedream API）
   • 免费图库（Unsplash、Pexels）
3. 自动上传图床：调用ImgBB图床，获取永久链接
4. 插入Markdown：将图片链接插入文章对应位置
5. 验证显示：确保所有图片链接有效

配图数量规范

• 推荐：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: 获取/生成图片

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

1. 公共领域作品 → WebFetch获取
2. AI生成 → 调用API生成
3. 免费图库 → WebFetch搜索
4. 截图素材 → 提醒用户提供

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》