1. ODOO 新 API 修饰符到底解决了什么问题如果你写过 ODOO 自定义模块大概率遇到过这种场景一个create方法里循环处理vals_list结果批量导入时性能掉得厉害或者api.depends里想根据当前语言、时区动态计算字段却发现缓存把结果锁死了。这些问题的根源往往不是业务逻辑写错而是修饰符没用对。ODOO 从 13.0 开始逐步用新 API 修饰符替换旧写法到 16.0/17.0 已经形成一套比较稳定的体系。核心变化集中在几个修饰符上api.model_create_multi让create一次接收多条记录api.depends_context让计算字段能感知上下文变化api.constrains在写入时做校验api.ondelete控制删除行为。它们共同的目标是让 ORM 在批量操作、缓存、上下文切换时行为可预测。这篇面向的是需要多工具协作的 ODOO 开发者——你可能同时用编辑器插件、命令行工具、AI 辅助编码来写模块。工具链一多配置就散Key 也散。所以我会把两件事放在一起讲一是新修饰符在自定义模块里的落地写法二是用 TaoToken 统一 Key 把工具链配置骨架搭起来。目标很直接修饰符用法和工具链配置一次讲清你照着复制就能跑。2. 前置准备TaoToken 统一 Key 与工具链骨架在写代码之前先把工具链的“入口”统一掉。多工具协作最烦的就是每个工具一套 Key、一套配置改一处漏一处。TaoToken 的做法是给你一个统一 Key然后通过不同 deep link 分流到模型对话、Coding Plan、控制台、API Keys、接入文档等具体页面。先拿 Key。打开控制台页面登录后进入 API Keys 管理新建一个 Key 并复制。这个 Key 后面会同时用在编辑器配置和命令行请求里。控制台入口https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite模型对话验证模型是否通https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewriteCoding Plan长期编码/Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewriteAPI 基础地址是https://taotoken.net/api注意这个地址不带 UTM 参数直接用于代码里的base_url。官网首页是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要看整体介绍时再点。注意Key 只存在本地配置文件里不要提交到 Git。下面给的骨架里用占位符sk-xxxx你替换成自己的。3. 可复制配置settings.json 与 config.toml 骨架工具链配置分两块编辑器侧用settings.json命令行/Agent 侧用config.toml。两者共用同一个 Key 和同一个base_url这样切换工具时不用重新找凭证。3.1 settings.json 骨架适用于 VS Code 及其衍生编辑器。把下面内容合并进你的用户设置或工作区设置{ taotoken.baseUrl: https://taotoken.net/api, taotoken.apiKey: sk-xxxx, taotoken.defaultModel: claude-sonnet-4-20250514, editor.formatOnSave: true, python.analysis.extraPaths: [ ./odoo/addons, ./custom_addons ], files.associations: { *.xml: xml, *.py: python } }这里taotoken.baseUrl指向 API 地址taotoken.apiKey填你刚复制的 Key。defaultModel按你实际可用的模型填不确定就先走模型对话页面确认。3.2 config.toml 骨架适用于命令行工具和 Agent 类客户端。放在用户目录下的.config/taotoken/config.toml[provider] name taotoken base_url https://taotoken.net/api api_key sk-xxxx timeout_seconds 60 [defaults] model claude-sonnet-4-20250514 max_tokens 4096 temperature 0.2 [odoo] addons_path ./custom_addons python_bin python3temperature给 0.2 是为了让代码生成更稳定ODOO 模块里字段名、方法名写错一个字母就报错低温度能减少这种抖动。addons_path指向你的自定义模块目录后面跑odoo-bin时可以直接引用。3.3 修饰符落地代码骨架配置搭好后写一个自定义模块来演示新修饰符。假设模块名custom_library核心模型library.bookfrom odoo import api, fields, models from odoo.exceptions import ValidationError class LibraryBook(models.Model): _name library.book _description Library Book name fields.Char(requiredTrue) isbn fields.Char() author_ids fields.Many2many(res.partner, stringAuthors) state fields.Selection( [(draft, Draft), (published, Published)], defaultdraft, ) display_name_ctx fields.Char( compute_compute_display_name_ctx, storeFalse, ) api.model_create_multi def create(self, vals_list): for vals in vals_list: if vals.get(isbn) and len(vals[isbn]) ! 13: raise ValidationError(ISBN 必须是 13 位) return super().create(vals_list) api.depends(name, state) api.depends_context(lang, tz) def _compute_display_name_ctx(self): for rec in self: rec.display_name_ctx f{rec.name} [{rec.state}] ({self.env.context.get(lang)}) api.constrains(isbn) def _check_isbn(self): for rec in self: if rec.isbn and not rec.isbn.isdigit(): raise ValidationError(ISBN 只能包含数字) api.ondelete(at_uninstallFalse) def _unlink_if_draft(self): for rec in self: if rec.state ! draft: raise ValidationError(只有草稿状态的书可以删除)几个关键点api.model_create_multi的vals_list是列表批量创建时只走一次方法比旧写法循环调用create快很多。api.depends_context让计算字段在语言或时区变化时重新计算storeFalse配合使用避免脏缓存。api.constrains在create、write时触发注意它不处理unlink。api.ondelete的at_uninstallFalse表示模块卸载时不执行该检查避免卸载报错。4. 验证请求跑一次修饰符行为验证配置和代码都就位后做一次行为验证。分两步先确认工具链能通再确认修饰符行为符合预期。4.1 确认 API 连通用 curl 发一个最小请求验证 Key 和 base_url 是否正确curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sk-xxxx \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: reply with ok}] }返回里能看到content字段就说明通了。如果返回 401检查 Key 是否复制完整返回 404检查base_url是否多了斜杠或路径。4.2 验证 model_create_multi 批量行为在 ODOO shell 里跑books env[library.book].create([ {name: Book A, isbn: 9781234567890}, {name: Book B, isbn: 9781234567891}, ]) print(len(books)) # 期望 2如果create里没写api.model_create_multi这里会报参数错误因为新版本 ORM 传的是列表。加上修饰符后vals_list正常接收两条返回记录集长度 2。4.3 验证 depends_context 触发book env[library.book].create({name: Ctx Book}) print(book.display_name_ctx) # 含当前 lang book.with_context(langzh_CN).display_name_ctx切换lang后重新读取值应随上下文变化。如果没加api.depends_context缓存会返回旧值这就是它存在的意义。4.4 验证 ondelete 拦截book env[library.book].create({name: Del Book, state: published}) book.unlink() # 期望抛 ValidationError抛错说明api.ondelete生效。把state改成draft再删应该成功。5. 本篇常见错排查报错一create() takes 2 positional arguments but 3 were given说明create方法没加api.model_create_multi但 ORM 按新协议传了vals_list。补上修饰符参数名用vals_list。报错二api.depends_context不生效字段值不更新检查是否同时写了storeTrue。depends_context通常配合storeFalse使用如果必须存储需要在上下文变化时手动触发重算成本较高建议改非存储。报错三api.constrains在 unlink 时没触发这是设计如此。constrains只覆盖create和write。删除校验要用api.ondelete。报错四api.ondelete在模块卸载时报错把at_uninstall设为False否则卸载时检查逻辑可能因为依赖数据已删而失败。报错五curl 返回invalid api keyKey 前后有空格或者用了Authorization: Bearer而该端点要x-api-key。按第 4.1 节的 header 写。报错六settings.json 里配置不生效确认编辑器重启过且工作区设置没有覆盖用户设置。taotoken.baseUrl不要写成https://taotoken.net/api/末尾斜杠会导致路径拼接错误。6. 把 Key 和修饰符一起收进工作流到这里修饰符写法和工具链配置已经串起来了。我的习惯是新模块先写api.model_create_multi的create再补api.constrains做字段校验计算字段一律先想清楚要不要depends_context。工具链这边settings.json和config.toml共用同一个 Key换工具时只改一处。如果你主要做长期编码或 Agent 类任务可以走 Coding Plan 页面看更细的配置https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。需要重新生成或管理 Key 时回 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。接入细节以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后留一个实用技巧在config.toml里把temperature压到 0.2 以下生成 ODOO 代码时字段名和方法签名会稳很多settings.json里把python.analysis.extraPaths指向你的custom_addons编辑器才能正确跳转到自定义模型。这两处配好修饰符写起来基本不会因为拼写问题返工。
ODOO 新API修饰符实战：用 TaoToken 统一 Key 打通配置骨架
1. ODOO 新 API 修饰符到底解决了什么问题如果你写过 ODOO 自定义模块大概率遇到过这种场景一个create方法里循环处理vals_list结果批量导入时性能掉得厉害或者api.depends里想根据当前语言、时区动态计算字段却发现缓存把结果锁死了。这些问题的根源往往不是业务逻辑写错而是修饰符没用对。ODOO 从 13.0 开始逐步用新 API 修饰符替换旧写法到 16.0/17.0 已经形成一套比较稳定的体系。核心变化集中在几个修饰符上api.model_create_multi让create一次接收多条记录api.depends_context让计算字段能感知上下文变化api.constrains在写入时做校验api.ondelete控制删除行为。它们共同的目标是让 ORM 在批量操作、缓存、上下文切换时行为可预测。这篇面向的是需要多工具协作的 ODOO 开发者——你可能同时用编辑器插件、命令行工具、AI 辅助编码来写模块。工具链一多配置就散Key 也散。所以我会把两件事放在一起讲一是新修饰符在自定义模块里的落地写法二是用 TaoToken 统一 Key 把工具链配置骨架搭起来。目标很直接修饰符用法和工具链配置一次讲清你照着复制就能跑。2. 前置准备TaoToken 统一 Key 与工具链骨架在写代码之前先把工具链的“入口”统一掉。多工具协作最烦的就是每个工具一套 Key、一套配置改一处漏一处。TaoToken 的做法是给你一个统一 Key然后通过不同 deep link 分流到模型对话、Coding Plan、控制台、API Keys、接入文档等具体页面。先拿 Key。打开控制台页面登录后进入 API Keys 管理新建一个 Key 并复制。这个 Key 后面会同时用在编辑器配置和命令行请求里。控制台入口https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite模型对话验证模型是否通https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewriteCoding Plan长期编码/Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewriteAPI 基础地址是https://taotoken.net/api注意这个地址不带 UTM 参数直接用于代码里的base_url。官网首页是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要看整体介绍时再点。注意Key 只存在本地配置文件里不要提交到 Git。下面给的骨架里用占位符sk-xxxx你替换成自己的。3. 可复制配置settings.json 与 config.toml 骨架工具链配置分两块编辑器侧用settings.json命令行/Agent 侧用config.toml。两者共用同一个 Key 和同一个base_url这样切换工具时不用重新找凭证。3.1 settings.json 骨架适用于 VS Code 及其衍生编辑器。把下面内容合并进你的用户设置或工作区设置{ taotoken.baseUrl: https://taotoken.net/api, taotoken.apiKey: sk-xxxx, taotoken.defaultModel: claude-sonnet-4-20250514, editor.formatOnSave: true, python.analysis.extraPaths: [ ./odoo/addons, ./custom_addons ], files.associations: { *.xml: xml, *.py: python } }这里taotoken.baseUrl指向 API 地址taotoken.apiKey填你刚复制的 Key。defaultModel按你实际可用的模型填不确定就先走模型对话页面确认。3.2 config.toml 骨架适用于命令行工具和 Agent 类客户端。放在用户目录下的.config/taotoken/config.toml[provider] name taotoken base_url https://taotoken.net/api api_key sk-xxxx timeout_seconds 60 [defaults] model claude-sonnet-4-20250514 max_tokens 4096 temperature 0.2 [odoo] addons_path ./custom_addons python_bin python3temperature给 0.2 是为了让代码生成更稳定ODOO 模块里字段名、方法名写错一个字母就报错低温度能减少这种抖动。addons_path指向你的自定义模块目录后面跑odoo-bin时可以直接引用。3.3 修饰符落地代码骨架配置搭好后写一个自定义模块来演示新修饰符。假设模块名custom_library核心模型library.bookfrom odoo import api, fields, models from odoo.exceptions import ValidationError class LibraryBook(models.Model): _name library.book _description Library Book name fields.Char(requiredTrue) isbn fields.Char() author_ids fields.Many2many(res.partner, stringAuthors) state fields.Selection( [(draft, Draft), (published, Published)], defaultdraft, ) display_name_ctx fields.Char( compute_compute_display_name_ctx, storeFalse, ) api.model_create_multi def create(self, vals_list): for vals in vals_list: if vals.get(isbn) and len(vals[isbn]) ! 13: raise ValidationError(ISBN 必须是 13 位) return super().create(vals_list) api.depends(name, state) api.depends_context(lang, tz) def _compute_display_name_ctx(self): for rec in self: rec.display_name_ctx f{rec.name} [{rec.state}] ({self.env.context.get(lang)}) api.constrains(isbn) def _check_isbn(self): for rec in self: if rec.isbn and not rec.isbn.isdigit(): raise ValidationError(ISBN 只能包含数字) api.ondelete(at_uninstallFalse) def _unlink_if_draft(self): for rec in self: if rec.state ! draft: raise ValidationError(只有草稿状态的书可以删除)几个关键点api.model_create_multi的vals_list是列表批量创建时只走一次方法比旧写法循环调用create快很多。api.depends_context让计算字段在语言或时区变化时重新计算storeFalse配合使用避免脏缓存。api.constrains在create、write时触发注意它不处理unlink。api.ondelete的at_uninstallFalse表示模块卸载时不执行该检查避免卸载报错。4. 验证请求跑一次修饰符行为验证配置和代码都就位后做一次行为验证。分两步先确认工具链能通再确认修饰符行为符合预期。4.1 确认 API 连通用 curl 发一个最小请求验证 Key 和 base_url 是否正确curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sk-xxxx \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: reply with ok}] }返回里能看到content字段就说明通了。如果返回 401检查 Key 是否复制完整返回 404检查base_url是否多了斜杠或路径。4.2 验证 model_create_multi 批量行为在 ODOO shell 里跑books env[library.book].create([ {name: Book A, isbn: 9781234567890}, {name: Book B, isbn: 9781234567891}, ]) print(len(books)) # 期望 2如果create里没写api.model_create_multi这里会报参数错误因为新版本 ORM 传的是列表。加上修饰符后vals_list正常接收两条返回记录集长度 2。4.3 验证 depends_context 触发book env[library.book].create({name: Ctx Book}) print(book.display_name_ctx) # 含当前 lang book.with_context(langzh_CN).display_name_ctx切换lang后重新读取值应随上下文变化。如果没加api.depends_context缓存会返回旧值这就是它存在的意义。4.4 验证 ondelete 拦截book env[library.book].create({name: Del Book, state: published}) book.unlink() # 期望抛 ValidationError抛错说明api.ondelete生效。把state改成draft再删应该成功。5. 本篇常见错排查报错一create() takes 2 positional arguments but 3 were given说明create方法没加api.model_create_multi但 ORM 按新协议传了vals_list。补上修饰符参数名用vals_list。报错二api.depends_context不生效字段值不更新检查是否同时写了storeTrue。depends_context通常配合storeFalse使用如果必须存储需要在上下文变化时手动触发重算成本较高建议改非存储。报错三api.constrains在 unlink 时没触发这是设计如此。constrains只覆盖create和write。删除校验要用api.ondelete。报错四api.ondelete在模块卸载时报错把at_uninstall设为False否则卸载时检查逻辑可能因为依赖数据已删而失败。报错五curl 返回invalid api keyKey 前后有空格或者用了Authorization: Bearer而该端点要x-api-key。按第 4.1 节的 header 写。报错六settings.json 里配置不生效确认编辑器重启过且工作区设置没有覆盖用户设置。taotoken.baseUrl不要写成https://taotoken.net/api/末尾斜杠会导致路径拼接错误。6. 把 Key 和修饰符一起收进工作流到这里修饰符写法和工具链配置已经串起来了。我的习惯是新模块先写api.model_create_multi的create再补api.constrains做字段校验计算字段一律先想清楚要不要depends_context。工具链这边settings.json和config.toml共用同一个 Key换工具时只改一处。如果你主要做长期编码或 Agent 类任务可以走 Coding Plan 页面看更细的配置https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。需要重新生成或管理 Key 时回 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。接入细节以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后留一个实用技巧在config.toml里把temperature压到 0.2 以下生成 ODOO 代码时字段名和方法签名会稳很多settings.json里把python.analysis.extraPaths指向你的custom_addons编辑器才能正确跳转到自定义模型。这两处配好修饰符写起来基本不会因为拼写问题返工。
