YouTube Transcript Requests

本目錄是 Hermes Wiki CronWindows Transcript Worker 之間的溝通佇列。

流程

Hermes weekly wiki scan
  → 發現 YouTube 影片需要 transcript 才能產 NotebookLM source pack
  → 但雲端 IP 被 YouTube 擋住,抓不到
  → 寫入 transcript-requests.json (status: pending)

Windows 11 worker (每小時執行)
  → git pull
  → 讀取 transcript-requests.json
  → 找出 pending 或 failed (< 3次) 的 request
  → 用 youtube-transcript-api 抓字幕 (家用/辦公室 IP)
  → 成功:寫 youtube/youtube-VIDEO_ID.json + .md
  → 失敗:更新 status + attempts + error
  → git add / commit / push

Hermes NotebookLM source pack cron
  → 優先讀 youtube/youtube-VIDEO_ID.md
  → 有 transcript → confidence = high
  → 沒有 → fallback 用 metadata / social post

Request 狀態

狀態說明
pending等待 worker 處理
success已成功抓取
failed抓取失敗 (可重試最多 3 次)
skipped跳過 (不需要)

目錄結構

raw/transcripts/
├── inbox/
│   ├── transcript-requests.json   ← 任務佇列
│   └── README.md                  ← 本文件
├── youtube/
│   ├── youtube-VIDEO_ID.json      ← 完整 segment 資料
│   └── youtube-VIDEO_ID.md        ← 可讀的 transcript
└── logs/
    └── transcript-worker.log      ← worker 執行記錄