浏览器插件缓存不要顺手存下输入
缓存只存得起解释得清的数据
把失败写成能读懂的结果
我会给这类工具再留几条反例:输入为空、外部依赖拒绝、重复执行和中途取消。断言不仅检查 Result,也检查状态是否被提前修改、临时文件是否清理。这样失败时可以直接判断是契约改变,还是某条收尾分支漏掉了。
错误信息也要指向用户能处理的位置。说明哪个参数或文件有问题,保留必要的底层上下文,不把一长串内部调用栈当作提示。可预测的失败路径比“尽量自动修复”更适合小工具。
浏览器插件的缓存很容易越攒越多,因为一个对象“以后可能有用”。先给每类数据找理由:离线必须的、可重新请求的、只用于本次会话的,分别处理。输入原文、访问令牌和带身份的响应通常不该因为方便留在本地。
检查时打开实际存储,而不是只看代码里调用了什么 API。确认键名不会把用户信息拼进去,过期后条目是否真的删除,退出或切换账号时是否清理。离线体验有成本,把暂时不可用说清楚,比把所有输入悄悄缓存下来可靠。
做浏览器端推理练习时,缓存很诱人:模型文件大,重复加载又慢。但“缓存推理结果”这句话太粗了,输入内容、模型版本和公开资源的生命周期完全不同。我的默认做法是不长期保存用户输入和输出,先弄清楚离线需求,再决定需要留下什么。
先区分可以保存的数据
模型版本、公开词表校验值和界面偏好通常可以保存,它们不包含用户正文。用户输入、生成结果和调试日志则可能带有私密内容,除非用户明确选择保存,否则只放在当前页面内存里。会话结束后丢失结果确实不方便,但这比悄悄把内容留在浏览器存储中更符合预期。
localStorage 适合少量字符串配置,不适合作为没有上限的结果仓库;它还能被同源脚本读取。IndexedDB 更适合较大的公开资源,但也不是天然安全的保险箱。无论使用哪个,都要在界面说明保存什么、保存多久、如何清除,而不是把说明藏进源码注释。
实际检查写入内容
我会先给缓存键加清晰前缀,例如 plugin-model-version,避免和输入内容混在一起。再打开浏览器开发者工具的存储面板,实际查看键和值。代码审查时,只看 setItem 很容易漏掉第三方库或调试分支。
const key = "plugin-model-version";
localStorage.setItem(key, manifest.version);
// 不把 prompt 或 result 写入长期存储
若用户需要最近记录,应设计明确开关、条数上限和删除按钮,并在测试里确认关闭开关后不会再写入。这个例子只表达边界,并不代表所有插件都该使用同一种存储。
不要用离线体验掩盖取舍
不缓存输入会让刷新页面后丢失内容,这是实际代价。可以先缓存公开模型资源,或者提供导出文本,让用户自己决定是否保存。另一个误区是只关注存储,不关注日志:控制台、错误上报和埋点也可能带着输入片段。每次接入服务,我会先问它收集哪些字段、失败时会不会附带页面信息。答案不清楚时,先不接入,或者只传不含正文的标识。功能少一点,但工具做了什么更容易解释。
最后让测试覆盖一次调用者最容易误用的写法。编译器和断言能给出明确反馈时,就不需要靠注释猜接口的意图。
5万+



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



