boyang-hu/website-rebuild-skill

解决的问题

本项目提供一个系统，使AI代理能够对现有网站进行高保真、逐行重建。与仅捕获视觉外观的简单网站爬虫或“克隆”工具不同，此工具专注于逆向工程底层逻辑和实现，创建一个功能完整、人类可读的源代码项目，该项目与原始网站在证明上完全相同。

工作原理

该过程遵循为AI代理设计的严格流水线：

1. 分类：代理首先判断网站是否可重建（例如，识别其是静态网站、WebGL场景，还是服务器端渲染应用）。
2. 证据镜像：捕获网站的只读快照，作为未来所有比较的绝对真实基准。
3. 逆向工程：展开压缩和混淆的代码，并创建映射，使重建中的每一行都能追溯到原始捆绑包中的特定行。
4. 移植：将逻辑移植到新项目中，所有更改均记录在差异表中。
5. 验证：代理在五个层面进行定量比较：控制台日志、网络请求、DOM结构、几何结构和像素级视觉匹配。
6. 源码化：最终输出被重构为结构清晰、模块化、人类可读的工程化项目，包含适当的命名和注释，同时保持与原始文件的字节级等价性。

适用人群

• 开发者和研究人员：希望研究复杂网页动画、WebGL引擎或高级前端架构实现方式的人。
• AI代理用户：使用Claude Code或Codex等代理，希望自动化网页资产重建以用于学习或迁移的人。
• 数字档案馆员：试图从Wayback Machine等存档中拯救“已死亡”网站的人。

亮点

• 像素级精确：使用定量验证确保重建结果与原始网站完全一致，通常可达到平均绝对差为0.00。
• 支持RSC：通过分析"flight"流输出，能够重建Next.js App Router站点。
• 零依赖工具链：核心流程由70个Node脚本组成，直到最终源码化阶段前无需任何npm包。
• 死站恢复：可通过从存档中捕获的字节重建Wayback Machine中的网站，实现拯救。
• 可追溯逻辑：重建代码的每一行均可追溯到原始网站捆绑包中的特定行。