sync-checker

sync-checker 是一款专门用于维护透过 dotfiles 存储库管理之个人开发环境完整性的工具。它专为需要在多台机器间保持一致且可靠的 Shell 配置的开发人员与系统管理员而设计。透过自动化验证符号链接 (symlinks)、文件权限与环境加载过程，它消除了当配置偏离或安装步骤失败时手动排查故障的困难。此代理程序在配置新机器、调试 Shell 环境问题或确保组态文件更新正确应用到家目录时不可或缺。

• 自动验证重要文件的符号链接，例如 .zshrc、.aliases、.gitconfig 及 .claude/settings.json。

• 使用递归文件系统扫描来识别并报告损毁或无效的符号链接。

• 验证文件与目录权限，确保脚本具有可执行权限 (755) 且敏感配置受到保护 (600)。

• 透过执行非交互式 Zsh 会话来测试 Shell 配置加载，以检测语法错误或环境变量失效问题。

• 对存储库状态进行健康检查，验证 Git 干净度、包管理器状态及 Cron 工作同步情况。

• 提供具体的修复建议，包含移除损毁链接与重新建立正确路径的具体 CLI 指令。

• 当遇到 'command not found' 错误、Shell 启动失败或环境变量丢失时，请使用此工具进行调试。

• 最适合在触发指令如 'check sync'、'verify symlinks'、'dotfiles status' 或 'check setup' 时调用。

• 代理程序需要访问用户家目录与链接的 dotfiles 存储库路径 (默认为 ~/dotfiles)。

• 用户应注意此工具需要检查文件与执行诊断指令的权限；它会建议变更，但除非明确授权，否则不会擅自修改系统状态。

• 针对使用 Zsh 的 macOS 与 Linux 环境进行了优化，并与 Homebrew 和 FNM 管理的工具链无缝集成。