Thunderbird插件问题：无法调用messageDisplayScripts添加邮件底部内容

排查步骤 #

• 确认Manifest配置与注册时机
  确保manifest.json指定了正确的版本（V2或V3均可，推荐V3），并将脚本注册代码放在扩展启动的触发逻辑中，比如runtime.onInstalled回调内，避免代码未执行：

  messenger.runtime.onInstalled.addListener(async () => {
    await messenger.messageDisplayScripts.register({
      js: [{ file: 'test.js' }],
      matches: ["messageDisplay://*/*"], // 明确绑定邮件显示页面
      allFrames: true
    });
  });
  

  必须指定matches规则，否则脚本无法关联到正确的邮件页面上下文。

• 查看扩展专属控制台
  不要使用普通浏览器控制台，打开Thunderbird的「附加组件管理器」，找到你的插件并点击「调试」，查看背景页面的控制台，这里能显示脚本注册的具体错误（比如权限缺失、路径错误）。

• 验证文件与打包完整性
  确认test.js确实在插件根目录，打包扩展时未遗漏该文件。如果使用web-ext工具打包，检查配置文件是否误排除了该文件。

• 补充必要权限
  除了messagesModify，在manifest.json中添加host_permissions以允许访问邮件页面：

  "host_permissions": ["messageDisplay://*/*"]
  

替代方案：通过messageDisplay事件手动注入脚本 #

如果messageDisplayScripts始终无法生效，可改用messageDisplay.onMessageDisplayed事件手动注入脚本实现需求：

1. 在background.js中监听邮件显示事件：

messenger.messageDisplay.onMessageDisplayed.addListener(async (tab, message) => {
  try {
    await messenger.tabs.executeScript(tab.id, {
      file: 'test.js',
      allFrames: true // 确保注入到邮件内容的iframe中
    });
  } catch (err) {
    console.error('脚本注入失败:', err);
  }
});

2. 在test.js中操作DOM添加底部内容：

console.info("Test.js called");
// 定位邮件内容容器（不同Thunderbird版本可能略有差异，可自行调整选择器）
const contentContainer = document.querySelector('.moz-text-html') || document.getElementById('messagepane') || document.body;
// 创建自定义底部区块
const footerBlock = document.createElement('div');
footerBlock.style.marginTop = '15px';
footerBlock.style.padding = '10px';
footerBlock.style.borderTop = '1px solid #e0e0e0';
footerBlock.innerHTML = '<p>这是添加的自定义底部内容</p>';
// 将区块添加到邮件底部
contentContainer.appendChild(footerBlock);

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