1:1复刻网站 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)
- 严禁直接
curl/urllib裸抓高防站点:遇到 Akamai(如us.louisvuitton.com)、Cloudflare 等防护返回403 Forbidden时,必须全程通过ego-browser的真机页面执行 DOM 提取与page.fetch(url, { saveAs })本地保存。 - 弹窗解锁先行(Modal & Scroll Unlock First):首次打开目标站点后,必须先检测并点击关闭地区切换弹窗(如
.lv-modal__container button.lv-modal__close)、Cookie 遮罩或订阅弹窗,并验证window.scrollTo(0, 500)能够真实改变window.scrollY,防止截取到锁屏半透明遮罩或空白懒加载区。 - 穿透懒加载提取 4K/高清原图:针对
<picture>动态data-srcset或<noscript><img src="..."></noscript>,必须编写脚本优先解析高清源 URL(如?wid=2048/?wid=1090),严禁抓取1x1base64 占位符。 - 100% 本地化资产与全量产品入库:所有首页海报、分类封面、全品类商品工作室白底/灰底图(PNG/JPG)必须下载至本地
assets/images/与assets/products/,所有官方图标与 Logo 必须内联原版<svg viewBox="...">,严禁使用任何外部防盗链 URL 或通用图库(Unsplash/Pexels)替代。 - 隔离工作区保护:若当前工作区已有存量业务代码,必须在独立子目录(如
<brand>-clone/)中构建完整项目,严禁覆盖根目录既有文件。
三、 标准 7 步像素级复刻全流程(7-Phase Pipeline)
Phase 1:真机取证侦察与弹窗穿透 (scripts/recon_and_harvest.mjs)
- 启动
ego-browserTaskSpace,设置桌面视口1440×900。 - 导航至目标 URL,自动检测并关闭 Country/Region 模态框与 Cookie 横幅,移除
body滚动锁。 - 分段滚动触发全页懒加载,提取:
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、搜索、心愿单、购物袋、关闭、箭头、社交图标)。
- 沿页面高度按固定步长(如
0, 720, 1660, 2450, 3150, 3920, 4630, 5400, 6100)利用page.cdp("Page.captureScreenshot")截取无弹窗高清基准图RECON/screenshots/original-clean-{y}.png。
Phase 2:首页全量高清媒体资产下载 (assets/images/)
- 解析首页所有 Hero 大片、品类网格图、推荐单品透明 PNG 及品牌故事竖图。
- 在
ego-browser内调用page.fetch(url, { saveAs })将全部图片保存至assets/images/,校验每个文件字节数> 1KB。
Phase 3:全站多品类商品爬虫与批量上传入库 (scripts/crawl_all_categories.mjs)
- 提取首页及导航菜单关联的所有核心品类 URL(如
womens-bags,womens-slg,womens-accessories,womens-shoes,mens-bags,mens-slg,mens-shoes,mens-accessories, 季节限定系列等)。 - 在
ego-browser中依次访问各品类落地页,自动提取每个商品卡片的:sku(唯一商品编号)name(官方商品名称)price&priceValue(格式化价格与数值)category&categoryName(所属品类 ID 与展示名)gender(人群归属)image(高清工作室商品图 URL)description/material/dimensions(工艺描述与规格)
- 跨品类按
sku去重,调用page.fetch将所有商品高清图下载至assets/products/prod_<SKU>.png。 - 自动编译生成结构化商品数据库:
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 视觉重构 (
index.html+css/lv-styles.css):- 严格按照原站 Section 顺序、宽高比(
16:9大片、4:5商品与品类卡片)及内联 SVG 构建 DOM。 - 实现吸顶导航状态机:在首屏 Hero 上方为透明背景配纯白文字/图标;向下滚动超过阈值(
60px)或鼠标悬停时平滑切换为纯白背景配纯黑文字/图标与底部细边框。
- 严格按照原站 Section 顺序、宽高比(
- 全量商品商城与交互引擎 (
js/lv-app.js):- 全量商品目录页 (
#lv-catalog-view):支持一键查看全部已上传商品(如 86+ 款),提供品类胶囊筛选栏(Category Pills)、价格高低排序与一键返回首页。 - 分屏商品详情模态框 (PDP):点击任意商品展示左侧高清大图舞台、右侧 SKU 编号、价格、工艺材质描述及
Place in Cart加购按钮。 - 实时搜索抽屉 (Search Overlay):支持按商品名、SKU、品类实时过滤并即时展示缩略图结果。
- 持久化心愿单与购物袋 (Wishlist & Shopping Bag):基于
localStorage持久化收藏与加购状态,实时更新顶部导航角标数量。 - 在线商品上传后台(
+ Upload ProductCMS Drawer):支持在网页端直接填写新商品名称、SKU、价格、所属分类、图片路径与描述,立即发布至全站目录并持久化保存。
- 全量商品目录页 (
Phase 6:静态代码、排版无障碍与 SEO/GEO 自动化审计 (scripts/)
- 运行
python3 scripts/seo_geo_generator.py <project_dir> <base_url>自动生成包含全量商品 URL 的sitemap.xml、robots.txt与llms.txt。 - 运行
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)
- 启动本地 HTTP 预览服务,使用
ego-browser访问本地克隆站。 - 强制触发全量图片加载,验证首页图片与全量目录商品图
loaded === total且brokenImages.length === 0。 - 分别在桌面端(
1440×900)与移动端(390×844)截取全流程对比图(首页各滚动位、全量商品目录页、PDP 详情页、CMS 上传抽屉、移动端首屏),验证移动端scrollWidth <= innerWidth(零横向溢出)。 - 关闭
ego-browserTaskSpace(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多视口截图对比与断链/溢出自动核验脚本。