SuperAPI AI 工具集

vault-sync-status

通用与其它

查看项目

更新于 10-16 06:21

技能介绍

用途:对当前主机上的 vault-sync 做一次性详细健康报告,适用于安装后快速检查、排查同步问题、CI 只读验证生产主机(sg01)、迁移前后检查,以及验证已安装运行时哈希与包源一致。

主要能力:解析 vault 路径(VS_VAULT_PATH → WIKI_PATH → skillwiki --human path → $HOME/wiki),运行 vault_sync_doctor 检查,报告冲突标记;读取调度器状态(leaf/full 主机为 wiki-push、wiki-fetch,snapshotter 主机为 wiki-snapshot);检查终端助手与 ~/bin/wiki-sync.sh 符号链接(仅警告不修复);按角色检查日志尾部与过滤器;验证 runtime-manifest.json、脚本 SHA-256 与包源匹配、运行时注册、live-verify.ok;解析 S3 可达性并做有超时上限的探测(默认 3 秒,可用 VS_REACHABILITY_TIMEOUT 覆盖)。

使用方式: VS_READ_ONLY=1 bash packages/vault-sync/skills/vault-sync-status/status.sh bash skills/vault-sync-status/status.sh --json bash skills/vault-sync-status/status.sh --read-only 支持 --json、--read-only、--fail-on error|warn。

限制:--read-only 下不写文件、不重启服务、不执行修改状态的 launchctl/systemctl;状态模式不修复问题。应从安装所用包树运行,避免随机 worktree 造成误报。未配置 S3 remote 视为未知而非不可达。资料未提供收费、价格与平台支持范围。