SuperAPI AI 工具集

vault-fuse-freshness

部署与运维

查看项目

更新于 10-15 23:44

技能介绍

用途:在通过 rclone 挂载消费 wiki 的 Linux 主机上,审计并维护 S3 到 FUSE 的可见性新鲜度。适用于新主机在 /vault-sync-install 后上线、排查 pvelxc/LXC 主机上的过期目录列表,以及验证 --dir-cache-time 是否仍处于跨设备 SLA 范围内。

主要能力:检测正在运行的 rclone 挂载进程;将生效的 --dir-cache-time 与阈值(默认 15m)比对;可选对指定过期目录执行 rclone rc vfs/forget dir=<path>;在启用 RC 时执行有界的 rclone rc vfs/refresh recursive=true dir=/;结果记录到 $(platform_log_dir)/wiki-fuse-refresh.log。

使用方式:交互式运行配套脚本,例如 bash packages/vault-sync/skills/vault-fuse-freshness/fuse-freshness.sh --check-only、--max-dir-cache 10m、--forget-dir _archive、--dry-run;无头或 CI 场景可用环境变量,如 VS_FUSE_CHECK_ONLY=1 VS_FUSE_MAX_DIR_CACHE=15m、VS_FUSE_FORGET_DIRS="_archive raw" VS_FUSE_RC_TIMEOUT_SECONDS=60。

限制:面向 Linux,非 Linux 主机将输出跳过信息后退出;不修改挂载单元文件,只验证运行时行为并刷新 VFS 视图;若 --dir-cache-time 超过阈值则返回非零,便于自动化标记漂移;vfs/forget 使用 dir=<path> 或 file=<path> 键,不要向其传 recursive=true,递归刷新仅用于 vfs/refresh;RC 调用带超时,可用 VS_FUSE_RC_TIMEOUT_SECONDS=<seconds> 覆盖。