avalonreset/legends-obs-kit

¿Qué hace legends-obs-kit?

Utiliza la CLI incluida como fuente de verdad. La columna vertebral en tiempo de ejecución es OBS WebSocket v5; FFprobe y el registro de OBS proporcionan la prueba de grabación.

Resolver y calificar

Resuelve el comando en este orden:

1. Usa lobs o legends-obs-kit cuando esté disponible en PATH.
2. Si esta habilidad está vinculada desde un repositorio o una versión extraída, muévete dos directorios arriba desde SKILL.md y ejecuta node <raíz>\dist\index.js.
3. En un checkout de desarrollo sin dist, ejecuta pnpm dev -- desde la raíz del repositorio.

Si no existe ninguno, dile al usuario que instale la versión completa o el repositorio. No inventes un backend de control de OBS. En los siguientes ejemplos, lobs significa cualquiera de las invocaciones resueltas que esté disponible.

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

doctor bloquea de forma segura el control local autenticado de OBS. Las comprobaciones de codificador, HDR, FFprobe, ruta de grabación y micrófono son capacidades a menos que la operación solicitada las necesite. Si FFprobe no está en PATH, establece LEGENDS_OBS_FFPROBE_PATH en su ejecutable.

Si la máquina no tiene un libro de contabilidad, ejecuta audit:capture --reason primera-linea-base. Si existe un libro de contabilidad, ejecuta audit:diff --against bueno; usa --against ultimo hasta que el primer canario exitoso cree un puntero de referencia conocido.

Enrutar por intención

Intención	Comandos
Estado de salud y en vivo	doctor, status, record:status
Máquina, perfil, escenas y fuentes	inventory, profile:show
Punto final de audio	audio:status, audio:plan, audio:bind
Historial de configuración y desviación	audit:status, audit:capture, audit:show, audit:diff, audit:verify
Cambio de perfil	profile:plan, profile:backup, profile:apply, profile:refresh, profile:rollback
Grabación local	record:start, record:stop, record:canary
Evidencia	logs:latest, receipts:list, receipts:verify
Cambiador de escenas por panel opcional	vision-switch:*

Lee references/command-map.md para el mapa compacto de comandos y seguridad.

La salida predeterminada está minimizada en privacidad para uso del agente. inventory --full, audio:status --include-devices, documentos de auditoría y recibos locales pueden incluir rutas de máquina, nombres de fuentes, IDs de puntos finales, títulos de ventanas y otros hechos de la estación de trabajo; mantenlos locales a menos que el usuario solicite explícitamente compartirlos.

Reglas de mutación

1. Lee el estado actual y genera un plan primero.
2. Verifica que la grabación, transmisión, búfer de repetición y cámara virtual estén inactivos.
3. Mantén LEGENDS_OBS_DRY_RUN=true por defecto.
4. Para una escritura autorizada, establécela en false, pasa --confirm, realiza una mutación acotada y restaura el modo dry-run en finally.
5. Cada inspección, plan, copia de seguridad, aplicación o actualización de perfil y cada record:canary requiere un --preset <id> explícito; los presets incluidos nunca se seleccionan como recomendación del usuario.
6. La aplicación de perfil toma instantáneas antes de escribir, actualiza solo cuando es necesario y verifica la lectura exacta.
7. Nunca imprimas ni copies la contraseña de OBS WebSocket ni las credenciales del servicio de OBS.
8. Nunca llames a una grabación WORKS sin un recibo de canario exitoso.
9. Trata ultimo como lo último observado, no probado. Solo un canario exitoso avanza ultimo-conocido-bueno.
10. Usa --require-microphone solo cuando la captura de micrófono sea parte de los criterios de aceptación del usuario.

Decisiones de hardware

No trates ningún preset incluido como universalmente correcto. Inspecciona los codificadores disponibles, la resolución/FPS actual, el formato de color, la ruta de visualización, el almacenamiento, las necesidades de audio y la plataforma de destino. Explica las compensaciones, ejecuta profile:plan y deja que el resultado solicitado por el usuario seleccione el preset.

El preset incluido hdr-4k60-av1-hybrid-mp4 es una referencia probada para hardware NVIDIA capaz: 3840×2160/60, P010, Rec.2100 PQ, rango limitado, Standard NVENC AV1, Hybrid MP4, CQP20 o mejor, keyframes de dos segundos, una sola pasada y sin reescalado. No es una recomendación predeterminada para otros sistemas.

Cambiador de visión opcional

El cambiador determinista de panel a escena está desarmado y en modo dry-run por defecto. Proporciona muestras de panel con --panel A|B|C|D o establece LEGENDS_OBS_PANEL_SENSOR en un script de PowerShell que emita la forma JSON documentada. Los cortes en vivo requieren además un estado armado, salidas inactivas, LEGENDS_OBS_DRY_RUN=false y --confirm. El bucle de corte nunca utiliza un LLM y nunca cambia el modo de visualización de Windows.