odoo-owl

Odoo OWL

在 Odoo 插件或独立 Owl 应用中进行 OWL 前端开发时，请使用此技能。

首要步骤

不要假设使用的是 OWL 3。首先从本地源码和项目代码中确认实际使用的 OWL/Odoo 前端版本：

• 从分支、清单、文档或配置中确认 Odoo 版本。
• 检查 $ODOO_SOURCE 下的本地 OWL 源码（若已设置），尤其是 addons/web/static/lib/owl 或同等路径。
• 检查从 @odoo/owl、owl、@web/* 导入的内容，以及本地前端惯例。
• 检查 __manifest__.py 中的资源声明，以及现有的 static/src/js、static/src/xml 和 static/src/scss 模式。

只有当目标项目实际使用 OWL 3 时，才使用 OWL 3 参考资料。对于较旧的 Odoo 版本，本地源码和现有项目惯例优先于此技能中的 OWL 3 说明。

按任务选择参考资料

• 构建或修改 OWL 组件：使用 OWL3-CORE.md、OWL3-TEMPLATES.md 和 OWL3-STATE-LIFECYCLE.md。
• 集成 Odoo 资源/网页客户端：使用 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 调试工作流，并检查浏览器/资源/测试接口。
• 测试 OWL 组件、组件、服务和注册表：结合使用 odoo-web-testing 和 OWL-TESTING.md。

始终遵循

保持 UI 状态明确且具备响应性。优先使用属性和事件清晰的小型组件。避免修改属性。使用生命周期钩子清理监听器和外部资源。将不安全的 HTML 视为安全边界。在归咎于 OWL 行为之前，先验证资源包注册和模板加载情况。