Bug melden
Dies ist der Support-Eingang für chengfeng-videocut, kein dritter Schnitt-Workflow. Standardmäßig wird nur ein öffentlicher Issue-Entwurf erstellt; externe Einreichungen müssen über Anonymisierungsvorschau und Benutzerbestätigung erfolgen.
Problembeschreibung
|
v
Minimale Read-Only-Diagnose -> Anonymisierung -> Repository / Titel / Text anzeigen
|
Benutzer bestätigt explizit
|
v
Authentifizierung + Label-Prüfung + Dublettencheck
|
v
GitHub Issue erstellen
1. Bestätigen, dass es sich um einen reproduzierbaren Bug handelt
Zunächst unterscheiden:
- Bug: Tatsächliches Verhalten weicht von bestehenden Verträgen, der Benutzeroberfläche, Versionsfunktionen oder deterministischen Ergebnissen ab.
- Funktionswunsch: Das Produkt hat diese Funktion nie versprochen; nicht als Bug tarnen.
- Nutzungsfrage: Zuerst beantworten oder diagnostizieren, nicht automatisch melden.
Sammle nur die minimalen Fakten, die zur Reproduktion erforderlich sind. Keine Runtime installieren, kein Studio starten, keine Projekte ändern, keine Clips neu schneiden oder Medien hochladen, um „Beweise zu sammeln“. Wenn eine Runtime vorhanden ist, kann node scripts/ensure-runtime.cjs --json aus dem Plugin-Stammverzeichnis ausgeführt werden (Read-Only), wobei nur state / kind / version / healthy / error.code beibehalten werden; keine vollständige doctor-Ausgabe anhängen. kind=desktop-managed bedeutet nur, dass die Installation von der Desktop-App stammt, berechtigt diese Skill aber nicht, die App, Dienste zu starten oder neu zu installieren. Wenn nicht vorhanden, schreibe „nicht erkannt“.
2. Festes Repository auswählen
Das Arbeitsbereichs-Stammverzeichnis ist nicht unbedingt ein Git-Repository; verbiete, das Remote aus dem aktuellen Verzeichnis zu erraten:
| Problemkomponente | target | GitHub Repository |
|---|---|---|
| Runtime, Studio, UI, CLI, API, Timeline, Rendering | product | Agentchengfeng/chengfeng-videocut |
| Skill, Marketplace, Installationsorchestrierung, MCP App, Workflow-Anleitung | skills | Agentchengfeng/chengfeng-videocut-skills |
Bei übergreifenden Komponenten-Problemen priorisiere das Repository, das zuerst den Vertrag verletzt, und beschreibe die andere Komponente im Text; wenn nicht eindeutig, den Benutzer fragen.
3. Strukturierte Eingabe generieren
Schreibe den Kandidaten mit umask 077 als JSON in das temporäre Verzeichnis des aktuellen Tasks, nicht in Produkt-Spezifikationsdateien; lösche nach der Einreichung das temporäre JSON und Markdown:
{
"schemaVersion": 1,
"target": "product",
"component": "Studio",
"title": "Runtime 0.1.1 kann HyperFrames-Ansicht des oberen Schnittfensters nicht öffnen",
"summary": "Ein Satz: Auswirkung beschreiben",
"steps": ["Erster Schritt", "Zweiter Schritt"],
"expected": "Erwartetes Verhalten",
"actual": „Tatsächliches Verhalten",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": [„Nur minimale, öffentlich zugängliche Diagnose“],
"acceptance": [„Überprüfbare Reparaturbedingungen“]
}
Nicht zulässig:
- API-Key, Token, Cookie,
.env; - Video, Audio, Screenshots, vollständige Logs oder Transkripte;
- Kundenname, ursprünglicher Videodateiname, echte
projectId, absolute Benutzerpfade; - Private Repository-Inhalte ohne Zustimmung des Benutzers.
4. Anonymisierten Entwurf erstellen und anzeigen
Suche das Skript aus dem aktuellen SKILL.md:
Zunächst das Plugin-Stammverzeichnis gemäß Auf Updates prüfen „Bereitschaftsprüfung“ Schritt 1 ermitteln (vom tatsächlichen Quellpfad dieser Skill aus zwei Ebenen nach oben; nicht codex plugin list ausführen oder andere Cache-Pfade durchsuchen; ersetze <Plugin-Stamm> durch diesen wörtlichen Pfad). Diese Skill verwendet es nur zum Lokalisieren des Skripts, installiert keine Runtime und startet keine Dienste:
node "<Plugin-Stamm>/skills/chengfeng-report-bug/scripts/report-bug.cjs" draft --input "<Berichts-JSON-Datei>" --output "<Entwurf-Ausgabedatei>" --json
target muss eindeutig product oder skills sein; bei Fehlen oder Tippfehlern anhalten, nicht stillschweigend auf ein anderes Repository umleiten. Das Skript bereinigt gängige Schlüssel, lokale Benutzernamen, Volume-Namen, Pfadreste und localhost-Abfrageparameter; automatische Anonymisierung kann keinen beliebigen Kundennamen erkennen, daher muss der Benutzer noch einmal manuell durchlesen. Dem Benutzer anzeigen:
repo
label=bug
title
Vollständig anonymisierter Text
Gleichzeitig die zurückgegebene confirmationReceipt speichern und dem Benutzer confirmationToken sowie Ablaufzeit anzeigen. Ohne explizite Bestätigung dieser öffentlichen Inhalte durch den Benutzer anhalten; die bloße Erkennung eines Fehlers ist keine Zustimmung zur Meldung. Der Token ist nur an den Entwurf gebunden und belegt nicht automatisch die Zustimmung des Benutzers; der Agent muss weiterhin auf eine eindeutige Antwort warten. Die Bestätigung gilt nur für die unmittelbar folgende Einreichung im aktuellen Task, läuft nach 30 Minuten ab und kann nicht Task-übergreifend oder wiederholt verwendet werden.
5. Nach Bestätigung einreichen
Nur den gerade angezeigten, unveränderten Entwurf einreichen:
node "<Plugin-Stamm>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<Berichts-JSON-Datei>" --target "<Ziel-Repository>" --confirmed --confirm-token "<Bestätigungs-Token>" --receipt "<Bestätigungsbeleg-Datei>" --json
Feste Regeln:
- Vor der Einreichung prüft das Skript
gh auth status, das Ziel-Repository Issues und das Labelbug; bei Fehlschlag bleibt der Entwurf erhalten. - Wenn ein Issue mit gleicher Komponente, gleichen Reproduktionsschritten und gleichem tatsächlichem Ergebnis existiert, wird die vorhandene Issue-URL zurückgegeben; nicht mit einem vagen Titel vorgeben, es sei ein Duplikat.
- Wenn sich der Text nach der Bestätigung ändert, wird
confirmation_mismatchzurückgegeben; erneut in der Vorschau anzeigen. - Wenn der Bestätigungsbeleg abgelaufen oder bereits verwendet wurde, wird
confirmation_expired / confirmation_replayedzurückgegeben; erneut in der Vorschau anzeigen. - Wenn das Erstellungsergebnis keine eindeutige Issue-URL enthält, nicht automatisch wiederholen; es könnte bereits erstellt worden sein.
- Nur wenn eine GitHub Issue-URL vorliegt, darf „bereits gemeldet“ gesagt werden.
Fehlerbehandlung
github_auth_required: Erklären, dass der Entwurf fertig, aber nicht eingereicht ist; Erfolg nicht behaupten.github_issue_create_failed: Entwurf und manuelle Eingabeoptionen beibehalten; keine Schleifenwiederholung.confirmation_required/confirmation_mismatch: Exakten öffentlichen Inhalt erneut anzeigen.- Keine Berechtigung oder Sichtbarkeit für das Ziel-Repository: Nicht stillschweigend ein anderes Repository melden; den Benutzer entscheiden lassen, ob das öffentliche Skills-Repository stattdessen gemeldet werden soll.