odoo-18

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Odoo 18 Skill - Master Index

Odoo 18 技能 - 总索引

Master index for all Odoo 18 guides. Use this to quickly find the appropriate guide for your task.

所有Odoo 18指南的总索引。使用本索引可快速找到适合你任务的指南。

Quick Reference

快速参考

Topic	File	When to Use
Actions	`odoo-18-actions-guide.md`	Creating actions, menus, scheduled jobs, server actions
API Decorators	`odoo-18-decorator-guide.md`	Using @api decorators, compute fields, validation
Data Files	`odoo-18-data-guide.md`	XML/CSV data files, records, shortcuts
Development	`odoo-18-development-guide.md`	Creating modules, manifest, reports, security, wizards
Field Types	`odoo-18-field-guide.md`	Defining model fields, choosing field types
Manifest	`odoo-18-manifest-guide.md`	manifest.py configuration, dependencies, hooks
Mixins	`odoo-18-mixins-guide.md`	mail.thread, activities, email aliases, tracking
Model Methods	`odoo-18-model-guide.md`	Writing ORM queries, CRUD operations, domain filters
Performance	`odoo-18-performance-guide.md`	Optimizing queries, fixing slow code, preventing N+1
Reports	`odoo-18-reports-guide.md`	QWeb reports, PDF/HTML, templates, paper formats
Security	`odoo-18-security-guide.md`	Access rights, record rules, field permissions
Testing	`odoo-18-testing-guide.md`	Writing tests, mocking, assertions, browser testing
Translation	`odoo-18-translation-guide.md`	Adding translations, localization, i18n
Transactions	`odoo-18-transaction-guide.md`	Handling database errors, savepoints, UniqueViolation
Controllers	`odoo-18-controller-guide.md`	Writing HTTP endpoints, routes, web controllers
Views & XML	`odoo-18-view-guide.md`	Writing XML views, actions, menus, QWeb templates
OWL Components	`odoo-18-owl-guide.md`	Building OWL UI components, hooks, services
Migration	`odoo-18-migration-guide.md`	Upgrading modules, data migration, version changes

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

Guide Index

指南索引

Actions Guide

动作指南

File:

odoo-18-actions-guide.md

When to read:

Creating window actions, URL actions, server actions
Setting up scheduled/cron jobs
Configuring report actions
Creating client-side actions
Understanding action bindings

文件:

odoo-18-actions-guide.md

阅读场景:

创建窗口动作、URL动作、服务器动作
设置定时/ cron任务
配置报表动作
创建客户端动作
理解动作绑定

Controller Guide

控制器指南

File:

odoo-18-controller-guide.md

When to read:

Creating HTTP endpoints
Writing web controllers
Setting up routes
Choosing auth types (user, public, none)
Handling JSON vs HTTP responses

文件:

odoo-18-controller-guide.md

阅读场景:

创建HTTP端点
编写Web控制器
设置路由
选择认证类型（user、public、none）
处理JSON与HTTP响应

Data Files Guide

数据文件指南

File:

odoo-18-data-guide.md

When to read:

Creating XML data files
Understanding record, field, delete, function tags
Using CSV data files
Working with shortcuts (menuitem, template, asset)
Understanding noupdate attribute

文件:

odoo-18-data-guide.md

阅读场景:

创建XML数据文件
理解record、field、delete、function标签
使用CSV数据文件
处理快捷方式（menuitem、template、asset）
理解noupdate属性

Decorator Guide

装饰器指南

File:

odoo-18-decorator-guide.md

When to read:

Using
```
@api.depends
```
for computed fields
Using
```
@api.constrains
```
for validation
Using
```
@api.ondelete
```
(Odoo 18) for delete validation
Using
```
@api.onchange
```
for form UI updates
Using
```
@api.model
```
for model-level methods

文件:

odoo-18-decorator-guide.md

阅读场景:

使用
```
@api.depends
```
定义计算字段
使用
```
@api.constrains
```
进行验证
使用
```
@api.ondelete
```
（Odoo 18）进行删除验证
使用
```
@api.onchange
```
更新表单UI
使用
```
@api.model
```
定义模型级方法

Development Guide

开发指南

File:

odoo-18-development-guide.md

When to read:

Creating new modules
Writing
```
__manifest__.py
```
Setting up module structure
Configuring access rights (CSV)
Creating record rules
Building wizards (TransientModel)
Creating reports

文件:

odoo-18-development-guide.md

阅读场景:

创建新模块
编写
```
__manifest__.py
```
设置模块结构
配置访问权限（CSV）
创建记录规则
构建向导（TransientModel）
创建报表

Field Guide

字段指南

File:

odoo-18-field-guide.md

When to read:

Defining new model fields
Choosing appropriate field types (Char, Text, Monetary, etc.)
Setting field parameters (required, default, index, etc.)
Creating computed fields
Setting up relational fields (Many2one, One2many, Many2many)

文件:

odoo-18-field-guide.md

阅读场景:

定义新模型字段
选择合适的字段类型（Char、Text、Monetary等）
设置字段参数（required、default、index等）
创建计算字段
设置关联字段（Many2one、One2many、Many2many）

Manifest Guide

清单指南

File:

odoo-18-manifest-guide.md

When to read:

Configuring
```
__manifest__.py
```
Setting up module dependencies
Defining asset bundles
Declaring external dependencies (Python, binary)
Using module hooks (pre_init, post_init, uninstall)
Understanding auto_install behavior

文件:

odoo-18-manifest-guide.md

阅读场景:

配置
```
__manifest__.py
```
设置模块依赖
定义资源包
声明外部依赖（Python、二进制文件）
使用模块钩子（pre_init、post_init、uninstall）
理解auto_install行为

Migration Guide

迁移指南

File:

odoo-18-migration-guide.md

When to read:

Upgrading modules from earlier versions
Writing migration scripts (pre, post, end)
Handling data migration
Using module hooks (pre_init, post_init, uninstall)
Version-specific migration logic

文件:

odoo-18-migration-guide.md

阅读场景:

从旧版本升级模块
编写迁移脚本（pre、post、end）
处理数据迁移
使用模块钩子（pre_init、post_init、uninstall）
版本特定的迁移逻辑

Mixins Guide

混合类指南

File:

odoo-18-mixins-guide.md

When to read:

Using mail.thread (messaging, chatter, field tracking)
Setting up mail.alias.mixin (email aliases)
Adding mail.activity.mixin (activities)
Using utm.mixin (campaign tracking)
Website publishing (website.published.mixin)
SEO metadata (website.seo.metadata)
Customer ratings (rating.mixin)

文件:

odoo-18-mixins-guide.md

阅读场景:

使用mail.thread（消息、 chatter、字段追踪）
设置mail.alias.mixin（邮箱别名）
添加mail.activity.mixin（活动）
使用utm.mixin（营销活动追踪）
网站发布（website.published.mixin）
SEO元数据（website.seo.metadata）
客户评分（rating.mixin）

Model Guide

模型指南

File:

odoo-18-model-guide.md

When to read:

Writing model methods
Using ORM queries (
```
search
```
,
```
read
```
,
```
create
```
,
```
write
```
,
```
unlink
```
)
Working with domain filters
Understanding recordsets and prefetching
Batch operations

文件:

odoo-18-model-guide.md

阅读场景:

编写模型方法
使用ORM查询（
```
search
```
、
```
read
```
、
```
create
```
、
```
write
```
、
```
unlink
```
）
处理域过滤器
理解记录集与预取
批量操作

OWL Guide

OWL指南

File:

odoo-18-owl-guide.md

When to read:

Building OWL components
Using hooks (useState, onWillStart, onMounted, etc.)
Using services (orm, rpc, action, dialog, notification)
Component lifecycle management
JavaScript/OWL translations with
```
_t()
```

文件:

odoo-18-owl-guide.md

阅读场景:

构建OWL组件
使用钩子（useState、onWillStart、onMounted等）
使用服务（orm、rpc、action、dialog、notification）
组件生命周期管理
使用
```
_t()
```
进行JavaScript/OWL翻译

Performance Guide

性能指南

File:

odoo-18-performance-guide.md

When to read:

Fixing N+1 query problems
Optimizing slow code
Reducing database queries
Understanding prefetch behavior

Using

search_read()

read_group()

mapped()

filtered()

文件:

odoo-18-performance-guide.md

阅读场景:

修复N+1查询问题
优化慢代码
减少数据库查询
理解预取行为

使用

search_read()

、

read_group()

、

mapped()

、

filtered()

Reports Guide

报表指南

File:

odoo-18-reports-guide.md

When to read:

Creating QWeb reports (PDF/HTML)
Writing report templates
Configuring paper formats
Creating custom reports with _get_report_values
Adding barcodes to reports
Using custom fonts
Creating translatable reports

文件:

odoo-18-reports-guide.md

阅读场景:

创建QWeb报表（PDF/HTML）
编写报表模板
配置纸张格式
使用_get_report_values创建自定义报表
在报表中添加条形码
使用自定义字体
创建可翻译报表

Security Guide

安全指南

File:

odoo-18-security-guide.md

When to read:

Configuring access rights (ACL)
Creating record rules
Understanding field-level access
Multi-company security
Preventing security pitfalls (SQL injection, XSS)
Public/Portal user security

文件:

odoo-18-security-guide.md

阅读场景:

配置访问权限（ACL）
创建记录规则
理解字段级访问
多公司安全
避免安全陷阱（SQL注入、XSS）
公共/门户用户安全

Testing Guide

测试指南

File:

odoo-18-testing-guide.md

When to read:

Writing unit tests (TransactionCase)
Writing browser tests (HttpCase)
Using test decorators (@tagged, @users, @warmup)
Testing with Form class
Mocking external APIs
Query count assertions

文件:

odoo-18-testing-guide.md

阅读场景:

编写单元测试（TransactionCase）
编写浏览器测试（HttpCase）
使用测试装饰器（@tagged、@users、@warmup）
使用Form类测试
模拟外部API
查询计数断言

Translation Guide

翻译指南

File:

odoo-18-translation-guide.md

When to read:

Adding translatable strings in Python (
```
_()
```
,
```
_lt()
```
)
Adding translatable strings in JavaScript (
```
_t()
```
)
Creating translatable QWeb templates
Setting up translated fields (
```
translate=True
```
)
Managing PO files
Exporting/importing translations
Working with languages (
```
res.lang
```
)

文件:

odoo-18-translation-guide.md

阅读场景:

在Python中添加可翻译字符串（
```
_()
```
、
```
_lt()
```
）
在JavaScript中添加可翻译字符串（
```
_t()
```
）
创建可翻译QWeb模板
设置可翻译字段（
```
translate=True
```
）
管理PO文件
导出/导入翻译
处理语言（
```
res.lang
```
）

Transaction Guide

事务指南

File:

odoo-18-transaction-guide.md

When to read:

Handling database errors (UniqueViolation, NotNullViolation)
Using savepoints for error isolation
Understanding transaction states
Dealing with serialization failures
Commit and rollback patterns

文件:

odoo-18-transaction-guide.md

阅读场景:

处理数据库错误（UniqueViolation、NotNullViolation）
使用保存点隔离错误
理解事务状态
处理序列化失败
提交与回滚模式

View Guide

视图指南

File:

odoo-18-view-guide.md

When to read:

Writing list views (use
```
<list>
```
not
```
<tree>
```
in Odoo 18)
Writing form views
Writing search views
Creating view inheritance with xpath
Writing QWeb templates
Creating actions and menus

文件:

odoo-18-view-guide.md

阅读场景:

编写列表视图（Odoo 18中使用
```
<list>
```
而非
```
<tree>
```
）
编写表单视图
编写搜索视图
使用xpath实现视图继承
编写QWeb模板
创建动作与菜单

File Structure

文件结构

agent-skills/skills/odoo/18.0/
├── SKILL.md                       # THIS FILE - master index
├── dev/                           # Development guides folder
│   ├── odoo-18-actions-guide.md     # ir.actions.*, cron, bindings
│   ├── odoo-18-controller-guide.md  # HTTP, routing, controllers
│   ├── odoo-18-data-guide.md        # XML/CSV data files, records
│   ├── odoo-18-decorator-guide.md   # @api decorators
│   ├── odoo-18-development-guide.md # Manifest, wizards (overview)
│   ├── odoo-18-field-guide.md       # Field types, parameters
│   ├── odoo-18-manifest-guide.md    # __manifest__.py reference
│   ├── odoo-18-mixins-guide.md      # mail.thread, activities, etc.
│   ├── odoo-18-model-guide.md       # ORM, CRUD, search, domain
│   ├── odoo-18-migration-guide.md   # Migration scripts, hooks
│   ├── odoo-18-owl-guide.md          # OWL components, services
│   ├── odoo-18-performance-guide.md  # N+1 prevention, optimization
│   ├── odoo-18-reports-guide.md      # QWeb reports, PDF/HTML
│   ├── odoo-18-security-guide.md    # ACL, record rules, security
│   ├── odoo-18-testing-guide.md      # Test classes, decorators
│   ├── odoo-18-transaction-guide.md # Savepoints, errors
│   ├── odoo-18-translation-guide.md # Translations, i18n
│   └── odoo-18-view-guide.md        # XML views, QWeb
├── CLAUDE.md                      # Claude Code specific
└── AGENTS.md                      # AI agents setup

agent-skills/skills/odoo/18.0/
├── SKILL.md                       # 本文件 - 总索引
├── dev/                           # 开发指南文件夹
│   ├── odoo-18-actions-guide.md     # ir.actions.*、cron、绑定
│   ├── odoo-18-controller-guide.md  # HTTP、路由、控制器
│   ├── odoo-18-data-guide.md        # XML/CSV数据文件、记录
│   ├── odoo-18-decorator-guide.md   # @api装饰器
│   ├── odoo-18-development-guide.md # 清单、向导（概述）
│   ├── odoo-18-field-guide.md       # 字段类型、参数
│   ├── odoo-18-manifest-guide.md    # __manifest__.py参考
│   ├── odoo-18-mixins-guide.md      # mail.thread、活动等
│   ├── odoo-18-model-guide.md       # ORM、CRUD、搜索、域
│   ├── odoo-18-migration-guide.md   # 迁移脚本、钩子
│   ├── odoo-18-owl-guide.md          # OWL组件、服务
│   ├── odoo-18-performance-guide.md  # N+1问题预防、优化
│   ├── odoo-18-reports-guide.md      # QWeb报表、PDF/HTML
│   ├── odoo-18-security-guide.md    # ACL、记录规则、安全
│   ├── odoo-18-testing-guide.md      # 测试类、装饰器
│   ├── odoo-18-transaction-guide.md # 保存点、错误
│   ├── odoo-18-translation-guide.md # 翻译、i18n
│   └── odoo-18-view-guide.md        # XML视图、QWeb
├── CLAUDE.md                      # Claude Code 专属
└── AGENTS.md                      # AI Agent 设置

Base Code Reference (Odoo 18)

基础代码参考（Odoo 18）

All guides are based on analysis of Odoo 18 source code:

```
odoo/models.py
```
- ORM implementation
```
odoo/fields.py
```
- Field types
```
odoo/api.py
```
- Decorators
```
odoo/http.py
```
- HTTP layer
```
odoo/exceptions.py
```
- Exception types
```
odoo/tools/translate.py
```
- Translation system
```
odoo/addons/base/models/res_lang.py
```
- Language model

addons/web/static/src/core/l10n/translation.js

- JS translations

For setup instructions with different AI IDEs, see AGENTS.md

所有指南均基于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翻译

如需不同AI IDE的设置说明，请查看AGENTS.md