Que fait run ?
Un site n'est pas terminé tant qu'il n'a pas été vu en fonctionnement. Le code source dit ce que quelqu'un avait l'intention ; le navigateur dit ce qu'une personne reçoit. Ce skill est le chemin le plus court entre un dossier et une page rendue.
Exécution
node <chemin/vers/skill>/scripts/serve.mjs <dossier> [--port 4173] [--open] [--shot sortie.png] [--stop] [--detect]
--detectaffiche ce qu'il a trouvé et ne démarre rien. Faites-le d'abord lorsque le dossier est inconnu.--portcommence à chercher sur ce port et prend le port libre suivant, de sorte que deux projets peuvent fonctionner en même temps.--openouvre le navigateur par défaut.--shot sortie.pngrend la page à 1440 de large, en pleine hauteur, via Playwright.--stoptue l'arborescence des processus à partir de.run/state.json.
Il écrit .run/state.json (pid, port, url, commande) et .run/server.log à côté du projet. Ces deux fichiers sont l'ensemble de l'interface entre le démarrage et l'arrêt.
Ce qu'il détecte
| Trouve | Exécute |
|---|---|
package.json avec dev, start, serve ou preview | npm run <ce script> sur un port libre, avec PORT défini |
index.html à la racine | python -m http.server sur ce dossier |
public/index.html, dist/index.html, build/index.html | un serveur statique enraciné dans la sortie compilée |
| Un fichier de configuration mais aucun script | le signale et s'arrête : le projet a besoin de sa propre commande |
go.mod, Cargo.toml, pubspec.yaml | le signale et s'arrête : utilisez la propre commande d'exécution du projet |
Détails spécifiques au framework, ports par défaut et modes d'échec à connaître : references/stacks.md.
Lecture du résultat
Le script prouve trois choses et rien de plus : un processus a démarré, un port a répondu, une page a été rendue. Ce qu'il ne peut pas vous dire :
- si la mise en page est correcte à 375, 768 et 1440 (utilisez
sitecraft/scripts/verify.mjspour cela) - si la console est propre (elle n'est pas capturée ici ;
verify.mjsla capture) - si la page dont vous avez pris une capture d'écran est celle que l'utilisateur voulait (vérifiez l'URL par rapport à la route que vous avez demandée)
Ainsi, la boucle est : serve.mjs --shot, regardez l'image de vos propres yeux, corrigez, prenez une nouvelle capture. Trois rendus est la limite pour un passage ; au-delà, le problème est le plan, pas le CSS.
Règles
- Ne laissez jamais un serveur en cours d'exécution. Arrêtez-le une fois la vérification terminée, ou dites clairement qu'il est toujours actif et sur quel port. Un serveur de développement errant sur la machine de l'utilisateur est un désordre qu'il doit nettoyer.
- Ne démarrez pas ce que vous ne pouvez pas arrêter. Si le projet a besoin de Docker, d'une base de données ou d'une clé API payante, dites-le avant de lancer quoi que ce soit.
- Signalez l'URL réelle.
localhost:4173, pas "l'application". Si le port a changé parce que 4173 était pris, dites le nouveau. - Lisez le journal avant de deviner. Un échec de démarrage est presque toujours une dépendance manquante, une variable d'environnement manquante ou un port déjà utilisé.
.run/server.logcontient la réponse, et citer l'erreur réelle est mieux qu'une théorie. - Pas d'installations sans le dire. Si
node_modulesest manquant,npm installest généralement la bonne chose à faire, et c'est aussi une modification de leur projet. Faites-le, puis dites que cela a été exécuté, ou demandez une fois si l'installation est volumineuse. - Statique plutôt que framework. Lorsqu'une sortie compilée existe et est à jour, servir
dist/est plus rapide et plus fidèle que le serveur de développement.
Quand cela ne démarrera pas
- Lisez
.run/server.loget citez la première erreur réelle, pas la dernière ligne. - Dépendances manquantes :
npm installdans le projet, puis réessayez. - Variables d'environnement manquantes : cherchez
.env.example, nommez ce qui est requis, et arrêtez si une valeur est secrète et absente. - Port déjà utilisé : le script passe déjà au port libre suivant ; un port codé en dur dans la configuration du framework est la cause habituelle quand il échoue encore.
- Étape de compilation requise : exécutez
npm run buildd'abord, puis servezdist/. - Natif ou conteneurisé : redonnez la commande documentée par le projet. Toutes les piles ne sont pas un script.
Liste de vérification
- La pile technique a été détectée plutôt que supposée
- Le serveur a été démarré et une réponse HTTP réelle a été vue, pas seulement un processus lancé
- L'URL et le port exacts ont été signalés
- Une capture d'écran a été examinée, pas seulement le journal
- La route correspond à la page qui était visée
- Le serveur a été arrêté, ou il est dit qu'il est toujours en cours d'exécution et où
- L'erreur réelle a été citée en cas d'échec