如何解决火狐浏览器升级后导致的原有侧边栏插件消失？

火狐v128+升级后侧边栏插件图标消失，主因是废弃sidebar_action字段、强制迁移到Manifest V3：需确认启用状态→执行browser.sidebarAction.open()临时唤出→拖图标至附加组件栏→检查manifest.json含sidebar_panel和sidebarAction权限→改用service_worker。

火狐浏览器升级后原有侧边栏插件突然消失，不是被卸载也不是被禁用，而是图标和入口彻底不见——这种情况通常发生在v128及以上版本强制迁移旧版WebExtension API、废弃sidebar_action字段之后。

确认插件是否仍处于启用状态

在地址栏输入 about:addons → 回车 → 切换到“扩展”标签页 → 查看目标插件右侧状态是否为“已启用”。

如果显示“已启用”但工具栏和侧边栏都无入口，说明插件未被删除，只是新版火狐不再识别其旧版侧边栏注册方式；若显示“已禁用”，点击启用后再继续下一步。

手动触发侧边栏入口（适用于兼容但未自动注册的插件）

方法一：通过地址栏命令临时唤出

在地址栏输入 about:debugging#/runtime/this-firefox → 回车 → 找到对应插件 → 点击“调试” → 在弹出的开发者工具窗口中，切换到“Console”标签 → 粘贴并执行：browser.sidebarAction.open(); → 按回车。

这行命令会强制调用该插件声明的 sidebarAction，仅本次生效；若报错 browser.sidebarAction is not defined，说明插件尚未适配 Manifest V3 或未声明 sidebar_action 权限。

方法二：拖拽图标到附加组件栏

点击右上角 ≡ 菜单 → 选择“定制…” → 在左侧“额外工具栏按钮”区域找到该插件图标 → 将其拖入顶部的“附加组件栏”（即地址栏下方那条细长栏）→ 松手 → 点击右下角“完成”。

此时插件图标将固定在附加组件栏，点击即可展开侧边栏；但注意：【此操作不会恢复原生侧边栏菜单项，仅提供快捷入口】。

检查并修复插件清单文件（Manifest.json）

第一步：确认插件是否支持 Manifest V3

在 about:addons 页面，找到该插件 → 点击右侧“更多” → 查看“详细信息” → 找到“清单版本”字段。若显示“Manifest V2”，则无法在火狐 v128+ 中使用 sidebar_action —— 必须升级至 V3 并改用 sidebar_panel 字段声明侧边栏。

第二步：验证权限声明

Manifest V3 插件必须在 manifest.json 中包含："sidebar_panel": "sidebar.html" 和 "permissions": ["sidebarAction"]；缺一不可。缺少 sidebarAction 权限会导致 browser.sidebarAction API 完全不可用。

第三步：检查 background 服务工作线程是否激活

Manifest V3 强制要求使用 service worker 替代 background scripts；若插件仍使用 "background": { "scripts": [...] }，侧边栏将无法初始化。需改为："background": { "service_worker": "background.js" }，且 background.js 中需有 browser.runtime.onInstalled 监听逻辑来注册侧边栏。