蝦修修 - 快速启动

一、打开软件

双击：
dist\蝦修修\蝦修修.exe

也可以从顶部菜单进入常用功能：

- 文件：选择资料表、选择输出目录、打开输出文件夹、打开处理日志
- 工具：GPT正式前检查、检查中转站配置、检查DeepSeek配置、打开预检摘要
- 帮助：快速启动、使用说明书、关于软件

二、第一次建议流程

1. 选择蝦皮后台导出的 Excel / CSV。
2. 选择输出目录，建议使用桌面或软件默认输出目录。
3. 确认字段识别：
   - 商品ID
   - 商品名称
   - 主商品图片
   - 商品图片1
4. 点击“本地预检（不调用GPT）”。
5. 看预检报告和样本拼图。
6. 任务完成后点击“导出蝦皮更新表”，软件会直接读取原始蝦皮表格并只替换主图链接。
7. 如需确认图片链接，点击“检查图片链接”；若浏览器可打开，蝦皮表格也会使用同一条链接。
7. 第一次正式测试建议只跑 1 条。

三、使用 OpenAI Images

1. 图片生成路由选择“OpenAI Images（当前可用）”。
2. 填写 OpenAI Key，或设置环境变量 OPENAI_API_KEY。
3. 点击“GPT正式前检查”。
4. 检查通过后点击“开始处理”。

四、使用中转站 API

1. 图片生成路由选择“中转站 API（OpenAI兼容）”。
2. 软件会自动勾选“启用中转站 API”。
3. 填写：
   - 中转站 Key
   - 中转站 URL，例如 https://api.example.com/v1
   - 中转站模型，默认 gpt-image-2；如果报 model_not_found，请改成中转站后台显示的模型名
4. 点击“检查中转站配置”。
5. 点击“GPT正式前检查”。
6. 检查通过后点击“开始处理”。

中转站回图支持 base64 和 URL 两种方式。

也可以使用环境变量：
OPENAI_RELAY_API_KEY
RELAY_API_KEY

五、DeepSeek

DeepSeek 当前只预留文字模型接口。
DeepSeek Images 当前不能生成主图，选择后正式处理会被阻止。

六、重要安全边界

软件不会：
- 登录蝦皮后台
- 打开 seller.shopee.tw
- 接管浏览器
- 模拟点击
- 自动上传图片

最终图片需要你自己手动上传到蝦皮。

七、输出位置

默认输出目录结构：

蝦修修优化结果
├─ 已完成
├─ 已优化跳过
├─ 待人工确认
├─ 失败任务
└─ 日志

处理日志在：
日志\处理日志.xlsx

八、遇到问题先看

1. 软件内点击“使用说明书”。
2. 查看 docs\软件使用说明书.html。
3. 查看 docs\交付测试报告.md，确认当前交付包已验证内容。
4. 检查“日志\处理日志.xlsx”的失败原因。
5. 小批量先跑 1 条，再跑 5 条，不要一开始全量跑。

九、单个商品重跑

1. 在“开始处理”区域输入商品ID。
2. 点击“查看状态”先确认该商品当前状态和失败原因。
3. 点击“打开文件夹”可以查看已经生成过的文件。
4. 如果只是检查边框和水印，点击“单品本地测试”，不会调用 API。
5. 如果要正式重新生成，点击“单品重跑”。旧文件不会删除，新文件会自动加编号。
