YT 暱稱還原助手

將 YouTube 聊天室與留言區的帳戶代稱(@ID)自動替換為暱稱(頻道顯示名稱)。採用本地背景爬蟲技術，不傳輸資料至第三方伺服器。

本插件參考自 YTid 名稱修復器，感謝夜有風分享~ ============================================================================== 專案儲存庫(僅供審查請勿重複上架):https://github.com/lisheng099/YT-Nickname-Restoration-Assistant ============================================================================== 本次更版 ### v1.0.7 (2025-12-16) - [優化] 處理降落訊息 ### v1.0.6 (2025-12-12) - [優化] Background.js 調整資料分析邏輯，改善分析速度。 - [優化] Fetcher.js 修正delaySettings參數、記憶體放機制、移除parseSubsString函式 - [優化] Popup.js 修改系統參數儲存機制 - [優化] Main.js 新增抓取意見調查欄位 - [優化] Manager.js 調整雜湊邏輯 ### v1.0.6 (2025-12-11) - [安全性] 權限請求："https://studio.youtube.com/*"，因為娜主播說後台也需要替換名稱跟查看訂閱數功能。 - [新增] Background.js - 背景網路請求管理器 - [優化] 將Fetcher.js中的單筆抓取邏輯移到background.js。 - [優化] 調整Manifest.json 新增background.js註冊 ============================================================================== 📺 YT 暱稱還原助手 (YT Real Name Restorer) 使用手冊 📖 簡介 YT 暱稱還原助手 是一款專為 YouTube 觀眾設計的瀏覽器擴充功能。為了解決 YouTube 將使用者 ID 改為難以辨識的 Handle（如 @User-xk9lp...）的問題，本工具能在聊天室與留言區自動將這些代碼「還原」為使用者真實設定的頻道顯示名稱。 本工具堅持 「本地運作、隱私優先」，所有查詢動作皆由您的瀏覽器直接發送至 YouTube，確保您的瀏覽隱私絕對安全。 🚀 主要功能介紹 1. 全自動暱稱還原 支援範圍： 直播聊天室 (Live Chat)、影片留言區 (Comments)。 運作方式： 當您瀏覽影片時，程式會自動掃描畫面上的 @Handle ID，並在背景默默查詢對應的真實暱稱進行替換。 智慧快取： 查詢過的名稱會儲存在您的電腦中（預設保存 7 天），下次遇到相同的人不用重新查詢。 2. 智慧資訊卡 (Tooltip) 滑鼠懸停在還原後的名稱上，會顯示浮動資訊卡： 真實名稱： 完整顯示頻道名稱。 原始 Handle： 方便核對原始 ID。 訂閱數標章： 根據訂閱人數顯示不同顏色的圓點標記： 🟢 青色：百萬訂閱 (1M+) 🟡 金色：十萬訂閱 (100k+) ⚪ 銀色：萬人訂閱 (10k+) 🟠 銅色：千人訂閱 (1k+) 🟤 褐色：潛力頻道 (<1k) 過期提示： 若資料過久未更新，會顯示提示，系統將自動在背景更新。 3. 進階設定 (點擊擴充功能圖示) 名稱最大長度： 可設定顯示字數（預設 20 字），避免過長的名稱破壞聊天室版面。 點擊複製網址： 開啟後，點擊暱稱即可直接複製該頻道的 URL。 抓取頻率控制： 提供「普通」與「慢速」模式，使用者可依據需求自行調整。 💾 匯入與匯出：社群分享最強大的武器 這是本工具最強大的功能之一，位於 「快取管理頁面」 (Manager)。透過分享資料庫 (.json 檔)，社群成員可以互相幫助，建立龐大的名稱資料庫。 如何操作？ 點擊瀏覽器右上角的擴充功能圖示。 點擊 「📋 開啟快取管理頁面」。 在管理頁面右上角找到按鈕： 匯出 (Export)： 將您目前電腦裡收集到的所有名單下載成 JSON 檔案。 匯入 (Import)： 讀取別人分享的 JSON 檔案，將名單合併到您的資料庫中。 🤝 為什麼要使用匯入功能？ (社群推廣重點) 在粉絲群、Discord 或是討論區分享這個 JSON 檔，有以下三大優點： ✅ 優點 1：集眾人之力，建立「熟人名單」 若您是某個 VTuber 或實況主的粉絲社群，成員們經常是固定的。 情境： 資深粉絲 A 已經掛台很久，電腦裡累積了 5,000 個常客的暱稱資料。 應用： A 可以將資料 「匯出」 並分享給新加入的粉絲 B。 效果： 粉絲 B 「匯入」 後，進入直播間的瞬間，所有常客的暱稱都會直接顯示，不需要從零開始累積。 ✅ 優點 2：秒開即用，零等待 (Instant Access) 一般情況下，擴充功能需要逐一查詢陌生的 ID，這需要一點時間。 差異： 透過匯入功能，您的資料庫內已經有了這些人的資料。 體驗提升： 當您進入熱鬧的聊天室時，所有人的名字都能瞬間顯示，完全不需要等待程式運轉，大幅提升使用體驗與電腦效能。 ✅ 優點 3：自動驗證機制 (Smart Validation) 您可能會擔心：「別人給我的名單如果是舊的怎麼辦？」 程式邏輯： 根據設計，匯入的資料會自動被標記為「等待更新」。 這代表什麼？ 代表您匯入後，馬上就能看到暱稱（享受秒開的便利）。但當您下次真的在聊天室遇到這個人時，擴充功能會「順便」在背景默默檢查一次資料是否正確。 結論： 您既享受了速度，程式又會自動幫您確保資料的新鮮度。 🛠️ 常見問題與疑難排解 Q1: 為什麼有些名字顯示虛線底線？ A: 這代表該筆資料是從「匯入」取得，或是已經超過 7 天未更新。這不影響閱讀，只要該使用者再次發言，系統就會自動在背景更新它。 Q2: 出現「[OUTPUT NOT AVAILABLE]」或無法還原怎麼辦？ A: 這通常是因為短時間內抓取過於頻繁。系統內建保護機制，會暫時停止抓取。 解決方法： 請稍待片刻（約 5 分鐘）即可恢復。若您需要長時間掛台，建議在設定中將抓取頻率改為 「慢速 (SLOW)」。 Q3: 我的資料會被上傳嗎？ A: 絕對不會。 程式碼中沒有任何上傳伺服器的邏輯，所有的資料都只存在您的瀏覽器內部。匯出的 JSON 檔也只會儲存在您的電腦硬碟裡。