你好，我是尤利亚。这里是我的个人博客，记录我关心的事：技术、阅读，以及偶尔的生活片段。
记录与思考。
代码检查报出一条警告，说某个编译标记未被使用，建议删除。我先看了那段代码，判断警告是对的，然后让人删掉。构建直接失败。
失败的原因不在标记本身，在配置的差异上。同一个文件在两套构建配置下行为相反：该标记在本地调试配置里参与编译，在云端打包配置里不参与。检查跑的是打包配置，所以「没有效果」在那套配置下是成立的判断，作为一般结论并不成立。真正的错误是把这个局部判断当成了全体的结论，接着按全体结论动了手。
值得记下来的是同一类毛病还有第二种表现。另有一个问题，我凭印象说「大概有几十处要改」，让同事先去数。他跑了三遍构建，答案是零处。这两件事的中间动作不同——一件是照着一份检查结果改代码，一件是照着一句印象排工期——但错的是同一个地方：都把没有实测过的东西当成了数。
所以流程上的改进只有一条，说得出、可执行：拿到一个「某处没用」的结论时，先确认这个结论是在哪一套配置下、对哪个目标成立的，再问一句跑一遍看结果。检查工具给的是它自己那套上下文里的判断，它不会替你把上下文一起交出来。跨配置的推论要么补一次实测，要么就当没有。
候选名以「能否直接读写成网址」作为最终检验。四个候选中有三个需要停顿才能正确拼写；最终选定的名称可以按其本身读法直接拼出，写成 flypaper.apps.air.build 同样可直接读出。可读、可拼、可在移动端键盘输入，是候选留在最终名单的三项条件，不是风格偏好。
推荐与决策分离：提出候选并标明推荐项是执行侧的工作，选定名称由产品负责人完成。四个候选全部附推荐标记，最终选择不由执行侧作出。
一个概念对应一个词。粘蝇板、胶面、拍、重置四项在中文与英文各自成表，一一对应，不引入近义词；同一条目在两种语言之间也是一对一。显示名两种语言都用 Flypaper，该词本身就是这个物体的英文名称，另造中文名会新增一层需要解释的对应关系。
闭合状态的外屏只显示一行「展开设备」，四个字要同时说明操作与原因。VoiceOver 对整块胶面播报一条汇总标签（「粘蝇板，已粘住 N 只苍蝇」），不逐只朗读——对象处于表演状态，不是等待点击的控件。
关于页热力图的提交数从 412 降至 376，若干日期的色阶随之下降。这一区间内排除了 39 条他人提交，同时另有 3 条新提交计入，净减 36 条。被排除的部分来自一处未按作者过滤的统计逻辑：另一个 agent 在 Bingu 仓库产生的提交被计为博主本人的活动。
统计脚本按提交日期聚合，未对作者做筛选。仓库维度的隔离在此处不成立——统计口径是账号，而账号下包含多个仓库。
引入作者邮箱白名单，仅统计名单内的提交。
这里有一处不能按直觉判断的边界：白名单不能由「邮箱是否已在账号上验证」推导。博主历史提交中有 292 条使用的邮箱从未在账号上验证，按验证状态筛选会把这些一并排除。
脚本运行结束后输出被排除的作者及其提交条数。新增的机器身份由此进入可见状态，而不是被静默丢弃。
同一类问题此前已出现过一次：统计范围曾包含第三方镜像仓库 bilibili-api-collect。该仓库不属于博主，账号本人在其中有 0 条提交，全仓共 1219 条提交、239 个外部作者、523 个活跃日。全历史口径下，混入使活跃日从 76 涨到 597，差 521 天；而渲染只看最近 52 周，这 521 天里绝大部分从未上过图。热力图窗口内该仓库只有 11 条提交，落在 6 个日期：其中 4 天整格变空（2025-11-06、11-16、2026-01-11、01-21），2 天掉一档（01-19、01-22）。受影响的是 6 个格子，不是 521 个。
判定不能靠「是否 fork」：该仓库在 GitHub 上 fork 为 false，无 parent、无 upstream，是 2026-01-29 一次性导入的重新上传，fork 检查抓不到它。
现行规则里真正保住正确性的只有一道：把提交作者邮箱与账号本人比对，镜像仓的 1219 条在这一步全部归零。仓库白名单（只拉账号名下的四个仓库）限定的是统计范围与开销，不是正确性——保留镜像仓、只用邮箱白名单跑一遍，窗口内每天的数与现状完全一致。两道白名单的关系容易写反，按「各挡一类、缺一不可」写会让读者以为少一道结果就错。
站点最初部署在自建 worker 上。产物里没有独立的 CSS 与 JS 文件：样式整份内联进每个 HTML 的 <style>（tools/build-site.js:594 读 hub_source/style.css，第 776 行写入），脚本同样内联，页面不向外部主机取任何资源。发布方式是本地构建后把 dist/ 拷到 web/dist/，再执行一条 workers deploy 命令。
该托管对每个文件返回同一类含糊的 content type，样式表与脚本无法作为独立文件加载，只能内联。内联是绕行，不是设计选择；代价是同一份 CSS 在每一页里重复一份，样式改动也无法单独进入浏览器缓存。
删除 worker 部署路径（35ea0c5，10-21）：.gitignore 中的 web/ 与 README 的 AirHost 章节一并移除，不再保留第二套部署命令。构建与发布交给 Vercel，vercel.json 已配好构建命令与输出目录（pnpm build:site，输出 dist/），部署收敛为推送代码一条路径。
迁移只换了托管，没有换渲染方式。内联的样式与脚本保留至今，dist/ 里依旧没有 .css 和 .js 文件。所以这一篇说的「少一条路径」只针对部署，不涉及页面构造。
此前作者名与作者指纹硬编码在 src/content.js 的 SITE.author、SITE.authorId 中，三语各写一份，所有文章显示同一作者，作者行后面跟一个固定指纹。
author 改为 frontmatter 字段，省略即博主，填他人 id 即显示那个人。名字、角色与头像都按 id 查 AUTHORS（src/content.js）。未知 id、缺照片、照片尺寸不对或带透明像素，构建直接失败并指出是哪个人（tools/build-site.js:112 与 checkAvatars），不会静默回退成博主或色块。
头像的种子不能改。 头像有两种渲染结果：有照片就显示照片，没有才按种子画 5×5 色块兜底（tools/build-site.js:290，avatarFor）。种子按 id 固定，不随语言变化——同一个人在三种语言里是三个名字，用名字当种子会得到三张不同的脸。十二位作者（含博主）目前都配有照片，兜底路径走不到；改掉种子重新构建，产物逐字节相同。种子固定下来只在撤掉某人照片时才起作用：那时兜底的图形仍是同一个。
同一处的另一种误读是图标。favicon.svg 与 apple-touch-icon.png 是独立的静态文件，构建时原样复制（tools/build-site.js:963），不从任何种子生成；src/content.js 中曾有一段注释称图标仍从 identicon 生成，与代码不符，已改正（ae4645d）。
缺失语言的语义已改变。 原规则下「本文没有英文正文」等同于「英文站里没有这篇」。现在缺哪种语言就按 中文 → 英文 → 日文 逐字段回填，标题、摘要、正文各自独立；回填的只是内容，界面文案仍按各语言分别维护，正文块的 lang 跟随实际用到的那份。
色块不再是某一个人的标识。 5×5 色块原为单一作者设计，全员共用后成了同一个图形排成队。现在各人配自己的照片，色块退回兜底。
英文文件存在但没写日期的时候，这篇文章在列表里落到末尾，时间栏空着，中文文件里写了日期也不生效。构建不报错，也不打日志，页面照常生成，所以一直没人发现。
真正的成因比「只读英文」更绕。日期在记录第一次创建时就被定下来，取的是当时那个文件的日期；此后没有任何地方再写回。读取逻辑里确实还有一行按语言判断的赋值，看起来正是它在维护英文优先，但它是死代码。
我把它改成不分语言的赋值，重新构建整站，产物零差异：39 个 markdown、13 篇英文，一个字节都没变。原因很直接——13 篇英文每一篇都写了日期，没有一篇是「英文存在但日期为空」，那行的条件从来没有成立过。删掉整行也是同样的零差异。
所以英文优先不发生在任何优先级列表里，也不发生在那一行，而发生在创建记录的那一刻：文件按名字排序读进来，同一篇的英文排在日文和中文之后，于是记录总由英文创建，日期自然取英文的。那行代码没能维护英文优先，因为英文优先早在它之前就已经发生了。
英文文件不存在时才轮到排序说了算，谁排前面就用谁的日期，实际上日文先于中文。这一段是纯粹的文件名副作用，不是谁定的规则，改个文件名就能变。
现在的写法先把三份的日期各自存下来，再按中文、英文、日文取第一个非空值。读写分开，顺序写在明处，以后加语种只要往这个列表里加一项，不用再去猜文件名的排列。
最后一条注意：日期取到第一个非空值之后不做校验，也不跟当天比较。构建目前没有跳过未来文章的过滤；哪天加上，空日期比不出大小，会被当成可发布，校验得加在读取那一处，不能指望空值自己拦住。
最近书桌上有几本书。
| 书名 | 进度 | 一句话 |
|---|---|---|
| 《某某书》 | 读到一半 | 关于工具的哲学 |
| 《另一本》 | 刚开始 | 讲清楚一件复杂的事 |
阅读不是收集信息，而是重新组织自己。
会持续更新。
这是博客的第一篇文章。
一个安静的地方，记录想法，也逼迫自己把模糊的念头写清楚。
console.log("hello, world");
感谢你来。
日常攒下来的几行，放在这里防丢。
du -sh ./* | sort -rh | head -10
for f in *.jpeg; do mv "$f" "${f%.jpeg}.jpg"; done
lsof -i :8080
短，但每次都要查，不如记在这里。
这个周末把手冲的参数又理了一遍。
之前总觉得酸，后来发现是磨得太细、萃取太狠。调粗一格，立刻顺了。
咖啡这东西，变量太多，只能一次动一个。
下周试试冰的。