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 管理的工具鏈無縫整合。