浏览器端推理插件升级:先核对宿主接口和降级行为
先把升级面拆成几段
插件更新涉及的不是一个版本号。宿主页面负责注入脚本、分配权限和提供存储;扩展里的 worker 负责调度;wasm 模块负责加载与推理;模型文件又可能走另一套缓存策略。排查时我会按这个顺序逐段确认,而不是看到“无法推理”就先怀疑模型。开发者工具里先看扩展是否启动,再看 worker 是否收到消息,最后看 wasm 请求与初始化日志。每一段都用公开、短小的测试文本,避免把浏览记录或页面正文带进控制台。
宿主接口尤其容易在升级后悄悄变化。消息字段改名、回调从同步变成 Promise、权限清单少了一项,都会造成表面相似但根因不同的故障。给接口加一个很薄的适配层,把接收值校验成明确的对象;遇到未知版本或缺失字段就返回可读错误,不要让异常穿过多层后才显示成“模型失败”。这层代码不解决兼容性本身,却能把故障位置固定下来。
降级路径也要有独立测试
浏览器不支持 WebAssembly、设备内存不足、模型下载被拦截,都不该让整个页面失去交互。我的降级方案是关闭本地推理入口,保留与插件无关的页面功能,并说明当前能力不可用;不会私自把页面内容转交到远端服务。若产品确实需要远端选项,必须由用户单独触发,并在请求前说明发送的内容范围。
测试时我会主动制造失败:拦截 wasm 请求、在无痕窗口清空扩展存储、让 worker 初始化时抛错。检查的重点是按钮是否恢复可点、监听器是否被移除、重复打开面板会不会创建第二个 worker。升级成功不等于第一次推理成功;关闭面板、切换页面、刷新后再打开,才更容易暴露遗留的状态。
留下能比较的升级记录
记录里只写插件版本、浏览器版本、测试用例编号、加载耗时区间和失败阶段。模型文件哈希若需要保存,也只保留公开构建产物的值。这样下一次升级时可以比对“同一个公开样例是否仍能初始化”,而不必依赖一张难以复用的截图。性能结果也要分开看:启动变慢可能来自缓存失效,推理变慢可能来自线程配置,两者不能合成一句笼统的结论。
浏览器端插件更新后,我先测加载链路,不急着比较推理结果。一个很小的检查是确认 wasm 文件能被正确取回,且 MIME 类型没有变。
const response = await fetch('/assets/plugin_bg.wasm');
console.assert(response.ok);
console.assert(response.headers.get('content-type')?.includes('wasm'));
再用一条不含个人内容的固定文本跑初始化和一次推理,记录是否出现内存增长或 worker 启动失败。缓存会掩盖问题,所以测试时开无痕窗口并勾选禁用缓存。这里的样例输入只用公开短句;真实页面内容不应被拼进调试日志。
初始化顺序需要明确状态
worker 尚未 ready,界面就发送第一条推理请求;模型缓存还在写,用户又打开第二个面板,这两类问题都不能靠增加延时解决。我会把状态收成未加载、下载中、初始化中、可用和不可用。按钮根据状态启用,worker 收到不合时机的请求就返回可读错误。这样失败发生在哪一段,控制台和界面看到的是同一件事。
消息适配层还要校验来源、类型和字段。页面参数不能直接决定模型下载地址,内容脚本也不应把任意网页消息转给后台。验证失败就停在入口处,不把“方便调试”的宽松处理带进发布版本。
分开看缓存与推理异常
首次失败、刷新成功时,优先检查缓存目录和响应头;固定公开输入始终异常,再检查 tokenizer 和模型初始化。记录冷启动、缓存命中和资源版本标识即可,不需要保存用户页面 URL。关闭面板后也要确认监听器被注销、取消下载能回到可重试状态、旧页面请求不会写回新面板。这些清理动作决定插件会不会越用越乱。
1322



被折叠的 条评论
为什么被折叠?



