huashu-image-upload
文章配图一键生成并上传图床，自动插入Markdown链接。当用户提到"配图"、"插图"、"上传图片"、"文章配图"时使用。
- Installs
- 672
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/alchaincyf/huashu-skills --skill huashu-image-upload- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads huashu-image-upload automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
图片配图与上传
为公众号文章自动生成配图、上传到图床、插入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 适用项目: 公众号写作 维护者: 花生
花叔出品 | AI Native Coder · 独立开发者 公众号「花叔」| 30万+粉丝 | AI工具与效率提升 代表作：小猫补光灯（AppStore付费榜Top1）·《一本书玩转DeepSeek》
FAQ
What does the huashu-image-upload skill do?
文章配图一键生成并上传图床，自动插入Markdown链接。当用户提到"配图"、"插图"、"上传图片"、"文章配图"时使用。
How do I install huashu-image-upload?
Run npx skills add https://github.com/alchaincyf/huashu-skills --skill huashu-image-upload in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/huashu-image-upload/ (personal) or .claude/skills/huashu-image-upload/ (project).
Which AI agents can use huashu-image-upload?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is huashu-image-upload safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains huashu-image-upload?
It is published by alchaincyf in alchaincyf/huashu-skills. It has 672 recorded installs.
More from alchaincyf/huashu-skills
huashu-md-to-pdf
alchaincyf/huashu-skills
将 Markdown 文档转换为专业的 PDF 白皮书，采用苹果设计风格。 支持完整的 Markdown 语法（代码块、表格、引用、列表等）。 自动生成封面、目录、页眉页脚。 使用场景：技术文档、白皮书、教程、报告等需要专业排版的 Markdown 文档。
huashu-douyin-script
alchaincyf/huashu-skills
抖音爆款脚本创作工作流。从竞品视频拆解到脚本生成的完整流程：下载抖音视频→Gemini视频分析→爆款公式提炼→脚本+分镜生成→AI味审校。 当用户提到"抖音脚本"、"爆款拆解"、"竞品分析"、"带货脚本"、"千川素材"、"种草脚本"、"视频拆解"、"抖音视频分析"时使用此技能。
huashu-proofreading
alchaincyf/huashu-skills
三遍审校降低AI检测率，让文章更有人味。当用户提到"AI味太重"、"像AI写的"、"降低AI检测率"、"审校"、"自然一些"时使用。
huashu-slides
alchaincyf/huashu-skills
从内容到成品PPTX的端到端演示文稿制作，含AI插画生成和18种设计风格。当用户提到"做PPT"、"做幻灯片"、"演示文稿"、"Keynote"、"slides"时使用。
huashu-design
alchaincyf/huashu-skills
设计哲学顾问，从20种风格中推荐3个方向并生成视觉Demo和AI提示词。当用户提到"设计风格"、"设计方向"、"配色方案"、"视觉风格"、"设计评审"、"推荐风格"时使用。
huashu-research
alchaincyf/huashu-skills
结构化网络调研流程，确保调研成果增量保存到文件，不因会话截断丢失。当用户说"调研"、"搜索资料"、"帮我查一下"、"了解一下"、"最新信息"时使用此技能。
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image