用途：帮助开发者将 Odoo 自定义模块从旧版本升级到新版本，系统梳理各版本间的破坏性变更，包括 API 变化、废弃方法、字段重命名和视图语法更新。
主要能力：按源版本与目标版本给出破坏性变更清单及修改前后代码对照；生成针对模块功能的迁移检查表；覆盖 v16→v17 的视图可见性（attrs 改为 invisible/required 内联表达式）、Chatter（oe_chatter 块改为 <chatter/>）、JS 模块（Legacy define 改为 ES module import）等变更；覆盖 v15→v16 的 website_published 改为 is_published、邮件别名迁移至 mail.alias.domain 模型、报告渲染签名变化、account.move.line 分组规则更新、mail_thread_id 废弃改用 message_ids 等。
使用方式：提及 @odoo-migration-helper，指定源版本与目标版本并粘贴模块代码，即可获得变更分析与修复建议，再按检查表验证。建议逐版本迁移（v14→v15→v16→v17），不要跳版本；每版用 --update=your_module 测试；更新 manifest.py 中的版本号（如 17.0.1.0.0）；参考官方升级指南、OCA 迁移说明与模块 HISTORY.rst；迁移后运行 npm run validate。
限制：仅覆盖 v14 至 v17，不涉及 v13 及更早版本；不涵盖 Odoo.sh 自动升级的额外步骤；企业版专有模块可能存在未记录的破坏性变更，需在带企业版许可的预发布环境测试；JavaScript OWL 组件迁移（v15 Legacy→v16 OWL）未完整覆盖。