Thunderbird插件开发：消息显示工具栏自定义菜单添加选项问题

核心原因 #

你在manifest.json里的配置只是创建了一个空的菜单触发按钮，菜单的具体选项需要通过WebExtension API动态添加，无法仅靠manifest配置完成。

具体实现步骤 #

1. 补充Manifest权限与后台脚本声明 #

首先确保你的manifest.json包含必要权限，并声明后台脚本（用来处理菜单创建和点击事件）：

{
  // 其他已有的配置...
  "permissions": [
    "menus",
    "messagesRead" // 如果需要读取邮件内容实现功能，添加此权限
  ],
  "background": {
    "scripts": ["background.js"] // 指向你的后台脚本文件
  },
  "message_display_action": {
    "default_title": "__MSG_ctaMailSummarize__",
    "theme_icons": [
      {
        "dark": "images/bot-icon-light-64.webp",
        "light": "images/bot-icon-dark-64.webp",
        "size": 64
      },
      {
        "dark": "images/bot-icon-light-32.webp",
        "light": "images/bot-icon-dark-32.webp",
        "size": 32
      },
      {
        "dark": "images/bot-icon-light-16.webp",
        "light": "images/bot-icon-dark-16.webp",
        "size": 16
      }
    ],
    "type": "menu"
  }
}

2. 编写后台脚本创建菜单选项 #

在background.js中，使用browser.menus API向消息显示工具栏的菜单中添加选项，并监听点击事件：

// 插件安装/更新时创建菜单项
browser.runtime.onInstalled.addListener(() => {
  // 添加普通菜单项
  browser.menus.create({
    id: "summarize-short",
    title: "生成简短摘要",
    contexts: ["message_display_action"] // 指定菜单项归属的上下文
  });

  browser.menus.create({
    id: "summarize-detailed",
    title: "生成详细摘要",
    contexts: ["message_display_action"]
  });

  // 添加分隔线
  browser.menus.create({
    id: "menu-separator",
    type: "separator",
    contexts: ["message_display_action"]
  });

  // 添加子菜单
  browser.menus.create({
    id: "settings-submenu",
    title: "功能设置",
    contexts: ["message_display_action"]
  });

  browser.menus.create({
    id: "toggle-theme",
    title: "切换主题适配",
    parentId: "settings-submenu", // 指定父菜单ID，成为子选项
    contexts: ["message_display_action"]
  });
});

// 监听菜单项点击事件，处理对应逻辑
browser.menus.onClicked.addListener((info, tab) => {
  switch (info.menuItemId) {
    case "summarize-short":
      // 这里编写生成简短摘要的逻辑
      console.log("执行简短摘要生成");
      break;
    case "summarize-detailed":
      // 这里编写生成详细摘要的逻辑
      console.log("执行详细摘要生成");
      break;
    case "toggle-theme":
      // 这里编写主题切换的逻辑
      console.log("切换主题适配");
      break;
  }
});

关键说明 #

• contexts: ["message_display_action"]是核心：它告诉Thunderbird，这些菜单项要显示在你通过manifest创建的消息显示工具栏菜单中。
• 你可以通过type: "separator"添加分隔线，通过parentId创建嵌套子菜单。
• 如果需要对当前显示的邮件进行操作，可以结合browser.messageDisplay API获取当前邮件的ID或内容，比如在点击事件中调用browser.messageDisplay.getDisplayedMessage(tab.id)获取当前邮件对象。

内容的提问来源于stack exchange，提问作者Giuseppe DS