legends-obs-kit 是做什麼的？
使用捆綁的 CLI 作為事實來源。執行骨幹為 OBS WebSocket v5；FFprobe 與 OBS 日誌則提供錄製證明。
解析與識別
按照此順序解析命令：
- 若
lobs或legends-obs-kit存在於PATH中，則優先使用。 - 若此技能是從儲存庫連結或解壓縮的發行版中取得，請從
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 控制。編碼器、HDR、FFprobe、錄製路徑與麥克風檢查屬於功能範疇，除非請求的操作需要它們。若 FFprobe 不在 PATH 上，請將 LEGENDS_OBS_FFPROBE_PATH 設定為其可執行檔路徑。
若機器上沒有分類帳，請執行 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。 - 對於一次授權的寫入操作，將其設為
false，傳遞--confirm，執行一次有界限的變更，並在finally區塊中恢復乾執行模式。 - 每次設定檔檢查、計劃、備份、套用或重新整理，以及每次
record:canary，都需要明確指定--preset <id>；絕不將預設的捆綁預設值推薦給使用者。 - 設定檔套用在寫入前會建立快照，僅在必要時重新整理，並驗證精確的回讀。
- 絕不列印或複製 OBS WebSocket 密碼或 OBS 服務憑證。
- 在沒有通過 canary 收據的情況下，絕不能稱錄製為
WORKS。 - 將
latest視為最後觀察到的狀態，而非經過驗證的狀態。只有通過的 canary 測試才能推進last-known-good。 - 僅在使用者的驗收標準包含麥克風擷取時，才使用
--require-microphone。
硬體決策
不要將任何捆綁的預設值視為普遍適用。請檢查可用的編碼器、目前解析度/FPS、色彩格式、顯示路徑、儲存空間、音訊需求與目標平台。解釋各項取捨，執行 profile:plan，並讓使用者要求的結果來選擇預設值。
捆綁的 hdr-4k60-av1-hybrid-mp4 預設值是針對具備足夠效能的 NVIDIA 硬體所測試的參考：3840×2160/60、P010、Rec.2100 PQ、有限範圍、標準 NVENC AV1、Hybrid MP4、CQP20 或更佳、兩秒關鍵影格、單次編碼、無縮放。這並非其他系統的預設建議。
可選的視覺切換器
確定性的面板對場景切換器預設為解除武裝且處於乾執行模式。請使用 --panel A|B|C|D 提供面板樣本，或將 LEGENDS_OBS_PANEL_SENSOR 設定為會發出已記錄之 JSON 格式資料的 PowerShell 指令碼。即時切換還需要武裝狀態、閒置的輸出、LEGENDS_OBS_DRY_RUN=false 以及 --confirm。切換迴圈絕不使用 LLM，也絕不變更 Windows 顯示模式。