Abschlussbericht und Vorschau

Ein Lauf der vollständig ist, was bedeutet, dass ihm die Arbeit ausgegangen ist, übergibt zwei Dinge: einen Abschlussbericht und eine Live-Vorschau deiner App. Läufe, die pausiert, gestoppt, abgebrochen wurden oder das Budget überschritten haben, tun das nicht.

Wenn es eine App gibt, die angezeigt werden kann, sagt das ein Hinweis. Er lautet Die App ist fertiggestellt, ihr Bericht und ihre Vorschau sind bereit, wenn die Vorschau läuft, und Die App ist fertiggestellt, ihr Bericht ist bereit und ihre Vorschau startet über den Tab „Bericht“, wenn sie das nicht tut. Wenn der Bericht die App nicht als fertig bezeichnet, lautet er Ein Durchgang wurde abgeschlossen, sein Abschlussbericht ist bereit. Bericht und Vorschau befinden sich im Reiter Bericht des Managers, nebeneinander.

Der Abschlussbericht

Der Bericht wird aus dem Protokoll des Laufs erstellt, ohne Modellaufruf. Er führt deine Tests nie erneut aus; er liest, was der Loop getan hat.

• Was gebaut wurde: die Dateien, die der Lauf erstellt oder geändert hat, die Karten, die er abgeschlossen hat, und die letzte Zusammenfassung jeder Bubble in eigenen Worten.
• Wie man sie ausführt: den Befehl aus deiner README, der die App startet (npm run dev, npm start und so weiter), wobei der Installationsschritt zuerst kommt, wenn Abhängigkeiten fehlen.
• Was getestet wurde: den letzten Testbefehl, den der Loop ausgeführt hat, seinen Exit-Code und wann.
• Was fehlt: alles, was verhindert, dass der Lauf als fertig zählt, wie etwa keine README, kein Testskript, Tests wurden nie ausgeführt, Tests schlagen fehl, Karten sind noch offen oder eine Vorschau ist abgestürzt. Wenn nichts fehlt, lautet er Nichts, was das Protokoll des Durchgangs erkennen kann.

Der Bericht bezeichnet die App als fertig, wenn:

1. die README einen Befehl zu ihrer Ausführung angibt,
2. der letzte Testlauf bestanden wurde,
3. keine Bubble mit FAIL oder ERROR geendet hat, und
4. die Vorschau nicht abgestürzt ist.

Unter dem Urteil gibt der Bericht auch an, ob die App Präsentabel ist, aus der letzten visuellen Prüfung des Laufs: Präsentabel, die visuelle Überprüfung war erfolgreich, …ist mit N Blockierungen fehlgeschlagen oder nicht bewertet, wenn keine Prüfung lief. Sie wird gemeldet, nicht gezählt: Ein Loop ohne Benutzeroberfläche hat keine visuelle Prüfung, und eine fehlgeschlagene Prüfung beendet den Durchgang des Prüfers bereits bei FAIL.

Wenn eine Vorschau läuft, macht der Bericht auch Screenshots der App. Berichte werden im Projekt, im Ordner der App, als JSON für den Reiter und als Markdown für deinen Editor gespeichert. Die letzten 20 werden aufbewahrt.

Die Live-Vorschau

Die Vorschau ist der Dev-Server deiner App, einer pro Board. Er wird von Läufen getrennt gehalten: Das Ende eines Laufs stoppt ihn nicht, und ein neuer Lauf stoppt ihn ebenfalls nicht, sodass eine Vite-App den Bearbeitungen des Loops weiter folgt.

• Starte, starte neu und stoppe ihn über den Reiter “Bericht” und lies sein Protokoll dort.
• Am Ende eines Laufs startet er von selbst nur dann, wenn sich das Board im Full Auto befindet und der Befehl erlaubt ist. Drücke ansonsten Vorschau starten.
• Ein Board, das Befehle in einer Sandbox ausführt, kann keine Vorschau ausführen.
• Stirbt der Server, zeigt der Reiter seinen Exit-Code und die letzten Zeilen an, statt stillschweigend leer zu werden.

Die visuelle Prüfung

In einem Loop, der eine Benutzeroberfläche baut, führt der Prüfer eine visuelle Prüfung durch. Er öffnet die App in einem echten Browser bei 1280 × 800 sowie bei 390 × 844 und prüft jede Seite.

• Diese führen direkt zum Fehlschlag: ein HTTP-Fehler, ein Dev-Server-Fehler-Overlay, eine leere Seite, eine Seite, die breiter als ihr Fenster ist, ein beschädigtes Bild, Platzhaltertext wie lorem ipsum oder TODO: und Stellvertreter-Bild-Hosts.
• Wenn du ein Vision-Modell eingestellt hast (Seite “Modelle”, Hilfsmodelle), betrachtet es auch die Screenshots und bewertet sie anhand des DESIGN.md des Loops. Layoutprobleme, Platzhalter und beschädigte Bilder, die es als blockierend markiert, lassen die Prüfung fehlschlagen; Design- und Polierhinweise sind Empfehlungen.
• Ohne ein Vision-Modell entscheiden die Seitenprüfungen allein, und das Ergebnis besagt deutlich, dass niemand die Screenshots angesehen hat.

Einstellungen › Agenten-Browser bietet Chromium herunterladen an, wobei die Größe zuerst angegeben wird. Sobald es dort ist, verwenden Läufe mit ausgeschaltetem Fenster es; andernfalls verwenden die Agenten einen installierten Chrome oder Edge.