keleus / BewlyCat

# BewlyCat
此项目基于BewlyBewly开发，并在其基础上进行功能扩充和调整，并合并了一些其他拓展的功能。
 只需对您的 Bilibili 主页进行一些小更改即可。 
## 👋 介绍
> [!IMPORTANT]
> 本插件及Fork代码禁止以任何形式的客户端封装！！！插件的目的是仅优化B站官方网站的使用体验。
>
> 该项目面向我个人使用习惯修改。当然，欢迎功能建议与bug反馈。
>
> 浏览器拓展商店上架均同时提交审核，实际更新速度取决于各个商店审核速度。请勿在issue中催促审核，商店异常行为由商店导致！
>
> 不会打包safari，也不会在项目里做大量的safari only适配，如果有需要欢迎自行打包。
>
> 本项目由MIT许可在原项目基础上开发，并亦与原作者联系取得了授权，包括上架Chrome应用商店等权利。
> [!CAUTION]
> 为了本项目能够在Github中直接被搜索到，项目将脱离BewlyBewly的Fork网络，成为一个独立的项目。但项目基于BewlyBewly是不变的～项目不会移除历史贡献者和原项目信息。
>
> B站于2026年1月调整了首页推荐API，请更新至`1.5.6`版本及以上，以适配新的首页推荐，排行榜和分区。
## 主要功能异同
### 新增功能
1. 新增视频卡片、顶栏链接后台打开的能力。
2. 新增默认播放器样式设置，当播放器样式是默认和宽屏的时候会自动滚动到弹幕框与底部平齐。
3. 新增用户面板大会员权益领取入口。
4. 新增首页推荐前进后退的能力。
5. 新增合集播放自动关闭功能（需要在设置里开启），方便挂合集听歌。
6. 新增web模式推荐按照点赞/播放比例过滤视频的能力（需要设置里开启）
7. 参考了`Extension for Bilibili Player`插件的快捷键，支持了其中大部分功能的自定义快捷键。
8. 记住倍速比例功能，开启后会记住上次倍速
9. 合集视频随机播放功能
10. 视频详情页稍后再看外置
11. 自定义暗色基准色，开启后会根据基准色调整暗黑模式的显示
12. 新增合集视频保持默认播放模式功能
13. 局部音量均衡：在「设置 → Bilibili → 播放器 → 音量均衡」启用，平衡不同视频之间的音量，并通过播放器组件关闭原生均衡。支持目标响度、强度调整及运行状态显示，详见算法与资源管理。
14. 收藏夹整理：在「设置 → Bewly 页面 → 收藏」为收藏夹设置 UP 主、分区、标题关键词组合规则，支持一键三连后自动同步到对应收藏夹，以及手动批量整理默认收藏夹（只复制，不移出默认收藏夹）。
### 删除功能
1. ~~删除了原插件广东话翻译~~广东话翻译由BewlyBewly插件原作者维护（缺少翻译情况下默认显示英文翻译结果）
2. 删除了内置字体，减少打包体积（14.4M -> 600K）
3. 删除了旧版顶栏（减少开发成本），并重构了原项目的顶栏组件（功能无差异）
4. 删除了部分影响功能正常使用的动画（如抽屉打开关闭的动画）
## ⬇️ 安装
### 在线安装
Chrome应用商店
Edge应用商店:审核周期不定
Firefox应用商店:已上线～（`1.0.2`版本已经修复抽屉问题）
> [!CAUTION]
> 审核可能存在延迟，Chrome一般会晚30分钟-15天，Edge一般会晚3-30天，Firefox一般会晚1-30分钟
### 本地安装
CI：使用最新代码自动构建
Releases：稳定版
#### Edge 和 Chrome(推荐)
> 确保您下载了 extension.zip。
在 Edge 浏览器中打开 `edge://extensions` 或者在 Chrome 浏览器中打开 `chrome://extensions` 界面，只需将下载的 `extension.zip` 文件拖放到浏览器中即可完成安装。
 Edge & Chrome 的另一种安装方法 
#### Edge
> 确保您下载了 extension.zip 并解压缩该文件。
1. 在地址栏输入 `edge://extensions/` 并按回车
2. 打开 `开发者模式` 并点击 `加载已解压的拓展程序` 
3. 在浏览器中加载解压后的扩展文件夹
#### Chrome
> 确保您下载了 extension.zip 并解压缩该文件。
1. 在地址栏输入 `chrome://extensions/` 并按回车
2. 打开 `开发者模式` 并点击 `加载已解压的拓展程序` 
3. 在浏览器中加载解压后的扩展文件夹
## 🤝 构建项目参考
查看 CONTRIBUTING.md
### BewlyCat&BewlyBewly贡献者
## ❤️ 鸣谢
- BewlyBewly - 该项目的基础
- vitesse-webext - 该项目使用的模板
- UserScripts/bilibiliHome,
bilibili-app-recommend - 获取访问密钥的参考来源
- Bilibili-Evolved - 部分功能实现
- bilibili-API-collect
- PiliPlus