疑難排解

先記錄應用程式版本、作業系統、發生問題的功能區、操作步驟和錯誤提示。重試前確認不會重複建立同一批任務。

快速檢查

1. 在 設定 → 關於 確認應用程式版本。
2. 在 設定 → 下載 驗證 yt-dlp、FFmpeg 與 Bun。
3. 在 設定 → 網路 檢查代理伺服器。
4. 需要帳號時，在 資源庫 → 應用程式工作階段 驗證登入。
5. 回到發生錯誤的頁面重新整理或重新建立任務。

依症狀處理

症狀	優先檢查
下載或轉碼的開始按鈕無法使用	下載檢查 yt-dlp 與 FFmpeg；轉碼檢查 FFmpeg。
無法解析連結	連結完整性、帳號權限、yt-dlp 與網路；必要時改用嗅探。
下載速度慢或頻繁失敗	降低下載並行；HLS 或 m3u8 再降低分段並行。
轉碼失敗	驗證 FFmpeg，確認輸入檔案可存取且格式受支援。
嗅探瀏覽器無法開啟	重新開啟「新增嗅探」以再次偵測；Chrome「瀏覽器預設」還應檢查遠端偵錯與連線授權。
嗅探沒有資源	點擊播放、捲動頁面、擴大嗅探範圍或重新開啟工作階段。
YouTube / 音樂要求登入	驗證或重新連接 YouTube 應用程式工作階段。
線上頁面一直載入	檢查代理伺服器、目標服務狀態與帳號地區。
RSS 不更新	手動重新整理訂閱，檢查來源位址和網路。
本機音樂無法播放	檢查檔案是否被移動、刪除或位於離線磁碟。
資源庫項目標記為遺失	掛載磁碟後重新檢查，或重新匯入現有檔案。

查看記錄

在 設定 → 一般 開啟記錄目錄。重現一次問題後，找到對應時間附近的記錄。

記錄可能包含本機路徑、網站位址或錯誤內容。提交前請刪除或遮蓋這些資訊。不要上傳應用程式工作階段、配對連結、權杖或完整資源庫資料庫。

仍未解決

前往 GitHub Issues，提供：

• 下蛋版本與系統版本。
• 發生問題的功能區和頁面。
• 可以穩定重現的步驟。
• 去識別化後的錯誤提示或記錄片段。
• 不含帳號、私人內容和本機路徑的螢幕擷取畫面。