migration-scripts

用途：在编写或审查数据库、配置迁移脚本或迁移注册表时使用。核心规则是把每个迁移视为冻结快照，不得从主代码库导入或引用常量、辅助函数、工具、共享类型或 createXxx() 之类的工厂函数；迁移输入输出类型使用 any；默认值用字面量对象而非常量引用，从而避免主代码库后续变更导致迁移静默失效。注册表方面，配置文件应按 src/utils/config/migration-scripts/v*-to-v*.ts 自动发现迁移文件（例如通过 import.meta.glob），并从文件名解析 fromVersion 与 toVersion，拒绝 v001-to-v003 这类非法步骤、重复目标版本以及不连续链路，不能只映射目标版本并假设文件名正确。性能方面，通用配置读取辅助函数或内容脚本路径不应导入迁移注册表，除非确实执行迁移；应将迁移感知的读写逻辑隔离到专门的导入、同步、恢复模块，避免常规运行时路径打包全部迁移脚本。检查清单包括：所有值内联硬编码、类型为 any、无工厂函数调用、默认值为字面量对象、迁移幂等可安全重跑、自动发现注册表校验 from 到 to 的连续性及重复目标、迁移感知存储逻辑与通用读路径隔离。限制：资料未提供具体安装命令、依赖或代码示例，实际落地需结合所在仓库结构。