用途：用于 Odoo 插件或独立应用中的 OWL 前端开发，指导组件的构建、修改、调试、测试与跨版本迁移。
首要步骤：不要假定项目使用 OWL 3，应先从本地源码与项目代码确认实际 OWL/Odoo 前端版本，包括分支、manifest、文档或配置中的 Odoo 版本；$ODOO_SOURCE 下的本地 OWL 源码（如 addons/web/static/lib/owl 或等价位置）；来自 @odoo/owl、owl、@web/* 的现有导入及本地前端约定；manifest.py 的 assets 声明以及 static/src/js、static/src/xml、static/src/scss 的既有写法。仅当目标项目确实使用 OWL 3 时才参考 OWL 3 资料；旧版 Odoo 以本地源码和项目约定为准。
任务路由：构建或修改 OWL 组件参考 OWL3-CORE.md、OWL3-TEMPLATES.md、OWL3-STATE-LIFECYCLE.md；集成 Odoo assets/Web 客户端参考 OWL3-ODOO-INTEGRATION.md 与 ASSETS.md；构建或审查字段组件参考 FIELD-WIDGETS.md；从 OWL 1/2 迁移到 OWL 3 参考 OWL3-MIGRATION.md，但需先核实本地兼容性；前端规范与风格审查可配合 odoo-code-review；调试 Odoo 前端异常参考 OWL-DEBUGGING.md，配合 Odoo 调试流程并检查浏览器、assets 与测试接缝；测试 OWL 组件、组件、服务与注册表可配合 odoo-web-testing 与 OWL-TESTING.md。
通用原则：保持 UI 状态显式且响应式；优先使用带清晰 props 与事件的小组件；避免直接改写 props；用生命周期钩子清理监听器与外部资源；将不安全 HTML 视为安全边界；在归咎于 OWL 行为前，先确认 asset bundle 注册与模板加载是否正常。
限制：本资料未提供具体版本号、安装命令、收费信息或效果数据。