← ClaudeAtlas

transcribe-meetinglisted

把會議錄音/錄影(mp4/m4a/wav/mp3…)轉成逐字稿,本機 Whisper large-v3-turbo、免上傳、免 API 金鑰。雙引擎:MLX(Apple GPU,9x realtime)/CPU(fallback)/both(並排比較)。觸發詞:「轉逐字稿」「會議轉錄」「把這個錄音/影片轉文字」「transcribe」「幫我聽打會議」。
yotron-ai/transcribe-meeting · ★ 0 · AI & Automation · score 67
Install: claude install-skill yotron-ai/transcribe-meeting
# 會議錄音 → 逐字稿(本機 Whisper) 把客戶會議或錄音檔轉成可供後續整理的逐字稿。全程本機��行,音檔不外傳、不需要任何雲端 API 金鑰;首次執行仍會下載套件與模型。 ## 什麼時候用 使用者給一個音檔/影片檔、要求轉成文字/逐字稿/聽打會議紀錄時。 ## 一次性前置(首次才需要) - **ffmpeg**:`brew install ffmpeg`(macOS) - **引擎不用手動裝**,`transcribe.sh` 首次執行會自動備妥(模型 ~1.5GB,首次下載需幾分鐘) - Python 3。MLX 引擎需要 3.10–3.13 其中一版(依賴 numba,對太新的 Python 沒 wheel);腳本會自動挑,並建在 `~/.cache/transcribe-meeting/mlx-venv`(約 1GB),**不動系統或既有的 whisper 安裝** ## 執行步驟 1. **跑轉錄腳本**(就在本 skill 資料夾內): ```bash bash "<skill目錄>/transcribe.sh" "<輸入檔路徑>" zh "<initial_prompt>" "<輸出資料夾>" [引擎] ``` - `initial_prompt` 餵**正確人名+領域詞**能大幅降低錯字。例:`"這是一場關��� AI 報價系統的會議,參與者有 Ray 與 Ben,會談到 LINE、報價、算價、里程碑。"` - 輸出資料夾可省略(預設在輸入檔旁的 `transcribe_out/`)。 - 引擎可省略(預設 `mlx`)。 - 產出 `.txt / .srt / .vtt / .json / .tsv`。 - 可先執行 `bash "<skill目錄>/transcribe.sh" --help` 查看完整 CLI。 - 目標輸出資料夾已存在時,預設不覆蓋;只有確認要替換時才加 `--overwrite`,舊輸出會保留到備份資料夾。 - 轉錄、轉繁與 QC 先在暫存 run directory 完成;成功後才發布。失敗時部分輸出會保留供診斷。 2. **選引擎**: | 引擎 | 說明 | 既有速度紀錄(未於本次驗證重跑)| |------|------|------| | `mlx`(預設)| Apple Silicon GPU | 參考值:2 分 48 秒(9.3x realtime) | | `cpu` | `openai-whisper` CPU,作為相容性 fallback | 參考值:約 35 分鐘 | | `both` | 兩個都跑,成功後輸出並排比較表 | MLX 時間 + CPU 時間 | - 非 Apple Silicon、或 MLX 準備失敗 → 明確顯示原因並退回 `cpu`;`both` 會標示比較已取消。 - `both` 用於想親眼確認品質沒退化時。比較表會給耗時、加速倍數、段數、字數、逐字稿相似度、實質差異片段。 - 判讀:相似度 >85% 且差異多為語助詞 → mlx 可安心用。若有整段內容只出現在一邊 → 該段人工聽一次。 - **短檔的倍數會被稀釋**(模型載入約 13 秒固定成本):30 秒片段只有 2–4x,5 分鐘 8.8x,25.9 分鐘 9.3x。評估效能要看長檔。 3. **判讀聲道**:腳本會先印 `mean_volume`。若數值很低(接近