BewlyBewly项目Safari浏览器适配指南

项目背景

BewlyBewly是一款优秀的B站美化插件，但由于Apple开发者账号的限制和Safari浏览器的特殊性，官方并未在App Store上架该插件的Safari版本。本文将详细介绍如何在Safari浏览器上安装使用BewlyBewly插件。

安装前准备

1. 下载插件文件：首先需要获取BewlyBewly的extension.zip文件，建议下载到Downloads文件夹下

2. 开启开发者选项：

   • 打开Safari浏览器
   • 使用快捷键Command + , 进入设置
   • 选择"高级"选项卡，勾选"显示网页开发者功能"
   • 此时设置界面会出现"开发者"选项

3. 允许未签名扩展：

   • 进入开发者选项
   • 勾选"允许未经签名的扩展"（可能需要输入系统密码）

转换与安装步骤

1. 使用终端转换插件： 打开终端应用，依次执行以下命令：

   cd ~/Downloads/
   xcrun safari-web-extension-converter --no-open extension
   

2. Xcode编译：

   • 转换完成后，在Downloads文件夹中找到生成的BewlyBewly文件夹
   • 双击其中的BewlyBewly.xcodeproj文件，使用Xcode打开
   • 确保运行目标选择为Mac（而非iOS）
   • 点击左上角的运行按钮，等待编译完成

3. 浏览器添加：

   • 编译成功后，打开Safari设置
   • 进入"扩展"选项
   • 找到BewlyBewly并启用
   • 建议设置为仅在bilibili.com域名下运行

常见问题解决方案

1. 登录状态不显示：

   • 尝试关闭Safari的"防止跨站跟踪"功能
   • 路径：Safari设置 → 隐私 → 取消勾选"防止跨站跟踪"
   • 注意：关闭此功能可能会影响隐私保护

2. 重启后插件失效：

   • 这是Safari的安全机制导致
   • 每次重启系统后需要重新执行"允许未签名扩展"的步骤

3. 编译警告处理： 如果转换时出现关于manifest.json的警告（如match_about_blank不支持），可以忽略，不影响基本功能

技术限制说明

1. 功能限制：

   • 右上角头像可能无法显示
   • "稍后观看"和收藏功能可能不稳定
   • 部分页面可能出现卡顿现象

2. 兼容性问题：

   • 不同版本的macOS和Safari可能存在兼容性差异
   • 最新测试在macOS 15.1 Developer Beta上会出现警告提示

3. 性能考虑：

   • 即使用户使用Safari浏览器，该插件仍会带来一定的性能开销
   • 不建议在低配置设备上长期使用

替代方案建议

对于追求稳定性的用户，可以考虑以下方案：

1. 使用开发者提供的预编译版本
2. 在Chrome或Firefox等主流浏览器上使用官方支持版本
3. 定期检查GitHub仓库获取更新

维护现状说明

目前项目组因以下原因无法提供Safari版本的官方支持：

1. Apple开发者账号年费成本较高
2. 维护多平台版本需要额外开发资源
3. Safari扩展机制与其他浏览器差异较大

用户可自行根据本文指导进行安装使用，但遇到问题需自行解决或寻求社区帮助。