legends-obs-kit は何をしますか？
バンドルされているCLIを唯一の情報源として使用してください。ランタイムの中核はOBS WebSocket v5です。FFprobeとOBSログが録画の証明を提供します。
解決と資格確認
以下の順序でコマンドを解決します：
lobsまたはlegends-obs-kitがPATH上で利用可能な場合は、それを使用します。- このスキルがリポジトリからリンクされているか、リリースを展開したものである場合、
SKILL.mdから2つ上のディレクトリに移動し、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制御へのハードゲートです。エンコーダー、HDR、FFprobe、録画パス、マイクのチェックは、要求された操作にそれらが必要な場合に限り機能します。FFprobeがPATH上にない場合は、LEGENDS_OBS_FFPROBE_PATH にその実行可能ファイルを設定します。
マシンに台帳（ledger）がない場合は、audit:capture --reason first-baseline を実行します。台帳が存在する場合は、audit:diff --against good を実行します。最初に成功したカナリア（canary）が既知の良好ポインタを作成するまでは、--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、監査ドキュメント、ローカルのレシートには、マシンパス、ソース名、エンドポイントID、ウィンドウタイトル、その他のワークステーションの事実が含まれる可能性があります。ユーザーが明示的に共有を要求しない限り、これらはローカルに保持してください。
変更ルール
- まず現在の状態を読み取り、計画を立案します。
- 録画、ストリーミング、リプレイバッファー、バーチャルカメラがアイドル状態であることを確認します。
- デフォルトで
LEGENDS_OBS_DRY_RUN=trueを維持します。 - 1回の許可された書き込みについては、
falseに設定し、--confirmを渡し、1つの境界のある変更を実行し、finallyでドライランを復元します。 - すべてのプロファイル検査、計画、バックアップ、適用、またはリフレッシュ、およびすべての
record:canaryには、明示的な--preset <id>が必要です。バンドルされたプリセットがユーザーの推奨として選択されることはありません。 - プロファイル適用は、書き込み前にスナップショットを作成し、必要な場合にのみリフレッシュし、正確な読み戻しを検証します。
- 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、limited range、Standard NVENC AV1、Hybrid MP4、CQP20以上、2秒キーフレーム、シングルパス、リスケールなし。他のシステムへのデフォルト推奨ではありません。
オプションのビジョンスイッチャー
決定論的なパネルからシーンへのスイッチャーは、デフォルトで無効化され、ドライラン状態です。--panel A|B|C|D でパネルサンプルを提供するか、LEGENDS_OBS_PANEL_SENSOR に、文書化されたJSON形式を出力するPowerShellスクリプトを設定します。ライブカットにはさらに、武装状態、アイドル出力、LEGENDS_OBS_DRY_RUN=false、および --confirm が必要です。カットループは決してLLMを使用せず、Windowsの表示モードを変更しません。