FUN SFX
請將此資料夾視為技能根目錄。執行指令前應先解析其位置；使用者的工作目錄可能在其他地方。Python 3.10+ 支援探索功能；音訊匯出亦需在 PATH 上安裝 FFmpeg。
尋找音效
執行 python3 <skill-root>/scripts/sfx.py search "whoosh" --json 以取得候選音效（包含絕對音訊路徑）。搜尋也接受場景描述，例如 "failed attempt" 或 "photo capture"。它會比對標題、ID、類別、標籤、建議用途和範例；多個詞彙必須全部命中。刻意排除負面指引。執行 list --json 取得完整收藏，或執行 show <id> 取得完整記錄。閱讀目錄可獲得人性化概覽。
每個提供的錄音都有一份個別的使用案例指南：包含推薦場景、時機、應避免的情況以及範例編輯。請使用記錄中的 usage 欄位為場景選擇音效，而不僅是匹配的類別。這些是創意推薦，非強制使用。
標籤仍以檔名推斷。請檢查 audio_review.status：七個錄音有自動音訊分析備註；另外 64 個則有基於檔名的推薦（未確認聽覺內容）。自動備註也可能誤判語音；請留意 audio_review.uncertainty。沒有任何錄音宣稱經過人工試聽。在選擇前請先試聽候選音效，特別是像「Walmart」、「Whoop」或「Spotlight」這類模糊名稱。檔案可能包含語音、音樂、靜音、多種效果或突然的音量變化。電影級嗖聲收藏和長篇恐怖片段需要選取節段。時機參考是相對於視覺動作，而非已驗證的來源進/出點。
準備音效提示
python3 <skill-root>/scripts/sfx.py export <id> /absolute/output/cue.wav --start 0.2 --duration 0.8 --gain-db -8 --fade-ms 10
輸出為立體聲 PCM WAV，取樣率 48 kHz。--start 是來源偏移量；時間軸放置是獨立的編輯步驟。若輸出檔案已存在，指令會拒絕執行。請保留原始錄音完整性。使用適度增益，保持對話清晰，並試聽最終混音；單一音量設定並不適用於所有錄音。
請使用使用者既有的影片編輯器或編輯工具來放置準備好的提示。閱讀 editing.md 可取得提示表欄位、時機指導和 FFmpeg 混音範例。記錄所選的 ID、來源節段、時間軸位置和增益，以便編輯可重現。請勿預設在每個剪輯處都添加音效。
權限與完整性
FUN SFX 維護者並不擁有任何內建音效的所有權。所有權利均歸各自所有者。在呈現或包裝音效收藏時，請保留此所有權聲明。
程式碼和文件採用 MIT 授權。內建錄音和匯出的音訊具有未驗證的權利，不包含在該授權範圍內；請參閱 ASSET_LICENSE.md。請勿將錄音描述為 MIT、免版稅或已清除再散布權限。檔案名稱包含「no copyright」並不構成授權證據。在移交編輯成果或包裝此技能時，請保留此區別。
在下載或修改過的套件時，請執行 python3 <skill-root>/scripts/sfx.py verify。catalog.json 包含可攜式路徑、技術中繼資料以及每個原始和可用音訊檔案的 SHA-256 校驗碼。