用途：Advanced Alchemy CLI 用于数据库迁移与版本管理，覆盖迁移生成、升级、降级、状态检查、分支管理、夹具导出以及框架 CLI 集成。
主要能力：核心生命周期命令包括 init、make-migrations、upgrade、downgrade；检查类命令包括 check、heads、history、show-current-revision，可用于 CI 或故障排查；还提供分支管理和工具类命令。
使用方式：需要独立 alchemy 命令时先安装 CLI extra。每条命令都应通过 --config 指向显式的点分配置路径。 示例： alchemy init --config path.to.alchemy_config.config alchemy make-migrations --config path.to.alchemy_config.config -m "add users" alchemy upgrade --config path.to.alchemy_config.config
仅在项目已有应用 CLI 需要扩展时，才把 CLI 嵌入 Click 或 Typer。
适用场景：在 CI 中于部署前用 check 做漂移检测；在排障时检查迁移状态；在确实需要时使用分支管理与夹具相关命令。
限制与注意事项：自动化中优先使用显式配置路径而非隐式发现；drop-all 等破坏性命令应置于明确的环境保护后；破坏性或离线 SQL 模式必须仅在有明确意图时使用。分支与工具命令只在迁移图确实需要时使用。使用前确认点分配置路径在目标环境可正常导入、迁移命令作用于预期数据库绑定。若配置对象尚未接通，可先参考 advanced-alchemy-getting-started；若框架 CLI 暴露相同迁移命令，可参考 advanced-alchemy-litestar 或 advanced-alchemy-flask；若夹具导出或加载属于运维流程，可参考 advanced-alchemy-database-seeding。