odoo-18

Odoo 18 技能 - 主索引

Odoo 18 开发指南的主索引。请根据任务从 references/ 中阅读相应指南。

快速参考

主题	文件	使用场景
动作	references/odoo-18-actions-guide.md	创建动作、菜单、计划任务、服务端动作
API 装饰器	references/odoo-18-decorator-guide.md	使用 @api 装饰器、计算字段、验证
控制器	references/odoo-18-controller-guide.md	编写 HTTP 端点、路由、Web 控制器
数据文件	references/odoo-18-data-guide.md	XML/CSV 数据文件、记录、快捷方式
开发	references/odoo-18-development-guide.md	创建模块、清单、报表、安全、向导
字段类型	references/odoo-18-field-guide.md	定义模型字段、选择字段类型
清单	references/odoo-18-manifest-guide.md	manifest.py 配置、依赖项、钩子
迁移	references/odoo-18-migration-guide.md	升级模块、数据迁移、版本变更
混入类	references/odoo-18-mixins-guide.md	mail.thread、活动、电子邮件别名、跟踪
模型方法	references/odoo-18-model-guide.md	编写 ORM 查询、CRUD 操作、域过滤器
OWL 组件	references/odoo-18-owl-guide.md	构建 OWL UI 组件、钩子、服务
性能	references/odoo-18-performance-guide.md	优化查询、修复慢代码、防止 N+1
报表	references/odoo-18-reports-guide.md	QWeb 报表、PDF/HTML、模板、纸张格式
安全	references/odoo-18-security-guide.md	访问权限、记录规则、字段权限
测试	references/odoo-18-testing-guide.md	编写测试、模拟、断言、浏览器测试
事务	references/odoo-18-transaction-guide.md	处理数据库错误、保存点、UniqueViolation
翻译	references/odoo-18-translation-guide.md	添加翻译、本地化、i18n
视图与 XML	references/odoo-18-view-guide.md	编写 XML 视图、动作、菜单、QWeb 模板

编码约定

编写代码前，如果已安装 odoo-workflow 技能，请先运行它（追踪真实源码，使用 file:line 编写 Context Brief，明确完成定义）；请将其与此工具包一同安装。

编写代码前，请阅读 references/api-highlights.md，并应用其中的快速检查项：❌ 标记的项目是在 Odoo 18 中不应使用的内容。

遵循所打开指南中的约定部分。以 Odoo 18 的运行时行为和现有稳定插件的风格为准；保持差异范围精简。

• 模块命名、资源、JavaScript、CSS 和 SCSS：参阅开发指南。
• XML 格式和 ID：参阅数据、动作、报表、安全和视图指南。
• Python、记录集、事务和翻译：参阅模型、字段、装饰器、性能、事务和翻译指南。

文件结构

skills/odoo-18.0/
├── SKILL.md                          # This file - master index
└── references/                       # Development guides
    ├── odoo-18-actions-guide.md
    ├── odoo-18-controller-guide.md
    ├── odoo-18-data-guide.md
    ├── odoo-18-decorator-guide.md
    ├── odoo-18-development-guide.md
    ├── odoo-18-field-guide.md
    ├── odoo-18-manifest-guide.md
    ├── odoo-18-migration-guide.md
    ├── odoo-18-mixins-guide.md
    ├── odoo-18-model-guide.md
    ├── odoo-18-owl-guide.md
    ├── odoo-18-performance-guide.md
    ├── odoo-18-reports-guide.md
    ├── odoo-18-security-guide.md
    ├── odoo-18-testing-guide.md
    ├── odoo-18-transaction-guide.md
    ├── odoo-18-translation-guide.md
    └── odoo-18-view-guide.md

基础代码参考（Odoo 18）

所有指南均基于对 Odoo 18 源代码的分析：

• odoo/models.py - ORM 实现
• odoo/fields.py - 字段类型
• odoo/api.py - 装饰器
• odoo/http.py - HTTP 层
• odoo/exceptions.py - 异常类型
• odoo/tools/translate.py - 翻译系统
• odoo/addons/base/models/res_lang.py - 语言模型
• addons/web/static/src/core/l10n/translation.js - JS 翻译

外部文档

• Odoo 18 官方文档
• Odoo 18 开发者参考
• Odoo 编码指南