bilibili好友分组加强版插件 · v1.3.0 正式版
Bilibili Friend Grouping Enhanced
制作日期：2026-10-18
源码无需构建，可直接解压并加载为 Microsoft Edge 扩展。

本版更新：修复主页彩蛋封面变为正方形的问题，恢复 16:9 视频封面；取消整页变暗，充电按钮用独立发光、跳动摇晃与装饰特效突出。开启减少动画或静态模式时保留静态高亮。插件与安装目录采用新名称。

一、更新前先备份
在旧插件管理页 → 备份与迁移 → 导出 JSON。
保留旧插件，不要先卸载。卸载会让浏览器清除该扩展自己的本地数据。

推荐更新方式：
1. 完整解压压缩包，找到 bilibili-friend-grouping-enhanced 文件夹。
2. 用新版文件覆盖你原来加载的插件文件夹内的同名文件，保留原文件夹位置。
3. 打开 edge://extensions，在原扩展卡片上点重新加载，名称会更新为“bilibili好友分组加强版插件”。
4. 刷新已经打开的 B 站页面。
原目录更新会沿用原扩展的本地记录。新版保留 v1 数据格式和 UID。
若加载到新目录，浏览器可能创建新扩展身份：先在旧扩展导出 JSON 备份，再停用旧扩展，加载新版后在“备份与迁移”导入备份。不要同时启用两套扩展，也不要在备份前卸载旧扩展。

首次安装：打开 edge://extensions → 开启开发人员模式 → 加载解压缩的扩展 → 选择能直接看到 manifest.json 的 bilibili-friend-grouping-enhanced 文件夹。
官方本地加载说明：https://learn.microsoft.com/en-us/microsoft-edge/extensions/getting-started/extension-sideloading

二、长脖猫菜单
在 B 站页面右下方，猫猫平时只露头。鼠标移上去展示全身，点击固定短菜单，再点收起。
短菜单：眼睛 = 暂停/恢复插件，猫图标始终保留；设置 = 打开页内分类管理面板；太阳/月亮 = 日夜模式；免打扰 = 隐藏消息与动态红色数字；秒数 = 头像悬停多久弹出分类菜单。
默认等待 3 秒，可填 0.1–30 秒。输入后按 Tab 或点空白处立即保存。
猫图相对 v1.1 缩小 30%，按透明像素边界裁切显示并贴边。可吸附到上、下、左、右；底部正立，左侧顺时针转 90°，顶部转 180°，右侧转 270°，短菜单文字保持正向。拖动位置会保存；聚焦猫猫后用方向键移动，Alt+四个方向键换边。

暂停与恢复：默认 Alt+Shift+M，在 B 站页面中生效。暂停恢复昵称/头像/评论、漫画提醒、折叠框、免打扰和主页彩蛋的原始显示；猫图标和菜单保留，可直接点眼睛或再次按快捷键恢复。
输入文字、输入法组合输入时不触发，避免打断编辑。需要先点页面空白处。
修改快捷键：设置 → 显示设置 → 暂停/恢复快捷键 → 点框后按你要的组合键 → 保存。
若页面快捷键被浏览器、系统或网站占用，可换组合键。也可在 edge://extensions/shortcuts 为本扩展分配额外浏览器级快捷键。
忘记快捷键时，点猫菜单的眼睛恢复，也可点浏览器工具栏扩展图标恢复。

三、分类与个人设置
鼠标停在 B 站头像上 3 秒，勾选分类即保存。可当场新增分类，点铅笔修改分类；“单独设置此人”打开成员设置。
设置面板中“分类与提醒”可查看每个分类及其成员；“好友名册”支持分类筛选、UID/原名/曾用名搜索、单独编辑与手动加入。

分类级设置：
- 漫画大字默认始终显示，完整动画下震动并轻微明暗闪烁。默认文字“快跑！”，颜色、文字、字体加粗、动图均可调整；也可改为悬停显示或关闭。
- 勾选“昵称统一显示为分类名称”，该分类成员页面昵称显示为分类名。
- 昵称大小可调 50–200%，头像可调 25–200%；100% 为原大小。昵称和头像可以分别隐藏。
- 头像模式可选原头像、内置随机女生头像、上传本地统一头像。八张虚构成年女生头像用内置 GPT Image 生成，日韩 ins 生活肖像风；根据 UID 固定分配，刷新不会换脸。
- 勾选替换评论并输入内容，默认“看到这行字的人每天都有好运气！”。支持多行文字，按纯文本显示。
- 勾选折叠内容后，可识别的该分类评论、视频卡片、动态会显示“点我展开”的自适应框；点开后有“再次折叠这条内容”。取消勾选后不显示折叠框。

个人级设置：
- 单独昵称覆盖分类统一昵称，留空则跟随分类。
- 头像可跟随分类、使用原头像、使用内置头像、上传本地自定义头像。
- 评论可跟随分类、显示原评论、单独输入替换文字。
- 内容可跟随分类、始终折叠、始终展开。
- 个人昵称/头像大小留空跟随分类，填百分比则单独覆盖。可见性可选跟随分类、始终显示、隐藏；“始终显示”可以覆盖分类的隐藏。隐藏头像也会隐藏这处头像的 GIF、光圈和漫画字。仍可在名册找到并编辑此人。
- 原始昵称、曾用名、UID 和备注仍保留。对方改名后按 UID 继续识别。

多分类规则：昵称、头像、评论与提醒按最高优先级分类决定；任意一个所属分类勾选折叠即折叠。个人设置优先于分类。优先级相同按分类列表顺序。
上传头像或图标只接受本地 GIF/PNG/JPEG/WebP，每张最多 256 KiB，边长不超过 4096 像素；不支持外部图片网址。导出备份包含自定义图片和个人设置。

四、默认值与备份
默认：漫画常驻、头像悬停 3 秒、完整动画、日间模式。
默认不启用：替换昵称、替换头像、替换评论、折叠内容、免打扰。
升级保留旧分类、UID、备注、图片与已有显示偏好；没有设置的新字段使用默认值。个人设置默认继承分类。
备份与迁移支持导出、预览导入、合并、覆盖和撤销最近一次导入。合并优先保留当前已有的个人规则；要以备份完整恢复时选择覆盖。

五、“不要点我”主页彩蛋
设置面板右上角、“在新标签页打开”左侧有红色“不要点我”按钮，独立管理页也有入口。
点击会打开 https://space.bilibili.com/353186187 并只对本次新打开的标签页启用彩蛋：
- 视频和文章封面换成用户选定的 B 款“巨大空口袋”，背景为红色猫耳轮廓。视频封面保持原生自适应 16:9，不会把卡片撑成正方形；封面宽高跟随 B站卡片与窗口布局，不固定像素尺寸，插画完整显示在原有封面区域。
- 卡片标题显示“吃饭是有尊严的，宁可饿着，不好吃我就不吃。——《没有什么了不起》蔡澜”。
- 关注、粉丝、获赞、播放四项数量显示 -999万。
- 保留页面原来的亮度，仅真正的充电按钮突出发光、跳动摇晃并显示装饰特效；减少动画、静态模式或系统“减少动态效果”开启时改为静态高亮。
- 充电仍需用户自己点击，插件不会自动充电或付款。
点过后入口文案改成“都说让老师不要点我了”。不会因访问记录而让普通主页访问也变样。
正常输入网址、从其他链接进入、刷新彩蛋标签页、离开后再返回都按正常主页显示。
彩蛋页上方的“本页彩蛋 · 返回正常主页”可立即退出；暂停插件也会恢复原样。
彩蛋仅改变本机显示，不改 B站后台资料、数据、封面或标题。主页灰度布局不同，未能识别的区域保持原样。

六、作用范围
所有替换只改变当前浏览器里的显示，不修改任何 B 站账号、实际昵称、实际头像、已发表的评论或服务器内容，不发送、删除或举报评论。
内置头像和 GIF 离线可用，分类数据保存在本机扩展存储，没有云上传。日夜模式只切换插件界面。
免打扰仅隐藏可识别的顶部“消息”和“动态”红色数量，不改变已读状态，不屏蔽系统推送。
支持通过 UID 识别的常见视频页评论、嵌套评论组件、首页/搜索视频卡片、视频右侧推荐、动态、转发原作者与嵌入视频。明确的作者投稿列表可使用主页 UID 归属，收藏、推荐、转发不会冒用主页 UID。
视频页能唯一识别当前 UP 时，仅主播放器可以折叠，评论区和右侧推荐列表保留。折叠会暂停其中正在播放的媒体，展开后可手动播放，不会自动恢复声音。
折叠只针对内容块，不折叠整个推荐列表。B站灰度版式、只有昵称无UID、Canvas/播放器弹幕、尚未适配的独立页面不能保证覆盖；不会凭同名或正文 @ 提及猜人。
漫画提醒和主页充电特效遵循系统“减少动画”设置；减少动画和静态模式停止震动、闪烁、跳动与摇晃，保留静态提醒。

七、验证范围与兼容性
正式版表示本次交付版本，不代表已覆盖 B站所有线上版式。B站布局会变化，尚未适配、未暴露 UID 或只通过绘图显示的区域可能无法识别；未识别区域保持原样。
本地结构测试与真实页面检查各有范围，不以本地结构测试代替线上全站验证。没有使用你的登录账号；详细边界见 VERIFICATION.md。
本包是可直接加载的本地扩展，未代为发布到扩展商店或 GitHub。

八、许可证
本项目代码采用 GNU General Public License v3.0 only（GPL-3.0-only），完整条款见 LICENSE.txt。GPL 允许商业使用和收费分发；分发受 GPL 约束的版本时，应按许可证提供对应源码并保留相应权利。
Google Animated Noto Emoji 等第三方素材遵循各自许可证，见 THIRD_PARTY_NOTICES.md 和 LICENSES/。本项目的 GPL 声明不改变这些素材的既有授权条款。
