开发博客

讣告是怎么做出来的

每个决定、每次返工、每个踩过的坑,按开发日期写下来。配的图都是当时真实跑出来的终端输出、测试结果和截图。

  • 22 篇文章
  • 11 月 7 日 – 11 月 21 日
  • 共约 184 分钟阅读

最新

时间线

按开发日期,从近到远

    • 官网首屏:移动端 Lighthouse 从 47 到 99

      11 月 20 日深夜,官网首屏换成了桌面小窗口的真组件,手机上的 Lighthouse 只有 55 分。到 11 月 21 日凌晨 2 点 41 分,同一份本机构建在同样的模拟条件下是 99 到 100 分。这篇讲三个多小时里的三步:让首屏文字随 HTML 一起出来,首屏之前少做事,只水合首屏。

      第 20 篇阅读约 6 分钟

    • 十种语言:README、官网和软件界面,怎么保证每一种都读得通

      11 月 20 日下午到 21 日凌晨,讣告的 README 有了十种语言,软件界面有了统一的消息目录,官网有了十种语言的页面。这篇讲怎样让十种语言保持同步:一份源文件,固定的术语表,在浏览器里量字宽的图,不翻译的清单,以及每种语言的逐行通读。

      第 19 篇阅读约 8 分钟

    • 国内镜像与发版流水线

      GitHub 在国内有时连不上,有时很慢。11 月 11 日讣告有了国内镜像:同一个域名按线路分流,安装脚本和更新检查在 GitHub 没有响应时回退到镜像。之后安装包怎么同步到镜像,改了两次:从服务器去 GitHub 拉,再改成发版流水线把验证过的版本推上去,服务器只复核和改名发布。

      第 18 篇阅读约 6 分钟

    • 发布说明里的一对反引号,清空了主工作目录

      2026 年 11 月 19 日晚上,一个 Codex worker 把带反引号的发布说明放进 shell 命令,删光了项目的主工作目录。删除护栏看到的是一段文字,出错的是 Codex 在 Windows 上把命令转交给另一层 shell 的那一步。这篇按记录复盘事故、我们第一个错误的判断、1.4.3 的新规则,以及放弃的沙箱和护栏的边界。

      第 17 篇阅读约 15 分钟

    • 和 AI 一起开发:谁决策,谁干活,闸门和证据

      讣告的代码主要由 AI 写出来:协调员拆任务、核实发现,worker 在各自的工作区里实现,审查员只读。这篇讲这套分工怎么形成,任务书里的闸门和证据为什么这样要求,以及我们自己怎样先成了讣告要解决的那个问题的第一个受害者。

      第 16 篇阅读约 6 分钟

    • 空闲时什么都不做:常驻进程的零唤醒

      11 月 14 日的一次体检里,常驻的 obitd 空闲时占着约 0.37 个 CPU 核,立刻再量却只有 0.02。我们把它当成跟负载有关的问题去复现,用 pprof 找到的根因出乎意料。修完之后,一串账本写入期间的 CPU 从约 2.9 个核降到 0.2,空闲时的平均占用从 0.15 个核降到 0.03,常驻进程只靠事件醒来。

      第 15 篇阅读约 5 分钟

    • 自动登记:从先问你,到默认关闭

      11 月 12 日我们先要求讣告拿出来的每一条提议都能放心批准,11 月 14 日傍晚放开了分级的自动登记,当晚在我们自己的机器上看到四类问题,第二天凌晨 1.3.0 把自动登记改成默认关闭。从 1.2.0 到 1.3.0,隔了不到七个小时。

      第 14 篇阅读约 8 分钟

    • macOS 和 Linux:没有按句柄改名,怎么办

      Windows 上下葬是在同一个句柄上核对身份再改名,macOS 和 Linux 的改名只认父目录加名字。11 月 10 日我们决定不放宽这条承诺,两天后改成先移再核对、不对就放回,当天把整套测试搬到两个平台的 CI 上,11 月 13 日发布 1.1.0。

      第 13 篇阅读约 7 分钟

    • 产品故事变成需求:墓地提醒与 Docker 容器

      11 月 11 日凌晨,一次讲产品故事时的说法被我们拿去核对代码,发现当时做不到,于是它成了需求:agent 碰到已经下葬的路径时,讣告当场告诉它。紧接着另一个烦恼也变成了需求:agent 起的 Docker 容器,到期先停下,保留期过后才删除。

      第 12 篇阅读约 7 分钟

    • 1.0.0:第一次发布

      讣告 1.0.0 在 11 月 11 日晚上七点五十分发布,离 11 月 7 日夜里的第一个提交不到四天。这篇讲为什么第一个版本直接叫 1.0.0 并且只做 Windows,安装包怎么在安装前核对 SHA-256,为什么安装讣告的第一句话是发给 agent 的,以及不到五个小时之后的 1.0.1。

      第 11 篇阅读约 6 分钟

    • 本机跑不动的测试:把测试分成两档

      讣告的测试大多碰真实的文件系统、Git 和子进程。空闲的 CI 机器上一分钟出头能跑完的包,在同时跑着十来个 worker 的本机上超时了。11 月 10 日我们把测试分成两档:本机只跑快的,全量只在 CI 上跑,同时让每个测试包都碰不到真实的用户环境。

      第 10 篇阅读约 6 分钟

    • 托盘、小窗口和右键菜单:给人用的那一半

      讣告从第一天起就是给 agent 用的,但批准提议、翻墓地、复活一个文件,最后总是要人来做。11 月 10 日一天里,我们补上了给人用的这一半:常驻的托盘进程、五页的小窗口、经典右键菜单、文件夹策略,以及资源管理器里的下葬日期。

      第 9 篇阅读约 7 分钟

    • 改别人的配置文件,怎么才不弄坏它

      讣告要把自己写进各家 agent 的配置文件,而这些文件随时可能被编辑器或 agent 自己改写。11 月 10 日我们围绕这个问题改了三轮,每一轮都是把一个名字换成一个句柄:先核对再写入,临时文件全程只用一个句柄,临时文件按已固定的父目录创建。

      第 8 篇阅读约 7 分钟

    • 账本:JSON、SQLite,和一次没有合进去的重构

      11 月 9 日我们评估了把账本从 JSON 换成 SQLite。原型里零散提交快了十倍,第一版真实实现却比 JSON 还慢,两轮剖析之后这个分支被搁置。真正让账本变快的,是批量收割、更紧凑的格式,以及把墓地记录拆成单独的快照。

      第 7 篇阅读约 7 分钟

    • 接入 30 个 agent:hook、插件,还是规则文件加 MCP

      最初讣告只接了 Claude Code 和 Codex。11 月 9 日下午到晚上,我们把接入层改成适配器注册表,当天就接上了 29 家,第二天补齐到 30 家:17 家用原生 hook,9 家用插件,4 家只有规则文件和 MCP。这篇讲三种接法怎么分,以及每一家能做到什么怎么如实标出来。

      第 6 篇阅读约 8 分钟

    • 为什么讣告用 Go,而不是 Rust

      讣告第一版计划推荐的是 Rust,第一晚就改成了 Go,之后代码涨到 1.36 万行和 6.4 万行时,又两次认真算过要不要重写。这篇按当时的记录,讲推荐 Rust 的理由为什么没用上,留在 Go 靠的是哪几条约束,以及借着追问补上的模糊测试、基准和并行测试。

      第 5 篇阅读约 17 分钟

    • 十二轮审查:怎样让一个会删文件的工具值得信任

      11 月 8 日这一天,讣告的三个阶段一共审了 40 轮:写完一个阶段,请审查员读,逐条核实,带着会失败的测试去修,再请新的审查员,直到一轮没有严重问题。这篇讲这套循环怎么运转,各轮在找什么,以及什么时候停。

      第 3 篇阅读约 9 分钟

    • 寿命、墓地、火化:为什么不直接用回收站

      讣告把一次删除拆成登记、到期、下葬、复活、火化五步。第一版到期时把东西交给系统回收站,第一个晚上我们就动手换成了自己的墓地。这篇讲换掉的理由,墓地怎样保证放回去的正是拿走的那个东西,以及回收站更合适的场合。

      第 2 篇阅读约 10 分钟