framechord 是做什麼的？
從任何能執行程序的代理中使用 framechord 二進位檔。如果缺少該檔案，請閱讀安裝以取得公開安裝程式、使用者本機安裝和明確更新，或說明 cargo install --path /path/to/framechord 進行原始碼簽出。請勿在技能內部切換媒體工具或進行提供者 API 呼叫。
支援原地運作現有的 mediaagent/ 專案。在升級較舊的安裝前，請閱讀重新命名與舊版專案；使用回傳的 data_directory 路徑，而非假設資料夾名稱。
閱讀指令以了解此二進位版本中的每個指令與旗標；工作流程了解輸出、限制、復原與審查；作者指南了解角色與資訊圖表範本。機器可讀的架構位於 references/schemas/。匯出的範本位於 templates/。
當跨場景重複使用相同角色時，請閱讀角色連續性。使用選定的身份參考、支援的保真度控制，以及與實際原始圖片的比較；API 成功不代表肖像相似度。
閱讀連線檢查以檢查設定或提供者/金鑰失敗：doctor 離線檢查存在性；doctor --live 以唯讀請求明確進行身分驗證。它支援提供者過濾、逾時和 JSON。閱讀各提供者的狀態/動作；成功的身分驗證不代表生成/模型/計費就緒。
閱讀語音以探索語音、設計預覽、接受已授權的錄音，或明確建立/複製/綁定選定的提供者語音。預覽生成、提供者端建立、規範綁定與接受錄音是獨立操作。
閱讀設定與目前模型以了解循環終端機精靈、Google 優先的預設值與明確的 OpenAI 替代方案、保留專案 .env 設定、遮罩憑證與專案技能安裝、非互動式設定就緒、模型篩選器與明確的目錄重新整理。對於單一資產，使用明確的目前提供者/模型/輸入/輸出旗標，無需初始化。對於重複性工作，代理使用 init PATH --preset recommended --json --non-interactive，檢查 config status --json，並在需要時以 config setup --file 提供精確配置。人類終端使用者執行 init 以繼續設定。初始化期間不會進行提供者呼叫。現有角色模型鎖定會被保留；已退役模型的身份需要建立新角色版本，並在再次生成前由人類接受參考。
精確保留要求的對白、歌詞、數字與標籤。在將文章改編為播客時，使用單獨明確的規劃操作。將文章文字提供在本機檔案中。角色是選用的；選定時，重複使用其已接受的參考與固定的語音/提供者/模型。衍生的身份資產必須使用原始資產的記錄提供者/模型；衝突的覆寫會失敗。保留原始元資料，而非將專案預設值複製到衍生作業 YAML 中。將穩定身份與姿勢、場景、表達或臨時服裝分開描述。候選參考需要使用者選擇後才能接受。
使用範本編寫檔案，然後執行 validate。在輸入是新項目時，先檢查 generate --job ... --dry-run --json 再執行。僅在生成是使用者要求的一部分時才呼叫生成。使用 --json --non-interactive 進行自動化。如實回報二進位檔回傳的成果路徑與不完整的作業。
使用 runs status、runs wait、runs reconcile 與 runs resume 處理記錄的執行。在考慮付費重試前，先擷取支援的提供者結果。切勿靜默重試未知的付費請求；--retry-unknown 需要明確的使用者授權。審查會將品質記錄與生成成功分開。審查不會自動修訂，且修訂不會取代規範的角色參考。
閱讀補救工作流程以了解 v2 cast、選定的規劃者輸入、有限驗證、參考儲存、復原結果附加、使用方式與遷移。作業/設定/執行接受 v1 與 v2；新的 cast 與播客組合需要 v2。其他資訊清單版本保持不變。
使用 plan --character MANIFEST --asset FILE 來明確選擇依賴項；二進位檔會將它們複製到 _inputs/。對於包含多個已儲存角色的場景，使用 cast 條目與作業特定的方向檔案。需要已接受的參考與相容的原始模型血統；切勿為了讓衝突消失而重寫設定檔。
對於驗收測試，預覽 verify --suite SUITE --json 並在 --execute --preview-hash HASH 前取得有界付費批次的核准。遺失的憑證會被跳過，而非傳遞。語音建立/複製使用其各自的明確角色指令與核准。review report 比較生成的成果與已儲存的參考；僅有實際的使用者選擇才能授權規範接受。
models --live 讀取提供者目錄；可見性不代表生成權利。usage 如實回報回傳的單位與未知成本。storage plan --output cleanup.yaml 在 framechord/ 之外準備保守的清理預覽；storage clean --plan cleanup.yaml 僅在重新驗證後才移除未引用的 blob。migrate --kind job|config|run --file FILE 進行預覽；--apply 保留 v1 備份。對於不確定的作業，runs recover 需要記錄的指紋與調解證據，然後 runs resume 在不重新生成的情況下發布提供的回應。