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 变更的开发和运维团队。