快速开始
本指南将帮助您在5分钟内开始使用美团店铺数据处理工具。
🚀 第一次使用
1. 启动应用
选择以下任一方式启动应用：
bash
# 双击运行
run.bat1
2
2
bash
# 启动Fluent Design界面
python gui_fluent.py1
2
2
bash
# 双击运行
美团店铺数据处理工具.exe1
2
2
2. 界面概览
启动后您将看到现代化的Fluent Design界面：
┌─────────────────────────────────────────────────────────┐
│ 🍲 美团店铺数据处理工具 │
├─────────────────────────────────────────────────────────┤
│ 📊 状态仪表板 │ ℹ️ 应用信息卡片 │
│ [已处理商品: 0] [已下载图片: 0] [成功率: 0%] │
├─────────────────────────────────────────────────────────┤
│ 📁 文件处理区域 │
│ [选择文件] [Excel输出路径] [图片保存目录] │
│ ☑️ 转换图片格式为JPG ☑️ 启用文件监控 │
├─────────────────────────────────────────────────────────┤
│ 🎮 控制按钮区域 │
│ [开始处理] [停止处理] [🌙 主题切换] [打开输出目录] │
├─────────────────────────────────────────────────────────┤
│ 📋 日志显示区域 │
│ 实时显示处理进度、状态信息和错误日志 │
└─────────────────────────────────────────────────────────┘1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
📝 基本使用流程
步骤1: 准备数据文件
确保您有美团商品数据的JSON文件，通常命名为 malatang.txt。
数据格式示例:
json
{
"data": {
"spuListVos": [
{
"name": "麻辣鸡锁骨(小份)",
"price": 1200,
"discountPrice": 1000,
"monthSale": 156,
"wmProductPicVos": [
{
"picUrl": "https://example.com/image1.jpg",
"picLargeUrl": "https://example.com/image1_large.jpg"
}
]
}
]
}
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
步骤2: 选择数据文件
- 点击 "选择文件" 按钮
- 在文件对话框中选择您的JSON数据文件
- 确认文件路径显示正确
文件格式
支持 .txt、.json 格式的美团商品数据文件
步骤3: 配置输出选项
Excel输出路径:
- 默认:
malatang_products.xlsx - 可自定义文件名和路径
- 支持追加模式，不会覆盖现有数据
图片保存目录:
- 默认:
images/ - 建议使用相对路径
- 程序会自动创建目录
处理选项:
- ✅ 转换图片格式为JPG: 将WebP等格式转换为JPG
- ✅ 启用文件监控: 自动监控文件变化并重新处理
步骤4: 开始处理
- 点击 "开始处理" 按钮
- 观察日志区域的实时输出
- 等待处理完成
处理过程:
🚀 开始处理数据...
📂 读取文件: malatang.txt
🔍 开始解析JSON文件...
📦 提取商品信息...
✅ 成功提取 8 个商品信息
📊 检查现有Excel数据...
💾 保存数据到Excel...
📁 创建图片目录...
🖼️ 开始下载图片...
🖼️ 下载图片 (1/8): 麻辣鸡锁骨(小份).jpg
✅ 处理完成!1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
步骤5: 查看结果
处理完成后，您将获得：
Excel文件 (malatang_products.xlsx):
| 商品名称 | 原价 | 折扣价 | 月售数量 | 图片链接 | 图片文件名 | 更新时间 |
|---|---|---|---|---|---|---|
| 麻辣鸡锁骨(小份) | 12.00 | 10.00 | 156 | https://... | 麻辣鸡锁骨(小份).jpg | 2024-01-01 12:00:00 |
图片文件夹 (images/):
images/
├── 麻辣鸡锁骨(小份).jpg
├── 炸鸡翅根(2个).jpg
├── 炸平菇5两.jpg
└── ...1
2
3
4
5
2
3
4
5
日志文件 (malatang_processor.log):
2024-01-01 12:00:00 - INFO - 开始处理麻辣烫数据...
2024-01-01 12:00:01 - INFO - 成功提取 8 个商品信息
2024-01-01 12:00:02 - INFO - 数据处理完成1
2
3
2
3
🔄 文件监控模式
启用自动监控
- 确保勾选 "启用文件监控" 选项
- 点击 "开始处理" 按钮
- 文件监控将自动启用
监控状态指示:
📁 文件监控已启用: malatang.txt
🔄 文件监控已启动，等待文件变化...
💡 提示: 修改文件后保存即可自动触发处理1
2
3
2
3
自动重新处理
当监控的文件发生变化时：
- 系统检测到文件修改
- 延迟2秒等待文件写入完成
- 自动启动新的处理流程
- 增量更新Excel和图片
🔄 文件已变化，开始自动处理...
📦 发现 3 个新商品需要处理
🖼️ 下载了 3 张新图片
✅ 自动处理完成!1
2
3
4
2
3
4
🎨 界面功能
状态仪表板
实时显示处理统计信息：
- 已处理商品: 当前会话处理的商品总数
- 已下载图片: 成功下载的图片数量
- 成功率: 图片下载成功率百分比
主题切换
点击 🌙 主题切换 按钮在深色/浅色主题间切换：
- 浅色主题: 适合白天使用，清晰明亮
- 深色主题: 适合夜间使用，护眼舒适
快捷操作
- 打开输出目录: 快速打开Excel和图片输出目录
- 停止处理: 中断当前处理任务
- 清空日志: 清除日志显示区域内容
📊 处理结果示例
成功案例
输入数据: 包含8个商品的JSON文件 处理结果:
📊 处理统计:
- 商品总数: 8 个
- 图片下载: 8 张 (100% 成功)
- Excel记录: 8 条
- 处理时间: < 2 秒
- 文件大小: 图片总计约6.2MB1
2
3
4
5
6
2
3
4
5
6
生成文件:
- ✅
malatang_products.xlsx- 完整商品信息表格 - ✅
images/- 8张JPG格式商品图片 - ✅
malatang_processor.log- 详细处理日志
文件命名规则
图片文件名与商品名称完全一致，只替换Windows不支持的字符：
<→＜(全角小于号)>→＞(全角大于号):→：(全角冒号)"→"(全角引号)/→／(全角斜杠)\→＼(全角反斜杠)|→｜(全角竖线)?→？(全角问号)*→＊(全角星号)
保留所有emoji表情和特殊符号，统一使用 .jpg 扩展名。
⚡ 性能提示
优化建议
- 使用SSD硬盘: 提高文件读写速度
- 稳定网络连接: 确保图片下载顺畅
- 充足内存: 处理大量商品时需要更多内存
- 关闭不必要程序: 释放系统资源
批量处理
对于大量商品数据：
- 建议分批处理，每批不超过100个商品
- 使用文件监控模式进行增量更新
- 定期清理临时文件和日志
🆘 遇到问题？
如果在使用过程中遇到问题：
重要提示
- 请确保有足够的磁盘空间存储图片
- 建议定期备份重要的Excel数据
- 首次使用建议先用小量数据测试