YT 昵称还原助手

本插件参考自 YTid 名称修复器，感谢夜有风分享~
项目仓库(仅供审查请勿重复上架):https://github.com/lisheng099/YT-Nickname-Restoration-Assistant
🇨🇳 简体中文 (Chinese Simplified)

应用名称：YT 昵称还原助手 (YT Real Name Restorer)

详细说明：

📺 YT 昵称还原助手 (YT Real Name Restorer)

📖 简介 YT 昵称还原助手 是一款专为 YouTube 观众设计的浏览器扩展。为了解决 YouTube 将用户 ID 改为难以辨识的 Handle（如 @User-xk9lp...）的问题，本工具能在聊天室与评论区自动将这些代码“还原”为用户真实设定的频道显示名称。

本工具坚持“本地运行、隐私优先”，所有查询动作皆由您的浏览器直接发送至 YouTube，确保您的浏览隐私绝对安全。

🚀 主要功能介绍

全自动昵称还原

支持范围：直播聊天室 (Live Chat)、视频评论区 (Comments)。

运作方式：当您浏览视频时，程序会自动扫描画面上的 @Handle ID，并在后台默默查询对应的真实昵称进行替换。

双重缓存机制：系统采用智能生命周期管理，查询过的数据默认保存 15 天，超过此时间将标记为过期并自动在后台更新。若某笔数据超过 30 天 未被使用，则会自动从硬盘中永久删除以释放空间。

智能信息卡 (Tooltip) 鼠标悬停在还原后的名称上，会显示浮动信息卡：

真实名称：完整显示频道名称。

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

订阅数徽章：根据订阅人数显示不同颜色的圆点标记：

🟢 青色：百万订阅 (1M+)

🟡 金色：十万订阅 (100k+)

⚪ 银色：万人订阅 (10k+)

🟠 铜色：千人订阅 (1k+)

🟤 褐色：潜力频道 (500+)

过期提示：若数据过久未更新，会显示提示，系统将自动在后台更新。

进阶设置 (点击扩展图标)

名称最大长度：可设定显示字数（默认 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 文件也只会存储在您的电脑硬盘里。