legends-obs-kit은(는) 무엇을 하나요?
번들된 CLI를 진리 기준으로 사용하십시오. 런타임 중심은 OBS WebSocket v5입니다. FFprobe와 OBS 로그가 녹화 증명을 제공합니다.
확인 및 실행
다음 순서로 명령어를 확인하십시오:
PATH에lobs또는legends-obs-kit이 있으면 이를 사용합니다.- 이 스킬이 저장소 또는 릴리스 아카이브에서 연결된 경우,
SKILL.md에서 두 디렉토리 위로 이동하여node <root>\dist\index.js를 실행합니다. dist가 없는 개발자 체크아웃에서는 저장소 루트에서pnpm dev --를 실행합니다.
어느 것도 존재하지 않으면, 사용자에게 완전한 릴리스 또는 저장소를 설치하도록 안내하십시오. OBS 제어 백엔드를 임의로 생성하지 마십시오. 아래 예제에서 lobs는 확인된 호출 중 사용 가능한 것을 의미합니다.
lobs doctor --pretty
lobs manifest --pretty
lobs agent:context --pretty
lobs audit:status --pretty
doctor는 인증된 로컬 OBS 제어를 강력하게 차단(gate)합니다. 인코더, HDR, FFprobe, 녹화 경로, 마이크 점검은 요청된 작업에 필요하지 않은 경우 선택적 기능(capabilities)입니다. FFprobe가 PATH에 없으면 LEGENDS_OBS_FFPROBE_PATH를 FFprobe 실행 파일의 경로로 설정하십시오.
시스템에 원장(ledger)이 없으면 audit:capture --reason first-baseline을 실행하십시오. 원장이 존재하면 audit:diff --against good을 실행하십시오. 첫 번째 통과 캐너리(canary)가 알려진-양호(known-good) 포인터를 생성할 때까지 --against latest를 사용하십시오.
의도에 따른 라우팅
| 의도 | 명령어 |
|---|---|
| 상태 및 라이브 상태 | doctor, status, record:status |
| 시스템, 프로필, 장면 및 소스 | inventory, profile:show |
| 오디오 엔드포인트 | audio:status, audio:plan, audio:bind |
| 설정 기록 및 변경 감지 | audit:status, audit:capture, audit:show, audit:diff, audit:verify |
| 프로필 변경 | profile:plan, profile:backup, profile:apply, profile:refresh, profile:rollback |
| 로컬 녹화 | record:start, record:stop, record:canary |
| 증거 | logs:latest, receipts:list, receipts:verify |
| 선택적 패널 장면 전환기 | vision-switch:* |
자세한 명령어 및 안전 맵은 references/command-map.md를 참조하십시오.
기본 출력은 에이전트 사용을 위해 개인정보가 최소화됩니다. inventory --full, audio:status --include-devices, 감사 문서, 로컬 영수증(receipts)에는 시스템 경로, 소스 이름, 엔드포인트 ID, 창 제목 및 기타 워크스테이션 정보가 포함될 수 있습니다. 사용자가 명시적으로 공유를 요청하지 않는 한 로컬에서 유지하십시오.
변경 규칙
- 먼저 현재 상태를 읽고 계획을 수립하십시오.
- 녹화, 스트리밍, 리플레이 버퍼, 가상 카메라가 유휴 상태인지 확인하십시오.
- 기본적으로
LEGENDS_OBS_DRY_RUN=true를 유지하십시오. - 한 번의 승인된 쓰기(write)를 위해
false로 설정하고,--confirm을 전달하며, 하나의 제한된 변경을 수행한 후finally블록에서 Dry-Run을 복원하십시오. - 모든 프로필 검사, 계획, 백업, 적용, 새로고침 및
record:canary는 명시적인--preset <id>가 필요합니다. 번들된 프리셋은 사용자 추천으로 선택되지 않습니다. - 프로필 적용은 쓰기 전에 스냅샷을 생성하고, 필요할 때만 새로고침하며, 정확한 읽기-확인(readback)을 검증합니다.
- OBS WebSocket 비밀번호 또는 OBS 서비스 자격 증명을 절대 출력하거나 복사하지 마십시오.
- 통과 캐너리 영수증 없이 녹화를
WORKS라고 부르지 마십시오. latest를 마지막으로 관찰된 상태로 취급하고 증명된 것으로 취급하지 마십시오. 통과 캐너리만이last-known-good을 갱신합니다.--require-microphone은 마이크 캡처가 사용자의 수락 기준에 포함된 경우에만 사용하십시오.
하드웨어 결정
어떤 번들 프리셋도 보편적으로 올바른 것으로 취급하지 마십시오. 사용 가능한 인코더, 현재 해상도/FPS, 색상 포맷, 디스플레이 경로, 저장 공간, 오디오 요구 사항 및 대상 플랫폼을 검사하십시오. 장단점을 설명하고, profile:plan을 실행하며, 사용자가 요청한 결과에 따라 프리셋을 선택하도록 하십시오.
번들된 hdr-4k60-av1-hybrid-mp4 프리셋은 적합한 NVIDIA 하드웨어를 위한 테스트된 참조입니다: 3840×2160/60, P010, Rec.2100 PQ, 제한된 범위, Standard NVENC AV1, Hybrid MP4, CQP20 이상, 2초 키프레임, 단일 패스, 리스케일 없음. 이는 다른 시스템을 위한 기본 권장 사항이 아닙니다.
선택적 비전 스위처
결정론적 패널-장면 전환기는 기본적으로 비활성화(disarm) 및 Dry-Run 상태입니다. --panel A|B|C|D로 패널 샘플을 제공하거나 LEGENDS_OBS_PANEL_SENSOR를 문서화된 JSON 형태를 출력하는 PowerShell 스크립트로 설정하십시오. 라이브 전환을 위해서는 추가로 무장(armed) 상태, 유휴 출력, LEGENDS_OBS_DRY_RUN=false, --confirm이 필요합니다. 전환 루프는 LLM을 사용하지 않으며 Windows 디스플레이 모드를 변경하지 않습니다.