log-focus-debug

log-focus-debug 技能是一項專為 DashPlayer Electron 代碼庫設計的工程實用工具。其主要目的是解決除錯特定功能時產生的日誌噪音問題，允許開發者在不受不相關系統日誌干擾的情況下，隔離並追蹤 Main 與 Renderer 進程中的完整日誌鏈。此技能強制執行臨時診斷標記的結構化生命週期，確保代碼庫保持整潔與專業。

• 通過配置環境變數（如 DP_LOG_LEVEL 與 DP_LOG_FOCUS_TOKEN）來實現目標日誌過濾。

• 標準化 Main 與 Renderer 日誌記錄器中 withFocus() 方法的使用，以鎖定特定的除錯工作階段。

• 支援注入臨時聚焦標記（例如 [FOCUS:token]），以便在密集的日誌文件中快速搜尋關鍵事件。

• 包含嚴格的清理規約，防止除錯遺留代碼進入正式環境或長期維護分支。

• 提供基於靜態分析工具（如 ripgrep）與代碼檢查的驗證步驟，確保無任何日誌代碼洩漏。

• 目標對象：負責 DashPlayer 模組（如 PlaybackService 或 UI 元件）開發的軟體工程師與貢獻者。

• 操作限制：必須遵守 <feature>-<yyyymmdd> 的命名規範，以防止標記衝突。

• 典型使用情境：當調查複雜的播放同步問題或 UI 狀態閃爍時，設定聚焦令牌、重現錯誤、分析輸出，並在結束後立即執行清理流程以刪除所有臨時標記。

• 輸入與輸出預期：輸入為定義唯一的聚焦令牌；輸出則確保在開發期間擁有乾淨、隔離的日誌環境，並在任務完成後保證代碼庫的驗證與清理。