Checklist / 检查清单

• Fixes mentioned issues / 修复已提及的问题
• Code reviewed by human / 代码通过人工检查
• Changes tested / 已完成测试

Description / 描述

本 PR 修复消息层（SW ↔ offscreen / 跨上下文广播）中三个现有 vitest / e2e 均无法暴露的隐性运行时问题。每个问题均先补充失败测试再修复（TDD），共新增 12 个单元测试。

问题 1：MessageQueue.publish 未检查 chrome.runtime.lastError

现象：广播消息（enableScripts、valueUpdate 等）在无其他上下文存活时产生 Unchecked runtime.lastError: Could not establish connection. Receiving end does not exist.；MV3 下不传回调时 chrome.runtime.sendMessage 返回 Promise，直接变成 unhandled rejection。Firefox MV3（事件页、无 offscreen 文档）下后台每次广播都会触发；Chrome 在 SW 启动早于 offscreen 创建的窗口期同样会触发。

根因：packages/message/message_queue.ts 的 publish() 以 fire-and-forget 方式调用 chrome.runtime.sendMessage 且不传回调，lastError 永远无人读取。项目自有 ESLint 规则 require-last-error-check 只能约束"有回调但未检查"的形态，无回调的形态是盲区。

修复：传入回调并读取 chrome.runtime.lastError；无接收方属于广播的正常情况，仅记录 trace 日志，不再污染控制台/产生 unhandled rejection。

问题 2：SW→offscreen 消息在 offscreen 客户端未就绪时崩溃（消息静默丢失）

现象：SW 启动后、offscreen 文档创建完成前，任何经 ServiceWorkerMessageSend 发往 offscreen 的消息（如 runtime/valueUpdate、runScript）抛出 TypeError: Cannot read properties of undefined (reading 'postMessage')，消息静默丢失且无可诊断信息。

根因：packages/message/window_message.ts 的 init() 只做一次 clients.matchAll() 查找，查不到时 this.target 为 undefined，connect() / sendMessage() 用非空断言 this.target! 直接发送。另外 target 一旦缓存永不刷新，offscreen 重建后旧 Client 引用已失效。

修复：

• 发送前轮询等待 offscreen 客户端出现（200ms 间隔、上限 30s，多个并发发送共享同一次等待）；超时以可诊断的错误拒绝，调用方（sendMessage 的 Promise 链）能正常捕获。
• 收到来自 offscreen 的消息时用其 source（即当前有效客户端）刷新 target，并校验 source.url 必须等于 offscreen 文档 URL，防止其他页面污染 target。

问题 3：offscreen 文档创建一次失败后永久卡死，直至 SW 重启

现象：chrome.offscreen.createDocument 一旦拒绝（启动资源压力、与关闭中的文档竞态出现 "Only a single offscreen document may be created" 等暂时性失败），本次 SW 生命周期内 offscreen 环境永远无法建立——后台脚本、定时脚本、沙箱全部失效，且伴随 unhandled rejection。

根因：src/service_worker.ts 中 creating latch 在 Promise 拒绝后停留在 rejected 状态且永不重置；main() 对 setupOffscreenDocument() 也没有任何错误处理。

修复：抽出为可独立测试的 src/app/service/service_worker/offscreen_setup.ts 模块：

• 创建失败按退避（500ms / 1s / 2s）重试；
• 失败后复查文档存在性，与检查之间的 TOCTOU 竞态（文档实际已存在）视为成功；
• 持续失败时返回 false 并重置 latch，后续调用可重新尝试；不再产生 unhandled rejection；
• 并发调用仍共享同一次创建（保持原语义）；Firefox（无 chrome.offscreen）行为不变。

测试 / Test results

• 新增 12 个单元测试（先写失败测试确认能复现，再修复转绿）：
  • packages/message/message_queue.test.ts：publish 必须传回调并在回调中读取 lastError；
  • packages/message/window_message.test.ts：客户端未出现时等待后发送、始终不可用时描述性拒绝、来源刷新 target、非 offscreen 来源不污染 target；
  • src/app/service/service_worker/offscreen_setup.test.ts：已存在跳过创建、并发共享、TOCTOU 视为成功、退避重试、持续失败后 latch 重置、Firefox 降级。
• 全量单测：vitest run 294 文件 / 3142 用例全部通过。
• pnpm run typecheck、ESLint、pnpm run build（Rspack 生产构建）通过。
• e2e 冒烟：background-script.spec.ts（offscreen 路径）、gm-api.spec.ts、popup.spec.ts 全部通过。

Screenshots / 截图

无 UI 变更 / No UI changes.

🤖 Generated with Claude Code