---
id: T-587
title: AI工场商品项目入口与 CDP 只读拉取蝦皮原主图 URL
phase: 7
deps: [T-586, T-563]
status: TODO
created: 2026-07-11
---

## 问题 / 背景

AI工场以“账号 + 商品 ID”建立项目，并从该账号 Chrome 的商品详情页只读取得全部主图 URL。该流程必须复用已验证 CDP、登录检测、商品失效 toast 和 tab 清理纪律，不能另写页面选择器或修改蝦皮商品。

## 方案

- 新增项目入口服务：校验账号、商品 ID 和重复项目；重复时打开已有项目。
- 抽取/复用 `app.editor` 图片列表读取能力，返回有序 `{src, index}`，不要求上传 input，不下载图片、不改标题/图片。
- 按①采集的只读边界确保账号 Chrome 就绪：已打开复用，未打开才启动；只检测登录，不自动登录、不填密码。
- 商品页后台打开，不主动抢焦点；只关闭本轮自动新建 tab，复用用户已有 tab 不关闭。
- 详情页失效、无权限、未登录、CDP 超时继续上浮结构化中文原因和 Shopee 原始 toast。
- 抓取结果写项目的原图 URL 快照，刷新时按 URL/顺序更新，不创建本地 asset，下载留给 T-588。

## 验收要点

- mock 覆盖已开 Chrome 复用、未开启动、明确未登录、暂时不确定登录、商品失效和成功读 1..9 张 URL。
- 成功路径不调用标题修改、文件上传、拖拽或更新提交。
- URL 顺序与蝦皮主图顺序一致；重复刷新幂等。
- 新建失败 tab 清理、复用 tab 保留；`bring_to_front=False`。
- 涉及 CDP 变更时同步 `docs/04-architecture.md` 并在测试商品做只读实跑；不点击更新。

## 边界（不改什么）

- 不下载/显示图片，不做照片池 GUI，不写蝦皮。
- 不更改现有①采集和③更新行为。
- 不绕过登录、验证码、风控或权限检查。

## 执行记录

（完成后记录 mock、只读实跑与 tab 清理结果。）