kaustubhupadhyaya/phone-reel-pipeline

Was macht phone-reel-pipeline?

Die End-to-End-Pipeline von Android zu Instagram-Reel. Das Telefon liefert das Filmmaterial (und optional Trend-Inspiration); der PC übernimmt die gesamte Bearbeitung; das Telefon erhält das fertige Reel, das der Nutzer per Hand postet. Diese Skill orchestriert ihre Geschwister-Skills – sie enthält keine eigenen Skripte und dupliziert keine deren Logik. Ein einziger Aufruf durchläuft die ganze Kette: Der Agent entsperrt das Telefon selbst (Tresor-PIN, kein Nutzer berührt das Telefon) und navigiert bei gewünschter Inspiration selbstständig durch die Edits-App.

Geschwister-Skills in diesem Repo – phone-reel-pipeline leitet an sie weiter, implementieren Sie sie nicht neu: phone-media-bridge verwaltet die Geräteverbindung, die Bildschirmsperre-Entsperrung und den Medienabruf/-transfer, ig-edits-inspiration verwaltet die Inspiration aus der Edits-App (Nur-Lesen-Erfassung plus eigenständige Navigation auf einem entsperrten Telefon), reel-maker verwaltet den Reel-Bau auf dem PC (und delegiert selbst an clip-picker und video-tool-router – rufen Sie diese beiden von hier aus niemals direkt auf). Lesen Sie die SKILL.md der Geschwister unter ihrem relativen Pfad vor jeder Phase; deren Dokumentation ist maßgeblich für Flags, Pfade und Fallstricke.

Wann verwenden

Auslöser: „End-to-End-Reel vom Telefon“, „Erstelle ein Reel aus meinen Handyaufnahmen“, „Telefon zu Reel“, „Hole vom Telefon und erstelle ein Reel“ oder jede Aufgabe, die Gerät → PC → Gerät in einem Durchlauf umfasst.

NICHT für:

• Reine PC-Bearbeitung mit bereits auf der Festplatte befindlichem Filmmaterial ohne Telefonbeteiligung → rufen Sie reel-maker direkt auf.
• Nur Inspiration („Was ist im Trend?“, „Fahrplan für diesen Schnitt“, noch kein Bau) → rufen Sie ig-edits-inspiration direkt auf.
• Posten → immer der Nutzer, auf dem Telefon, per Hand. Keine Skill in diesem Repo postet, plant oder lädt etwas hoch – Autoposten wurde explizit abgelehnt.

Arbeitsablauf

Phase 0 – Geräteprüfung + Entsperrung

Führen Sie adb devices -l aus. Finden Sie ADB über die Kette der Brückenskripte (Flag --adb, Umgebungsvariable ADB, PATH, dann den WinGet-Plattformtools-Fallback). Wenn die Geräteliste leer ist, STOPPEN Sie und drucken Sie diese Checkliste für den Benutzer:

1. WLAN: Telefon im selben WLAN wie der PC, Drahtloses Debugging EIN (erneut koppeln mit Code + adb connect <ip>:<port>, wenn die Verbindung weg ist).
2. USB: Datenfähiges Kabel (nicht reines Ladekabel), Dateiübertragung (MTP)-Modus, USB-Debugging aktiviert, RSA-Fingerabdruckaufforderung auf dem Telefon akzeptiert.

Wenn das Gerät als unauthorized angezeigt wird, fahren Sie nicht fort – bitten Sie den Benutzer, die RSA-Aufforderung auf dem Telefon zu akzeptieren, und führen Sie dann erneut adb devices -l aus. Fahren Sie nur fort, sobald das Gerät als device gelistet ist. Entsperren Sie dann für den autonomen Durchlauf (kein Benutzereingriff erforderlich):

C:\Python314\python.exe %USERPROFILE%\GitHub\editor-pack\skills\phone-media-bridge\scripts\unlock.py

ALREADY_UNLOCKED → fortfahren. VAULT_ENTRY_MISSING → sammeln Sie phone-1:password über das Tresor-Popup ein (python "%USERPROFILE%\.agents\skills\secure-vault\vault.py" gui --request "phone-1:password"), dann erneut ausführen. Vollständige Regeln in phone-media-bridge Phase 0b.

Phase 1 – Inspiration (OPTIONAL, nur wenn der Benutzer trendgeführte Bearbeitungen wünscht)

Stellen Sie eine Frage: Trendgeführt (Edits-Inspiration) oder direkter Bau (Referenzlink oder freie Gestaltung)? Wenn der Benutzer Trendführung wünscht, übergeben Sie an ig-edits-inspiration: Es erfasst aus der Edits-App (Nur-Lesen-Erfassung bevorzugt; eigenständige UI-Navigation auf dem entsperrten Telefon ist gemäß seiner Doktrin erlaubt) und gibt ein reel-maker-förmiges Rezept zurück. Dieses Rezept wird zur Bauspezifikation für Phase 3. Den Benutzer zu bitten, selbst durch Edits zu navigieren, ist der Schnellpfad-Fallback, keine Anforderung – der Agent steuert, wenn der Benutzer es nicht getan hat. Wenn der Benutzer die Inspiration überspringt, gehen Sie direkt zu Phase 2 – reel-maker Phase 1 akzeptiert bereits einen Referenzlink, sodass jeder vom Benutzer bereitgestellte Link unverändert mit der Übergabe reist.

Phase 2 – Medienabruf

Übergeben Sie an phone-media-bridge: Führen Sie dessen Inventarschritt aus, zeigen Sie dem Benutzer dann eine kompakte Zusammenfassung pro Ordner (Ordnername, Clip-Anzahl, Gesamtgröße – kein vollständiger Dateidump) und stellen Sie EINE Frage (Mehrfachauswahl), welche Ordner/Clips abgerufen werden sollen. Führen Sie dann dessen Abrufschritt aus. Das abgerufene Filmmaterial landet im Junction skills\phone-media-bridge\scripts\phone_pull (physisch auf D:\EditorPackArchive). Das Filmmaterial bleibt auf D: – Editoren lesen von dort, kopieren Sie es niemals auf C:. Fortsetzungssicher: Wenn das Telefon während des Abrufs getrennt wurde, führen Sie den Abruf erneut aus; siehe Fallstricke.

Phase 3 – PC-Bau

Rufen Sie den reel-maker-Ablauf mit dem Rezept aus Phase 1 (oder dem Referenzlink) plus dem Medienordner aus Phase 2 auf. reel-maker delegiert selbst an clip-picker + video-tool-router – duplizieren Sie diese Weiterleitung hier nicht. Zwei Dinge explizit übergeben: (a) Handyfilmmaterial ist oft HEVC/HDR, daher gilt die video-tool-router HLG 10-Bit-Absicherung (Tonemapping vor Grading/Untertitel-Einbrennung, sonst waschen die Farben aus); (b) HEVC-Decodierung ist langsam, daher wird Phase 3 die Laufzeit dominieren (siehe clip-picker-Fallstricke).

Phase 4 – Zurückschieben (GENEHMIGUNGSTOR)

FESTE REGEL: Schieben Sie NIE etwas auf das Telefon ohne die ausdrückliche Genehmigung des Benutzers für genau diese Datei in diesem Durchlauf. Der Abschluss von Phase 3 bedeutet NICHT die Erlaubnis zum Zurückschieben. Halten Sie am Ende von Phase 3 an und melden Sie den/die lokalen PC-Pfad(e), Dauer und Größe; fragen Sie „Auf Telefon schieben?“ und fahren Sie nur bei „Ja“ fort. Eine pauschale „Erstelle Reels“-Anweisung zählt niemals als Schiebe-Genehmigung.

Nach der Genehmigung übergeben Sie an den Push-Schritt von phone-media-bridge (push_reel.py): Schieben Sie das fertige reel_<name>_vN.mp4 auf das Telefon unter /sdcard/Movies/Reels. Überprüfen Sie, ob die Datei auf dem Gerät existiert (adb shell ls) und melden Sie ihre Byte-Größe im Vergleich zur PC-Kopie.

Phase 5 – Übergabe (der Benutzer postet)

Führen Sie den phone-media-bridge-Schritt aus, der Instagram auf dem Telefon öffnet (push_reel.py --open-app). Dann STOPPEN: Der BENUTZER postet, per Hand, in der Instagram-App. NIEMALS Autoposten – explizit abgelehnt. Melden Sie: den Reel-Pfad (Telefonpfad + PC-Pfad), die Versionsnummer und eine kurze Liste, was vor dem Posten zu überprüfen ist (Untertitel lesbar, Audio vorhanden, korrektes Seitenverhältnis).

Ausgabe

• reel_<name>_vN.mp4 auf dem Telefon (/sdcard/Movies/Reels/) plus die PC-Kopie, die im Projektordner aufbewahrt wird (versioniert; überschreibt niemals v1).
• Ein End-to-End-Statusbericht: pro Phase bestanden / übersprungen / fehlgeschlagen, Wanduhrzeit pro Phase, welcher Geschwister-Skill jede Phase bearbeitet hat, und ehrliche Einschränkungen (siehe unten). Beispielform: Phase 0 bestanden (Gerät <serial>, über Tresor entsperrt, 5 s) → Phase 1 übersprungen (Benutzer wählte direkten Bau) → Phase 2 bestanden (3 Clips, 1,2 GB, 4 min) → Phase 3 bestanden (reel_<name>_v1.mp4, 22 min) → Phase 4 bestanden (Push verifiziert, Größen stimmen überein) → Phase 5 übergeben (Instagram geöffnet, Benutzer muss posten).

Fallstricke

• Junction fehlt nach einem frischen Clone: skills\phone-media-bridge\scripts\phone_pull ist ein Junction nach D:\EditorPackArchive und überlebt einen frischen Clone nicht – erstellen Sie es gemäß der phone-media-bridge-Dokumentation vor Phase 2 neu.
• Telefon während des Durchlaufs getrennt: Abrufe sind fortsetzungssicher (Abrufschritt erneut ausführen); Übertragungen sind es nicht – führen Sie push_reel.py erneut aus und überprüfen Sie erneut mit adb shell ls.
• Telefon sperrt sich während des Durchlaufs erneut: unlock.py setzt einen Bleib-wach- + 30-Minuten-Timeout, aber ein Neustart oder manuelles Sperren aktiviert die Bildschirmsperre erneut – führen Sie unlock.py erneut aus (PIN bleibt im Tresor, kein Benutzereingriff erforderlich) und fahren Sie fort.
• HEVC-Decodierung ist langsam (clip-picker-Fallstrick): Kontaktblätter und Bewegungsbewertung über Handyfilmmaterial dauern länger als über H.264 – sagen Sie dies vorab, verringern Sie nicht die Abtastung, um dies auszugleichen.
• Niemals Autoposten: Keine UI-Automatisierung des Instagram-Post-Ablaufs, keine Planung, keine Uploads. Das Öffnen der App für den Benutzer ist der letzte automatisierte Schritt.

Regeln für ehrliche Berichterstattung

• Berichten Sie, was tatsächlich verifiziert vs. angenommen wurde, pro Phase: Geräteseriennummer in adb devices -l gesehen (nicht „Telefon verbunden“), Entsperrung über dumpsys verifiziert (nicht „Telefon offen“), Abruf-Byte-Zahlen abgeglichen (nicht „Dateien kopiert“), Push mit adb shell ls + Größenabgleich verifiziert, Instagram geöffnet (nicht „Reel gepostet“).
• Wenn eine Phase übersprungen wurde (z. B. keine Inspiration), sagen Sie dies explizit – implizieren Sie niemals, dass ihre Ausgabe existiert.
• Zeitmessung ehrlich: gemessene Wanduhrzeit pro Phase melden; HEVC-Transcodierungs-/Bewertungszeit ist echte Arbeit, kein Overhead, der versteckt werden muss.
• Qualitätseinschränkungen kennzeichnen, anstatt sie stillschweigend auszuliefern: wackelige Auswahlen, ausgewaschenes HDR, Grenzen bei der Wiederverwendung von geliehenem Audio (Reel-Maker Phase-5-Regeln gelten).