ZH CN Installation

安装

请只使用官方网站或GitHub 最新 Release发布的安装包。

Windows

Windows ZIP 是浏览器扩展合集，不是 EXE 或 MSI，因此没有 Windows 系统级代码签名。

1. 从同一个 Release 下载 Windows ZIP 与 SHA-256 校验文件。
2. 在下载目录用 PowerShell 执行 Get-FileHash <安装包> -Algorithm SHA256，与校验文件中的值比较。
3. 解压外层 ZIP，再解压适合当前浏览器的扩展包。
4. Chrome、Chromium、Brave 或 Edge 打开扩展管理页面，启用“开发者模式”，选择“加载已解压的扩展程序”。
5. 选择包含 manifest.json 的解压目录。
6. Firefox 手动包仅用于临时测试：打开 about:debugging#/runtime/this-firefox，选择“临时载入附加组件”，再选择 manifest.json。

浏览器商店版本上线后，优先使用官方商店安装。

Linux

Linux TAR.GZ 包含相同的浏览器扩展包，不是 AppImage、DEB、RPM 或原生可执行程序。在下载目录执行 sha256sum -c <校验文件> 后，可选择：

• 从所有者发布的 Chrome Web Store、Edge Add-ons 或 Firefox Add-ons 官方商店安装；
• 解压浏览器扩展包，通过开发者模式或 Firefox 临时附加组件手动加载；
• 开发测试使用 chromium --load-extension=/绝对路径、 google-chrome --load-extension=/绝对路径、 microsoft-edge --load-extension=/绝对路径，或 npx web-ext run --source-dir /绝对路径。

命令行加载在关闭浏览器后可能不会保留，不能替代已审核的浏览器商店版本或企业托管策略。

macOS

公开 DMG 与 PKG 必须完成 Developer ID 签名、Apple 公证和 stapling。下载同一 Release 中的校验文件后，在下载目录执行 shasum -a 256 -c <校验文件>，再正常打开 DMG 或 PKG。如果 Gatekeeper 拒绝安装，不要绕过系统隔离； 请重新下载当前版本或提交问题。