用途与状态:web-clone 已被硬性弃用(Hard-deprecated),资料明确要求不要调用或路由该技能,实时 URL 的视觉实现与视觉 QA 应直接使用 $visual-ralph。
不适用场景:仅有截图参考而无实时 URL 时,应使用 $visual-verdict;需要修改、重设计或“改进”站点时,走标准实现流程;目标涉及认证、支付流程或后端 API 对齐时,超出 v1 范围;多页面/多路由深度克隆也不适用,v1 仅处理单页。
原 v1 范围(供参考):单页克隆,包含布局结构(header、nav、内容区、侧栏、footer)、排版(字体族、字号、字重、行高)、颜色、间距、边框、圆角,以及核心交互(导航链接、按钮、表单元素、下拉、模态、开关)和响应式提示;不包含后端 API 集成或数据获取、认证流程或受保护内容、动态/个性化内容、多页爬取或路由图克隆、第三方组件功能、图片/资源复制(外部图片用占位符)。法律提示:仅克隆自己拥有或获得明确许可的站点,尊重版权与商标。
必要工具:需要 Playwright MCP,配置命令为 codex mcp add playwright npx "@playwright/mcp@latest";必需工具包括 browser_navigate、browser_snapshot、browser_take_screenshot、browser_evaluate、browser_wait_for,可选 browser_click、browser_network_requests。若未发现浏览器工具应立即停止并提示用户配置。
流程概要:Pass 1 提取(导航、等待渲染、可访问性快照、整页截图、DOM 与计算样式、交互元素、可选网络请求);Pass 2 制定组件计划与设计令牌;Pass 3 生成克隆;Pass 4 验证(本地服务 npx serve {output_dir} -l 3456 --no-clipboard,或 python3 -m http.server 3456 -d {output_dir},视觉阈值 score >= 85,结构地标匹配,功能抽查);Pass 5 迭代,最多 5 次。状态持久化到 .omx/state/{scope}/web-clone-extraction.json 与 web-clone-verdicts.json,在 ralph 中还需写入 ralph-progress.json。
限制:上下文预算建议总提取控制在 60KB 以下,交互元素上限 50 个,DOM 深度超限时从 8 降到 4;页面加载失败、browser_evaluate 返回空、视觉分数连续 3 次低于阈值等均有对应处理说明。