image-illustration-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插入格式

- 使用永久网络链接(不是本地路径)
- 填写有意义的图片描述(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: 在文章中插入图片

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 适用项目: 公众号写作 维护者: 花生
Weekly Installs
9
Repository
alchaincyf/huashu-skillsFirst Seen
Jan 24, 2026
Security Audits
Installed on
claude-code7
gemini-cli6
antigravity6
windsurf6
opencode6
codex6