用途:在指定的快照主机(如 sg01)上,从旧 Hermes cron 脚本手工迁移期间执行快照,或在启用定时器前验证护栏、在非生产 Linux 主机上测试快照逻辑。
主要能力:通过活动 vault 物化根投影;将直接 S3 内容同步进 Git 工作树;在暂存前剥离活动删除意图路径;提交并以基于 rebase 的合并推送到 GitHub。强制单写入者 Git 不变量,每集群仅一台指定快照主机可运行,角色由 fleet.yaml 约束。
关键护栏:platform_require linux 硬性阻止非 Linux 主机;rclone sync 强制 --max-delete 10;删除意图不复活,活动 Git 墓碑在 git add 前始终剥离匹配路径;WIKI_SNAPSHOT_MAX_TOMBSTONE_PRUNES 默认 10,限制精确 deletefile 调用;远端清单失败时跳过可选墓碑修剪并告警,不视为空集证明;投影一致性是晋升屏障,需 index.md 与 log.md 的 SHA-256 在超时内匹配,并满足工作树字节一致与只读预览 index_drift=false、log_drift=false。
使用方式:交互式默认 dry-run 用 /vault-snapshot --dry-run,执行用 /vault-snapshot;终端安装后用 bash $(platform_share_dir)/bin/wiki-snapshot.sh --dry-run 或去掉 --dry-run。脚本位于 $(platform_share_dir)/bin/,日志写入 $(platform_log_dir)/wiki-snapshot.log。
限制:仅 Linux;需指定快照主机角色;若根投影物化报 SYNC_LOCK_HELD,不得编辑工作树或按时间删锁,须按 docs/managed-write-lock-reclaim-runbook.md 处理。默认快照节奏为每 30 分钟,在 *:02 与 *:32。