用途:把保存下来的 HTML 快照(浏览器“另存为”、wget、HTTrack、SingleFile 等离线抓取)重建为像素级一致的 Next.js App Router 项目,且不依赖第三方库;若暂不需要完整构建,也可只产出 Wave 0–2 的中间设计文档。
输入:需要 source-pages/ 目录,内含 {site}-{page}.html 及其同名 _files/ 资源目录(哈希命名的压缩 CSS、JS、图片、字体)。技能会先自动检测输入类型:有 _files/ 目录视为保存快照;仅有内联 <style> 视为 SingleFile 导出;有 package.json 与 src/ 则回退为源码仓库模式。检测命令示例:find . -maxdepth 2 -name ".html" -o -name ".htm" | sort
主要能力:解析压缩 CSS 的每条规则,解码 CSS Module 类名(ComponentName_propertyName__hashCode),解析自定义属性链,编目 @keyframes,映射 @media 断点,并据此生成 Next.js 项目。产出两套目录树:.design-soul/ 设计文档(wave0 逐页探索与去混淆 CSS、wave1 设计基因与令牌值、wave2 构建简报、wave3 设计系统基础)与 nextjs-project/ 可构建项目(app/ 路由、components/ 共享与页面组件、lib/tokens.ts 与 animations.ts、styles/globals.css、public/assets/ 自托管资源、tailwind.config.ts、package.json、tsconfig.json、next.config.js)。
使用方式:按页面各启动一个 Wave 0 代理并行处理,完成后以 done.signal 作为完成信号;核心原则是“解析而非猜测”,每个值都必须可追溯到具体 CSS 规则、自定义属性、内联 style、<style> 块或 @keyframes/@media,找不到则标记 UNVERIFIED,不得编造或取整。
适用场景:需要把离线快照忠实还原为可维护 Next.js 页面时使用。
限制:最终项目仅允许 next、react、react-dom、typescript、tailwindcss 等必要依赖,字体、图标、动画、组件均需自托管或自行实现;资料未提供具体安装命令、版本号、收费信息及实际构建验证结果。