huashu-image-upload

用途

为公众号文章自动完成配图、上传图床与插入 Markdown 链接。当用户提到“配图”“插图”“上传图片”“文章配图”，或文章审校完成、内容完整但缺少图片时，会自动加载此能力。

主要能力

• 分析配图需求：根据文章内容确定需要 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，适用经典艺术作品、历史人物肖像、古籍封面，免费、无版权问题、高质量。
2. AI 生成（推荐）：来源为火山引擎 doubao-seedream-4-0-250828，适用题图、概念图、抽象主题，原创、可定制、快速。
3. 免费图库：来源为 Unsplash、Pexels、Pixabay，适用题图、概念图、背景图，免费、高质量、商业可用（CC0）。
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。

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

1. 分析文章，确定配图需求：通读全文，标记重点章节，列出配图需求清单（6-8 项），确定每张图的位置和作用。
2. 获取/生成图片：按优先级获取，公共领域作品用 WebFetch，AI 生成调用 API，免费图库用 WebFetch 搜索，截图素材提醒用户提供。
3. 上传到图床，获取永久链接：对每张图片调用上传脚本 python3 /Users/alchain/Documents/写作/tools/upload_image.py <图片URL>。
4. 在文章中插入图片：![图片描述](https://i.ibb.co/xxxxx/image.jpg)。
5. 验证显示：grep -n "!\[" "文章路径.md"，所有图片链接应为 https:// 开头的网络链接。

图片规范

• 尺寸：封面图 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 张）；确定配图位置（题图+核心章节）；所有图片已获取；所有图片已上传 ImgBB 图床；图片链接为永久网络链接（https:// 开头）；已在 Markdown 中插入图片（使用网络链接）；图片描述（alt text）已填写；所有图片链接验证通过。

技术依赖

• Python 脚本：/tools/upload_image.py（已有）。
• API 配置：ImgBB API key（已配置在 ~/.zshrc）。
• AI 生成 API：火山引擎 doubao-seedream（可选）。
• 工具：WebFetch（获取公共领域图片）。

适用场景与限制

适用项目为公众号写作。成功案例：《为什么最好的内容都是无用的》6 张配图（2 张公共领域 + 4 张 AI 生成）；《DeepSeek-OCR 深度评测》5 张配图，全部上传 ImgBB，复制到公众号无压力。

常见问题：AI 生成图片的临时链接会失效，必须上传 ImgBB 获取永久链接；图床上传失败时脚本会 fallback 到原 URL，但建议检查 ImgBB API 配置；推荐配图，特别是 3000 字以上长文，1000 字以下短文可只配题图；不建议使用本地图片路径，复制到公众号编辑器后会失效。

其他维护信息：最后更新 2025-11-07；维护者为花生。