Skip to main content
打开 设置 → 适配中心。同一管理页也可从扩展 Options 页和页内设置对话框进入。 已安装站点拓展标签

​
从在线拓展库安装

  1. 打开 浏览与更新 标签。
  2. 在 在线拓展库 下，若列表为空或过期，刷新 registry。
  3. 查看包名、版本、目标域名或自托管标记、描述与兼容状态。
  4. 选择 安装。
  5. 在浏览器扩展中批准请求的目标域权限。Ophel 只会请求该站点拓展或绑定引用的 HTTPS 源。
  6. 安装完成后刷新目标站点。
registry 站点拓展通过签名远程 registry 更新。替换已安装版本前，Ophel 会校验：
  • 签名索引
  • 不可变包摘要
  • 站点拓展的 minAppVersion
  • 完整运行时 schema
默认 registry 源：
客户端大约每 24 小时检查一次 registry。失败或无效下载不会替换 last-known-good 已安装状态。

​
导入本地 JSON 拓展

当你在社区库之外测试自己创建或收到的站点拓展时，使用 本地 JSON 导入。
  1. 选择导入控件并挑选 .json 文件。
  2. 检查确认对话框：包名、ID、版本、匹配模式数量与风险提示。
  3. 确认导入。
  4. 扩展端在提示时批准目标域权限，然后刷新站点。
本地导入会走与 registry 包相同的运行时规则校验，但它们：
  • 不会 通过社区 registry 签名认证
  • 不会 自动更新
若要替换，请导入更新的本地文件。 本地 JSON 导入确认

​
扩展权限

扩展对站点拓展源使用可选主机权限与动态 content script 注册。
  • 若所需权限被拒绝，安装或绑定会回滚，不会留下半安装状态。
  • 在另一台浏览器恢复备份后，站点拓展数据会恢复，但域名权限必须重新授予。站点拓展页会在 重新授权已恢复的站点适配包 下列出它们。
  • 禁用或卸载某个源的最后一个站点拓展时，会移除其动态注册。若多个站点拓展或自定义绑定共享同一源，Ophel 会保留注册，直到最后一个引用被移除。
站点拓展主机权限提示

​
绑定自定义源

自定义源用于自托管或同应用多部署场景，这些域名不在站点拓展静态 matches 中。 典型自托管站点拓展会使用 matches: []，并在你添加源之前显示 需要绑定 / 自托管 标记。
  1. 打开 自定义站点 标签。
  2. 输入精确 HTTPS 源，例如 https://chat.example.com。 路径和通配符会被拒绝。
  3. 选择一个已安装站点拓展。
  4. 保存绑定。
  5. 在扩展中批准主机权限。
  6. 刷新绑定源。
所选站点拓展会始终在该源上激活。Ophel 会按站点拓展 ID 与源派生键存储每个实例，因此同一站点拓展的两个部署不会混用设置、主题、阅读历史与会话数据。 自定义 HTTPS 源绑定

​
更新、禁用或卸载

当 registry 站点拓展需要更新的 Ophel 版本时，UI 会显示 需要 Ophel 或更高版本。

​
你可能看到的状态标记

​
安装问题排查

如果站点拓展装上了，但站点仍未被识别：
  1. 确认站点拓展已启用。
  2. 在授予权限后，刷新目标标签页。
  3. 检查当前源是否与站点拓展或自定义绑定完全一致，包括协议与主机。
  4. 对自托管站点拓展，确认已存在自定义源绑定。
  5. 若来自在线库，检查是否有更新版本。
  6. 若最新包仍失败，在 GitHub 提交 issue，附带站点 URL、站点拓展版本、Ophel 版本与失效选择器名称，不要包含私密会话内容。

​
相关页面

最后修改于 2026年8月13日