39 lines
1.8 KiB
Markdown
39 lines
1.8 KiB
Markdown
---
|
||
id: T-588
|
||
title: AI工场远程缩略图与蝦皮原图进入照片池
|
||
phase: 7
|
||
deps: [T-587, T-546]
|
||
status: TODO
|
||
created: 2026-07-11
|
||
---
|
||
|
||
## 问题 / 背景
|
||
|
||
拉取商品后要低成本浏览远程主图：缩略图只进内存，用户单击才下载原图落照片池。网络请求不能卡 GUI，失败不能阻断其他缩略图，也不能因为显示缩略图就把全部原图写盘。
|
||
|
||
## 方案
|
||
|
||
- 实现异步缩略图 loader（QNetworkAccessManager 或受控线程池+signal），含内存缓存、并发上限、取消、单图重试和占位状态。
|
||
- 实探并记录 Shopee CDN 缩略图尺寸后缀、Referer、Content-Type 和重定向事实；不可用时安全回退原 URL 的受限读取。
|
||
- 复用现有无系统代理、安全超时、大小上限和图片解码校验；只允许 http/https、公网地址。
|
||
- 单击蝦皮原图时下载原图到 `originals/`，先写临时文件并校验解码，再原子替换目标并创建原图 asset；重复单击幂等。
|
||
- 明确不增加“导入本地图片”入口；照片池来源仅蝦皮原图和后续 AI 生成图。
|
||
|
||
## 验收要点
|
||
|
||
- 缩略图加载不在 GUI 主线程，不落盘；单图失败/超时显示中文状态且其他图继续。
|
||
- 缓存命中不重复请求；切项目或关闭窗口可取消未完成加载。
|
||
- 单击后原图真实落盘、asset 可用；失败不留下半文件或可用 asset。
|
||
- 非图片、超限、内网 URL、坏图片和重定向边界有测试。
|
||
- CDN 两项事实有真实探查记录，测试不依赖公网。
|
||
|
||
## 边界（不改什么）
|
||
|
||
- 不做 AI 生成、终选、导出或蝦皮写操作。
|
||
- 不自动下载全部原图，不加入本地图片导入。
|
||
- 不在日志记录 Cookie、带敏感查询串的完整 URL 或图片字节。
|
||
|
||
## 执行记录
|
||
|
||
（完成后记录 CDN 实探、缓存和下载验证。）
|