| name | huashu-image-upload |
| description | 文章配图一键生成并上传图床，自动插入Markdown链接。当用户提到"配图"、"插图"、"上传图片"、"文章配图"时使用。 |
图片配图与上传
为公众号文章自动生成配图、上传到图床、插入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 脚本
上传方式
python3 /Users/alchain/Documents/写作/tools/upload_image.py <图片URL或本地路径>
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图床（永久有效）
- ⚠️ 上传失败时，自动使用原链接作为fallback
- 📌 详见
/tools/README.md - 图片上传脚本说明
Markdown插入格式
- 使用永久网络链接（不是本地路径）
- 填写有意义的图片描述（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步标准流程）
Step 1: 分析文章，确定配图需求
- 通读全文，标记重点章节
- 列出配图需求清单（6-8项）
- 确定每张图的位置和作用
Step 2: 获取/生成图片
根据图片来源优先级获取图片：
- 公共领域作品 → WebFetch获取
- AI生成 → 调用API生成
- 免费图库 → WebFetch搜索
- 截图素材 → 提醒用户提供
Step 3: 上传到图床，获取永久链接
python3 /Users/alchain/Documents/写作/tools/upload_image.py <图片URL>
Step 4: 在文章中插入图片
Step 5: 验证显示
grep -n "!\[" "文章路径.md"
参考资源
/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》
