Que fait url-ui-recreate ?
Compétence Agent pour la recréation pixel-perfect de l'interface utilisateur à partir d'une URL. À partir d'une URL web donnée, le processus complet capture → design → spec → implémente → pixel-QA → archive produit un site de recréation traçable en Vite + React + Tailwind, avec pixelmatch comme outil de validation principal (bl omni en tant que preuve secondaire).
Comment ça marche
- Capture : L'agent prend une capture d'écran de la page web à partir de l'URL fournie.
- Design : Analyse la capture pour extraire les composants, couleurs, polices, espacements et mise en page.
- Spec : Génère un document de spécifications détaillant chaque élément visuel et son comportement.
- Implement : Génère le code source complet en utilisant Vite comme bundler, React pour les composants, et Tailwind CSS pour les styles.
- Pixel-QA : Compare la sortie générée avec la capture originale à l'aide de pixelmatch, signalant toute divergence au niveau du pixel.
- Archive : Structure la sortie dans un répertoire traçable avec documentation, captures et code source.
Plateformes supportées
- Claude Code
- Cursor
- Codex
- Autres agents capables d'exécuter des commandes shell et de manipuler des fichiers
Exigences
- Node.js 18+
- Vite 5+
- React 18+
- Tailwind CSS 3+
- pixelmatch 5+
- Un navigateur headless (playwright ou puppeteer) pour la capture
Utilisation
# Exemple d'invocation via un agent
agent run ericjsliu/url-ui-recreate --url "https://exemple.com"
Le résultat sera placé dans ./recreate-<nom-de-domaine>/ par défaut.
Configuration
| Variable d'environnement | Valeur par défaut | Description |
|---|---|---|
RECREATE_OUTPUT_DIR | ./recreate-<domaine> | Dossier de sortie du projet |
RECREATE_TOLERANCE | 0.01 | Tolérance pixelmatch (0-1) |
RECREATE_HEADLESS | true | Utiliser le mode headless pour la capture |
Remarques
- bl omni peut être utilisé comme vérification complémentaire mais pixelmatch reste l'outil de décision principal.
- Les fichiers générés sont entièrement autonomes et peuvent être déployés avec
npm run devounpm run build. - Pour les sites nécessitant une authentification, fournissez au préalable des cookies ou jetons.
Licence
MIT