# Huashu Image Upload

文章配图一键生成并上传图床，自动插入Markdown链接。当用户提到"配图"、"插图"、"上传图片"、"文章配图"时使用。

- Repository: https://github.com/alchaincyf/huashu-skills (2152 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add alchaincyf/huashu-skills --skill huashu-image-upload -g -a claude-code -y`
Codex: `npx skills add alchaincyf/huashu-skills --skill huashu-image-upload -g -a codex -y`
Cursor: `npx skills add alchaincyf/huashu-skills --skill huashu-image-upload -g -a cursor -y`
Gemini CLI: `npx skills add alchaincyf/huashu-skills --skill huashu-image-upload -g -a gemini-cli -y`

## Description

文章配图一键生成并上传图床，自动插入Markdown链接。当用户提到"配图"、"插图"、"上传图片"、"文章配图"时使用。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 图片配图与上传

为公众号文章自动生成配图、上传到图床、插入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` 脚本

### 上传方式
```python
# 调用上传脚本（在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插入格式

```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`）

The rest: https://github.com/alchaincyf/huashu-skills/blob/HEAD/huashu-image-upload/SKILL.md