━━━━━━━━━━━━━━━━━━━━━━━━━━━━
影片資料工具 — 安裝與使用說明
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【安裝（只做一次）】

⚠️ 這個工具只支援 Mac，Windows 不能用。
⚠️ 不要直接打開 payload 裡的 index.html——那只是介面外殼，
   單獨開是沒有作用的，一定要照下面步驟安裝。

1. 對「安裝.command」按【右鍵 → 打開】
   （直接雙擊會被 macOS 擋下來，一定要右鍵）
2. 跳出安全性警告時，選「打開」
   ※ 如果右鍵打開還是被擋（新版 macOS）：
     去「系統設定 → 隱私權與安全性」，拉到最下面
     會看到「已阻擋安裝.command」，按【強制打開 / 仍要打開】
3. 等它自動下載安裝（需要網路，約 2-5 分鐘）
4. 看到 ✅ 安裝完成，Finder 會顯示「影片下載」App
5. 建議把 App 拖到 Dock

【日常使用】

1. 點「影片下載」App，會在瀏覽器打開工具頁面
2. 貼上影片網址（YouTube / Vimeo / Instagram / TVCF / 新片场 / 其他）
3. 按「檢查連結」→ 選解析度 → 下載影片（或只要音訊 mp3）
4. 檔案存在「下載項目 → 影片下載」資料夾

GIF 轉檔：選一支下載好的影片，選大/中/小或拉桿調整，
可先按「預估檔案大小」再決定轉不轉。

【Instagram 說明】

貼文與 Reels 都可以，貼上網址即可（例如 instagram.com/p/xxxx/）。

- 需要「Chrome 有登入 Instagram」，工具是借你的登入狀態去看。
  你的帳號看得到的就能下載；沒追蹤的私人帳號一樣看不到。
- 別短時間大量抓：IG 會偵測自動化行為，可能限流或警告你的帳號。
  當參考片偶爾抓幾支沒問題，別拿它做批次備份。

【新片场（xinpianchang）專用說明】

2026 年 7 月起新片场加了安全驗證，要借用 Chrome 的通行證：

方式 A（先試這個）：
  1. 用 Chrome 打開該影片頁（讓它正常顯示、開始播放）
  2. 馬上回工具貼上「影片頁網址」→ 檢查連結 → 下載

方式 B（A 被擋掉時）：借 Chrome 擴充「猫抓」（CatCatch）
  1. Chrome 裝好「猫抓」擴充（線上應用程式商店搜尋 猫抓）
  2. 用 Chrome 開影片頁，讓影片開始播放
  3. 點右上角猫抓圖示，複製它抓到的影片連結
     （xpccdn 開頭、.mp4 結尾的那條）
  4. 把那條連結貼進工具的「檢查連結」→ 下載

注意：新片场的連結有時效（幾小時）且只在你自己的網路有效。
若下載失敗，重按一次「檢查連結」拿新的即可，不用重開工具。

【出問題的時候】

工具裡的錯誤都會附一顆「複製錯誤回報」按鈕，
點它之後把訊息傳給發你這個工具的人，他會處理。

如果點 App 後跳出「啟動失敗」或網頁無法顯示：
1. 重新下載最新版安裝包，再跑一次「安裝.command」
2. 還是不行的話，把這個檔案傳給發你工具的人：
   家目錄 → 資源庫 Library → Logs → vdl-app.log

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
工具說明：本工具僅供內部找參考、建立資料庫使用。
素材若要用於商業產出，請另行取得正式授權。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
