质检规则最初被做成了提交前的一道闸——后来摘掉了。同样一套规则，放在「挡住正在干活的人」和「事后给主管看」两个位置，误伤的代价差着数量级。

公告看起来是最简单的功能——一条记录、一个消息条。真正要想清楚的是：它和业务提示抢不抢位置、已读存在哪、什么算读过，以及为什么公告的 id 发出去就不能再动。

扩展里做语音转写，云端要每人一个 API key，浏览器内 WASM 又太慢。最后落到 Native Messaging + 本机宿主——路上撞到的每一道墙，都是消息通道的尺寸与形状。

打包脚本一路绿灯、还打印了体积和哈希，产出的却是一个装不上的包。以及为什么图标永远要从最大的原稿往下生成。

一个看似只需要一行代码的判断，被宿主系统的改版打穿了三次。每一代都有一个看起来天经地义的依据，而每一个依据都在某天悄悄失效。

快捷键散在各个模块里各自监听，很快就会出现两个功能抢同一个键、改键要改代码、焦点在 iframe 里就不灵。收成一个监听器之后，这几件事都有了唯一的答案。

一台常驻服务器跑着无头浏览器抓监控数据。搬进扩展之后服务器可以关掉了——前提是想清楚哪些能搬、数据以谁为准，以及为什么面板会卡。

入口迭代了三次。最后删掉的那颗小球做得很精致——贴边三档、换位手柄、呼吸动画。问题恰恰在于它看起来太像一个「东西」了。

内容脚本注入每个 frame，于是你的模块级变量每个 frame 各一份。五份定时器一起改同一块 DOM，会产出一类极难复现的 bug——以及一条很反直觉的排查口诀。

内容脚本注入每一个 frame，而富文本编辑器的那个 iframe 带着自己的 base href。相对路径按 baseURI 解析，于是同源请求悄悄变成了跨域请求。

操控一个没有源码的 React 表单，四件事各有一个「想当然的写法」会失败。附一个可以亲手点出结论的靶页。

一个 slice 一个 key、deep-merge 自动补新字段，听起来就够了。但数组不逐元素合并——这一条会在你完全想不到的地方炸。

组件库的 Form 实例挂在 fiber 上。拿到它就能 setFieldsValue 一步到位，不用再走「开下拉→等选项→点击」那一套。代价是跨 frame 找到「真正那张表单」。

在一个你控制不了的 SPA 上挂自己的界面，会遇到三类问题。每一类都会以「完全不像是 UI 引起的」的方式暴露出来。

Vite + crxjs + TypeScript 的扩展工程长什么样，五个入口各管什么，以及为什么 npm run build 通过不代表类型没问题。

把一台常驻的 Puppeteer 机器人搬进扩展的 Service Worker，要先接受一件事：它三十秒没事干就会被杀掉。定时、状态、重连全都得重新设计。

隔离世界、主世界、扩展页面共享同一棵 DOM 却不共享 JS 堆。这个边界会制造两种方向相反的误判，以及一个必须自己造的跨世界桥。

从网页内注入面板改成浏览器级侧栏，换来的是不抢页面空间和不被宿主重建冲掉。代价是三个必须先知道的约束。

不能上架、用户没有管理员权限、很多人不用命令行。最后落到一条 PowerShell，以及一堆「顺序不能换」的细节。

一条记录装所有参数，改一处要动整块 JSON。拆开之前得先想清楚：这个参数是「管理员说了算」还是「用户也能改」——选错了会得到很难查的 bug。

显示层、提交源、组件状态——同一个富文本字段背后是三份数据。写漏一份，你会得到「提交正常但草稿丢内容」这种最难复现的 bug。

「调试日志」开关立项就有，但它只管得住两个文件——其余三百多处裸 console 拨不拨都照样刷屏。收口的过程里有四条规矩和一个环形缓冲。

一份 CSS 要同时服务四种消费方：独立页面、被框架接管的设置页、和一堆 shadow DOM 注入组件。它们的取值方式完全不同，而失败方式一个比一个安静。

明文的本地白名单等于零鉴权。用签名把兜底名册钉死，再配一套静默退避的健康探测——服务器挂了不影响干活，也不会有人给自己开权限。

一个不能上架、不能开源的浏览器扩展，靠一个人做完分发、更新、鉴权、公告、更新日志、统计和排障。这是整个系列的地图。