# 选品链接审计 2026-10-06

**范围**：/sourcing 模块 11 个 tab（选品情报台/数据探索/AI选品/畅销榜/促销流/产品查找/类目树/价格历史/卖家/监控池/选品决策台）全部链接。
**链接类型**：A=站内深链→价格历史 viewer（代码全量枚举 9 处）；B=外链图片 CDN（Keepa 缩略图）；C=Keepa 官方原图代理（同源 /api/sourcing/keepa-graph）；导航入口 AppShell → /sourcing。
**方法**：源码 grep 全量枚举 `<a>`/setQs 跳转 → API 实机测试（zipforce 租户）→ Playwright 浏览器点击级验证 + 截图存档 `screenshots/sourcing-links-audit-20261006/`（01 watch→viewer / 02 URL种子直开 / 03+03b viewer AE 死选项 / 04 seller AE 死选项）。工具：`tools/audit_sourcing_links.py` + `_b.py`。

## 通过项（9）

| # | 项 | 证据 |
|---|---|---|
| P1 | watch 表 ASIN 链接 → viewer 正确落地（tab 激活+国家+ASIN 种子） | 截图 01，URL `?mtab=viewer&vasin=B09P1G2952` |
| P2 | viewer URL 种子直开（分享/刷新可还原） | 截图 02 |
| P3 | watch 链接 vcountry=domain_name 与 API ABA_DOMAIN 键一致（实测 2 行均 US） | API watchlist |
| P4 | ASIN 格式门禁：explore/BSR/AI-deals 链接渲染前 `/^[A-Z0-9]{10}$/` 校验 | page.tsx L1177/1393/1535 |
| P5 | DealsTab/FinderTab 国家列表已正确过滤为 Keepa 13 站 | DealsTab L14 / FinderTab L14 |
| P6 | source=none 空状态兜底：EmptyState+live 按钮，不显示误导性空图表 | 截图 01/02 |
| P7 | 图片域 images-na.ssl-images-amazon.com 存活；enforced CSP 未限 img-src，缩略图可加载 | HTTP 实测 + Caddyfile L18 |
| P8 | seller tab 选 AE 有错误兜底（红字「站点不支持: AE」） | 截图 04 |
| P9 | AI 选品 13 站列表与 KEEPA_DOMAINS 全集一致 | page.tsx L1432 |

## 问题清单（8 + 1 理论项）

### 🔴 F1 加监控 domain 校验上限过时——BR/AU/NL 必 422
- `api/routers/sourcing.py` `WatchIn.domain: Field(ge=1, le=11)`；前端 WatchTab 2026-09-28 已补齐 12 BR/13 AU/14 NL（注释明言对齐 KEEPA_DOMAINS 14 站），API 校验没跟上 → 三站加监控必 422。ViewerTab「一键关注+设提醒」走 data.domain（ABA_DOMAIN 值 12/13/14）同样 422。
- 反向：domain=7（Keepa 不存在的域）被放行，入库后 watchlist `domain_name=KEEPA_DOMAINS.get(7,'7')='7'`，链接 vcountry="7" → viewer 400。
- 修复：校验改为 KEEPA_DOMAINS 键集（1-6,8-14）。

### 🟠 F2 viewer/seller 国家选择器含 AE/SA/SE 死选项
- ViewerTab L178、SellerTab L177 用全量 COUNTRIES（含 AE/SA/SE）；Keepa 不采集中东/瑞典，所有端点 400。实测：price-history AE 400、sellers/top AE 400、截图 03b 红字。
- 修复：照 DEAL_COUNTRIES 同款过滤（13 站）。

### 🟡 F3 数据探索选 AE/SA/SE 显示误导性「无匹配」
- explore API `ABA_DOMAIN.get(country,-1)` → domain_id=-1 → 0 行 → 前端显示「无匹配」。AU 有专门提示（L1207），AE/SA/SE 没有——违反「数据缺失要可视化兜底」铁律。
- 注意：charts 情报台的 ABA 席位数据对 AE 是**有数据的**（explorer API 实测返回 country_terms），只有 Keepa 侧为空——两个 tab 语义不同，处理方式待拍板。

### 🟡 F4 viewer 加载失败后旧数据残留
- `load()` 失败（如 AE 400）只 setErr 不清 data——之前载入过有数据的 ASIN 时，错误下方仍显示上一个 ASIN 的图表卡（03b 因先前 ASIN 恰无数据未显形，代码路径可证）。修复：load 开始或失败时 `setData(null)`。

### 🟡 F5 全模块无外链（产品决策待拍板）
- 9 处链接全部是站内 viewer 深链；无任何 Amazon 商品页（/dp/ASIN）或 Keepa 官网产品页跳转。AgentResp.deals 声明了 `url` 字段但从未渲染（F8 同源）。用户看到好 ASIN 无法一步到 Amazon 验证。

### ⚪ F6 跳转方式混用
- page.tsx×5 / WatchTab / SellerTab×2 用 `<a href>`（全页刷新），Deals×2 / Finder×3 用 setQs（SPA 无刷新）。功能都对，体验不一致。

### ⚪ F7 CSP Report-Only 白名单缺实际图片域（前瞻）
- Caddyfile L20 Report-Only `img-src ... https://m.media-amazon.com` 未含代码实际使用的 `images-na.ssl-images-amazon.com`——若将来转强制，促销流/产品查找缩略图全被拦。

### 理论项（无实际触发路径，仅记录）
- ViewerTab 种子 effect deps=[qs.vasin] 且 guard `qs.vasin !== data?.asin`：同 ASIN 换国家不重载。但所有 setQs 写入方（Deals/Finder）都在 viewer 卸载状态下运行（条件渲染），重挂载即正确加载。当前 UI 无触发路径。

## 修复批次（待拍板）
1. **批一（缺陷修复，改动小）**：F1 API 校验键集 + F2 两处选择器过滤 + F4 失败清 data + F3 explore 提示对齐 AU 做法 + pen_tests 补 3 断言（BR 加监控 200 / AE viewer 400 友好提示 / 选择器无死选项）。
2. **批二（待拍板产品语义）**：F5 是否加 Amazon/Keepa 外链；F6 是否统一 SPA；F7 CSP 白名单补域。
3. **部署协调**：兄弟窗口 off-site-promotion 正在加第五 tab——rebuild 需协调顺序，避免互相用旧代码覆盖镜像。

2026-10-06 · zipforce-hub 主窗口 · 截图与工具已存档
