SRTC — 螢幕錄影直達 Claude
SKILL_DIR 是包含此 SKILL.md 的目錄（通常為 ~/.claude/skills/srtc）。以下所有指令都從該目錄執行。工具為 python3 "$SKILL_DIR/vtc.py"；摘要引擎為 python3 "$SKILL_DIR/screencast/screencast.py"。
功能
⌃⌘S切換螢幕 + 麥克風錄製（選單列代理程式vtc-hotkey）。按下Esc可取消錄製。預設 10 分鐘上限，並在最後 20 秒播放倒數音效 + 紅色面板。- 停止錄製後：以 1 fps 取樣 → 移除未變化的秒數 → 產生 2×2 時間戳記截圖表；滑鼠軌跡記錄 → 針對圈選、停留或點擊的位置產生縮放的「指標截圖表」；Whisper（本機執行，錄製期間串流處理）→ 產生時間戳記逐字稿。
- 交付方式：將 Claude 視窗移至最前方，並將圖片與提示詞直接貼到開啟的對話中（使用者按下 Enter 發送）。
~/.claude/CLAUDE.md中的規則（從claude-rule.md安裝）會將旁白設定為請求內容。
指令
| 使用者提問 | 實際執行指令 |
|---|---|
| 狀態/是否正在錄製 | python3 "$SKILL_DIR/vtc.py" status |
| 分析現有錄影（任何 .mov/.mp4 檔案） | python3 "$SKILL_DIR/screencast/screencast.py" digest "<檔案路徑>" → 然後「讀取」產生的 DIGEST.md，以及 sheets/ 和 pointer/ 中的每個截圖表 |
| 儲存空間用量 | python3 "$SKILL_DIR/vtc.py" usage |
| 清理舊錄影 / 清理全部 | python3 "$SKILL_DIR/vtc.py" clean / python3 "$SKILL_DIR/vtc.py" clean --all |
| 變更熱鍵/麥克風/錄製上限/保留天數 | 編輯 ~/.config/vtc.json（鍵值：hotkey、mic、cap_seconds、warn_seconds、keep_days、deliver、auto_send、asr），然後執行 launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey |
| 安裝 / 重新安裝 | "$SKILL_DIR/install.sh"（使用者必須自行執行此指令：它會註冊一個登入代理程式與鑰匙圈憑證） |
當使用者詢問剛完成的錄影相關問題時，摘要資料夾為影片旁的 recordings/<日期>.digest/（預設為 ~/Movies/SRTC/，或 ~/.config/vtc.json 中的 recordings 路徑）：請先讀取 DIGEST.md，再依序讀取其中列出的截圖表。
疑難排解（請依此順序檢查）
- 熱鍵失效，選單列顯示「熱鍵被擋：密碼欄位」 → 某些應用程式握有安全鍵盤輸入權（通常是瀏覽器中的密碼欄位）。請點擊退出該欄位。執行
ioreg -l -w 0 | grep -o '"kCGSSessionSecureInputPID"=[0-9]*'可顯示持有該權限的行程 ID。 - 熱鍵失效，日誌顯示「不受信任」（
~/Library/Application Support/VideoToClaude/hotkey.log）→ 輔助使用權限遺失（通常發生在未執行sign.sh就重新建置後）。請前往「系統設定」→「隱私權與安全性」→「輔助使用」：移除vtc-hotkey（−），再重新加入（+ 或直接拖曳執行檔）。代理程式會在 2 秒內重新啟用。 - 「未錄製到任何內容」 →
vtc-hotkey缺少「螢幕錄製」或「麥克風」權限；螢幕錄製權限需要執行launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey後才會生效。 - 逐字稿為空白或內容錯誤 → 檢查摘要中的「audio peak / average」數值；平均低於 −40 dB 表示麥克風選擇錯誤。
~/.config/vtc.json中的mic為優先順序清單；執行python3 "$SKILL_DIR/screencast/screencast.py" devices可列出所有裝置。 - 逐字稿正確但延遲產生 → Whisper 模型檔案遺失（
models/whisper-large-v3-turbo/weights.safetensors）；請參閱 README。 日誌位置：~/Library/Application Support/VideoToClaude/{hotkey,runner,asr,recorder-ffmpeg}.log。
請勿自行執行 install.sh、sign.sh 或 launchctl bootstrap；僅顯示指令並讓使用者自行執行。