Skip to content

⚡️ GM 值更新改用按 storageName 订阅的 Port 精准推送 - #1848

Draft
cyfung1031 wants to merge 65 commits into
mainfrom
pr/central-runtime-connection-202611
Draft

cyfung1031 wants to merge 65 commits into
mainfrom
pr/central-runtime-connection-202611

Conversation

@cyfung1031

@cyfung1031 cyfung1031 commented Nov 10, 2026 •

Copy link
Copy Markdown
Collaborator

Checklist / 检查清单

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

#1834 的广播放大路径已针对性修改;整包 GM value 持久化仍存在,尚无新 HEAD 的实机验收,故不宣称完整解决该 Issue。

Description / 描述

保留按 storageName 索引的 Port 精准推送;补全 SW 重启后的写入回执、单调状态与按需对账,同时严格区分正常断线和扩展权限失效。

关联:#1834、#1835、#1838;设计挑战以本 PR 原 ca1bf345 为基线。工作分支直接基于 main,不依赖 #1838 合并。

背景

路径 机制 代价或失效点
main storage.local.onChanged 向全部 frame 广播 不相关 frame 也收到大对象相关变化
#1838 查询 tab/脚本缓存,再按 tab 发送 查询、缓存一致性、frame 二次过滤
本 PR 初版 storageName → Set<Port> 路由精准,但 SW 重启的通知缺口可能使写入 Promise 永远 pending
本 PR 当前 HEAD Port 精准推送 + 独立持久化回执 + revision/snapshot 写入完成不依赖广播;断线后恢复最终状态,不承诺补齐全部历史事件
flowchart LR
  F["运行脚本的 frame"] -->|"Port: storageName + revision"| SW["SW 订阅索引"]
  F -->|"GM 写入 RPC"| V["ValueService"]
  V -->|"保存数据 + revision"| DB[("ValueDAO")]
  V -->|"明确的 committed receipt"| F
  V -->|"仅推送已订阅 Port"| SW
  SW -->|"valueUpdate"| F
  SW -->|"重连版本不同才返回 snapshot"| F
  V -->|"保留原后台通知"| O["Offscreen"]
Loading

本次实现

范围 修改及不变量
单调版本 每个存储记录持久化 revision / epoch(旧记录默认为 0 / 空 epoch);真实修改在既有逐 storageName 串行队列内增加版本,同值写入不增加版本
双通道排序 writer RPC 回执与 Port notification 均按版本判断;旧版本不覆盖新快照,跨版本缺口读取权威状态;128 条近期 ID 只用于有限去重,不再承担排序正确性
跨页恢复 frame 订阅上报当前版本,SW 先注册 Port 再读值;版本一致仅确认,不传整份数据;版本不同才回传 snapshot。订阅请求关联 ID 阻止迟到响应覆盖新连接/新存储世代
GM 提交语义 ValueDAO.save 成功后才发出 {committed:true, update};GM.setValue / GM.setValues / delete 异步 Promise 不依赖 Port。失去回执或超过 30 秒是结果不明,绝不自动重试写入
乐观缓存 对可能失败的写入,存活的上下文按需重新读取权威快照,不盲目 rollback;snapshot 恢复最终值,不伪造中间 listener 回调
初始化与 early-start pageLoad 的版本字段纳入显式白名单;同 storageName 的不同脚本初始化时按较新 revision 统一状态;提前运行的脚本只校正缓存,不重新执行
连接生命周期 SW 正常断线立刻尝试连接,失败才随机退避;Port 连上却没有初始 ready、或 30 秒内订阅无 ACK 均仅重试该连接,不将整个上下文永久 terminal
终止状态 扩展更新/重载/停用产生明确的 context invalidation 才停止重连并释放 Port/定时器;不重新注入已运行脚本,不复活已撤销权限
消息错误契约 runtime.lastError 返回类型化 transport-loss 错误;Network Rules 写操作保留「可能已成功、回复丢失」的 ambiguous 语义;记录日志及不等待结果的 GM API 不再造成 unhandled rejection
内存/性能边界 无 tab 全量扫描、tabs.sendMessage fallback、心跳、无界事件日志;每 GM context 近期 ID 最多 128 个;写入回执及 snapshot RPC 均有超时;配置默认值不写回持久化缓存

2026-11-12 后续设计挑战修复(HEAD dc7bcdf8)

本轮针对 cbdd07a1 的静态设计挑战报告 的 F1–F4 实施修复;仍以最终状态收敛为目标,不冒充完整事件日志。

风险 本轮处理 性能/内存约束
F1:刷新中又收到更高版本 frame 记录每个 storageName 的 desired revision,Port 保留 refresh-dirty 并在 ACK 后按需补读;GM context 追踪 in-flight 期间观察到的更高 revision,最多 5 次延迟重读 不存历史事件;失败重读采用指数退避与上限,不在同一调用栈忙循环
F2:脚本 flag 尚未出现 content/inject 各自维护等待启动的脚本描述符;r2 delta 或最新 snapshot 先更新初始值,真正建立 ExecScript 时移除待启动引用 无无限事件队列;不重跑已启动 userscript,包括 early-start
F3:单一 frame 内部分 world 失败 world 处理成功才回 true;frame 记录失败的 content/inject world,仅对失败 world 重新下发最新 snapshot;迟到 ACK 不会清除较新的失败状态 复用既有消息回执,不增加每条事件第二套 RPC;仅失败时保存 dirty bit/代际编号
F4:pageLoad 错误被无限重试 只有类型化 MessageResponseLostError 在 context 有效时重试;协议/权限/配置错误 fail-fast;每次尝试 30 秒超时,页面真实卸载取消退避 jitter 退避,不因硬错误持续唤醒 SW
附加静态挑战 同一 world 某脚本异常不再阻断其他同名 storageName 脚本;仅声明 value listener 的脚本可使用经身份验证的内部对账 RPC 正常同步值更新路径不分配 Promise recovery 数组

新增单元回归覆盖:r3 snapshot 延迟与 r5 gap、GM context 并行对账、script flag 晚到、content 失败而 inject 成功、空 world 回执不能算成功、明确永久 pageLoad 错误、共享存储的脚本异常隔离。测试已编写,但当前环境未执行 Vitest、typecheck、构建及浏览器 E2E;不可将静态审阅视作测试通过。

报告的 F5 仍属产品契约选择:snapshot 不能恢复掉线期间每次 listener 调用;F6 需要当前 HEAD 的 Chrome/Firefox + 50-frame/100 KB/1 MiB p50/p95、SW heap 实测;F7 为已有 delete/write 互斥域问题,本轮未扩大底层存储改造。不要将旧 baa60b62 浏览器数字套用到新 HEAD。

必须明确的契约

  • 保证:成功收到明确提交回执表示 SW 已完成对应 GM 写入;旧 revision 不应使本地状态回退;扩展仍有效时,可自动恢复 Port 订阅。
  • 最终一致性,不是历史事件完整性:SW 停止窗口内其他 frame 可能遗漏若干 GM_addValueChangeListener 事件。snapshot 可以让同步 GM_getValue 最终与权威存储收敛,无法重建每条中间 oldValue、remote 事件。
  • 回应丢失的歧义:超时/transport loss 的写入可能实际已提交;会拒绝 Promise、尝试读取状态,但不会自动重试带副作用的写入。
  • 扩展升级、停用或移除:既有页面 JS 的纯 DOM 行为由浏览器决定是否保留;旧扩展 GM 权限不得被静默恢复,也不主动重跑 userscript。
  • 尚未改造:GM value 仍以整份对象持久化,体积大的单键更新仍可能涉及完整序列化;本 PR 不改变 ValueDAO 存储后端。

性能证据与待测项目

CodFrm 对旧 HEAD baa60b62 的独立浏览器测试 表明 indexed Port 方向在 Chrome/Firefox 的正常路径可工作,且相比传统广播/tab 路由有优势;该报告不适用于当前 HEAD 的版本对账与回执开销。此前声称“只要开 Port SW 就保持常驻”的结论已由维护者撤回,不能作为本方案的收益。

  • 本分支待实测:Chrome/Firefox(Opera 如可测),SW 自然 idle 重启,50 frame 同时重订阅、跨 frame 写入与 bfcache;
  • 性能待实测:空存储/100 KB/1 MiB、1 写 50 收/50 写并发、CPU 和 p50/p95;尤其注意 writer 回执 entries 会额外序列化 old/new 值,以及多 frame snapshot 首次对账的成本;
  • 内存待实测:长期重连/扩展失效后 timer、Port、pending Promise 的 retained heap,确认增长有界。

新增的回归用例(已编写,尚未运行)

  • A/B 持久化后 writer ACK 以 B→A 乱序抵达;Port A→超过 128 条事件→ACK A;跨 revision 缺口由 snapshot 修复,不伪造 listener。
  • 同值写入版本不增加,存储失败不能返回 committed;跨脚本共享存储初始化使用较新 revision;用户配置默认值不会污染存储或 snapshot。
  • SW 订阅 31 秒才恢复、Port 已连接却从不发 initial ready、bfcache 旧连接失效;不同请求/不同存储世代的迟到 snapshot 被丢弃。
  • Network Rules 丢回复仍为 ambiguous;MessageWriter 和 GM_log 在失效 context 后无 unhandled rejection。

验证状态

项目 证据
本轮起点 / HEAD ca1bf345 → cbdd07a1 → dc7bcdf8(与 GitHub 当前 PR head 核对)
变更范围 前次 31 次提交/26 个文件;本次针对 cbdd07a1 挑战报告追加 15 次提交/9 个文件;PR 相对 main 共 65 个 commits/31 个文件
GitHub 树/分支 对起点增量比较,fast-forward 更新成功;未使用 force push
当前 HEAD 的 Vitest / TypeScript / Prettier / 构建 未运行:当前执行环境没有完整仓库 checkout 和可用依赖,不能用静态检查替代执行验证
当前 HEAD 的 Chrome / Firefox / Opera E2E 和基准 未运行;维护者原测试与旧版本绑定,不冒充本轮实测
先前 1,175 项单元测试 仅绑定更早的 baa60b62,不代表本次代码通过

合并前必须完成当前 HEAD 的 typecheck、format/lint、相关完整测试集及真实浏览器生命周期回归;特别验证 SW 重启期间跨 frame 状态收敛和 50-tab 负载。未将未执行的验证勾选为通过,也未依赖托管 CI 作为中间实现检查。

建议审查重点

  1. 版本仅在实际写入时增加;epoch 更换、Port 消息与 RPC 回执竞态是否单调。
  2. 重连 snapshot 的请求关联/过时响应丢弃;是否会复制不必要的大对象。
  3. async GM 写入收到 committed 回执与后续 snapshot 失败的解耦;异常期不重试副作用。
  4. Network Rules 的 ambiguous contract,以及各 fire-and-forget GM 调用的拒绝处理。
  5. 旧脚本已运行时的 SW 自然重启、extension invalidation 与 early-start 不重复执行。

Screenshots / 截图

不适用:无 UI 改动。

CodFrm and others added 4 commits November 10, 2026 03:57
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
cyfung1031 marked this pull request as ready for review November 10, 2026 11:03
@cyfung1031

Copy link
Copy Markdown
Collaborator Author

跑了一下脚本,没任何问题

AI 给我这个测试用脚本也没有 fail

1848_test.user.js

你用firefox, opera 之类的跑一下吧 @CodFrm

@CodFrm

CodFrm commented Nov 11, 2026

Copy link
Copy Markdown
Member

实测结果(head baa60b62,Chrome 156 headless / Firefox 154.0.1)

结论:性能达到 Port 原型的水平,功能和 bfcache 在 Chrome、Firefox 上都通过;但有两个问题需要先修。

1. 断线重连期间丢更新,写入方的 GM.setValue 永远不返回

SW 被回收或重启后所有 Port 断开。value_port.ts:127 的 scheduleReconnect 让第一次重连也要先等 250–500 ms;SW 端只通过 Port 推送(runtime.ts:480),scripting 也删掉了按标签页接收的路径,没有任何兜底。这段时间里写值,接收方收不到;写入方的 Promise 只能靠收到这条更新来完成,于是永久挂起。

测试 本 PR Port 原型 #1838 main
Chrome:SW 自然空闲回收后立刻写(10 页) 3/3 挂起,其他页收到 0–1/9 3/3 正常 — 3/3 正常
Chrome:强制停止 SW 后 12 秒内连续写(50 页) 前 3 次写入 0/49 收到,回执挂起 48/48 48/48 48/48
Firefox:后台挂起后立刻写 1/2 次丢更新 1/1 2/2 2/2

「已知限制」里写了断开期间不重放,但这个窗口不是罕见情况:Chrome 和 Firefox 上空闲回收大约每分钟一次(见下面的更正),而且写入方的 Promise 会永久挂起,main 和 #1838 都没有这个问题。

建议:

  • 被动断开时立刻重连,退避只用在连接失败时;
  • SW 发现写入方所在的 frame 还没订阅,就按 frameId 退回用 tabs.sendMessage 投递,scripting 已订阅时忽略这条兜底。

原型就是这样做的,上面三个测试全部通过。

2. 扩展更新后,旧页面会一直重试

扩展更新或重载后,页面里留下的旧 content script 调 runtime.connect 会抛出「Extension context invalidated」。value_port.ts:103 记一条日志后继续退避重试,上限 10 秒,永远不停。实测扩展重载后 90 秒,3 个旧页面报了 29 次错,main 是 0 次。建议失败时检查 chrome.runtime?.id,为空就 stop()。

更正:SW 不会常驻

描述里引用的「360 秒内 SW 保持驻留」来自我之前的测量,是错的。原型断开后立刻重连,SW 的停止和重启都发生在 250 ms 的轮询间隔里,所以没看到。改成跟踪 SW target 的 id 之后:300 秒内 main、原型、本 PR 都出现了 6 个 SW 实例,空闲时扩展进程的 CPU 是 0.81 / 1.05 / 0.94 s。也就是说没有常驻,也就谈不上「避免冷启动」;main 自己的定时唤醒频率也差不多。

性能(main / #1838 / 原型 / 本 PR,交替运行,load avg 13–35,所有更新都完整送达)

场景,单位 ms,单次写入 p50 中位数 main #1838 原型 本 PR
1 写 / 50 收,存储为空 5.4 9.9 2.4 1.9
同上,100 KB 164 14.9 8.6 10.1
1 写 / 50 个无关页 8.5 5.3 1.4 1.35
50 页同时写,存储为空 240 789 47 81
50 页同时写,1 KB 354 945 175 98

「50 页同时写」两行的主进程 CPU:本 PR 和原型 2.4–2.9 s,main 4.4–6.4 s,#1838 11–13 s。

测过、没有发现问题的部分

  • 跨标签页、iframe、remote 标记、回执:Chrome 3/3,Firefox 通过;bfcache:Chrome 3/3,Firefox 通过。
  • early-start 脚本早期写值:在热 SW、冷 SW、加 60 个脚本拖慢 pageLoad 三种条件下共 65 次,全部正常。
  • 启动要等订阅确认:document-start 脚本执行时刻 p50 是 133 ms,main 是 164 ms,没有变慢。
  • 每个 frame 初始化时先 connect:打开 150 个不跑脚本的 frame,扩展进程 CPU 只多约 0.08 s。
  • SW 重启时 50 个 frame 同时重连:18 秒内主进程 CPU 0.75 s,没有风暴成本。
  • 相关的 7 个测试文件 90/90 通过,tsc --noEmit 通过。

没覆盖:Opera(本机没有);附件里的 1848_test.user.js 没有跑。

@CodFrm

CodFrm commented Nov 12, 2026

Copy link
Copy Markdown
Member

代码行数又来到了2000、数据存储也又加了一堆字段,虽然AI改AI维护,但也顶不住这么折腾啊,还是要考虑一点可维护性

这么做下去又要成一坨了 和 #1747 一样

@cyfung1031

Copy link
Copy Markdown
Collaborator Author

代码行数又来到了2000、数据存储也又加了一堆字段,虽然AI改AI维护,但也顶不住这么折腾啊,还是要考虑一点可维护性

这么做下去又要成一坨了 和 #1747 一样

先draft
日後再處理

@cyfung1031
cyfung1031 marked this pull request as draft November 12, 2026 04:23
@cyfung1031

Copy link
Copy Markdown
Collaborator Author

先把firefox 問題處理吧
這個不急

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.

2 participants