odoo-17

Odoo 17 技能 - 总索引

Odoo 17 开发指南总索引。根据你的任务，从 references/ 中阅读相应指南。

快速参考

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

编码规范

编写代码前，如果已安装 odoo-workflow 技能，请先运行它（追踪真实源码，提供包含 file:line 的 Context Brief，并明确完成标准）；请将它与本资料包一同安装。

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

请遵循所打开指南中相关的规范部分。规范仅供参考：保持现有稳定插件的风格，并让差异集中在必要范围内。指导意见发生冲突时，优先遵循 Odoo 17 运行时和源码行为，其次是周边插件的风格，最后是规范。

• 模块布局和资源放置：开发指南和控制器指南。
• XML 格式和外部 ID：数据、视图、动作、报表和安全指南。
• Python 命名、导入、记录集、事务和翻译：模型、字段、装饰器、性能、事务和翻译指南。
• JavaScript 和 CSS/SCSS：开发指南。

文件结构

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

基础代码参考（Odoo 17）

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

• 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 17 官方文档
• Odoo 17 开发者参考
• Odoo 17 编码指南