cmshoppe/docs/tasks/T-587.md

id, title, phase, deps, status, created

id	title	phase	deps	status	created
T-587	AI工场商品项目入口与 CDP 只读拉取蝦皮原主图 URL	7	T-586 T-563	TODO	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 清理结果。）