1.0.0，以及上架

扩展这周发了 1.0.0， 并且已经在 Chrome 应用商店上架。 在这之前装它要 clone 整个仓库、自己「加载已解压的扩展程序」； 现在商店排第一，GitHub Releases 排第二。

1.0.0 不代表功能齐了，代表它已经完整地跑完过好几遍： 抓取、断点恢复、增量、导出、导入、再解析、再生成站点。 中间那几天修的都是把这条链路走顺——以及三次修完之后才露出来的形态。

第一个外部贡献

有人报了一个卡死：抓取停在半路，之后一段都跑不起来。他连修法一起提了过来。 修完之后立刻冒出这个 bug 的下一种形态： 卡住的那个异步任务并没有被取消，它醒过来会和接管它的那一段重叠—— 以前之所以看不到，是因为以前一段都跑不起来。

所以补了两层：被顶掉的那一圈跑到边界自己退出（并且说一声， 悄悄退出等于没发生过），同一时刻只许有一批在跑。 两层都不打断进行中的那一批——打断会丢掉已经抓下来、还没记账的进度。

收尾和还在跑的那一批撞上了

同一批里最值得记的一个：收尾（封段、算校验和、写 manifest） 与还在跑的那一批可以重叠，而重叠的后果不是控制台里一条报错：

manifest 说 902 字节 / 1 条
文件实际 4181 字节 / index 5 行

校验和是按封段那一刻算的，所以这份档案通不过自己的校验， 而多出来的那 4 条捕获对任何遵循规范的读取方都不存在。 用户那边看到的只是一句莫名其妙的 JavaScript 报错。

修法是一道闸门：收尾先关门，等在跑的那一批落地，再封段。 失败也要开闸——收尾会因为「还有抓不下来的条目」而拒绝， 而那之后用户正是要去重试它们，闸门关着的话这次抓取再也推不动， 且界面上看不出原因。

四条测试在浏览器里从来就没成立过

CI 在 Node 从 24.18.0 升到 24.19.0 之后红了四条。看着像是 Node 弄坏了测试， 其实反过来。

WHATWG 的规范写着「压缩数据结束之后还有输入就抛错」， Chrome、Firefox、Safari 一直都抛；Node 是唯一不抛的那个， 24.19.0 把这条补齐了。也就是说那四条断言在浏览器里从来没成立过—— 而这个扩展只跑在浏览器里，是 Node 一直宽松才让它们绿着。

生产代码不受影响，而且是结构性的不受影响：它从来只解压单条记录。 但断言不能删——「整个段落能一口气解压」是真性质， zcat、pywb、ReplayWeb.page 全靠它。 那属于 gzip 的规范，不属于浏览器那个 API。所以：整段解压换用真正支持它的解压器， 单条仍然走浏览器的 API（那才是读取器真实的用法）， 再补一条「喂整段一定抛」把这个约束钉住。

最后那条要看运行时有没有实现规范，所以探能力，不看版本号： 旧 Node 上带原因跳过，而不是让整个套件红——那等于把一条测试的口味 变成 Node ≥ 24.19 的安装门槛，而 README 承诺的是 ≥ 20。

发版之后，没有任何东西会提醒你

上架带来一件新的、只能靠人记住的事：商店里的包不会跟着 GitHub 的 release 自己走，得手动再传一次。忘了传的后果是站点说 v1.0.3、 用户装到 v1.0.2，而两边都是绿的。

官网首页那个版本徽标也是同一类——它不在扩展仓库里，没有任何 CI 会因为它过期而红。 所以这两条都写进了发版流程文档：跨系统的步骤，只能记在同一处。

顺带清掉三句悄悄过期的话，都不是刚坏的：README 顶上还写着「但还缺图片抓取」， 而同一份 README 一百行之后就把图片抓取列成做完了——那是访客读到的第一句话。 「74 个运行时真正需要的文件」实测已经是 89 个。界面文档里两条早就做完的 「还欠什么」，删掉而不是打勾——留着只会让人以为它还没做。

测试：71 个测试文件、1609 个测试，零安装即可跑。