1:1website复刻skill — 像素级全站与全量商品目录复刻大师技能

1:1website复刻skill — 像素级全站与全量商品目录复刻大师技能은(는) 무엇을 하나요?

定位：将“逆向取证级 DOM/CSS 采集 + Akamai/Cloudflare 真机穿透 + 全品类商品爬虫与本地化落盘 + 1:1 交互商城重构 + 自动化排版/SEO/多视口视觉 QA”浓缩为单一闭环的终极 1:1 网站复刻技能。

---

一、 技能融合架构（6 大底层能力合一）

本技能将以下 6 个本地与 GitHub 顶尖技能的核心能力融为一体，解决单一技能无法兼顾“高防网站穿透”、“懒加载原图提取”、“全品类商品批量入库”与“像素级静态/动态交互还原”的痛点：

模块来源	核心职责	在本技能中的固化阶段
1. Jane-xiaoer/claude-skill-web-clone	5 阶段取证工作流、DOM 语义树映射、区块级 1:1 视觉还原	Phase 1（DOM 区块测绘）& Phase 7（多滚动位截图对比）
2. ericshang98/perfect-web-clone-skill	浏览器 getComputedStyle 精确 Token 提取、DESIGN.md 契约、吸顶导航状态机	Phase 1（CSS 精确提取）& Phase 4（设计规范合成）
3. ego-browser (Real Chromium Engine)	穿透 Akamai (HTTP 403) / Cloudflare、自动关闭锁屏弹窗、浏览器上下文 page.fetch 下载	Phase 1 ~ Phase 3（全真机环境采集与零 403 资产落盘）
4. renwork-web-create-skill (Mode B v3)	零占位图铁律（Zero Placeholder Policy）、SEO/GEO (sitemap.xml/robots.txt/llms.txt) 自动化	Phase 2（100% 本地资产）& Phase 6（SEO/GEO 生成）
5. wideway-export-site-builder-skill	全量商品目录视图（PLP）、分屏商品详情页（PDP）、购物袋、心愿单与前端商品上传 CMS	Phase 5（全站商品交互商城与在线上传引擎）
6. layout-typography-auditor	单一 <h1> 校验、语义化交互标签（杜绝 <div onclick>）、表单 autocomplete、:focus-visible 审计	Phase 6（静态代码质量与无障碍 0 错误闸门）

---

二、 铁律与红线（Non-Negotiable Rules）

1. 严禁直接 curl / urllib 裸抓高防站点：遇到 Akamai（如 us.louisvuitton.com）、Cloudflare 等防护返回 403 Forbidden 时，必须全程通过 ego-browser 的真机页面执行 DOM 提取与 page.fetch(url, { saveAs }) 本地保存。
2. 弹窗解锁先行（Modal & Scroll Unlock First）：首次打开目标站点后，必须先检测并点击关闭地区切换弹窗（如 .lv-modal__container button.lv-modal__close）、Cookie 遮罩或订阅弹窗，并验证 window.scrollTo(0, 500) 能够真实改变 window.scrollY，防止截取到锁屏半透明遮罩或空白懒加载区。
3. 穿透懒加载提取 4K/高清原图：针对 <picture> 动态 data-srcset 或 <noscript><img src="..."></noscript>，必须编写脚本优先解析高清源 URL（如 ?wid=2048 / ?wid=1090），严禁抓取 1x1 base64 占位符。
4. 100% 本地化资产与全量产品入库：所有首页海报、分类封面、全品类商品工作室白底/灰底图（PNG/JPG）必须下载至本地 assets/images/ 与 assets/products/，所有官方图标与 Logo 必须内联原版 <svg viewBox="...">，严禁使用任何外部防盗链 URL 或通用图库（Unsplash/Pexels）替代。
5. 隔离工作区保护：若当前工作区已有存量业务代码，必须在独立子目录（如 <brand>-clone/）中构建完整项目，严禁覆盖根目录既有文件。

---

三、 标准 7 步像素级复刻全流程（7-Phase Pipeline）

Phase 1: 真机取证侦察与弹窗穿透 (scripts/recon_and_harvest.mjs)

1. 启动 ego-browser TaskSpace，设置桌面视口 1440×900。
2. 导航至目标 URL，自动检测并关闭 Country/Region 模态框与 Cookie 横幅，移除 body 滚动锁。
3. 分段滚动触发全页懒加载，提取：
   • RECON/original-recon.json & RECON/homepage-blocks.json：全页所有 Section 的标题、副标题、CTA 链接、网格列数与精确坐标。
   • RECON/css-spec.json：通过 getComputedStyle 提取 Header、Hero、Section 标题、Product Card、Footer 的精确字号、行高、字距、内边距、背景渐变与边框色。
   • RECON/svgs.json：提取全站原版矢量 SVG（品牌 Wordmark、搜索、心愿单、购物袋、关闭、箭头、社交图标）。
4. 沿页面高度按固定步长（如 0, 720, 1660, 2450, 3150, 3920, 4630, 5400, 6100）利用 page.cdp("Page.captureScreenshot") 截取无弹窗高清基准图 RECON/screenshots/original-clean-{y}.png。

Phase 2: 首页全量高清媒体资产下载 (assets/images/)

1. 解析首页所有 Hero 大片、品类网格图、推荐单品透明 PNG 及品牌故事竖图。
2. 在 ego-browser 内调用 page.fetch(url, { saveAs }) 将全部图片保存至 assets/images/，校验每个文件字节数 > 1KB。

Phase 3: 全站多品类商品爬虫与批量上传入库 (scripts/crawl_all_categories.mjs)

1. 提取首页及导航菜单关联的所有核心品类 URL（如 womens-bags, womens-slg, womens-accessories, womens-shoes, mens-bags, mens-slg, mens-shoes, mens-accessories, 季节限定系列等）。
2. 在 ego-browser 中依次访问各品类落地页，自动提取每个商品卡片的：
   • sku（唯一商品编号）
   • name（官方商品名称）
   • price & priceValue（格式化价格与数值）
   • category & categoryName（所属品类 ID 与展示名）
   • gender（人群归属）
   • image（高清工作室商品图 URL）
   • description / material / dimensions（工艺描述与规格）
3. 跨品类按 sku 去重，调用 page.fetch 将所有商品高清图下载至 assets/products/prod_<SKU>.png。
4. 自动编译生成结构化商品数据库：
   • data/products.json（标准 JSON 数据库）
   • js/products-data.js（前端零延迟加载全局变量 window.LV_CATALOG_DATA / window.SITE_CATALOG_DATA）

Phase 4: 设计规范文档生成 (DESIGN.md & NOTES.md)

将采集到的视觉参数固化为 DESIGN.md：

• 色彩令牌：主文本色（如 #1a1a1a / #000000）、次级文本色（#727272）、浅边框（#e1e1e1）、商品卡片石质工作室背景渐变（linear-gradient(180deg, #efeeec 0%, #f6f5f3 50%, #fbfaf9 100%)）。
• 排版比例：品牌定制无衬线字体栈、H1/H2（28px/36px 或 24px/32px, letter-spacing: 0.4px）、眉题 Pretitle（10px/16px, uppercase, letter-spacing: 1px）、商品标题与价格（14px/20px）。
• 布局与栅格：Header 高度（88px，左右内边距 48px）、4 列商品/品类网格（grid-template-columns: repeat(4, 1fr), gap: 32px 16px, 左右边距 64px）、3 列品牌文化网格（repeat(3, 1fr)）。

Phase 5: 1:1 像素级页面重构与全功能商品商城 (index.html, css/, js/)

1. 首页 1:1 视觉重构 (index.html + css/lv-styles.css)：
   • 严格按照原站 Section 顺序、宽高比（16:9 大片、4:5 商品与品类卡片）及内联 SVG 构建 DOM。
   • 实现吸顶导航状态机：在首屏 Hero 上方为透明背景配纯白文字/图标；向下滚动超过阈值（60px）或鼠标悬停时平滑切换为纯白背景配纯黑文字/图标与底部细边框。
2. 全量商品商城与交互引擎 (js/lv-app.js)：
   • 全量商品目录页 (#lv-catalog-view)：支持一键查看全部已上传商品（如 86+ 款），提供品类胶囊筛选栏（Category Pills）、价格高低排序与一键返回首页。
   • 分屏商品详情模态框 (PDP)：点击任意商品展示左侧高清大图舞台、右侧 SKU 编号、价格、工艺材质描述及 Place in Cart 加购按钮。
   • 实时搜索抽屉 (Search Overlay)：支持按商品名、SKU、品类实时过滤并即时展示缩略图结果。
   • 持久化心愿单与购物袋 (Wishlist & Shopping Bag)：基于 localStorage 持久化收藏与加购状态，实时更新顶部导航角标数量。
   • 在线商品上传后台 (+ Upload Product CMS Drawer)：支持在网页端直接填写新商品名称、SKU、价格、所属分类、图片路径与描述，立即发布至全站目录并持久化保存。

Phase 6: 静态代码、排版无障碍与 SEO/GEO 自动化审计 (scripts/)

1. 运行 python3 scripts/seo_geo_generator.py <project_dir> <base_url> 自动生成包含全量商品 URL 的 sitemap.xml、robots.txt 与 llms.txt。
2. 运行 python3 scripts/layout_typography_auditor.py <project_dir> 执行静态质量闸门：
   • 确保全页仅有一个主 <h1>；
   • 确保所有点击事件绑定在 <button> 或 <a>（或通过 JS 事件委托绑定），杜绝非语义化 <div onclick>；
   • 确保所有文本输入框具备 autocomplete 属性与无障碍 <label>；
   • 确保所有交互控件具备 :focus-visible 样式，达成 0 blocking errors, 0 interface guidelines。

Phase 7: 多视口真机视觉 QA 与交付报告 (scripts/visual_qa_verify.mjs)

1. 启动本地 HTTP 预览服务，使用 ego-browser 访问本地克隆站。
2. 强制触发全量图片加载，验证首页图片与全量目录商品图 loaded === total 且 brokenImages.length === 0。
3. 分别在桌面端（1440×900）与移动端（390×844）截取全流程对比图（首页各滚动位、全量商品目录页、PDP 详情页、CMS 上传抽屉、移动端首屏），验证移动端 scrollWidth <= innerWidth（零横向溢出）。
4. 关闭 ego-browser TaskSpace（await task.finish({ keep: [] })），生成 CLONE_REPORT.md 并交付。

---

四、 配套自动化脚本清单 (scripts/)

• scripts/recon_and_harvest.mjs：真机弹窗穿透、DOM/ComputedStyle/SVG 提取、原站分段基准截图与首页高清图片下载器。
• scripts/crawl_all_categories.mjs：全品类商品递归抓取、跨品类 SKU 去重、高清商品图批量本地下载与 products.json / products-data.js 编译器。
• scripts/seo_geo_generator.py：基于 data/products.json 自动生成 sitemap.xml、robots.txt 与 llms.txt。
• scripts/layout_typography_auditor.py：HTML/CSS 语义化、标题层级、表单与焦点可访问性零错误审计工具。
• scripts/visual_qa_verify.mjs：本地服务器自动挂载 + ego-browser 多视口截图对比与断链/溢出自动核验脚本。