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 變更的開發和運維團隊。