avalonreset/legends-obs-kit

Was macht legends-obs-kit?

Verwenden Sie die gebündelte CLI als maßgebliche Quelle. Das Laufzeitgerüst ist OBS WebSocket v5; FFprobe und das OBS-Protokoll liefern den Aufzeichnungsnachweis.

Auflösen und qualifizieren

Lösen Sie den Befehl in dieser Reihenfolge auf:

1. Verwenden Sie lobs oder legends-obs-kit, wenn es auf PATH verfügbar ist.
2. Wenn dieses Skill aus einem Repository oder einer extrahierten Version verknüpft ist, gehen Sie zwei Verzeichnisse über SKILL.md nach oben und führen Sie node <root>\dist\index.js aus.
3. In einem Entwickler-Checkout ohne dist führen Sie pnpm dev -- aus dem Repository-Stammverzeichnis aus.

Wenn keine dieser Optionen existiert, teilen Sie dem Benutzer mit, die vollständige Version oder das Repository zu installieren. Erfinden Sie kein OBS-Steuerungs-Backend. In den Beispielen unten steht lobs für den jeweils verfügbaren aufgelösten Aufruf.

lobs doctor --pretty
lobs manifest --pretty
lobs agent:context --pretty
lobs audit:status --pretty

doctor setzt eine harte Zugangssperre für authentifizierte lokale OBS-Steuerung voraus. Encoder-, HDR-, FFprobe-, Aufnahmepfad- und Mikrofonprüfungen sind Fähigkeiten, sofern die angeforderte Operation sie nicht benötigt. Wenn FFprobe nicht auf PATH ist, setzen Sie LEGENDS_OBS_FFPROBE_PATH auf dessen ausführbare Datei.

Wenn die Maschine kein Ledger hat, führen Sie audit:capture --reason first-baseline aus. Wenn ein Ledger existiert, führen Sie audit:diff --against good aus; verwenden Sie --against latest, bis der erste erfolgreiche Canary einen bekannten-guten Zeiger erstellt.

Nach Absicht routen

Absicht	Befehle
Gesundheit und Live-Status	doctor, status, record:status
Maschine, Profil, Szenen und Quellen	inventory, profile:show
Audio-Endpunkt	audio:status, audio:plan, audio:bind
Einstellungshistorie und Abweichung	audit:status, audit:capture, audit:show, audit:diff, audit:verify
Profiländerung	profile:plan, profile:backup, profile:apply, profile:refresh, profile:rollback
Lokale Aufnahme	record:start, record:stop, record:canary
Nachweise	logs:latest, receipts:list, receipts:verify
Optionaler Panel-Szenenwechsler	vision-switch:*

Lesen Sie references/command-map.md für die kompakte Befehls- und Sicherheitsübersicht.

Standardausgabe ist datenschutzminimiert für die Agentennutzung. inventory --full, audio:status --include-devices, Prüfdokumente und lokale Quittungen können Maschinenpfade, Quellennamen, Endpunkt-IDs, Fenstertitel und andere Arbeitsplatzfakten enthalten; halten Sie diese lokal, es sei denn, der Benutzer bittet ausdrücklich um deren Weitergabe.

Mutationsregeln

1. Lesen Sie den aktuellen Zustand und erstellen Sie zuerst einen Plan.
2. Stellen Sie sicher, dass Aufnahme, Streaming, Replay-Puffer und virtuelle Kamera inaktiv sind.
3. Behalten Sie standardmäßig LEGENDS_OBS_DRY_RUN=true bei.
4. Für einen autorisierten Schreibzugriff setzen Sie ihn auf false, übergeben Sie --confirm, führen Sie eine begrenzte Mutation durch und stellen Sie den Trockenlauf in finally wieder her.
5. Jede Profilinspektion, -planung, -sicherung, -anwendung oder -aktualisierung sowie jeder record:canary benötigt ein explizites --preset <id>; gebündelte Voreinstellungen werden niemals als Benutzerempfehlung ausgewählt.
6. Profilanwendungen erstellt Schnappschüsse vor dem Schreiben, führt Aktualisierungen nur bei Bedarf durch und überprüft die exakte Rücklesung.
7. Geben Sie niemals das OBS-WebSocket-Passwort oder die OBS-Dienst-Anmeldeinformationen aus oder kopieren Sie sie.
8. Bezeichnen Sie eine Aufnahme niemals als WORKS ohne eine erfolgreiche Canary-Quittung.
9. Behandeln Sie latest als zuletzt beobachtet, nicht als bewiesen. Nur ein erfolgreicher Canary rückt last-known-good weiter.
10. Verwenden Sie --require-microphone nur, wenn die Mikrofonaufnahme Teil der Akzeptanzkriterien des Benutzers ist.

Hardware-Entscheidungen

Behandeln Sie keine gebündelte Voreinstellung als universell korrekt. Inspizieren Sie verfügbare Encoder, aktuelle Auflösung/Bildrate, Farbformat, Anzeigepfad, Speicher, Audioanforderungen und Zielplattform. Erklären Sie Kompromisse, führen Sie profile:plan aus und lassen Sie das vom Benutzer angeforderte Ergebnis die Voreinstellung auswählen.

Die gebündelte Voreinstellung hdr-4k60-av1-hybrid-mp4 ist eine getestete Referenz für leistungsfähige NVIDIA-Hardware: 3840×2160/60, P010, Rec.2100 PQ, eingeschränkter Bereich, Standard NVENC AV1, Hybrid MP4, CQP20 oder besser, Zwei-Sekunden-Keyframes, Einzeldurchlauf und keine Neuberechnung. Sie ist keine Standardempfehlung für andere Systeme.

Optionaler Vision Switcher

Der deterministische Panel-zu-Szene-Wechsler ist standardmäßig deaktiviert und im Trockenlauf. Liefern Sie Panel-Beispiele mit --panel A|B|C|D oder setzen Sie LEGENDS_OBS_PANEL_SENSOR auf ein PowerShell-Skript, das die dokumentierte JSON-Form ausgibt. Live-Schnitte erfordern zusätzlich einen bewaffneten Zustand, inaktive Ausgaben, LEGENDS_OBS_DRY_RUN=false und --confirm. Die Schnittschleife verwendet kein LLM und ändert niemals den Windows-Anzeigemodus.