From 9678c9e01b82b7870de5cd3e553bfe659e3f2d99 Mon Sep 17 00:00:00 2001
From: JianFeeeee <JianFeeeee@users.noreply.gitcode.com>
Date: Fri, 2 Oct 2026 15:56:58 +0800
Subject: [PATCH] =?UTF-8?q?docs(extension):=20=E5=AE=89=E8=A3=85=E9=A1=B5?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8E=E3=80=8C=E6=9C=AA=E7=AD=BE=E5=90=8D=E3=80=8D?=
 =?UTF-8?q?=E6=8B=92=E7=BB=9D=E7=9A=84=E6=AD=A3=E8=A7=A3=EF=BC=88=E7=94=A8?=
 =?UTF-8?q?=E6=88=B7=E5=AE=9E=E6=B5=8B=E8=B8=A9=E5=88=B0=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

正式版 Firefox 在 about:addons 的「从文件安装」强制要求 Mozilla 签名，
自签 xpi 会报「附加组件未签名 / not verified」。唯一免签路径是
about:debugging#/runtime/this-firefox 的「临时加载附加组件」。

同时说明临时加载的代价：浏览器重启即失效，而这个扩展靠 alarms 每 30 秒
同步历史、必须常驻，所以要长期用得上必须走 AMO 签名发布。
---
 web/extension/install.html | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/web/extension/install.html b/web/extension/install.html
index 6ce4ad1..ebcd2fa 100644
--- a/web/extension/install.html
+++ b/web/extension/install.html
@@ -98,6 +98,17 @@
       <li>点「临时加载附加组件」，选择下载的 xpi</li>
       <li>点扩展图标，填入上面的本站地址与同步令牌，保存</li>
     </ol>
+    <p class="hint" style="margin-top:.5rem">
+      <b>不要在 <code>about:addons</code> 里点「从文件安装」</b>。本扩展是自签名（未上架
+      任何商店），那条路在正式版 Firefox 会因缺少 Mozilla 签名而报
+      「附加组件未签名 / not verified」。只有 <code>about:debugging</code> 的
+      「临时加载附加组件」不需要签名。
+    </p>
+    <p class="hint">
+      注意：<b>临时加载的扩展在浏览器重启后会被移除</b>，需要每次重启后重新加载一次。
+      若要长期常驻，需把 xpi 提交到 addons.mozilla.org 签名后发布，
+      或改用 Chromium 版（zip 需开发者模式，但同样不需签名）。
+    </p>
     <p class="note" id="note-firefox"></p>
   </div>