Was macht run (Ausführen)?
Eine Seite ist erst fertig, wenn sie in Aktion gesehen wurde. Der Quellcode verrät, was jemand beabsichtigt hat; der Browser zeigt, was der Benutzer erhält. Diese Fähigkeit ist der kürzeste Weg zwischen einem Ordner und einer gerenderten Seite.
Ausführen
node <skill folder>/scripts/serve.mjs <verzeichnis> [--port 4173] [--open] [--shot ausgabe.png] [--stop] [--detect]
--detectgibt aus, was gefunden wurde, und startet nichts. Verwende dies zuerst, wenn der Ordner unbekannt ist.--portbeginnt die Suche an diesem Port und nimmt den nächsten freien Port, sodass zwei Projekte gleichzeitig laufen können.--openöffnet den Standardbrowser.--shot ausgabe.pngrendert die Seite mit 1440 Pixeln Breite, voller Höhe, über Playwright.--stopbeendet den Prozessbaum über.run/state.json.
Es schreibt .run/state.json (PID, Port, URL, Befehl) und .run/server.log neben das Projekt. Diese beiden Dateien sind der gesamte Handover zwischen Start und Stopp.
Was erkannt wird
| Gefunden | Ausführung |
|---|---|
package.json mit dev, start, serve oder preview | npm run <dieses Skript> auf einem freien Port, mit gesetztem PORT |
index.html im Stammverzeichnis | python -m http.server in diesem Ordner |
public/index.html, dist/index.html, build/index.html | ein statischer Server, der auf das erstellte Ausgabeverzeichnis zeigt |
| Eine Konfigurationsdatei, aber keine Skripte | meldet es und stoppt: das Projekt benötigt seinen eigenen Befehl |
go.mod, Cargo.toml, pubspec.yaml | meldet es und stoppt: Verwende den eigenen Ausführungsbefehl des Projekts |
Framework-Spezifika, Port-Standardwerte und die Wissenswerten Fehlermodi: references/stacks.md.
Das Ergebnis lesen
Das Skript belegt drei Dinge und nicht mehr: Ein Prozess wurde gestartet, ein Port hat geantwortet, eine Seite wurde gerendert. Was es nicht sagen kann:
- ob das Layout bei 375, 768 und 1440 Pixeln korrekt ist (verwende dafür
sitecraft/scripts/verify.mjs) - ob die Konsole sauber ist (wird hier nicht erfasst;
verify.mjserfasst sie) - ob die auf dem Screenshot gezeigte Seite die vom Benutzer gemeinte ist (überprüfe die URL gegen die Route, nach der du gefragt hast)
Die Schleife lautet also: serve.mjs --shot, betrachte das Bild mit eigenen Augen, korrigiere, erstelle erneut einen Screenshot. Drei Renderings sind das Maximum für einen Durchlauf; danach liegt das Problem am Plan, nicht am CSS.
Regeln
- Lasse niemals einen Server laufen. Stoppe ihn, wenn die Überprüfung abgeschlossen ist, oder sage klar, dass er noch läuft und auf welchem Port. Ein versehentlich laufender Dev-Server auf dem Rechner des Benutzers ist ein Problem, das er bereinigen muss.
- Starte nichts, was du nicht stoppen kannst. Wenn das Projekt Docker, eine Datenbank oder einen kostenpflichtigen API-Schlüssel benötigt, sage dies, bevor du etwas startest.
- Melde die echte URL.
localhost:4173, nicht "die App". Wenn der Port verschoben wurde, weil 4173 belegt war, nenne den neuen. - Lies das Protokoll, bevor du rätst. Ein fehlgeschlagener Start ist fast immer eine fehlende Abhängigkeit, eine fehlende Umgebungsvariable oder ein bereits belegter Port.
.run/server.logenthält die Antwort, und das Zitieren des tatsächlichen Fehlers ist besser als jede Theorie. - Keine Installation ohne Ansage. Wenn
node_modulesfehlt, istnpm installnormalerweise richtig, und es ist auch eine Änderung ihres Projekts. Führe es aus, sage dann, dass es gelaufen ist, oder frage einmal nach, wenn die Installation umfangreich ist. - Statisch vor Framework. Wenn ein Build-Output existiert und aktuell ist, ist das Ausliefern von
dist/schneller und genauer als der Dev-Server.
Wann es nicht startet
- Lese
.run/server.logund zitiere den ersten tatsächlichen Fehler, nicht die letzte Zeile. - Fehlende Abhängigkeiten:
npm installim Projekt, dann erneut versuchen. - Fehlende Umgebungsvariablen: Suche nach
.env.example, benenne, was erforderlich ist, und stoppe, wenn ein Wert geheim ist und fehlt. - Port bereits belegt: Das Skript weicht bereits auf den nächsten freien Port aus; ein hartcodierter Port in der Framework-Konfiguration ist die übliche Ursache, wenn es trotzdem fehlschlägt.
- Build-Schritt erforderlich: Führe zuerst
npm run buildaus, dann lieferedist/aus. - Nativ oder containerisiert: Gib den Befehl zurück, den das Projekt dokumentiert. Nicht jeder Stack ist ein Skript.
Checkliste
- Der Stack wurde erkannt, nicht angenommen
- Gestartet und eine echte HTTP-Antwort gesehen, nicht nur einen gestarteten Prozess
- Die genaue URL und den Port gemeldet
- Einen Screenshot betrachtet, nicht nur das Protokoll
- Überprüft, ob die Route mit der gemeinten Seite übereinstimmt
- Gestoppt, oder gesagt, dass es noch läuft und wo
- Den tatsächlichen Fehler bei einem Fehler zitiert