avalonreset/legends-obs-kit

O que legends-obs-kit faz?

Use a CLI fornecida como fonte da verdade. A espinha dorsal de execução é o OBS WebSocket v5; FFprobe e o log do OBS fornecem a prova da gravação.

Resolver e qualificar

Resolva o comando nesta ordem:

1. Use lobs ou legends-obs-kit quando estiver disponível no PATH.
2. Se esta skill estiver vinculada a um repositório ou a uma release extraída, suba dois diretórios a partir de SKILL.md e execute node <raiz>\dist\index.js.
3. Em um checkout de desenvolvimento sem dist, execute pnpm dev -- a partir da raiz do repositório.

Se nenhum existir, informe ao usuário para instalar a release ou repositório completo. Não invente um backend de controle do OBS. Nos exemplos abaixo, lobs significa qualquer invocação resolvida que estiver disponível.

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

doctor impõe um bloqueio rígido (hard-gate) para controle autenticado do OBS local. Verificações de codificador, HDR, FFprobe, caminho de gravação e microfone são capacidades, a menos que a operação solicitada as exija. Se o FFprobe não estiver no PATH, defina LEGENDS_OBS_FFPROBE_PATH para seu executável.

Se a máquina não tiver um livro-razão (ledger), execute audit:capture --reason first-baseline. Se existir um livro-razão, execute audit:diff --against good; use --against latest até que o primeiro teste (canary) bem-sucedido crie um ponteiro de referência conhecido.

Roteamento por intenção

Intenção	Comandos
Saúde e estado ativo	doctor, status, record:status
Máquina, perfil, cenas e fontes	inventory, profile:show
Ponto final de áudio	audio:status, audio:plan, audio:bind
Histórico de configurações e desvios	audit:status, audit:capture, audit:show, audit:diff, audit:verify
Alteração de perfil	profile:plan, profile:backup, profile:apply, profile:refresh, profile:rollback
Gravação local	record:start, record:stop, record:canary
Evidências	logs:latest, receipts:list, receipts:verify
Troca de cena por painel (opcional)	vision-switch:*

Leia references/command-map.md para o mapa compacto de comandos e segurança.

A saída padrão é minimizada para privacidade, adequada para uso por agente. inventory --full, audio:status --include-devices, documentos de auditoria e recibos locais podem incluir caminhos de máquina, nomes de fontes, IDs de endpoints, títulos de janelas e outros fatos da estação de trabalho; mantenha-os localmente, a menos que o usuário peça explicitamente para compartilhá-los.

Regras de mutação

1. Leia o estado atual e produza um plano primeiro.
2. Verifique se a gravação, transmissão, buffer de repetição e câmera virtual estão ociosos.
3. Mantenha LEGENDS_OBS_DRY_RUN=true por padrão.
4. Para uma gravação autorizada, defina-o como false, passe --confirm, execute uma mutação limitada e restaure a execução simulada em um bloco finally.
5. Toda inspeção de perfil, plano, backup, aplicação ou atualização e todo record:canary exigem um --preset <id> explícito; presets fornecidos nunca são selecionados como recomendação ao usuário.
6. A aplicação de perfil tira instantâneos antes de escrever, atualiza somente quando necessário e verifica a leitura exata de volta.
7. Nunca imprima ou copie a senha do OBS WebSocket ou as credenciais do serviço OBS.
8. Nunca chame uma gravação de FUNCIONA sem um recibo de teste (canary) bem-sucedido.
9. Trate latest como o último observado, não comprovado. Apenas um canary bem-sucedido avança o last-known-good.
10. Use --require-microphone somente quando a captura do microfone fizer parte dos critérios de aceitação do usuário.

Decisões de hardware

Não trate nenhum preset fornecido como universalmente correto. Inspecione os codificadores disponíveis, resolução/FPS atual, formato de cor, caminho de exibição, armazenamento, necessidades de áudio e plataforma alvo. Explique as compensações, execute profile:plan e deixe que o resultado solicitado pelo usuário selecione o preset.

O preset fornecido hdr-4k60-av1-hybrid-mp4 é uma referência testada para hardware NVIDIA capaz: 3840×2160/60, P010, Rec.2100 PQ, faixa limitada, Standard NVENC AV1, Hybrid MP4, CQP20 ou melhor, keyframes de dois segundos, passagem única e sem redimensionamento. Não é uma recomendação padrão para outros sistemas.

Troca de cena por visão opcional

O trocador determinístico de painel para cena está desarmado e em execução simulada por padrão. Forneça amostras de painel com --panel A|B|C|D ou defina LEGENDS_OBS_PANEL_SENSOR para um script PowerShell que emita a estrutura JSON documentada. Cortes ao vivo adicionalmente exigem um estado armado, saídas ociosas, LEGENDS_OBS_DRY_RUN=false e --confirm. O loop de corte nunca usa um LLM e nunca altera o modo de exibição do Windows.