transcribe-meetinglisted
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`。若數值很低(接近