插件安装失败 — 扫了码还是打不开怎么办

排查步骤

第一步：确认 Grayjay 已安装并正常运行

插件安装是通过 Grayjay 自身完成的。如果 Grayjay 本身没装好或启动就闪退，先解决基础安装问题。

第二步：确认 URL Scheme 被系统识别

点击「Open in Grayjay」或扫二维码后，系统应该弹出一个选择 Grayjay 的对话框。如果没弹出，说明 Grayjay 没有注册对应的 URL Scheme。

解决：

• 在系统设置的「默认应用」里，检查 Grayjay 是否被允许处理该类链接
• 清除浏览器默认设置后重试
• 直接在 Grayjay 应用内打开 Sources 页面，手动输入插件安装地址（如果应用内提供这个入口）

第三步：插件文件本身的问题

某些插件可能因为网络原因下载不完整。可以：

• 换一个网络环境（从 Wi-Fi 切到 4G 或反过来）
• 等一段时间再试（plugins.grayjay.app 服务器可能临时有波动）

第四步：应用版本太旧

旧版本的 Grayjay 可能不支持某些较新的插件安装方式。先更新应用到最新版，再试安装。

特殊情况：PeerTube 实例插件

PeerTube 实例是动态生成的插件——你输入一个实例 URL，Grayjay 会动态为这个实例生成插件。如果 PeerTube 插件安装失败，额外检查：

• 你输入的实例 URL 是否正确（必须是一个真实可访问的 PeerTube 实例）
• 该实例是否已关闭或下线