# 订单班图片整理工具使用说明

## 📋 功能说明

本工具用于批量整理订单班文档中的图片资源，包括：
- 统一图片格式为 `.jpg`
- 规范化图片命名
- 修复Markdown文件中的图片引用路径
- 创建图片索引文件

## 🚀 快速使用

### 方法一：使用Python主程序（推荐）

```bash
cd /Users/xiaoqi/Documents/Dev/Project/2025-09-08_n8nDEMO演示
python3 scripts/organize_images_main.py
```

然后选择：
- 选项1：完整执行（处理所有订单班）
- 选项2：仅验证（检查不修改）
- 选项3：仅修复路径
- 选项4：退出

### 方法二：使用Shell脚本

```bash
cd /Users/xiaoqi/Documents/Dev/Project/2025-09-08_n8nDEMO演示
./scripts/run_image_organize.sh
```

### 方法三：分步执行

如果需要更细粒度的控制，可以分别执行各个脚本：

```bash
# 1. 处理所有订单班图片
python3 scripts/fix_all_orders_images.py

# 2. 修复Markdown路径
python3 scripts/fix_all_markdown_paths.py

# 3. 修复特殊问题
python3 scripts/complete_fix_paths.py

# 4. 验证结果
python3 scripts/final_validation.py
```

## 📁 文件结构

处理后的文件结构：
```
data/订单班文档资料/
├── 文旅/
│   └── notion文稿/
│       ├── image/
│       │   ├── 设计图_01.jpg
│       │   ├── 场景图_01.jpg
│       │   └── ...
│       ├── *.md (Markdown文档)
│       └── 图片索引.md
├── 财经商贸/
│   └── ...
└── ...
```

## 🔧 脚本说明

| 脚本名称 | 功能说明 |
|---------|---------|
| organize_images_main.py | 主程序，提供交互式界面 |
| fix_all_orders_images.py | 批量处理所有订单班图片 |
| fix_all_markdown_paths.py | 修复Markdown中的路径问题 |
| complete_fix_paths.py | 修复特殊的URL编码问题 |
| final_validation.py | 验证所有图片路径是否正确 |
| safe_analyze_images.py | 分析图片情况（只读不改） |

## 📝 命名规则

图片重命名规则：
- Whisk_* → `设计图_XX.jpg`
- 中文场景名 → `场景图_XX.jpg`
- 展示相关 → `展示图_XX.jpg`
- 效果相关 → `效果图_XX.jpg`
- 流程相关 → `流程图_XX.jpg`
- 其他 → `图片_XX.jpg`

## ⚠️ 注意事项

1. **执行前建议备份**：程序会询问是否备份，建议选择"是"
2. **备份位置**：`/backups/backup_日期时间/`
3. **验证结果**：执行后会自动验证，确保所有路径正确

## 🔍 故障排除

### 问题1：某些图片找不到
检查图片文件名是否有特殊字符或URL编码，运行修复脚本：
```bash
python3 scripts/complete_fix_paths.py
```

### 问题2：图片编号错误（如图片_010.jpg应为图片_10.jpg）
这类问题会在执行主程序时自动修复

### 问题3：需要恢复到原始状态
如果创建了备份，可以从备份目录恢复：
```bash
cp -r backups/backup_日期时间/* data/订单班文档资料/
```

## 📊 当前状态

截至最后一次运行：
- ✅ 12个订单班
- ✅ 124张图片
- ✅ 所有路径验证通过
- ✅ 无URL编码问题

## 🆘 需要帮助？

如遇到问题，可以：
1. 先运行验证模式查看问题
2. 查看具体的错误信息
3. 检查 scripts 目录下是否有所有必要的脚本文件