用途：升级 @supabase/supabase-js 与 Supabase CLI，检测破坏性变更、迁移代码并规划回滚。覆盖 v1→v2 迁移（认证方法重命名、data/error 解构、Realtime API 重构）、小版本升级、@supabase/ssr 采用，以及通过 pip install --upgrade supabase 升级 Python SDK。
主要能力：审计已安装的 Supabase 包并扫描代码中的导入位置；识别 v1→v2 破坏性变更，如 session()/user() 改为异步 getSession()/getUser()，signIn() 拆分为 signInWithPassword、signInWithOAuth、signInWithOtp，.api 命名空间移除，onAuthStateChange 多一层解构，错误由 message 字符串改为 code 枚举，.single() 零行报错需改用 .maybeSingle()，Realtime 由 .on() 改为 channel 频道 API；执行升级并应用代码迁移；验证、测试并准备回滚。
使用方式：先检查版本与导入，如 npm list @supabase/supabase-js、supabase --version、pip show supabase | grep Version，并用 grep 查找导入与 createClient 调用。创建分支后执行 npm install @supabase/supabase-js@latest、npm install @supabase/ssr@latest、npm install -g supabase@latest、pip install --upgrade supabase，并按需运行 npx supabase gen types typescript --linked 与 npx supabase db diff --use-migra -f upgrade_check。随后用 npx tsc --noEmit、npm test、python -m pytest tests/ -v 验证，并手动冒烟测试注册、OAuth、密码重置、会话刷新、Realtime 与存储。回滚可固定旧版本或还原分支。
适用场景：需要将 Supabase 项目从 v1 升级到 v2、升级 CLI 或 Python SDK、采用 @supabase/ssr 时。
限制：需已安装对应 SDK、Git 工作区干净、有测试套件，Node.js >= 18 或 Python >= 3.8。资料未提供具体收费、价格或平台信息。