BRAINIALL 對話者標記轉錄 是做什麼的？
當代理需要將一份經明確授權的巴西葡萄牙語或西班牙語錄音轉換為可供審閱的逐字稿與字幕成品時，請使用此技能。上游儲存庫提供了一個無依賴的 Node.js 22 客戶端、模擬測試、公開的 OpenAPI 合約，以及包含字詞時間戳記和匿名說話者輪次標籤的 JSON、SRT 和 WebVTT 輸出。
BRAINIALL 端點是一個外部計費 API。在選擇媒體之前，工作流程需要確認錄音權利以及任何適用的說話者通知或同意。它接受一個本地的常規 .mp3、.wav、.m4a、.mp4、.mpeg、.mpga、.webm 或 .ogg 檔案，大小上限為 25 MB。它會拒絕目錄、萬用字元、符號連結、遠端 URL、不支援的語言、已存在的輸出目錄以及缺少確認的情況。一個專用且可撤銷的金鑰保留在 BRAINIALL_API_KEY 環境變數中；金鑰、媒體、逐字稿、檔案名稱以及上游回應主體皆排除在日誌之外。
客戶端在請求中設定 diarize=true 並僅發送一個請求。它絕不會自動重試不明確的上傳，因為另一個請求可能會產生另一筆費用。人工審閱仍然是必要的：說話者標籤表示輪次，而非生物識別身份，且產生的字詞和時間可能會有錯誤。
安裝
在使用前，請先複製並檢查上游原始碼。這可以避免在安裝過程中執行未鎖定版本的第三方套件：
git clone https://github.com/fasuizu-br/brainiall-transcription-skill.git
cd brainiall-transcription-skill
git rev-parse HEAD
npm test
在審閱已簽出的原始碼和測試結果後，請使用代理主機的文件化安裝程序，將 skills/brainiall-diarized-transcription 複製到本地的技能目錄中。克隆目錄本身並非主機的技能目錄。
使用前請先檢閱公開原始碼與測試。請透過已安裝上游 SKILL.md 中特定於技能的設定連結，來建立或管理所需的帳戶，並在任何正式請求前檢查當前價格和餘額。
呼叫
安裝技能並確認權利、成本、輸入內容、語言和輸出路徑之後，其捆綁的客戶端會相對於上游 SKILL.md 執行：
node scripts/transcribe.mjs \
--input /absolute/path/to/authorized-recording.wav \
--language pt \
--output-dir /absolute/path/to/new-output-directory \
--rights-and-consent
除非使用者明確要求顯示敏感的逐字稿內容，否則僅回報輸出路徑以及說話者/字詞數量。