YT ニックネーム復元アシスタント

本拡張機能は「YTid 名稱修復器」を参考にしました。共有してくださった「夜有風」様に感謝いたします。
==============================================================================
プロジェクトリポジトリ (審査用のみ、再公開禁止): https://github.com/lisheng099/YT-Nickname-Restoration-Assistant
==============================================================================
📺 YT ニックネーム復元アシスタント (YT Real Name Restorer)

📖 はじめに
YT ニックネーム復元アシスタントは、YouTube 視聴者専用に設計されたブラウザ拡張機能です。YouTube がユーザーIDを認識しにくいハンドルネーム（例：@User-xk9lp...）に変更した問題を解決するため、チャットやコメント欄でこれらのコードを自動的にユーザーが設定した本当の表示名に「復元」します。

本ツールは 「ローカル動作、プライバシー優先」 を徹底しており、すべてのクエリはブラウザから直接 YouTube に送信されるため、閲覧プライバシーは完全に安全です。

🚀 主な機能

1. 全自動ニックネーム復元

対応範囲：ライブチャット (Live Chat)、動画コメント欄 (Comments)。

仕組み：動画を閲覧中、プログラムが画面上の @Handle ID を自動的にスキャンし、バックグラウンドで対応する実際のニックネームを照会して置換します。

二重キャッシュメカニズム：システムはスマートなライフサイクル管理を採用しています。データはデフォルトで 15日間 保持され、その後は期限切れとしてマークされ、バックグラウンドで自動更新されます。30日間 使用されていないデータは、容量節約のためにディスクから完全に削除されます。

2. スマート情報カード (Tooltip)
復元された名前にマウスを合わせると、詳細情報カードが表示されます：

本当の名前：チャンネル名を完全に表示します。

元のハンドル：元のIDを確認するのに便利です。

登録者数バッジ：登録者数に応じて異なる色のドットマークを表示します：

🟢 青色：100万人以上 (1M+)

🟡 金色：10万人以上 (100k+)

⚪ 銀色：1万人以上 (10k+)

🟠 銅色：1000人以上 (1k+)

🟤 茶色：ポテンシャル (500+)

期限切れ通知：データが長期間更新されていない場合、ヒントが表示され、システムがバックグラウンドで自動更新します。

3. 高度な設定 (拡張機能アイコンをクリック)

名前の最大長：表示文字数を設定可能（デフォルト：20文字）。長すぎる名前がチャット欄のレイアウトを崩すのを防ぎます。

クリックしてURLをコピー：有効にすると、ニックネームをクリックするだけでそのチャンネルのURLをコピーできます。

取得頻度コントロール：「通常」と「低速」モードを提供し、ニーズに合わせて調整可能です。

💾 インポートとエクスポート：コミュニティ共有のための最強の武器
これは本ツールの最も強力な機能の一つで、「キャッシュ管理ページ」(Manager) にあります。データベース（.jsonファイル）を共有することで、コミュニティメンバー同士が協力し、巨大な名前データベースを構築できます。

操作方法

ブラウザ右上の拡張機能アイコンをクリックします。

「📋 キャッシュ管理を開く」 をクリックします。

管理ページの右上にあるボタンを見つけます：

エクスポート (Export)：現在コンピュータに収集されているすべてのリストを JSON ファイルとしてダウンロードします。

インポート (Import)：他の人が共有した JSON ファイルを読み込み、リストをあなたのデータベースに統合します。

🤝 なぜインポート機能を使うのか？ (コミュニティ活用のポイント)
ファングループ、Discord、掲示板でこの JSON ファイルを共有することには、以下の3つの大きなメリットがあります：

✅ メリット 1：みんなの力で「常連リスト」を作成
あなたが VTuber や配信者のファンコミュニティに属している場合、古参ファンは蓄積された常連客のデータをエクスポートして新規ファンに共有できます。新規ファンはインポート後、配信に入った瞬間にすべての常連客のニックネームが直接表示され、ゼロから蓄積する必要がありません。

✅ メリット 2：即時表示、待ち時間ゼロ (Instant Access)
通常、拡張機能は未知の ID を一つずつ照会するため、少し時間がかかります。インポート機能を使えば、データベースにすでにデータが存在します。賑わっているチャットルームに入っても、全員の名前が瞬時に表示され、プログラムの動作を待つ必要がなく、体験とパフォーマンスが大幅に向上します。

✅ メリット 3：自動検証メカニズム (Smart Validation)
プログラムは、インポートされたデータを自動的に「更新待ち」としてマークします。つまり、インポート後すぐにニックネームが表示されます（即時表示の利便性）。しかし、次回チャットでそのユーザーに実際に遭遇した際、拡張機能は「ついでに」バックグラウンドでデータの正確性を密かにチェックします。

🛠️ よくある質問とトラブルシューティング

Q1: なぜ一部の名前に点線の下線が表示されるのですか？
A: そのデータが「インポート」から取得されたか、15日以上更新されていないことを示しています。閲覧には影響しません。そのユーザーが再度発言すると、システムがバックグラウンドで自動的に更新します。

Q2: 「OUTPUT NOT AVAILABLE」と表示される、または復元できない場合は？
A: これは通常、短期間に頻繁に取得しすぎたことが原因です。システム内蔵の保護機能により、一時的に取得が停止されています。しばらく（約5分）待つと回復します。長時間放置する場合は、設定で取得頻度を 「低速 (SLOW)」 に変更することをお勧めします。

Q3: 私のデータはアップロードされますか？
A: 絶対にありません。 コードにはサーバーにアップロードするロジックは一切含まれておらず、すべてのデータはブラウザ内部にのみ存在します。エクスポートされた JSON ファイルも、あなたのコンピュータのハードドライブにのみ保存されます。