Skip to content

⚡️ GM 值更新改为定向推送给运行该脚本的标签页,不再经 storage.local 广播到所有 frame - #1838

Draft
CodFrm wants to merge 6 commits into
release/v1.6from
fix/1834-value-update-fanout
Draft

CodFrm wants to merge 6 commits into
release/v1.6from
fix/1834-value-update-fanout

Conversation

@CodFrm

@CodFrm CodFrm commented Nov 9, 2026 •

Copy link
Copy Markdown
Member

Checklist / 检查清单

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

Description / 描述

fix #1834
related #1835

背景

scripting.js 以 <all_urls> + allFrames: true 注册,原来在每个 frame 里监听 chrome.storage.local.onChanged 来接收 SW 写入的 valueUpdateDelivery。onChanged 不能只订阅某个 key,所以任何一次 storage.local 写入(包括 ValueService 每次整包保存的 value:<storageName>)的新旧值都会投递到所有页面的所有 frame。数据越大、标签页越多,CPU 越高,#1834 就是这种情况。复现与根因见 #1835 (comment) 。

本次改动

不再借 storage.local 广播,改为 SW 用无状态的 tabs.sendMessage 定向投递:

  • 投递表 ValueUpdateDelivery(src/app/service/service_worker/value_delivery.ts):pageLoad 时登记每个 frame(tabId、frameId、documentId)运行的 storageName,持久化到 storage.session,SW 被回收后第一次投递前恢复。每次写入的查找是一次内存遍历,不再 tabs.query、也不再逐个读弹窗的 tabScript 缓存。
  • 按标签页合并:同一标签页同时只有一批消息在途,期间到来的更新按顺序攒成下一批(runtime/valueUpdates,一条消息携带多条更新);不同标签页之间并发、互不等待。
  • 整页还是定向:运行该 storageName 的 frame 不多时按 documentId 定向发给这些 frame,超过约三分之一时整个标签页发一次,由各 frame 的 scripting 按 storageName 过滤。
  • 单向通知:消息层新增 Server.onNotify / ExtensionContentMessageSend.notify,页面不回包。
  • 生命周期:pageLoad 一到达就把该 frame 登记为「待定」(查出运行哪些脚本前所有更新都投递给它,early-start 脚本此时已在运行),查完后改为实际的 storageName;顶层 frame 的 pageLoad 一到达还会清掉该标签页旧页面的登记;bfcache 还原时每个运行脚本的 frame 带上 storageName 经 pageShow 重新登记;tabs.onRemoved / onReplaced 清理;目标已不存在的 document 从表里移除。
  • 回执:GM_setValue / GM_setValues 的 valueSender 带上发起写入的 frameId、documentId,发起方 document 还没登记(页面早期写值)时也会单独投递,GM.setValue 的 Promise 能等到回执。投递路由按 document 区分,同一 frameId 下尚未清掉的旧 document 不会吞掉发给新 document 的回执。
  • 不属于任何标签页的 frame(扩展弹出窗口、侧边栏等页面里内嵌的网页):tabs.sendMessage 投递不到,SW 把本次更新随 GM_setValue 的应答带回,内容侧就地处理(回执完成、本脚本监听触发);扩展自身页面(offscreen 里的后台脚本)不带,由 offscreen 投递送达。
  • scripting 不再监听 storage.local.onChanged;删除 deliveryStorage 与 setSessionAccessLevel。

实现考虑

  • 为什么投递表落在 storage.session 而不是长连接:真相在 storage.session,内存里只是副本,SW 被回收只丢一份可重建的缓存,没有重连、断线检测,也没有页面在 bfcache 里拿着失效 port 的问题(⚡️ GM 值更新改用按 storageName 订阅的 Port 精准推送 #1848 讨论过的那类状态)。只持久化运行脚本的 frame:没有脚本的 frame(如反复载入的广告 iframe)只参与「整页还是定向」的计数,SW 重启后少计它们只会让选择偏向整页投递,结果仍然正确。
  • 为什么要有「一批在途」的门控:它把高频写入时的消息数从「写入次数 × 标签页数」降到大约「标签页数 × 往返轮数」,并保证同一 frame 收到的更新有序(乱序到达时较旧的值会覆盖页面里较新的值)。去掉门控的对照构建在场景 C 慢 2–4 倍、网页渲染进程 CPU 约翻倍(数据见验证)。
  • 整页 / 定向的阈值:Chrome 156 实测,一个 11 frame 的页面上发 300 次,整页一次 930–1545 ms;逐个定向 k=1 是 238–287 ms,k=3 是 823–1365 ms,k=6 是 1648–2152 ms。单条消息的固定成本约为整页投递里每多一个 frame 的两倍,据此取 3k > n + 2 时整页发送。
  • 单向通知:接收端不回包时,回调形式的 tabs.sendMessage 必然得到 lastError「The message port closed before a response was received」,Promise 形式则正常 resolve(Chrome 156 实测;Firefox 按 MDN 以无参数 fulfill),所以 notify 用 Promise 形式。单独一项只省约 10–20%,但门控需要的「发送完成」信号依赖它 resolve。
  • 两类发送失败分开处理:消息超过 64 MiB 时 tabs.sendMessage 同步抛出;目标 frame / 标签页不存在时才返回被拒绝的 Promise(Chrome 156 实测)。同步抛出视为调用被拒、目标仍在:合并后的批次逐条按顺序重发,单条本身超限则记录错误并跳过;只有 Promise 被拒绝才移出目标。区分依据是调用约定而不是错误文案,notify 因此保持同步透传,不能改成 async 函数(有单测锁定)。
  • pageLoad 竞态:清理旧页面必须在 pageLoad 处理的第一个 await 之前同步执行,否则新页面子 frame 先于顶层完成登记时会被一并清掉(有单测覆盖)。
  • Firefox:userScripts 世界收不到 runtime.onMessage;scripting.js 是普通 content script,可以收到,所以仍由它转发。MessageSender 没有 documentId 时退回按 frameId 定向。

已知限制

  • 门控让极端负载下的扇出延迟受往返长尾影响:单向通知从发出到 resolve 的耗时 p50 为 17–42 ms,但在 load avg 约 290 时 p99 到 1.6 s。此时下一批要等上一批 resolve,单写入方场景的扇出延迟会被拉长(同一轮里去掉门控的对照为 37 ms,本 PR 为 167 ms);load avg 约 75–110 时两者都是 40 ms。
  • 单条更新超过 64 MiB 无法投递:一次写入的新值加旧值超过扩展消息上限时,这条更新会被跳过(记录错误),页面里该 key 的缓存不会更新,发起方这次 GM.setValue 等不到回执;之后的更新不受影响。这是改用消息投递后才有的上限(本 PR 第一版同样存在);main 的 storage.local 广播在这个量级下的行为没有实测。
  • 整页投递场景的扇出延迟略高于 main:脚本在每页 11 个 frame 都运行的场景 D,扇出延迟中位数 18 ms,main 是 7 ms(负载噪声很大,三轮范围 12–170 / 3–7 ms);setValue 本身 4.9 vs 5.4 ms。
  • 整包持久化的线性成本仍然存在:大数据下单次写入仍随 value:* 整包大小增长,需要按 key 粒度持久化,不在本 PR 范围。
  • 不属于任何标签页的 frame 收不到其他页面写入的更新(扩展弹出窗口、侧边栏里内嵌的网页):自己写值的回执与本脚本监听已恢复,但别处的写入推不到这类 frame(tabs.sendMessage 需要 tabId),main 经 storage.onChanged 可以。要恢复只能为这类 frame 保留一条 storage 广播或长连接通道,是否值得由维护者决定。
  • Chrome 隐身("incognito": "split")未核实:两个 profile 各有一个 SW,各自只登记、投递自己的标签页;main 上 storage.local.onChanged 是否会把普通窗口的写入推给隐身窗口里运行同一脚本的页面(反之亦然)没有实测——自动化环境里隐身那一侧的 SW 一直没有启动,main 上脚本也没在隐身页运行,无法对比。用真实浏览器在普通 / 隐身窗口各开一个运行同一脚本的页面、一侧写值看另一侧即可确认。
  • 扩展进程 CPU 高于 main:main 只写一次 storage 由浏览器广播,本版在 SW 里逐个标签页发消息(场景 C 空存储 3.16 对 0.8 s,见下表)。
  • 每个运行脚本的 frame 载入时多一次 storage.session 写入(持久化投递表)。
  • 长寿命页面里被移除且从未被定向投递过的子 frame 会留在投递表里,直到该标签页顶层重新载入或关闭;只影响「整页还是定向」的计数与一次多余的投递,不影响正确性。其中运行脚本的 frame 会随记录写入 storage.session,持续新建运行脚本 iframe 的单页应用里这份记录会一直增长。
  • 与本 PR 无关、未改动:ExtensionContentMessageSend.sendMessage 用 !this.options?.frameId 判断,会把 frameId: 0 当成未指定而发给整个标签页(影响 emitEventToTab),建议另开修复。

建议审查重点

  • value_delivery.ts:deliver 对同步抛出 / Promise 被拒绝的区分;restore 与恢复前到达的 register / resetTab 的合并规则;flush 的队列身份判断(标签页关闭期间的在途批次);dropFrames 只移除发送时看到的那份记录。
  • runtime.ts 的 pageLoad:resetTab 与「待定」登记必须在第一个 await 之前。
  • gm_api.ts(SW)的 isTablessPageFrame 与内容侧 applyOwnValueUpdate:只有不属于标签页的网页 frame 才把更新随应答带回,带回时同一次更新不能再经投递处理一遍。
  • scripting.ts:子 frame 现在也监听 pageshow 并在运行脚本时上报;popupPageRestored 对 frameId 非 0 的上报本来就忽略。

验证

head b4633a97(已推送),base 为 origin/main 与 head 的 merge-base 4b5a584c;git diff origin/main...b4633a97 共 19 个文件。

单元测试(先写 RED 再改到 GREEN)

  • 新增 value_delivery.test.ts(23 例:旧 document 不吞发起方回执 / 发起方投递失败不误删同 frameId 的记录 / 批次超限逐条重发且队列不卡住 / 单条超限跳过后续照常 / 定向 / 发起方回执 / 整页阈值两侧 / 按 document 拆分 / 在途合并与顺序 / 标签页间不阻塞 / 失败移除 / 顶层重载 / 关闭与替换 / bfcache 重新登记 / SW 重启恢复与合并 / 只持久化运行脚本的 frame)、extension_message.test.ts(含「调用被拒时同步抛出」的契约);扩充 server.test.ts(onNotify)、scripting.test.ts(批量过滤、各 frame 的 pageShow 上报)、runtime.test.ts(pageLoad / pageShow 登记、顶层清理竞态、查询脚本期间的「待定」投递)、SW gm_api.test.ts(valueSender 带 frame;只有不属于标签页的网页 frame 的应答带回更新)、内容侧 gm_api.test.ts(应答带回更新时 GM.setValue / GM.setValues 完成并触发本脚本监听)。packages/chrome-extension-mock 补了 tabs.onReplaced。
  • pnpm exec vitest run --no-coverage --no-file-parallelism src/app/service/content src/app/service/service_worker src/app/service/offscreen src/app/service/sandbox packages/message:61 个文件、1212 个测试全部通过。pnpm run typecheck、改动文件的 eslint / prettier 通过。

运行时功能(Chrome 156 headless,b4633a97 的构建)

  • 跨标签页 + 同源 iframe 的 GM_addValueChangeListener [旧值→新值, remote] 序列 3/3 与修复前逐条一致。
  • bfcache:标签页 B 跳到不匹配脚本的页面再后退(确认从 bfcache 还原),其他标签页写值。上一版 53a1bddf:B 收不到;本版 3/3 收到。
  • SW 回收:5 个运行脚本的标签页空闲 45 s,SW 在写值前已被回收(裸起 Chrome,只附着页面),冷启动后从 storage.session 恢复,3/3 次 5/5 个标签页都收到。
  • 预渲染(speculation rules)激活的页面:确认 activationStart > 0,激活后能收到其他标签页的更新,自己写值回执正常,2/2。
  • 扩展弹出窗口(chrome.action.openPopup())里内嵌运行脚本的网页:main 自己写值 10 ms 返回、本脚本监听触发、收到其他标签页的写入;修复前 40b25ff3 自己写值 8 s 超时、监听不触发;本版 3 ms 返回、监听触发(remote 为 false),其他标签页的写入仍收不到(见已知限制)。
  • 页面冻结(Page.setWebLifecycleState frozen)期间另一标签页连续写 20 次:main 与本版一致——写入方回执不受影响,解冻后按顺序收到 20/20,之后的写入照常。
  • pnpm exec playwright test e2e/gm-api.spec.ts -g "API tests|Content inject":3 passed。
  • 消息上限:探针扩展确认超过 64 MiB 时同步抛出、目标不存在时异步拒绝。在真实扩展里用 40 MiB 级写入复现队列卡死没有成功(页面主线程被大值处理拖住,脚本超时),该缺陷以单测按 Chrome 实测行为复现。
  • 隐身:尝试了 CDP 浏览上下文与 chrome.windows.create({ incognito: true }) 两种方式,隐身那一侧的 SW 都没有启动、main 上脚本也不在隐身页运行,未能对比(见已知限制)。

Firefox MV3(Firefox 154,Selenium + geckodriver,解包安装),b4633a97 2/2(此前 64e8b4d4 3/3、40b25ff3 1/1):跨标签页 / iframe 序列同上;bfcache 还原后收到;event page 处于 stopped 时写值,回执与其他标签页接收都正常。

性能(headless Chrome 156,全部在开发机上跑)。四个构建按轮次轮换各跑 3 轮,格式为「中位数(第 1 / 2 / 3 轮)」。⚠️ 测试期间机器有大量其他负载(load avg 36–344),单轮波动很大,只宜看量级与同轮相对关系。main = 4b5a584c(广播);上一版 = 53a1bddf;Port = 本 PR 评论里的 runtime.connect 订阅原型(spike/1834-value-port);本版 = 本 PR 在 64e8b4d4 之前的构建;之后的改动(只持久化运行脚本的 frame、超限逐条重发、pageLoad 时的「待定」登记、按 document 区分路由、不属于标签页的 frame 随应答带回更新)未重测性能,其中只有「待定」登记与路由键处在正常路径上。所有运行中每个标签页都收到了全部更新。

场景:A = 1 页写 / 50 页接收;B = 1 页写 / 50 个不运行脚本的页(各带 2 个 iframe);C = 50 页每 200 ms 同时写、各 10 次,已有存储为空 / 1 KB;D-framed = 20 页、脚本在每页 11 个 frame 都运行;D-ads = 20 页、每页另有 10 个不运行脚本的跨站 iframe。

setValue p50(ms)

场景 main 上一版 Port 本版
A 28.4 (5.9 / 28.4 / 29.8) 21.4 (21.4 / 39.3 / 9.2) 5.7 (5.7 / 5.9 / 2.3) 8.4 (24.2 / 8.4 / 6.1)
B 17.4 (36.6 / 12.5 / 17.4) 12.7 (12.7 / 8 / 14.8) 3.3 (22.4 / 3.3 / 1.3) 2.4 (1.8 / 4 / 2.4)
C 空 1329 (1478 / 1329 / 581) 1805 (2340 / 1805 / 1218) 472 (2402 / 472 / 198) 603 (603 / 925 / 550)
C 1 KB 742 (1161 / 720 / 742) 2068 (2068 / 2306 / 1719) 720 (720 / 750 / 36.7) 455 (280 / 510 / 455)
D-framed 5.4 (3.5 / 6.8 / 5.4) 11.3 (14.8 / 11.2 / 11.3) 3.7 (3.7 / 3.4 / 3.8) 4.9 (16.3 / 4.9 / 3.7)
D-ads 16.6 (20.1 / 16.6 / 8.1) 42.6 (9.1 / 65.8 / 42.6) 2.3 (2.1 / 7.5 / 2.3) 3.9 (16.2 / 3.9 / 3.6)

setValue p95(ms)

场景 main 上一版 Port 本版
A 137 (13.3 / 869 / 137) 75.2 (75.2 / 796 / 18.5) 25.5 (29.1 / 25.5 / 6.4) 92.6 (1051 / 92.6 / 11.6)
B 99.2 (99.2 / 99.2 / 77.8) 51.5 (1539 / 12.1 / 51.5) 101 (242 / 101 / 2.9) 40 (4.7 / 63.4 / 40)
C 空 4792 (5917 / 4792 / 1144) 3604 (3604 / 3729 / 1520) 630 (5625 / 630 / 344) 1896 (4693 / 1896 / 593)
C 1 KB 1647 (1872 / 1429 / 1647) 4801 (3427 / 4801 / 4965) 1487 (3443 / 1487 / 217) 876 (876 / 3121 / 812)
D-framed 13.6 (6.2 / 581 / 13.6) 59.6 (45.5 / 59.6 / 426) 26.3 (14.5 / 456 / 26.3) 18.6 (165 / 10.8 / 18.6)
D-ads 253 (253 / 260 / 32.6) 482 (482 / 394 / 1559) 8 (5.9 / 826 / 8) 16.8 (468 / 13 / 16.8)

扇出延迟 p50(ms,一次写入到所有标签页都收到)

场景 main 上一版 Port 本版
A 45 (10 / 56 / 45) 50 (50 / 84 / 28) 14 (18 / 14 / 7) 45 (498 / 45 / 28)
D-framed 7 (3 / 7 / 7) 27 (27 / 22 / 29) 7 (7 / 7 / 9) 18 (170 / 12 / 18)
D-ads 23 (27 / 23 / 11) 165 (34 / 165 / 181) 5 (5 / 13 / 5) 14 (502 / 11 / 14)

场景 C 从开始到全部投递完成(ms)

场景 main 上一版 Port 本版
C 空 28202 (28202 / 99021 / 10208) 25931 (27713 / 25931 / 15836) 8878 (33176 / 8878 / 5280) 12208 (17629 / 12208 / 8234)
C 1 KB 14717 (14717 / 15713 / 11888) 30667 (25197 / 30667 / 66002) 16635 (16653 / 16635 / 3109) 9428 (9428 / 19869 / 7317)

进程 CPU(s,测量窗口内增量的中位数,浏览器主进程 / 网页渲染进程 / 扩展进程)

场景 main 上一版 Port 本版
A 0.48 / 1.43 / 0.07 0.91 / 1.12 / 0.43 0.21 / 0.57 / 0.08 0.8 / 1.49 / 0.29
B 0.45 / 2.21 / 0.08 0.32 / 0.47 / 0.15 0.12 / 0.17 / 0.04 0.17 / 0.3 / 0.04
C 空 5.2 / 14.79 / 0.8 14.4 / 14.83 / 6.38 2.66 / 7.89 / 1.22 8.08 / 10.82 / 3.16
C 1 KB 6.52 / 16.4 / 0.72 15.76 / 16.7 / 6.58 2.95 / 8.58 / 1.38 5.57 / 6.61 / 2.2
D-framed 0.22 / 0.41 / 0.04 0.48 / 0.45 / 0.19 0.13 / 0.27 / 0.05 0.33 / 0.41 / 0.12
D-ads 0.26 / 1.64 / 0.05 1.49 / 5.99 / 0.27 0.13 / 0.3 / 0.06 0.33 / 0.45 / 0.13

读法:相对上一版,本版在所有场景、所有指标上都更好,三轮基本一致。相对 main,本版在 A / B / C / D-ads 的 setValue 与 C 场景网页进程 CPU 上更好,但扩展进程 CPU 各场景都高于 main(C 空 3.16 s 对 0.8 s:main 只写一次 storage 由浏览器广播,本版在 SW 里逐个标签页发消息),D-framed 的扇出延迟也更高(18 对 7 ms)。相对 Port,Port 在 A / D 的延迟与主进程 CPU 上三轮都更低;C 场景 Port 单轮波动太大(198–2402 ms),无法判断胜负。

门控对照(64e8b4d4 的构建 vs 去掉「一批在途」门控的构建,以及加了计时的同一构建,按轮次轮换 2 轮)

轮 构建 场景 load setValue p50 / p95 ms 扇出延迟 p50 / max ms C 总耗时 ms CPU 主进程 / 网页 / 扩展 s 单向通知 resolve p50 / p99 ms
1 计时 A 294 9.4 / 485 360 / 686 – 1.06 / 3.3 / 0.3 26 / 1625
1 计时 C 空 207 791 / 2691 – 15692 5.02 / 7.36 / 2.23 29 / 625
1 去掉门控 A 149 10.7 / 47 37 / 381 – 0.7 / 0.99 / 0.26 –
1 去掉门控 C 空 134 1986 / 8099 – 32750 11.76 / 16.82 / 4.53 –
1 本版 A 127 15.7 / 186 167 / 1193 – 0.76 / 1.53 / 0.31 –
1 本版 C 空 160 429 / 1312 – 11470 5.52 / 7.32 / 2.43 –
2 计时 A 110 7.8 / 16.8 31 / 180 – 0.71 / 1.05 / 0.26 17.5 / 166
2 计时 C 空 106 1419 / 2515 – 19073 7.27 / 9.71 / 3.18 42 / 425
2 去掉门控 A 94 7.7 / 29.1 40 / 451 – 0.75 / 1.21 / 0.27 –
2 去掉门控 C 空 75 1460 / 3080 – 19588 11.11 / 14.92 / 4.08 –
2 本版 A 75 8.9 / 31.4 40 / 244 – 0.76 / 1.12 / 0.28 –
2 本版 C 空 84 647 / 1239 – 10183 5.56 / 8.08 / 2.46 –

去掉门控后场景 C 慢 2–4 倍、网页进程 CPU 约翻倍;门控的代价在负载极高时显现(单写入方扇出延迟 167 对 37 ms),负载约 75–110 时两者都是 40 ms。本版在上表 A 的第 1 轮出现的约 500 ms 扇出延迟也是这个原因。

Screenshots / 截图

N/A — 无界面改动。

scripting.js 以 <all_urls> + allFrames 注册并监听 chrome.storage.local.onChanged,
任何一次 local 写入(包括整包的 value:*)的新旧值都会被投递并反序列化到所有页面的所有 frame,
存储数据较大或标签页较多时导致 CPU 占用高(#1834)。

- SW 按弹窗的标签页脚本缓存找出运行该 storageName 的标签页,外加发起写入的标签页,逐个 tabs.sendMessage
- scripting 去掉 storage.local.onChanged 监听,runtime/valueUpdate 按本 frame 的 storageName 过滤
- 删除不再使用的 deliveryStorage 与 setSessionAccessLevel
@cyfung1031

Copy link
Copy Markdown
Collaborator

@CodFrm 我覺得最終還是不要用storage.local 儲data 吧
跨頁通訊只有storgae.local 最有效
但你要數據儲存方法多的是
以前有indexeddb
之後又有opfs

@CodFrm

CodFrm commented Nov 9, 2026

Copy link
Copy Markdown
Member Author

@CodFrm 我覺得最終還是不要用storage.local 儲data 吧 跨頁通訊只有storgae.local 最有效 但你要數據儲存方法多的是 以前有indexeddb 之後又有opfs

indexeddb 经常丢数据,opfs 不合适,性能问题怕不是更差,而且这里并不是存储结构的问题啊,是因为之前用 chrome.storage.local 用来做通讯广播导致的

@cyfung1031

cyfung1031 commented Nov 9, 2026 •

Copy link
Copy Markdown
Collaborator

我有一个想法


每个 scripting 在初始时做一个 runtime.connect 发给中央 (service worker) (完全不需要tab query.)
然后中央要更新时,直接跟被开始的 port 沟通
这样的话就不需要query 跟browser内部再配对tab和document window (像broadcastmessage一样直接用 messageport 传东西, 不走 tab api )

再进一步的话,
由于各tab的mainframe subframe scripting已经知道自己页面有什么脚本在执行
可以在port 沟通时指明 storagename (=uuid) filter
这样就不用全部tab试一次再tab里面搞filter. 直接减少沟通用数据
( port01 发scriptA 和 C, port02 发 scriptB和 D, port 03 发 scriptE , .... )

port断了的话,scripting就自动重连.
如果scripting 没重连,先考虑简单情况,即frame window 消失了,这样中央要更新时就直接发少一个
这是自动释放。 中央直接观察 onDisconnect 就可以。
(复杂的休眠情况,等wake up 时 scripting 能再发出 runtime.connect. 这也避免了中央把一大堆死data 传给休眠 tab 的问题)

PS. port 建立了以后,port本身就是一个 标配的 javascript 跨域通讯方式。 它的 postMessage onmessage 都不再需要跑 extension 那一块 呀,原來還是歸 runtime api 裡的


我觉得是行得通的

你可以先还原,之后再找AI试试这做法
实作会比较复杂
但有AI嘛,不怕


cyfung1031 的核心想法是用 Port 长连接实现精准消息推送,减少不必要的广播和查询开销。他建议每个页面及 iframe 的 scripting 启动时,通过 runtime.connect 连接到 Service Worker,并上报当前运行脚本的 storageName。当数据更新时,Service Worker 就能直接向订阅了对应数据的 Port 推送消息,无需 tabs.query、tabs.sendMessage,也不必在各个标签页内再次过滤。Port 断开时通过 onDisconnect 自动清理,页面恢复后重新连接。这个方案在架构上比较合理,能够减少无效通信,并让订阅关系跟随页面生命周期自动维护;但需要妥善处理 MV3 Service Worker 休眠、重启、断线重连及订阅状态恢复等问题,实现复杂度较高。

总体而言,Port 方案值得进一步验证,但需要通过实际性能测试确认收益是否足以抵消复杂度。

@CodFrm

CodFrm commented Nov 10, 2026 •

Copy link
Copy Markdown
Member Author

runtime.connect 好像有问题,某些环境不支持 runtime.connect,原来我用过,我再验证一下

#534

好像是这个,不过没影响


不过还有一个问题,SW是有生命周期,会断掉的,有复杂性,另外connect是长链接,资源占用不一定比postMessage低

@CodFrm

CodFrm commented Nov 10, 2026

Copy link
Copy Markdown
Member Author

runtime.connect 订阅方案实测

结论:Port 订阅方案在 Chrome 上可行,五个测试场景都比本 PR 和 main 快,CPU 也更省。但要补三处才能保证正确,而且只要还有标签页在运行脚本,SW 就会一直常驻,这个取舍需要决定。另外测出本 PR 有一个 bfcache 回归,不管最后选哪个方案都要修。

关于「某些环境不支持 runtime.connect」

这个说法应该来自 #534:Opera 的 content script 里没有 runtime.onConnect,但 runtime.connect 是有的。src/scripting.ts:31 的注释说的也是 onConnect。scripting.js 现在本身就在用 runtime.connect:runtime/gmApi 的长连接(GM_xmlhttpRequest、GM_download 等)就是经 forwardMessage → ExtensionMessage.connect → chrome.runtime.connect() 转发的。Port 方案只需要 content 主动 connect、SW 侧 onConnect,用不到 content 侧的 onConnect。Opera 本机没有,未实测。

原型实现

基于本 PR head 53a1bddf 做的本地原型,没有推送:

  • scripting 在 pageLoad 得知本 frame 运行哪些 storageName 后,通过 runtime.connect 向 SW 订阅。没有脚本的 frame 不建连接。
  • SW 维护 storageName → port 的索引,值更新直接 port.postMessage,不再 tabs.query,也不查 tabScript 缓存。
  • 被动断开(SW 重启)时重连;pageshow(persisted) 时强制重连,原因见下。
  • 发起写入的 frame 还没订阅时(pageLoad 之前写值,如 early-start 脚本),退回用 tabs.sendMessage 发给这个 frame,保证 GM.setValue 能收到回执。为此给 ValueUpdateSender 加了 frameId。

正确性

  • 跨标签页、同源 iframe 的 GM_addValueChangeListener 新旧值、remote 标记、GM.setValue 回执:3/3 通过。[新值, remote] 序列与 main、本 PR 一致,没有重复投递。
  • bfcache(Port 方案):直接按提议实现时,页面从 bfcache 还原后收不到更新。原因是进入 bfcache 时只有 SW 一侧收到断开,页面这一侧收不到 onDisconnect,一直拿着已经失效的 port。加上 pageshow(persisted) 时重连后 3/3 通过。
  • bfcache(本 PR 的回归):复现步骤:标签页 B 跳到一个不匹配脚本的页面,再后退(bfcache 还原),然后由其他标签页写值,B 收不到更新。main 3/3 通过,本 PR 3/3 失败。原因:跳走时,frameId 0 的 pageLoad 清空了 tabScript:<tabId>;还原时 RuntimeService.pageShow 只发出 popupPageRestored,markTabInjected 只记录 origin,没有恢复运行记录,所以 getTabIdsByStorageName 查不到这个标签页。

SW 生命周期

e2e/session.mjs 的会话里,Playwright 和日志收集器都附着在 SW 上,附着了 DevTools 的 SW 不会被空闲回收。所以这一项是单独启动 Chrome、只附着页面来观察的(5 个运行脚本的标签页):

  • main、本 PR:SW 空闲约 31 s 后被回收。
  • Port:360 s 内一直没有被回收,也没有出现 5 分钟强制断开。

也就是说,只要有标签页在运行脚本,SW 就会常驻。好处是没有冷启动:空闲后第一次写入,本 PR 需要 203 ms,Port 是 41–94 ms。代价是 SW 的内存一直占着。

性能

沿用 #1835 评论里的测试脚本,Chrome 156 headless,三个版本按场景轮换跑三轮。表中是单次写入 p50 的中位数,括号里是三轮的范围;所有运行中每个标签页都收到了全部更新。

场景 main(广播) 本 PR Port
A. 1 页写 / 50 页接收,存储为空 6.1 ms (5.5–7.5) 12.5 ms (8.4–37) 2.9 ms (2.4–4.2)
A. 同上,存储 100 KB 169 ms (103–203) 19 ms (12–46) 8.1 ms (7.5–9.2)
B. 1 页写 / 50 个无关页 26 ms (13–35) 6.3 ms (4.3–14) 1.0 ms (0.8–1.8)
C. 50 页同时写,存储为空 207 ms (191–236) 822 ms (690–1066) 59 ms (51–138)
C. 50 页同时写,存储 1 KB 580 ms (289–657) 1068 ms (747–2156) 63 ms (27–139)

浏览器主进程 CPU 受负载影响最小,三轮几乎不变。场景 C 存储为空时:main 4.4–4.8 s、本 PR 11–14 s、Port 2.3–2.6 s;存储 1 KB 时:6.5–7.0 s、12–16 s、2.5–2.7 s。本 PR「已知限制」里那一档(存储很小、多页同时写入,比广播慢),在 Port 方案下反而比广播还快:每次写入省掉了 tabs.query 和缓存查询,也省掉了浏览器主进程逐个标签页的路由。

局限

@cyfung1031

Copy link
Copy Markdown
Collaborator

看到你的測試結果感覺更值得做了
那些缺點也不是缺點

@cyfung1031

Copy link
Copy Markdown
Collaborator

改为 draft. 应直接处理更理想的 #1848

@CodFrm

CodFrm commented Nov 11, 2026

Copy link
Copy Markdown
Member Author

更正:上面那条评论里「Port:360 s 内一直没有被回收……只要有标签页在运行脚本,SW 就会常驻」是错的。

当时用「SW target 是否存在」轮询,原型断开后立刻重连,SW 的停止和重启都发生在 250 ms 的轮询间隔里,所以没看到。改成跟踪 SW target 的 id 后:300 秒内 main 和 Port 原型都出现了 6 个 SW 实例(每次空闲约 30 秒就被回收),空闲时扩展进程 CPU 是 0.81 s 和 1.05 s。所以 Port 方案并不会让 SW 常驻,「SW 常驻」这个取舍也不存在。原评论其余数据不受影响。#1848 的实测结果另外写在 #1848 里。

@CodFrm

CodFrm commented Nov 11, 2026

Copy link
Copy Markdown
Member Author

看到你的測試結果感覺更值得做了 那些缺點也不是缺點

由于 SW 这种会自杀的特性,这些有状态的都不好处理,如果再继续在这个上面优化postMessage呢?

主要瓶颈应该是在搜索匹配,发信的消耗应该是差不多的

@cyfung1031

Copy link
Copy Markdown
Collaborator

看到你的測試結果感覺更值得做了 那些缺點也不是缺點

由于 SW 这种会自杀的特性,这些有状态的都不好处理,如果再继续在这个上面优化postMessage呢?

主要瓶颈应该是在搜索匹配,发信的消耗应该是差不多的

這正是解決了自殺特性
如果不理SW 自殺
SW 死掉腳本就不能跑
(目前沒有這樣的機制,全靠瀏覽器做 navigate 動作時觸發SW)

用runtime connect 可以重新呼叫sw
自動復活

當然 agent 找出來的edge case 要處理

@CodFrm

CodFrm commented Nov 11, 2026

Copy link
Copy Markdown
Member Author

看到你的測試結果感覺更值得做了 那些缺點也不是缺點

由于 SW 这种会自杀的特性,这些有状态的都不好处理,如果再继续在这个上面优化postMessage呢?
主要瓶颈应该是在搜索匹配,发信的消耗应该是差不多的

這正是解決了自殺特性 如果不理SW 自殺 SW 死掉腳本就不能跑 (目前沒有這樣的機制,全靠瀏覽器做 navigate 動作時觸發SW)

用runtime connect 可以重新呼叫sw 自動復活

當然 agent 找出來的edge case 要處理

我在 #1848 (comment) 写了问题

接收端不回包、监听返回 false,发送端用 Promise 形式的 tabs.sendMessage
(回调形式在接收端不回包时必有 lastError,Chrome 156 实测)。
供高频、不需要回执的一对多推送使用。
- 新增 ValueUpdateDelivery:pageLoad / pageShow 登记各 frame 运行的 storageName,
  真相存于 storage.session,SW 回收后首次使用时恢复;不再每次写入都 tabs.query
  并逐个读取 popup 的 tabScript 缓存。
- 同一标签页同时只有一批消息在途,期间的更新合并成下一批;不同标签页之间并发。
- 运行该脚本的 frame 不多时按 documentId 定向,超过约三分之一时整页投递一次。
- 值更新改用单向通知 runtime/valueUpdates,页面不回包。
- 顶层 frame 的 pageLoad 一到达就清掉旧页面登记;bfcache 还原时各 frame 带上
  storageName 重新登记,修复本 PR 先前版本还原后收不到更新的回归。
- GM_setValue / GM_setValues 的 valueSender 带上 frameId、documentId,
  发起方尚未登记时也能单独收到回执。
tabs.sendMessage 在消息超过 64 MiB 时同步抛出(Chrome 156 实测),目标不存在时才返回被拒绝的
Promise。原实现没有区分两者:同步异常让 flush 的 Promise 被拒绝,该标签页的队列条目再也不会被删除,
之后的更新全部只入队不发送,发起方的 GM.setValue 也等不到回执。

现在同步抛出视为调用被拒、目标仍在:合并后的批次逐条按顺序重发,单条本身超限则记录错误并跳过;
只有 Promise 被拒绝才把目标移出投递表。
- pageLoad 一到达就把该 frame 登记为「待定」,查出运行哪些脚本前所有更新都投递给它。
  early-start 脚本在 document_start 就已运行,原实现要等 getScriptsForTab 返回才登记,
  这段时间里其他标签页的写入送不到(main 上 scripting 从初始化起就监听,pageLoad 返回前两侧都转发)。
- 投递路由按 document 区分。子 frame 跳到新页面、新页面尚未登记完成时,early-start 脚本写值的回执
  原本会被并进同一 frameId 下旧 document 的路由而发丢,GM.setValue 等不到完成;投递失败时也只移除
  对应 document 的记录。
扩展弹出窗口、侧边栏等页面里内嵌的网页 frame 没有 tabId,tabs.sendMessage 投递不到,
GM.setValue / GM.setValues 的 Promise 只靠投递来的值更新完成,因此永远等不到(main 经
storage.local.onChanged 能送达)。现在 SW 识别出这类发起方时把本次更新随 GM_setValue 的应答带回,
内容侧收到后就地处理:回执完成、本脚本的监听照常触发。扩展自身页面(offscreen 里的后台脚本)
不带,它们由 offscreen 投递送达。

其他标签页写入的更新仍无法推送到这类 frame。
@CodFrm

CodFrm commented Nov 13, 2026

Copy link
Copy Markdown
Member Author

更新:改为投递表定向 + 按标签页合并(head b4633a97)

在上一版「每次写入 tabs.query + 逐个读 popup 缓存 + 整标签页 tabs.sendMessage」的基础上,保持无状态的 tabs.sendMessage(不用长连接),改了四处:

  1. 投递表:pageLoad 时登记每个 frame 运行的 storageName,存 storage.session,SW 回收后恢复;查找变成一次内存遍历。
  2. 按标签页合并:同一标签页同时只有一批在途,期间的更新攒成下一批;标签页之间并发。
  3. 整页 / 定向:运行该脚本的 frame 不到约三分之一时按 documentId 定向,否则整页发一次(阈值来自 Chrome 156 实测)。
  4. 单向通知:页面不回包(Server.onNotify / ExtensionContentMessageSend.notify)。

顺带修了上一版的 bfcache 回归(还原后收不到更新),PR 描述的「验证」里有前后对比。

性能(开发机,负载很重,只看量级)

四个构建轮换各 3 轮,setValue p50 中位数(ms)。完整表格(p95、扇出延迟、三类进程 CPU、门控对照)见 PR 描述。

场景 main 上一版 Port 原型 本版
1 页写 / 50 页收 28.4 21.4 5.7 8.4
1 页写 / 50 个无关页 17.4 12.7 3.3 2.4
50 页同时写,空存储 1329 1805 472 603
50 页同时写,1 KB 742 2068 720 455

相对上一版全面更好;相对 main,setValue 与网页进程 CPU 更好,但扩展进程 CPU 更高(SW 逐个标签页发消息);相对 Port,Port 在单写入方延迟与主进程 CPU 上三轮都更低,多页同时写的场景单轮波动太大,分不出胜负。测试期间 load avg 36–344,需要的话我可以在空闲机器上重跑。

回归排查

另做了一轮独立审查(只给代码与 main 作基准),逐条在本机复核,修了三处:

  • 消息超过 64 MiB 时该标签页的投递队列永久卡死(40b25ff3):超限时 tabs.sendMessage 是同步抛出,原实现没接住。现在批次超限逐条重发,单条超限跳过。
  • early-start 脚本的两处缺口(599b280c):页面登记完成前收不到其他标签页的更新;子 frame 跳转后、新页面登记前写值,回执会被并进旧 document 而发丢。现在 pageLoad 一到达就登记为「待定」,路由按 document 区分。
  • 扩展弹出窗口 / 侧边栏里内嵌的网页中 GM.setValue 永不返回(b4633a97):用 chrome.action.openPopup() 实测复现(修复前 8 s 超时,main 10 ms)。现在更新随应答带回。

实测确认不是回归:预渲染激活的页面、页面冻结后解冻、Firefox 与 Chrome 的 documentId 支持版本一致。

需要拍板 / 帮忙确认

  1. 弹出窗口、侧边栏里内嵌的网页收不到其他页面写入的更新:这类 frame 没有 tabId,tabs.sendMessage 到不了;main 可以。要恢复只能给它们单独保留 storage 广播或长连接。我倾向先作为已知限制,是否要补由你们定。
  2. Chrome 隐身窗口:扩展是 split 模式,普通 / 隐身两侧的 SW 各自只投递自己的标签页。main 上 storage 事件会不会跨两侧推送,我在自动化环境里没能验证(隐身侧 SW 起不来,main 上也一样)。用真实浏览器在普通、隐身窗口各开一个跑同一脚本的页面,一侧写值看另一侧,两分钟能确认。
  3. 单条更新超过 64 MiB(新值 + 旧值)投递不了,这条更新被跳过、发起方这次 GM.setValue 不返回;之后的更新正常。上一版同样存在。是否要做降级(如超限时不带旧值)由你们定。

@CodFrm
CodFrm changed the base branch from main to release/v1.6 November 16, 2026 10:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Compatibility] 出现CPU占用多,内存一直增长的问题

2 participants