# 蝦修修：主图链接回写说明

## 功能用途

开启“图片链接回写”后，蝦修修会在最终主图生成完成后，把最终主图上传到授权服务器图片空间。上传成功后，软件会保存公网图片链接，并导出一份可以回传蝦皮的更新表格。

处理顺序：

1. AI 生成主图
2. 自动加边框
3. 自动加水印
4. 保存最终主图
5. 上传最终主图到授权服务器
6. 授权服务器保存图片
7. 客户端保存公网图片链接
8. 导出蝦皮原表回写版更新表格

## 第六步：链接回写配置

在新手引导第 6 步和软件左侧“图片链接回写”模块中，需要重点确认下面的设置。

![链接回写配置](../assets/onboarding/step06.png)

建议设置：

- 启用最终图上传并回写链接：必须开启
- 上传服务器：默认使用当前授权服务器地址，通常不用手动修改
- 上传失败重试：建议 2 次
- 任务结束后自动导出蝦皮更新表：可按需要开启
- 导出前检查图片链接是否可访问：大批量会更慢，建议小批量抽查时开启

重点提醒：

- 如果没有勾选“启用最终图上传并回写链接”，软件仍然可以生成图片，但导出的蝦皮更新表不会自动替换为公网主图链接。
- 如果要最终通过蝦皮表格批量回传主图，必须先确认链接回写已开启。
- 大批量处理时，建议跑完当前分类表格后统一导出更新表，不要边跑边频繁导出。

## 智能提示词分流说明

蝦修修新增了智能提示词分流，用来降低文字多的商品被 AI 改字、改包装、改商品信息的风险。

当前提示词模式分为三类：

- 系统默认提示词：普通商品默认使用，适合大多数商品主图优化。
- 高风险商品提示词：标题命中高风险词库时使用，更保守，重点减少 AI 篡改商品文字和包装信息。
- 用户自定义提示词：用户开启后，普通商品走自定义提示词；但只要命中高风险，仍优先走高风险提示词。

智能分流规则：

1. 软件在请求中转站 AI 前，会先检查商品标题。
2. 标题命中高风险词库时，标记为高风险商品。
3. 高风险商品使用高风险商品提示词。
4. 未命中高风险词库时，按当前选择使用系统默认提示词或用户自定义提示词。
5. 排除词库可以避免误判，例如“收纳盒”这类词可能出现在“牙膏收纳盒”“洗衣液收纳盒”中，不一定代表商品本身是高风险。
6. 强制高风险词会优先生效，适合特别容易出问题的商品词。

注意事项：

- 智能分流只能降低风险，不能保证 AI 绝对不出错。
- 洗衣液、洗洁精、牙膏、化妆品、药膏、包装文字密集的商品，建议先小批量测试。
- 如果某类商品经常被 AI 改字，可以把相关关键词加入高风险词库。
- 如果某个词只是配件或收纳类商品，不希望触发高风险，可以加入排除词库。
- 日志会记录提示词分流结果，方便后续排查。

## 为什么不把图片密钥写进客户端

客户端软件会卖给客户，不能把服务器文件权限、云存储密钥或管理后台信息写进客户软件。否则客户可以通过反编译拿到敏感信息，导致图片空间被滥用。

当前做法：

- 客户端只保存卡密、设备码、授权服务器地址。
- 客户端上传图片前，服务器会先校验卡密和设备码。
- 校验通过后，服务器把图片保存到自己的图片目录。
- 客户端拿到服务器返回的公网图片链接。

## 导出的表格是什么

软件不会重新创建一张空模板。

它会直接读取你导入的蝦皮媒体资讯原始表格，并尽量完整保留：

- 所有栏位名称
- 栏位顺序
- 商品ID
- 未修改栏位内容
- Excel 单元格格式

软件只做一件事：

```text
根据商品ID，把“主商品图片 / 主商品圖”对应字段替换成 AI 最终主图链接。
```

输出位置：

```text
输出目录/批量更新表格/蝦修修_蝦皮原表回写_仅替换主图链接.xlsx
```

## 图片链接检查

“检查图片链接”会读取当前任务状态里的最终主图链接，并逐条检查是否能访问。

检查方式兼容常见情况：

- 先尝试 HEAD
- 如果服务器不支持 HEAD，会自动改用 GET 抽样读取
- 只要浏览器能正常打开图片，一般就会判断为可访问

## 旧任务补传

如果你之前已经生成过最终主图，但还没有开启图片链接回写，可以开启该功能后重新开始任务。软件会优先复用已有最终主图上传，不会无意义地重新调用 AI 生图。

## 回传蝦皮注意事项

- 蝦皮是否接受外部图片链接，最终以蝦皮后台表格导入规则为准。
- 建议先用 5 到 10 个商品做小批量测试，确认链接能被蝦皮后台识别后再跑大批量。
- 回传蝦皮的表格必须是当前分类的最新商品表格，不要用旧表格。
- 不建议跨分类回传。
- 如果蝦皮提示文件过大，请按分类或分批导出上传。
