gongxiangp2/docs/前端UI改动清单.md

前端 UI 改动清单

当前进行中

• 标题栏商品搜索重构 (HeaderTaobaoSearch)
  • 交互升级：从常驻输入框改为图标按钮触发的拉出式 (Pull-out) 输入框 + 下拉面板模式。
  • 主题适配：完美支持深浅色模式切换。
  • 功能增强：支持全量查看主图、SKU图、详情图。
  • 导出功能：支持带图片嵌入的 Excel 导出。
  • 头部挂载完成：入口已放在标题栏 网络状态 前。
  • 后端对接完成：前端统一走 /api/taobao-detail-plus?itemId=...，不直连第三方，不暴露 API Key。
  • 查询链路完成：服务端代理、超时控制、错误处理、商品 ID 提取已收口。
  • 影子环境联调完成：http://192.168.58.20:5320
  • 联调测试商品：867081550619

当前对接口径

• 这份文档就是 Gemini 改完后的前端交接清单，后续以它作为标题栏商品搜索的唯一对接入口。
• 当前代码文件：
  • components/Header.tsx
  • components/HeaderTaobaoSearch.tsx
  • components/TaobaoImageGalleryModal.tsx
  • app/api/taobao-detail-plus/route.ts
  • lib/taobao-detail-plus.ts
• 当前已确认边界：
  • 前端只调站内接口 /api/taobao-detail-plus
  • 不把第三方 API Key 放前端
  • 不把这块能力迁到 /api/external/*
  • 当前阶段先保持“商品搜索 + 结果查看 + 全量图片查看/导出”，不顺手扩成上传、落库或批量导图

待处理

• (暂无)

已完成 (最近)

• 标题栏商品搜索功能重构 (2026-04-22)
• 标题栏商品搜索后端对接、影子环境部署与联调 (2026-04-22)