YT 暱稱還原助手

本插件參考自 YTid 名稱修復器，感謝夜有風分享~
==============================================================================
專案儲存庫(僅供審查請勿重複上架):https://github.com/lisheng099/YT-Nickname-Restoration-Assistant
==============================================================================
本次更版

### v1.2.0 (2026-03-28)
- [優化] 引入前台 L1 同步熱快取 (Local Cache)，改以 CSS 無痕隱藏原生節點而非強制刪除，徹底解決重新渲染時的文字閃動與跳脫問題。
- [修復] 修復聊天室中傳送訊息後，因底層 Polymer 框架觸發節點資料刷新而導致原 ID 漏出及與頻道暱稱疊加的問題。
- [效能] 大幅優化 DOM 掃描器 (PageScanner)，精準定位 Shadow Root 容器，解決影片留言區與直播聊天室在大量訊息捲動時的高 CPU 消耗與卡頓問題。
- [修復] 徹底修復 YouTube 留言區切換排序 (熱門/最新) 時，因為 Virtual DOM 或異步載入導致的暱稱錯置 (Ghosting) 與張冠李戴問題。
- [架構] 重新設計 UI 渲染邏輯 (保留原生 TextNode)，確保能完美相容 YouTube 底層的 Polymer 框架更新機制。
- [修復] 修復當背景資料抓取失敗（如遭到限流或網路異常）時，頁面元素被永久鎖死在 "fetching" 狀態的問題，確保網路恢復後能重新抓取。
- [修復] 解決懸浮資訊卡 (Tooltip) 在特定的 DOM 嵌套結構 (Nested Spans) 下會被自己覆寫，導致顯示空白 ID 或截斷名稱的邏輯陷阱 Bug。
- [語系] 全面檢查並深度優化簡體中文 (zh-CN) 的在地化慣用語（例如：資料->数据、檔案->文件、介面->界面 等），提升國際化體驗。

### v1.1.2 (2025-12-30)
- [新增] 前後端保險絲機制
獨立控管「前端介面替換」與「後端資料抓取」。
偵測到大量異常時自動熔斷，避免影響使用者瀏覽。
後端熔斷時停止網路請求，僅使用本地快取；前端熔斷時停止 UI 渲染。
- [新增] 自動維護機制：版本更新時自動重置保險絲狀態，無需手動開啟。
- [新增] 開發者功能：新增模擬故障模式 (Simulate Error) 方便測試。
- [修正] 修正手動清空資料庫後，刷新頁面仍可能顯示舊快取的問題。
- [修正] 快取更新機制，從FIFO改為LRU。

### v1.1.1 (2025-12-29)
- [架構] 引入多語言系統。
- [優化] 調整畫面替換頻率。
- [優化] 程式碼架構優化。

### v1.1.0 (2025-12-24)
- [架構] 核心資料庫全面遷移至 IndexedDB，解除儲存容量限制。
- [新增] V1 舊資料自動遷移至 V2 機制，無痛升級。
- [新增] Popup 新增「過期天數」與「自動刪除天數」設定，可自定義資料生命週期。
- [新增] Popup 新增「除錯模式 (Debug Mode)」開關。
- [優化] 管理頁面 (Manager) 改為非同步計算資料大小，解決大量資料時的卡頓問題。
- [優化] 新增 YouTube 禮物/贊助訊息的名稱還原支援。
- [修正] 修正分頁關閉後，加速額度記憶體未釋放的問題。

### v1.0.9 (2025-12-21)
- [修正] 修正爬蟲測試頁面異常
- [修正] 修正爬蟲間隔機制
- [修正] 修正不同網址頁面的快速額度機制
- [修正] 修正處理降落訊息

### v1.0.9 (2025-12-20)
- [重構] 實施功能模組化架構 (Feature Folders)，將檔案按頁面 (pages/) 與功能 (js/) 分類。
- [優化] 移除冗餘的前台邏輯，全面採用背景佇列管理 (bg_fetcher.js)。
- [修正] 解決多分頁並行時的請求衝突問題。
- [修正] 修正 manifest.json 與各頁面的路徑引用，確保架構一致性
==============================================================================
📺 YT 暱稱還原助手 (YT Real Name Restorer)

📖 簡介
YT 暱稱還原助手 是一款專為 YouTube 觀眾設計的瀏覽器擴充功能。為了解決 YouTube 將使用者 ID 改為難以辨識的 Handle（如 @User-xk9lp...）的問題，本工具能在聊天室與留言區自動將這些代碼「還原」為使用者真實設定的頻道顯示名稱。

本工具堅持 「本地運作、隱私優先」，所有查詢動作皆由您的瀏覽器直接發送至 YouTube，確保您的瀏覽隱私絕對安全。

🚀 主要功能介紹

1. 全自動暱稱還原

支援範圍：直播聊天室 (Live Chat)、影片留言區 (Comments)。

運作方式：當您瀏覽影片時，程式會自動掃描畫面上的 @Handle ID，並在背景默默查詢對應的真實暱稱進行替換。

雙重快取機制：系統採用智慧生命週期管理，查詢過的資料預設保存 15 天，超過此時間將標記為過期並自動在背景更新。若某筆資料超過 30 天 未被使用，則會自動從硬碟中永久刪除以釋放空間。

2. 智慧資訊卡 (Tooltip)
滑鼠懸停在還原後的名稱上，會顯示浮動資訊卡：

真實名稱：完整顯示頻道名稱。

原始 Handle：方便核對原始 ID。

訂閱數標章：根據訂閱人數顯示不同顏色的圓點標記：

🟢 青色：百萬訂閱 (1M+)

🟡 金色：十萬訂閱 (100k+)

⚪ 銀色：萬人訂閱 (10k+)

🟠 銅色：千人訂閱 (1k+)

🟤 褐色：潛力頻道 (500+)

過期提示：若資料過久未更新，會顯示提示，系統將自動在背景更新。

3. 進階設定 (點擊擴充功能圖示)

名稱最大長度：可設定顯示字數（預設 20 字），避免過長的名稱破壞聊天室版面。

點擊複製網址：開啟後，點擊暱稱即可直接複製該頻道的 URL。

抓取頻率控制：提供「普通」與「慢速」模式，使用者可依據需求自行調整。

💾 匯入與匯出：社群分享最強大的武器
這是本工具最強大的功能之一，位於 「快取管理頁面」 (Manager)。透過分享資料庫 (.json 檔)，社群成員可以互相幫助，建立龐大的名稱資料庫。

如何操作？

點擊瀏覽器右上角的擴充功能圖示。

點擊 「📋 開啟快取管理頁面」。

在管理頁面右上角找到按鈕：

匯出 (Export)：將您目前電腦裡收集到的所有名單下載成 JSON 檔案。

匯入 (Import)：讀取別人分享的 JSON 檔案，將名單合併到您的資料庫中。

🤝 為什麼要使用匯入功能？ (社群推廣重點)
在粉絲群、Discord 或是討論區分享這個 JSON 檔，有以下三大優點：

✅ 優點 1：集眾人之力，建立「熟人名單」
若您是某個 VTuber 或實況主的粉絲社群，成員們經常是固定的。資深粉絲可以將累積已久的常客資料匯出分享給新粉絲。新粉絲匯入後，進入直播間的瞬間，所有常客的暱稱都會直接顯示，不需要從零開始累積。

✅ 優點 2：秒開即用，零等待 (Instant Access)
透過匯入功能，您的資料庫內已經有了這些人的資料。當您進入熱鬧的聊天室時，所有人的名字都能瞬間顯示，完全不需要等待程式運轉，大幅提升使用體驗與電腦效能。

✅ 優點 3：自動驗證機制 (Smart Validation)
程式會自動將匯入的資料標記為「等待更新」。這代表您匯入後，馬上就能看到暱稱（享受秒開的便利）。但當您下次真的在聊天室遇到這個人時，擴充功能會「順便」在背景默默檢查一次資料是否正確。

🛠️ 常見問題與疑難排解

Q1: 為什麼有些名字顯示虛線底線？
A: 這代表該筆資料是從「匯入」取得，或是已經超過 15 天未更新。這不影響閱讀，只要該使用者再次發言，系統就會自動在背景更新它。

Q2: 出現「OUTPUT NOT AVAILABLE」或無法還原怎麼辦？
A: 這通常是因為短時間內抓取過於頻繁。系統內建保護機制，會暫時停止抓取。請稍待片刻（約 5 分鐘）即可恢復。若您需要長時間掛台，建議在設定中將抓取頻率改為 「慢速 (SLOW)」。

Q3: 我的資料會被上傳嗎？
A: 絕對不會。 程式碼中沒有任何上傳伺服器的邏輯，所有的資料都只存在您的瀏覽器內部。匯出的 JSON 檔也只會儲存在您的電腦硬碟裡。