Show HN: MigraDiff v1.3.0 – PostgreSQL schema差異與AI遷移解釋

MigraDiff 是一款專注於 PostgreSQL schema 差異比較的開源工具，近日其 v1.3.0 版本正式發佈。本次更新最引人矚目的特性是引入了 AI 驅動的遷移解釋功能，旨在幫助開發者更安全、更清晰地理解數據庫遷移中的每一步變更。

AI 遷移解釋功能通過 --explain 標誌啓用，用户需要安裝帶有 AI 支持的版本（pip install migradiff[ai]），並首先運行 migra --setup-ai 配置自己的 Anthropic API 密鑰。該功能由 Claude Haiku 模型驅動，能夠以通俗易懂的英文解釋每條遷移語句的具體作用、潛在風險，以及針對破壞性操作（如刪除列或表）提供更安全的替代方案。值得注意的是，所有數據均在本地處理，不會發送到 MigraDiff 的服務器，從而保護了用户的數據庫隱私。該功能與現有的 --output json、--from-file 等標誌完全兼容，可以無縫集成到現有的工作流中。

除了 AI 解釋，v1.3.0 還新增了遷移文件夾輸入模式（--from-migrations-dir）。這一模式允許用户直接對照一個包含編號遷移文件的目錄與一個基礎 schema 進行差異比較，而無需搭建一個實時的分支數據庫。這對於那些希望在不影響生產環境的情況下驗證遷移腳本正確性的團隊來説尤其有用。該模式支持 Supabase 使用的時間戳格式、Flyway 使用的版本號格式，以及標準的數字前綴格式。文件會按照正確的數值順序（如 9 在 10 之前）排序應用，避免了字典序排序可能帶來的錯誤。

此外，該版本還在 README 中明確了 CLI 命令與 Python 包命名的區別：CLI 命令保持為 migra 以確保向後兼容性，而 Python 包名則為 migradiff。這一澄清有助於減少用户的困惑。所有用户可以通過 pip install --upgrade migradiff 輕鬆升級到最新版本。完整的更新日誌可在項目的 GitHub 頁面上查看。

總體而言，MigraDiff v1.3.0 通過 AI 解釋和遷移文件夾支持，顯著提升了數據庫遷移管理的安全性和易用性，特別適合那些需要頻繁進行 schema 變更的開發和運維團隊。