更新日志

2.2.0 合并上线（PR #15，1c7fcaf）之后的一轮深度评审与自审：安全与 CI 权限、门禁判据的 「能不能被证伪」、四篇实测稿落地，加上 2.2.0 那轮改动自身的修补。按 USAGE 的递增口径 （修 bug、补文章、不动结构），进修订号；2.2.0 至今没有 tag，那一次发版的收口与这一次的 tag 都由本人执行。

• 评审后的第二轮（2026-11-02） 两轴评审（规范 / 需求忠实度）+ 安全与判据正确性专项，六路并行，结论逐条自己复验后才动手。
• 评审后的第二轮（2026-11-02） 凡是「commit 里写了读数」的，这一节只写我这一轮实测到的数。
• 评审后的第二轮（2026-11-02） 漏斗那条 Referer 承诺原先不成立，现在成立并且有刀。 _includes/seoMeta.html:119-121 把 <meta name="referrer" content="no-referrer"> 关在 {% comment %} 里，产物里 name="referrer" 0 个， 而 dev/js/funnel.js 的 fetch 没写 referrerPolicy——默认 strict-origin-when-cross-origin 会把 本站 origin 发给接收端。起一台记录请求头的桩实测：改之前 referer = http://127.0.0.1:8799/， 改之后 referer = null（fetch 与 Image 两条路都验）。check-seo 新增两判分别盯这两条路， 少一边就红——只判「文件里出现过这个词」的那写法，删掉一句、留一个词，仍然绿。
• 评审后的第二轮（2026-11-02） GET /e 缺 e 参数会抛异常（scripts/funnel-worker/worker.mjs:59）。204 是 null-body 状态， 带 GIF 构造 Response 当场 TypeError；Node 24 复现的是同一句规范： Response constructor: Invalid response status code 204。README 推荐的手工探针形状因此一直是脚本异常。 本地桩此前恒回 200，这条在线上坏着也复现不出来——现在桩与 Worker 同形（204 无动作体）， 并且新增一判盯「给 204/205/304 带动作体」。
• 评审后的第二轮（2026-11-02） ci-gates.mjs 的行级少读闭死。 驱动从「行首是 gate」改成词元级：for … do gate …; done、 if …; then gate …; fi、time gate … 三类 bash 合法写法此前被安静跳过——在 /tmp 复现过， 输出 ✓ 1 道门禁全绿 而 jekyll.yml 那边真会跑那道门。上一轮的交叉校验用的是同一个循环的自计数， 那条断言永真；现在换成按词数的另一条路径。台账 12 → 19 条，含超时、脏源、两条 expectGreen。
• 评审后的第二轮（2026-11-02） 牙齿自己抓到我的改动把口径挪走了：sw.js 的清单改走 | jsonify（产物由单引号变双引号）之后， check-sw-teeth 三把按单引号锚的刀同时报「变异没命中产物（这条是假牙）」——正是这道门该说的话。 牙齿同步成引号无关，23/23 复绿，工作树按 finally + 信号钩子还原干净。
• 评审后的第二轮（2026-11-02） suggest-inlinks.mjs 的注入用字符串形式 replace：语料里的 $&、$'、$` 会被当成替换模式展开。 拿真模板复现：文件从 15,247B 灌成 30,583B、JSON.parse 抛错，而 catch 只写 stderr、退 0—— 审阅台坏了而命令成功。语料里现存 5 处这种形状。改成函数形式替换 + 坏了红着退出。
• 评审后的第二轮（2026-11-02） 交付锁从 _drafts/ 搬进 scripts/ 并进了门禁清单（第 24 道）。它此前只被 .git/info/exclude 排除——那是机器本地、不随仓库走的一层；配套测试也从「写了没人调用」变成 CI 每次跑（7 个用例）。
• 评审后的第二轮（2026-11-02） .gitignore 补四条：_drafts/*.txt、_drafts/*.sh、_drafts/legacy-2026-10/、_drafts/.delivery.lock/。 同一条理由：换机器后一次 git add -A 会把 10 个流水线内部件（952K，含人设档案与运行日志）推上公开仓库。 deploy-github.sh 的密钥形态从 5 类补到 8 类（gh[pousr]_、AIza…、sk-…、JWT 前两段）， 加之前先在全仓文本跑过：0 命中。
• 评审后的第二轮（2026-11-02） 审阅台在 375px 下有 237px 横向溢出：grid 子项的自动最小宽度 + 证据句里那些不可断的 markdown 长链接。 现在溢出 0，同时补了防抖（此前每敲一个字重建 485 条）、键盘选中行的可见标记（此前 j/k 之后看不出选了谁）、 未选中时按 y 不再静默给第一行盖章、触控高度 44px、进度与提示的 live region。
• 评审后的第二轮（2026-11-02） 两条被证伪的评审结论（不修，记录在此以免下次又被当缺陷报）：demo/vueRouterDemo/hashRouter.html 那个 innerHTML = location.hash 在 Chromium 下不可利用——片段里的 < 被归一化成 %3C， goto 与页内点击两条路都不落地；仍改成 textContent，但它是隐患不是漏洞。埋点件 u 参数在 URL 里是 %2F 编码的，Worker 那侧 searchParams.get('u') 会自动解回 /better-blog/tools.html——不是缺陷。
• 评审后的第二轮（2026-11-02） 内容：_posts/2026-10-27-sandbox-runtime-ssh-readable.md 的封面与三张正文图从未产出（全盘无原件， 正文也不依赖图）。不伪造终端截图：摘掉四处引用，分享卡改由 og-images.mjs 生成（1200×630）， 补 tldr（读数全部取自正文已写死的那些）。三道门禁因此从红回绿：check-tldr、check-og-images、check-sw。
• 评审后的第二轮（2026-11-02） 第三轮自审补的四处（都在前两轮的报告里被我标成「未修/待决定」，这轮逐条先证实再改）：
• 评审后的第二轮（2026-11-02） og-images.mjs --check 原先只要求无 cover 的篇目在表里，有 cover 的漏登记一句不报。 渲染侧确实无感（分享卡三级取值链第一级就是 cover），但那张表是生成器会写的台账—— 少一格的意思就是下一次 pnpm og:images 凭空多一个 diff。判据补上，实测会咬：删掉 rtk 那一行 → 表自检退 1，红在正确那一句，还原后哈希一致。
• 评审后的第二轮（2026-11-02） 验证 meta 那一组原先只从模板出发（模板声明什么就去产物找什么），于是模板把 msvalidate.01 那三行整段删掉时两头发绿——而失效被推迟到「哪天把 Bing 码领回来填进 _config.yml」那一刻：码在配置里、没有任何一处在发它，17 组照旧全绿。加一条反向判据 （CFG_KEY 每一枚必须在模板里有发射处、配置里必须有那个键），配一刀 + 一条 expectGreen （只换 if 两个子句的顺序仍须绿——判的是还有没有发射处，不是字节形状）。
• 评审后的第二轮（2026-11-02） check-release-teeth 的 K5 是一把已经变成假的刀：它的期望串是「停在 PREV」，而 PREV 恰好等于本机真实 git tag 的最新一枚（2.1.0）——就算 --tags-file 那一整条口被 摘掉、门禁退回读真仓库，它也照样命中。换成仓库里不可能出现的哨兵版本，并就地断言该值 确实不在真 tag 集里（哪天有人打了就退 2，不悄悄退化）。K5 第一次下刀还顺带暴露门禁是 按版本排序取最新，不是按清单行序——夹具因此只放一枚哨兵，排序那一面交给 K6。 另补 K7 expectGreen：tag 已收口时 --require-tag 必须退 0（T1 若被写成永远红，前两把 照样各红一次，整份台账一路通过）。台账 6 → 7 把。
• 评审后的第二轮（2026-11-02） README 的第三方段抄了 THIRD-PARTY-NOTICES 的分节条数（8/3/8），实测与清单三节的实际 行数（10/4/9，含已删那行）早已对不上，而且 weixinJsSdk.js 早在 2026-10-28 就删了还被 列作「待确权」。改成按节指路、不抄数字——同一课这一轮我已经在 USAGE 上用过两次。
• 评审后的第二轮（2026-11-02） 搜索索引那条疑虑查证后不成立：根目录的 search.json / search-full.json 是 Liquid 模板（每次构建现生成，产物里含四篇新稿），不是入库快照，没有陈旧问题。
• 评审后的第二轮（2026-11-02） 台账与口径：check-seo-teeth 漏斗组从 13 枚涨到 24 枚变异（含反向夹具；funnel.enable: false 那一支是判定写完当天自查才发现漏配刀的），各台账条数一律以它自己打印的读数为准、文档里不再重述； 门禁清单 23 → 24 道；check-discovery 那句写死的「9 组」改回 GROUPS.length；上一条里 check-discovery-teeth 的 82/82 是抄错了本子（那是 tools-surface 的数），实为 8/8，已改。
• 评审后的第二轮（2026-11-02） 2.2.1 收口这一发顺带证明了一件事：check-release-teeth 的 7 把刀全部从新的 package.json 版本重派生（BASE=2.2.1 → 升一位 2.2.2、退一位哨兵、退化形状 2.2）， 一刀不空转。95e9163 把写死的 2.1.0 换成派生值，等的就是这一刻——上一版在这里 改版本号时，6 把里有 5 把静默变成 no-op 还报绿。
• 评审后的第二轮（2026-11-02） 版本 bump 时自查出的两处自身缺陷一并修掉：.gitignore 缺仓库根 *.log 这一条 （一次 pnpm dev / jekyll serve --trace 调试在根目录留下三个未跟踪日志，而 deploy-github.sh 跑 git add -A；这三个文件只加规则、不删除，那是另一路会话的现场）； ci-gates.mjs 开跑前先 pgrep 一次常驻 watcher 并警告不拦路——牙齿就地改源会喂给 watcher，_site 可能在两道门之间被重建，本轮正是这样红掉两道牙齿门的（工作树里一个跟踪 文件的 diff 都没有）。CI 上没有 watcher，pgrep 缺席时静默跳过。

三条线一起走：商店按钮的转化漏斗终于有了自己的计数端点、那 23 道门禁第一次在合并之前跑、 481 条内链建议从一份读完就结束的报告变成一条能收尾的队列。按 USAGE 的口径（新增一整块能力、 原有位置不动），进次版本。

• 新增（埋点与漏斗） 商店 CTA 的计数分三段：view / impression / click。 判的是「这张卡出现过吗」和「这次出现被点了几次」， 此前站点对这两个问题一无所知。托管方案走不通：Cloudflare Web Analytics 只有页面级 PV，官方 FAQ 写明 all requests should originate from our beacon JavaScript，自报事件端点在那条路上根本不存在。 于是计数落到本站自己的 Worker + Workers Analytics Engine：无 Cookie、无访客 ID、无第三方域。
• 新增（埋点与漏斗） 前端 dev/js/funnel.js → funnel.min.js 1,667B（gzip 796B），只在工具页与插件产品页加载 （_includes/funnelScript.html 是唯一发点），其余页面零新增字节。标记写在源头 data-funnel="kind:placement:slug"，线上读数与源一致：/tools.html 16 枚、 /extensions/account-password-helper.html 5 枚。
• 新增（埋点与漏斗） 隐私口径写在埋点件里而不是文档里：doNotTrack 与 navigator.globalPrivacyControl 各自独立判—— 合成一判 A||B 的话删掉其中一个仍然绿（2026-10-28 被自己写的牙齿抓到过）。发送用 fetch(..., {keepalive: true, mode: 'no-cors'})，没有 fetch 回落 Image；不写 localStorage、不发 Cookie。
• 新增（埋点与漏斗） funnel.endpoint 留空 = 整件不发标签，这一行就是开关本身。Worker 侧在 scripts/funnel-worker/ （wrangler deploy --dry-run：2.39 KiB / gzip 1.27 KiB，limits.cpu_ms: 10，observability 关掉）： 只 writeDataPoint、返回 1×1 GIF，不读 Cookie / User-Agent / IP，binding 缺失直接 500 而不是静默丢数。 部署它需要账号，属于本人动作；上线之前这条漏斗在线上是「埋点已在、数据为零」。
• 新增（埋点与漏斗） 判据落在 check-seo 新增的两组（组数 15 → 17）：「漏斗埋点面」13 把刀 + 「验证 meta」4 把。 参数契约判双向：前端发了而 Worker 不读的那一列、Worker 读了而前端从不发的那一列，各自单独红。 这一族不是补档而是复现——funnel.js 第一版就漏掉了 kind，四次曝光发出的四个请求字节全等， 页面不报错、门禁不响，只有真浏览器对着本地 stub 数才发现。
• 新增（工程门禁） .github/workflows/ci.yml：23 道门禁在 PR 阶段就跑。 在此之前 jekyll.yml 的触发器只有 push: master 与 workflow_dispatch，也就是那 23 道门在合入之前一次都不会跑——红的发现地点因此 必然是「代码已经在 master 上、站点正要发布」，那时唯一能做的事是回滚一次发布。这条只构建 + 跑门， 不传 artifact、不碰 Pages，permissions 收在 contents: read（PR 可能来自 fork，它不需要任何部署能力）。
• 新增（工程门禁） 清单不写第二份：scripts/ci-gates.mjs 从 jekyll.yml 里把那 23 条 gate '...' 调用原样解析出来执行， 顺序与参数都是那一份。顺序是有理由的——三道 teeth 必须排在 check-seo 之后，因为它们就地改源再还原 会把那批源文件的 mtime 推到当下，而 check-seo 有一道「源比产物新就拒跑」的闸。 元门自己也有牙齿：ci-gates-teeth.mjs 12 条夹具。第一版修复拿同一个循环的两个计数对照自己， 那条断言恒成立、等于没写；是真夹具 gate $'ansi' scripts/ok.mjs 把它证伪的（旧代码 exit 0、 报「1 道门禁全绿」、那道门根本没执行）。修判据时顺手写的判据，同样要先红过一次才算数。
• 新增（工程门禁） check-sw 那枚「封面去重」的牙此前是假的：它只注入一份重复封面，没摘掉去重用的 Set， 于是注入之后门禁仍然绿。现在一刀两个动作，牙齿台账 23/23 条变异如期变红且红在对的组； check-discovery-teeth 8/8（这一行原本写的是 82/82——那是 check-tools-surface-teeth 的数， 2.2.1 复核时按台账自己打印的读数改回来）、check-seo-teeth 178/178（这一版收尾时给它补了一条 反向夹具，变成 179/179，见下面那条）。
• 新增（工程门禁） 这一版发版过程中，2.2.0 自己把两处判据侧的缺陷顶了出来，都在 PR 门禁上红的（那正是这条 workflow 存在的理由）：
• 新增（工程门禁） 漏斗判据的靶子收窄到「起始标签里的真属性」。check-seo F2 原来用 /\bdata-funnel="…"/ 扫产物 HTML，于是本条日志里那句「三段写法」的说明文字被当成四枚锚点， /changelog.html 一个埋点都没有却被判红四条。文档写出标记是这一族的常态而不是漏洞， 所以改成 <[a-zA-Z][^>]*?\bdata-funnel="…" —— [^>] 跨不过 >，<code> 里的示例不再命中。 台账随之多了一条反向夹具（expectGreen）：往不加载计数件的页面注入一段 <code> 属性写法， 门禁必须仍然全绿。只有正向案例的台账，把判据改成「永远红」也能全绿通过——这一条就是补那个洞的。
• 新增（工程门禁） check-release-teeth 的变异值不再写死 2.1.0，改成从 package.json 现读再派生 （升一位、退一档、形状退化成两段）。版本号一动，旧那 6 把刀里 5 把同时空转：replace 找不着 2.1.0 就原样返回，门禁读的是一份没被改过的副本，于是判全绿；另两把的 expect 钉着 「而包体是 2.1.0」，红的是另一句。现在变异没有落点会直接抛并记「锚点失效」，不再是安静的绿。
• 新增（内链审阅） scripts/suggest-inlinks.mjs 从此多产一份 dev/inlink-review.html（gitignore，不入库）：481 条建议 原来是「读完就结束的清单」，现在按文章分组、可勾选接受/拒绝、决策留在 localStorage、一键导出成 可直接粘进 _posts 的 Markdown。产物模板改用整段锚定正则替换 __DATA__，写完把 JSON 抠回来 parse 一遍再算数——第一版 String.replace 命中了模板说明文字里的占位符，构建不报错、文件反而大了 43 万字节，只有浏览器 JSON.parse 那一句炸。
• 优化（产物字节） 18 个模板与布局里 46 处维护性备注从 HTML 注释换成 {%- comment -%}：那些字是给读源码的人的， 此前每一页都替读者付一遍。线上首页现在只剩刻意保留的 IE 条件注释（281B）。
• 优化（产物字节） _includes/footer.html 里那行被 HTML 注释包住的 assign 删掉：Liquid 在注释里照旧执行， 于是每一页多发一枚 9 字节的空注释 <!-- -->，而下一行已经把同一个变量赋过一遍。
• 优化（产物字节） 删掉 dev/libJs/weixinJsSdk.js（741 行闭源厂商副本，assets/ 里构建产物、站内零引用）， THIRD-PARTY-NOTICES.md 那一行改写成处置记录而不是许可证声明。
• 修复 pnpm dev 起 jekyll serve 报 directory is already being watched：符号链接别名让 FSEvents 把同一 目录注册两次。_config.yml 的 exclude 补 .preview 与 _drafts/evidence，两条都带实测理由。
• 修复 _posts/2026-10-25-freellmapi-635-vs-483.md 缺 tldr——这条红在 HEAD 上就存在，正是「门禁只在 master 上跑」的形状：它进了 master 才被看见。
• 修复 deploy-github.sh 在当前分支是 master/main 时打印 check-release.mjs --require-tag 的读数（只提示、 不拦）：2.1.0 那次三处版本号都改了、tag 忘了，站点没有任何症状，只有拿 tag 算增量的人对不上。 tag 那一档刻意不在 CI 里——CI 的 checkout 默认不取 tag，而「feature 分支上要求 tag 已存在」 等于把还没发生的发版判成缺陷。

四条线一起走：西文字体换成自托管 webfont、一批补齐「手感」的动效、招财猫终于有了 收放口、以及四项按页收口的下发与分享元数据。按 USAGE 的口径，这是新增一整块能力， 进次版本。

• 新增（版式） 西文换成 Newsreader（标题）+ IBM Plex Mono（元信息），只下 latin 子集， 三个文件合计 78,264B（可变 Newsreader 58,152B + Plex Mono 400/500 各约 10KB）， 授权与来源记在 assets/fonts/LICENSES.md（三者均 SIL OFL 1.1，全部按原样分发， 没有自行裁剪的衍生件）。 中文一个字节都不下：补齐中文字形最小也是 MB 级（霞鹜文楷全量 woff2 约 10MB， 分片后首片仍 1.5MB），而本站正文以中文为主，为它付一次冷启动不划算。 收益不在「更好看」，而在把三条栈钉死——改前同一页在 macOS 是 Georgia + PingFang、 Windows 掉成 Times New Roman + 微软雅黑、Linux 可能直接方框。 落点是 tokens.scss 的 $font-display / $font-meta，editorial 层 75 处规则引用 （23 处标题、52 处元信息），回落链保留 Georgia / SF Mono，字体取不到时版式不塌。 preload 只给 Newsreader 一条（刊头 H1 压着它，不 preload 会首屏换一次字）； 两份 Plex Mono 不 preload，它们只服务小号元信息。 核验：文章页 document.fonts 里 Newsreader 为 loaded，同一段拉丁文本在 64px 下 实测宽 662.55px，Georgia 725.81px、系统 serif 564.55px —— 字形确实换了，不是声明 了个寂寞。
• 新增（版式） 标题衬线中途从 Fraunces 换成 Newsreader。Fraunces 被一个字母否掉：它的 f 带 一道向左甩出的横担，混在宋体汉字里不像字母而像装饰件，而这个 f 不在任何可变轴上 （WONK 在 Google 那份 latin 子集里已被裁掉，改 font-variation-settings 实测零 反应），换不掉，只能换族。它的数字同样不合用（3 平顶、4 斜开口），当时先补过一份 只接管 U+0030-0039 的 Noto Serif 裁剪子集（6,096B，按 OFL 保留字条款改名分发）。 Newsreader 的 f 是正常衬线、y 的长尾还留着辨识度，数字本身齐线且开口清楚，于是 汉字／英文／数字三者互相好认——换族一次解决两件事，那份裁剪子集连同它的 @font-face 一并删掉，比 Fraunces 那套还省 15,332B（73,484 → 58,152）。
• 新增（版式） 动效令牌：--dur-1..4（120/200/320/560ms）与 --ease-out / --ease-in-out / --ease-back。此前 editorial 层没有任何时长与曲线变量，取值硬编码在四十多处规则里。
• 新增（动效） 灯箱 FLIP（M1）：点开正文图片时从那张缩略图的实际矩形飞过去，关闭飞回来。 JS 逐帧只写 transform（起点只有运行期才知道），宽高一律不碰——碰了就是逐帧重排 一张 92vw 的图。开 300ms / 关 240ms，两个方向共用一条 fly()，反向那次的起止点 必须对调（早先两行都写同一个值，transitionend 不来，每次关闭都白等满 400ms 超时）。
• 新增（动效） 卡片 hover 语言（M3）：首页卡片、分类行、系列行、书架行的标题在 hover 时位移 + 变色，位移走 translate 不占 transform。
• 新增（动效） 按压反馈（M4）：11 类控件补上 :active { scale: .97 }。此前全站只有 .cta 与 .icon-menu 两处有 :active，其余按钮按下去没有任何回信。
• 新增（动效） 面板逐项错峰入场（M6）：⌘K 结果、书架行、目录项按 28ms 步进依次出现， 由 .is-fresh 开关类控制——不加开关就会在每次筛选重绘时重放一遍入场。
• 新增（动效） 阅读进度条末端的剩余时长气泡（M7）：口径与页头那行「约 N 字 · M 分钟」严格同源 （ceil(chars / 400)，页头用的正是 Liquid 的 plus: 399 | divided_by: 400）， 起手时气泡的数字必须等于页头那个数，否则同一页两处自相矛盾。
• 新增（动效） 合集进度轨的完成脉冲（M9）：读完合集最后一篇时轨道弹一下并扫过一道光。 纯 CSS，.is-complete 由 _layouts/post.html 写进 class，不依赖 JS、不随 hover 重放。
• 新增（动效） 招财猫的三层开关：构建期 site.showCat（关掉连 HTML 都不渲染）、视口宽度、 以及用户自己收起（.mao-toggle，记在 localStorage 的 mao_tucked，跨页生效）。 原来只有前两层，且宽度那道 1500px 只在加载那一刻判一次——把窗口拉宽猫不会出来， 窄屏上想让猫消失也没有出口。宽度门槛降到 1240px 的依据：@media (max-width: 1239px) 那段里左下角的「目录」浮标与猫实测叠在一起，1500 比必要的高出一大截。 另补 resize 重算与视线跟随（归一化位移小于 0.02 不写样式，约半个视口以内不动）。 收起态随后又收了一次：原来只沉 - 10px，落在屏幕上仍是 187×40 的一对完整耳朵， 占着左下角不说，那 40px 高的实面盒子还横在正文一条带上吃点击。改成沉 calc(100% + 8px)（只剩 22px 高的耳尖）并给整块 pointer-events: none、只让 .mao-toggle 自己收回 auto。扣子的位置也跟着挪了一次：先按「不被底边切掉」放在 top: -32px，结果它悬在屏底上方 30px 处，正压在左侧正文某一行的中间——一颗按钮 盖住一句能点的话，比猫本身碍事。改成 top: -2px 贴着屏底，24px 的扣子恰好整颗 落在屏内，挡的那 24×24 回到屏幕最边缘、不在任何一行文字当中。实测收起后那条带上 elementFromPoint 命中的是页头而不是猫，扣子矩形 y 落在 637..661（视口高 661）、 中心命中的仍是它自己。 代价是收起态不再能拖着猫走（rtDraggable 挂在同一节点，收不到 pointerdown）， 要先点扣子放回来。
• 新增（动效） reduce 覆盖：这四条新 @keyframes（lightboxFade / itemRise / trackPop / fillSweep）不单独写降级，由 base.scss 那份全站 .01ms !important 兜底压住； 真机核验过——reduce 下 trackPop 与 fillSweep 的时长都是 1e-05s，光带落在 translate: 100% 的终态、被 .post-series-fill 的 overflow: hidden 裁掉， 按压过渡同样归零。FLIP 在 JS 侧直接跳过飞行。
• 修复（视觉） 正文标签的灰是 token 化时漏改的：@mixin tagStyle 里仍写着 #A6ABB2，比 --ink-4（#7A8089）还浅一档，压在 #FAFAFA 的药丸底上只有 2.2:1，14px 的标签 读起来像被擦过一层。改成 var(--ink-3)（同底 4.8:1）、hover 落到 --ink-2。 没有直接上 --ink-2 是留着层级：侧栏卡片标题「标签」本身才 --ink-4，正文标签 比它重两级就把层级倒过来了。夜间模式另有 .night-mode 那条覆盖，实测仍是 #949AA4 对 #191C23（6.0:1），不受这次改动影响。
• 修复（视觉） 阅读设置面板的「恢复默认」往下坠：文字在按钮自己那 28px 里其实是居中的， 偏的是按钮外面——分隔线到文字 9px、文字到面板底边 18.5px（面板 padding-bottom: 12px 与按钮高度各算了一遍）。把那 12px 并进按钮（28 → 40、面板底部归零）， 两侧各 13px，面板总高不变；居中改由 display: flex; align-items: center 明写， 不再依赖 <button> 各自的 UA 默认行为。颜色从 --ink-4 提到 --ink-3，与同一块 面板里的 .reader-opt 同档。
• 优化（下发与分享） normalize 与 jQuery 改自托管，摘掉 cdn.staticfile.org：2026-09-23 实测那份 normalize 15s 超时、code=000，而同页 at.alicdn 的图标 CSS 只要 0.07s——慢的是这个域。 两者都挂在 <head> 且都阻塞（一个是渲染阻塞样式表、一个是解析阻塞脚本）， 后果可复现：headless Chrome 打开任意页都取不到 document.body。 版本与字节数与原外链一致（jQuery 3.3.1 / 86,927B，normalize 6.0.0 / 2,216B）， 只换来源不换实现；jQuery 仍同步加载，加 defer 会改到执行次序，那是另一回事。
• 优化（下发与分享） 三方 CSS 按页收口：github-markdown / prism / share 三份只在文章页下发。 产物实测依据：markdown-body 命中 67 个文件且全是文章页、class="language- 命中 59 个 同样全在文章页、social-share 多出的那一个是 demo/shareDemo/index.html （它走 demoHead，根本不加载这份清单）。其余 52 个非文章页面每个都在背 16,159B（逐份 gzip 相加 5,608B）匹配不到任何节点的样式。 收口写在 headAssets.html 里而不是搬去 postHead.html：这三份必须排在 index.min.css 之前，挪到那个 include 后面就排到了之后，等于把覆盖关系整个反过来。 prism.min.js 一并从 default.html 删掉（文章页那一处保留），省 22,482B（gzip 8,405B）。
• 优化（下发与分享） WebLab 的 ace 改成按需注入：两条阻塞式 <script src> 从 weblab.html 摘掉， 改成第一次按下编辑区或第一次点「提交运行」才注入。A/B 实测（同一台机器、禁用 HTTP 缓存、 两变体交替各 5 次取中位）：按下之前 ace 请求 10 → 0、ace 字节 405KB → 0， 页面总下载 850KB → 445KB，DOMContentLoaded 2,546ms → 2,206ms，主线程 TaskDuration 2.51s → 2.36s； 按下之后两者完全一致（10 个文件 / 550KB、编辑器 5/5 就位），也就是没有把功能改坏， 只是把账推迟到真要用的那一下。对照的 A 变体只把两条脚本插回原位， 三次 ace.edit() 仍走新的懒路径，所以这组数字是改动前收益的下界。 空盒子在改动前后是同一块 300px 深色（高度由 weblab.scss 钉死），晚装不位移。
• 优化（下发与分享） og:image 补一级「本篇生成卡片」：67 篇文章里 34 篇没有 cover，它们此前全部落到 同一张站点兜底图上——转发行里认不出是哪篇，标题信息白送不要。 新增 scripts/og-images.mjs：用本机 Chrome 把 1200×630 的品牌卡（分类 · 日期 · 标题 · 站名） 截成 JPEG 存进 assets/img/og/（34 张、1,876,291B），取值表写在 _data/og_images.yml （67 条，含那 33 篇有 cover 的，好让 --check 分清「有 cover」与「漏生成」）。 seoMeta.html 于是走三级链：front matter cover > 本篇卡片 > 站点兜底图， twitter:image 与 JSON-LD 的 image 自动跟到同一张卡；宽高只在能确定时声明 （卡片恒为 1200×630，而 cover 的尺寸各不统一）。产物结果：34 卡片 + 33 cover + 0 兜底。 卡片图入库而不是 CI 生成：Pages 的构建镜像里没有 Chrome，pnpm og:check 只做校验 （五条断言：表指向的文件在磁盘、卡片尺寸恰为 1200×630、应生成的篇目都在表里且签名未变、 assets/img/og 无孤儿文件、每个键都能在 _site 找到对应页面），缺图时 exit=1。
• 优化（下发与分享） _config.yml 的 exclude 补 scripts：不带 front matter 的文件会被 Jekyll 原样复制 进 _site，加之前线上因此多出 /better-blog/scripts/。
• 优化（下发与分享） 整站回归：pnpm build + bundle exec jekyll build 通过，16 项产物级断言全绿 （字体声明与文件、无中文 webfont、三方 CSS/JS 按页收口、weblab 无阻塞 ace、 og 三级链与卡片可访问、showCat 与 .mao_box、站内绝对引用 0 坏链）。 冒烟走 baseurl 口径的本地服务，每页新建 target：文章页 0 条 JS 异常。

发布 2.0.0 之后跑了两轮独立评审加一轮自测，修掉查出来的问题。全部是「2.0.0 声称的收益 当时并不成立」或「自检脚本自己骗人」这一类，没有新特性。

• 变更 文章页面包屑 66 页全错：'/categories.html#' | append: page.categories | first 里 append 先把数组转成字符串，再对字符串取 first 得到 nil，整条链塌成裸 baseurl （产物实测 66 次 href="/better-blog"，点上去 301 回首页）。改成 page.categories[0]。 这是 10184a5 引入的存量缺陷，也就是说 2.0.0 条目里「分类归档拿到锚点级内链权重」 当时并未兑现。
• 变更 「跳到主要内容」在 68 个页面没有落点（66 篇文章 + 关于 + WebLab）：header 里的 href="#main" 指向一个不存在的 id，键盘用户按下去毫无反应。补 id="main"。
• 变更 两篇文章此前根本没有 front matter：2022-08-08-webpack-move-vite.md 与 2023-05-08-vue3-vite-study.md 从 1.0.0 起就是裸 Markdown。Jekyll 对没有 YAML 头的 _posts 文件照样排期、照样输出 HTML，只是不套任何 layout（实测产物里没有 <html> 也没有 <head>），所以这两页一直是无样式、无导航、<title> 为空的裸正文， 也因为缺 categories / tags 而不在分类归档与标签云里。补齐 front matter， 并把首屏那行与标题同文的 ## 删掉（否则标题下面立刻复读一遍）， _posts/2026-06-05-ai-sdd.md 同一处一并删。
• 变更 合集自检脚本永远通过：USAGE 用的键名是 posts，_data/series.yml 实际是 order， 核对数恒为 0、输出永远是「失效 无」。改成 order，并加一条 assert 防止自检脚本自己静默通过。 真实核对结果：34 条连载链接 + 5 条精选，0 失效。
• 变更 SEO 自查四条重写：第 1 条 grep -l '<h1' | wc -l 数的是「有 H1 的文件数」， 永远等于文章总数，出两个 H1 也发现不了；改成统计异常项，并补面包屑锚点、 noindex 与 sitemap/JSON-LD 一致性两条。
• 变更 文档口径纠正三处：_data/series.yml 注释里 date 与文件名不一致「两处」实为四处（逐条列出）； README /demo.html 的示例数按页面实际条目写 19（demo/ 目录仍是 18）； 2.0.0 条目与 sitemap 注释里「Liquid 语法错误导致条件恒假」的说法不成立——那种写法 errors 为空、也不报 Warning，是把条件求值反向（只保留外链封面），且 1.0.0 没有 sitemap.xml 文件，「11 条」是本次开发的中间态而非线上历史。 2.0.0 的 tag 说明里留着旧表述，已推送的 tag 不重写。
• 变更 noindex 的页面不再声明 JSON-LD，与 USAGE「noindex 是整站唯一的收录开关」对齐 （块数 161 → 160，CollectionPage 26 → 25）。
• 变更 自检脚本自己也要跑一遍：把 USAGE 那六条原样执行，暴露出两处脚本自身的错—— sitemap 检查用 u.split('/better-blog/')[-1] 取首页地址时得到空串，把站点根目录当成 「无落盘文件」误报（首页是 index.html）；JSON-LD 的预期块数写在 404 撤销结构化数据 之前（161 → 160）。同时补一句「必须带着重建那一条一起跑」：对着上一次残留的产物目录跑， 刚修完的问题会整片报「异常」。
• 变更 顺带记一个坑：Liquid 4 会把 {% comment %} 体内的花括号标签当块解析，一路吃到 endcomment 才报「不是合法分隔符」，构建直接失败——所以文档注释里举反例， 只能写不带花括号的读法。

从 1.0.0 起：十余次提交、两百余个文件（逐条用 git log --oneline 1.0.0..2.0.0 与 git diff --shortstat 1.0.0..2.0.0 核对；这里不写具体数字，因为记变更的这次提交自己也在区间里， 任何精确值都会在下一个 commit 之后过期）。这一版的主线是把站点从「写着方便」 改成「读着舒服、爬着看得懂」——一次编辑杂志风改版，加一条完整的检索层治理。

• 新增（阅读体验） 编辑杂志风改版：刊头、正文排版、目录、分类归档页与工具箱菜单重做。
• 新增（阅读体验） 合集与精选：_data/series.yml 提供连载条与系列内翻页，_data/picks.yml 提供首页编辑精选。
• 新增（阅读体验） 回访链路：阅读位置续读浮条（7 天有效、读完即清）、窄屏目录底部抽屉、正文图片灯箱、 主题偏好定档与无闪烁首屏。
• 新增（阅读体验） 阅读偏好、文内链接预览、金句分享卡片；书架、篇末收束层与主题日蚀转场。
• 新增（阅读体验） 蒲公英飘籽动效回到首页刊头（改为铺在刊头内、颜色取自 --ink-4，滚出视口与切后台停帧）。
• 新增（阅读体验） 8 篇文章：pnpm 并发组、gods-eye-view 免密跑通、三家 agent 并行工作区、周榜 skill 类目、 三处静默改动、agent 自动出图工具链、Next.js AVIF 开关、cloudflare 安全审计双校验器。
• 新增（检索层与工程） _includes/jsonLd.html：结构化数据一次给全 BlogPosting(66) / BreadcrumbList(66) / CollectionPage(26) / WebSite / Blog / Person（含 sameAs），共 161 个 JSON-LD 块。
• 新增（检索层与工程） sitemap 补 <image:image>（32 条站内封面）、<lastmod>，并把收录范围收敛到 「导航可达页 + 全部文章」；robots.txt 的 Sitemap 指向真正存在的地址。
• 新增（检索层与工程） 版本号管理：site.version、CHANGELOG.md、LICENSE（代码 MIT）与 LICENSE-CONTENT.md（文章 CC BY-NC-SA 4.0），页脚展示版本并可回溯到本文件。
• 新增（检索层与工程） README 重写为站点首页说明（中文为主 + 英文摘要段）；USAGE.md 补 「发布链路与分支」「写一篇新文章」「检索层自查」三节。
• 修复 线上主分支缺内容：线上产物落后 master 十余次提交（本次一并追平）， sitemap.xml、feed.xml、categories.html、 series.html、tools.html 全部 404，而 robots.txt 与每页 <link rel=alternate> 正指向它们。 根因是 deploy-github.sh 推的是当前分支（main），Workflow 只监听 master。
• 修复 站点地图的封面图段（1.0.0 没有 sitemap.xml 这个文件，线上一直 404，所以这是新增而非修复）： 写的时候踩到一个「读起来对、跑起来反」的坑——if post.cover and post.cover contains '://' == false 在 Liquid 里既不报语法错也不报 Warning，却把条件求值成「只保留外链」，产物里 11 条 <image:loc> 全是失效图床、站内 32 张封面一条没进。改成 unless post.cover contains '://' 一层独立判断后为 32 条。这类问题构建日志看不出来，只能靠数产物，见 USAGE.md「检索层自查」。
• 修复 44 个文章配图工作笔记（42 份 assets/img/{slug}/prompts/*.md + 2 份 outline.md，首行都带 front matter，会被 Jekyll 当页面渲染）、与 feed.xml 内容等价的 rss.xml、iconfont 预览页、test.html 被 Jekyll 当公开页渲染并挂在域名下 → 全部排除。
• 修复 分页页（/page2/ … /page9/）与首页共用 <title> 与 description，在 Search Console 表现为 「重复网页」；分页页改用短标题前缀 + 页码。demo/openMapDemo 与文章页 <title> 撞车一并错开。
• 修复 63 处正文重复 H1（47 处与标题同文删行，其中 1 处藏在 banner 图后面、渲染层的兜底够不着； 16 处与标题不同文、降级为 ##），每篇文章现在恰好 1 个 H1； 删掉的那批同时让 post.excerpt 恢复成真正的导语——原先上一篇/下一篇预览与 feed 的 <summary> 只是把标题重复一遍。
• 修复 11 篇的外链封面逐个复测：timgsa 域名停服、zhimg 防盗链、vscode 官网 404， 10 篇的 cover 注释下线（列表卡片回到纯文字版式，不再破图）， 仅存可访问的 img.alicdn.com 一张已拉取本地转 1440×480 webp。
• 修复 三处窄屏横向溢出（分享栏居中写法、行内 code 的 40 位 commit hash、宽表格）； 悬浮按钮在窄屏按滚动方向收放。
• 修复 categories 统一写成 YAML 列表：原先空格分隔的写法被 Jekyll 按空白拆碎 （categories: AI frontend 会变成两个不存在的分类），分类收敛到 13 个。
• 修复 品牌名与 SEO 标题分离：title 继续是刊头署名，新增 seo_title / seo_home_title / seo_archive_title 只进 <title> 与 og:title，把「前端博客」这类真正被搜的词放进标题。
• 变更 首页「热榜」改为手工挑选的编辑精选：Waline 服务端只暴露单路径读取，没有全站排行接口。
• 变更 首页刊头恢复蒲公英动效，纳入 prefers-reduced-motion 治理（该偏好下只画一帧静止）。

追溯打标：master 上第一个可用的完整状态——Jekyll 4.3 + Vite 6 构建、H2O 主题改版前的文章体系、 Waline 评论与阅读量、Cloudflare Workers 部署，以及账号密码管理助手相关文章的许可证表述修正 （GPL-3.0）。此后的内容都归在 2.0.0。