odoo-forge-bundle 0.1.0

package/payload/skills/view-dev/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: view-dev
+description: 当需要查阅 Odoo 视图开发文档、判断应读取哪些 Odoo UI/视图参考文件，或基于参考文档回答 XML 视图、继承视图、动作、字段部件、搜索、看板/列表/表单布局及相关 ORM 或安全规则问题时使用。
+---
+
+# Odoo View Development
+
+## 定位
+
+这是一个面向 Odoo 视图开发的文档导览库。
+
+`SKILL.md` 只负责回答三件事：
+
+1. 这次问题应该先查哪几本文档。
+2. 每本文档主要覆盖什么主题。
+3. 多个主题交叉时，应该按什么顺序组合阅读。
+
+具体规范不写在这里，统一放在 `references/` 各本书里。那些书以原始文档为主，只做拆分、归类和轻量排版，不主动压缩成摘要。
+
+## 导览规则
+
+1. 先判定问题类型，再决定读哪几本书，不要上来就把所有文档一起加载。
+2. 先读“机制书”，再读“具体视图书”；先读“主归属文档”，再读补充文档。
+3. 用户要完整规范时，优先指向整本书；不要用 `SKILL.md` 代替原始 reference。
+4. 一个事实尽量只在一本文档里作为主归属出现；本页只做索引和分流，不重复重写规则。
+5. 如果问题跨多个主题，优先按本页“常见阅读路径”选 2 到 4 本书组合阅读。
+
+## 如何使用这个 Skill
+
+- 先在“书目总表”里判断主题归属。
+- 再在“常见阅读路径”里判断阅读顺序。
+- 最后只打开当前问题真正需要的 `references/*.md`。
+
+## 快速判断
+
+| 如果你要查…… | 先看这些 |
+| --- | --- |
+| 继承视图、`xpath`、`position`、主视图/扩展视图 | `view-records.md` |
+| 按钮跳转、弹窗、`context`、`domain`、`target` | `actions.md` |
+| `readonly`、`invisible`、`required`、`parent`、`uid` | `python-expressions.md` |
+| 字段 widget、状态条、标签、多对多 tags、图片 | `field-widgets.md` |
+| form/list/search/kanban/calendar/gantt 等具体视图 | 对应具体视图书 |
+| 权限、`groups`、记录规则、字段可见性 | `security.md` |
+| chatter、followers、activity、消息线程 | `mail-thread.md` |
+| 模型字段、记录集、上下文、ORM 语义 | `orm-api.md` |
+| QWeb 指令、模板语法、QWeb 视图 | `qweb-templates.md`、`qweb.md` |
+
+## 书目总表
+
+### 基础机制
+
+| 文件 | 主要讲什么 | 什么时候读 | 主要来源 |
+| --- | --- | --- | --- |
+| `references/view-records.md` | `ir.ui.view` 记录结构、`inherit_id`、`mode`、`priority`、`xpath`、`position`、视图解析 | 只要涉及继承视图、`xpath`、为什么 patch 不生效、主视图/扩展视图关系 | `03_用户界面/01_视图记录.md` |
+| `references/actions.md` | `ir.actions.act_window`、`target`、`views`、`domain`、`context`、绑定动作、服务端动作等 | 按钮跳转、打开表单/列表、弹窗、默认搜索条件、上下文注入 | `01_服务器框架/03_操作.md` |
+| `references/orm-api.md` | 模型、字段、记录集、环境、上下文、常见 ORM 方法、继承扩展 | 视图字段背后的模型语义、字段类型、`context`、`domain`、默认值、`group_by` 来源 | `01_服务器框架/01_ORM API/00_ORM API.md` |
+| `references/security.md` | 访问权限、记录规则、字段访问、安全陷阱 | `groups`、字段是否能看见、按钮是否该给、为什么前端可见但后端报权限错误 | `01_服务器框架/06_Odoo 中的安全性.md` |
+| `references/field-widgets.md` | 视图字段部件、view widget、常见 widget 的支持字段类型和选项 | 查 `statusbar`、`many2many_tags`、`image`、`priority`、`statinfo`、`mail_activity` 等部件 | `02_Web框架/10_JavaScript 参考.md` 中的 `## 视图`、`## 字段` |
+| `references/qweb-templates.md` | QWeb 模板语法与模板机制 | 看板模板、QWeb 视图、模板指令本身怎么写 | `02_Web框架/12_QWeb 模板.md` |
+| `references/mail-thread.md` | `mail.thread`、chatter、activity、小组件与消息功能接入 | form 里要加聊天区、活动区、关注者、消息线程时 | `01_服务器框架/10_混入类和实用类.md` 中的 `## 消息功能` |
+| `references/ui-icons.md` | UI 图标参考 | 按钮 `icon`、界面图标查找 | `03_用户界面/04_UI 图标.md` |
+
+### 视图架构总则
+
+| 文件 | 主要讲什么 | 什么时候读 | 主要来源 |
+| --- | --- | --- | --- |
+| `references/common-architecture.md` | 视图架构的总体规则、RNG 约束、上下文和权限会怎样影响视图行为 | 不确定某条规则属于哪种视图、要先建立总框架时 | `03_用户界面/02_视图架构.md` 的 `## 通用架构` |
+| `references/python-expressions.md` | `readonly`、`required`、`invisible`、`domain`、`context`、`parent`、`uid`、`today`、`now` | 动态显示、动态只读、关系字段过滤、表达式报错、`column_invisible` 之类问题 | `03_用户界面/02_视图架构.md` 的 `## Python 表达式` |
+
+### 具体视图
+
+| 文件 | 主要讲什么 | 什么时候读 | 主要来源 |
+| --- | --- | --- | --- |
+| `references/form.md` | form 视图完整架构，含 `field`、`label`、`button`、`group`、`sheet`、`notebook`、`header`、`footer` 等 | 新建 form、改 form 布局、改表单按钮区、查 `button_box` / `oe_title` / chatter 放法 | `03_用户界面/02_视图架构.md` 的 `## 表单` |
+| `references/settings.md` | settings 视图中的 `app`、`block`、`setting` | 写系统设置页、配置页 | `03_用户界面/02_视图架构.md` 的 `## 设置` |
+| `references/list.md` | list 视图完整架构，含根属性、列、按钮、`groupby`、`header`、`control/create` | 列表列定义、内联编辑、分组头、批量动作、x2many 行创建 | `03_用户界面/02_视图架构.md` 的 `## 列表` |
+| `references/search.md` | search 视图、`field`、`filter`、`separator`、`group`、`searchpanel`、默认搜索值 | 搜索栏、筛选器、默认搜索、搜索面板、group by | `03_用户界面/02_视图架构.md` 的 `## 搜索` |
+| `references/kanban.md` | kanban 根属性、`templates`、卡片字段、按钮链接、`header`、`progressbar` | 看板卡片结构、拖拽、快速创建、列头进度条 | `03_用户界面/02_视图架构.md` 的 `## 看板` |
+| `references/qweb.md` | qweb-as-view 基础规则 | qweb 视图、控制面板按钮提取、qweb 渲染上下文 | `03_用户界面/02_视图架构.md` 的 `## QWeb` |
+| `references/graph.md` | 图表视图 | 图表聚合、条形图、饼图、折线图 | `03_用户界面/02_视图架构.md` 的 `## 图表` |
+| `references/pivot.md` | 透视表视图 | 透视分析、度量与维度 | `03_用户界面/02_视图架构.md` 的 `## 透视表` |
+| `references/calendar.md` | 日历视图 | 事件类模型、日历展示 | `03_用户界面/02_视图架构.md` 的 `## 日历` |
+| `references/activity.md` | 活动视图 | 活动流、活动看板 | `03_用户界面/02_视图架构.md` 的 `## 活动` |
+| `references/cohort.md` | 队列 / cohort 视图 | 留存、转化、分期分析类场景 | `03_用户界面/02_视图架构.md` 的 `## 队列` |
+| `references/grid.md` | 网格视图 | 数值网格、可编辑单元格 | `03_用户界面/02_视图架构.md` 的 `## 网格` |
+| `references/gantt.md` | 甘特图视图 | 排程、时间轴规划 | `03_用户界面/02_视图架构.md` 的 `## 甘特图` |
+| `references/map.md` | 地图视图 | 地理位置与路线展示 | `03_用户界面/02_视图架构.md` 的 `## 映射` |
+
+## 常见阅读路径
+
+### 新建 Form
+
+按这个顺序读：
+
+1. `references/view-records.md`
+2. `references/common-architecture.md`
+3. `references/python-expressions.md`
+4. `references/form.md`
+5. `references/field-widgets.md`
+6. `references/actions.md`
+7. `references/orm-api.md`
+8. `references/security.md`
+
+如果涉及 chatter / activity，再补：
+
+9. `references/mail-thread.md`
+
+### 改 Inherited Form
+
+按这个顺序读：
+
+1. `references/view-records.md`
+2. `references/form.md`
+3. `references/python-expressions.md`
+4. `references/field-widgets.md`
+5. `references/actions.md`
+6. `references/security.md`
+
+### 查 Widget
+
+按这个顺序读：
+
+1. `references/field-widgets.md`
+2. 对应具体视图书，例如 `references/form.md`、`references/list.md`、`references/kanban.md`
+3. 如果是 QWeb 模板中的字段或结构，再补 `references/qweb-templates.md`
+4. 如果 widget 依赖消息功能，再补 `references/mail-thread.md`
+
+### 查按钮 / Action / Context
+
+按这个顺序读：
+
+1. 对应具体视图书
+2. `references/actions.md`
+3. `references/python-expressions.md`
+4. `references/security.md`
+5. 必要时补 `references/orm-api.md`
+
+### 查权限 / Groups / 安全
+
+按这个顺序读：
+
+1. `references/security.md`
+2. `references/view-records.md`
+3. `references/python-expressions.md`
+4. 对应具体视图书
+
+### 查 Search / 默认筛选 / Group By
+
+按这个顺序读：
+
+1. `references/search.md`
+2. `references/actions.md`
+3. `references/python-expressions.md`
+4. 必要时补 `references/orm-api.md`
+
+## 回答原则
+
+- 如果用户问“这个怎么写”，先指出应读哪几本书，再基于那些书回答。
+- 如果用户问“完整规范”，优先引导读取整本 reference，不把整本书压成几句摘要。
+- 如果用户问“为什么不生效”，优先联查 `view-records`、`actions`、`security`、`orm-api` 与对应具体视图书。
+- 如果用户只是要找文档，本页应先完成“分流”和“选书”，不要提前复述过多细节。
+
+## 目录说明
+
+- `references/`：完整书册
+- `assets/`：后续可放 XPath 模板、XML 片段、示意图
+- `scripts/`：后续可放视图定位、章节索引、文档校验脚本

package/payload/skills/view-dev/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "视图开发"
+  short_description: "导览 Odoo 视图开发文档，定位 XML 视图与继承实现依据"
+  icon_small: "./assets/icon-small.svg"
+  icon_large: "./assets/icon-large.svg"
+  brand_color: "#714B67"

package/payload/skills/view-dev/assets/README.md

@@ -0,0 +1,7 @@
+# Assets
+
+后续可放视图开发中复用率高的模板资源，例如：
+
+- XPath 片段模板
+- 常见 XML 结构片段
+- 输出格式模板

package/payload/skills/view-dev/assets/icon-large.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 919 495"><path d="M695,346a75,75,0,1,1,75-75A75,75,0,0,1,695,346Zm0-31a44,44,0,1,0-44-44A44,44,0,0,0,695,315ZM538,346a75,75,0,1,1,75-75A75,75,0,0,1,538,346Zm0-31a44,44,0,1,0-44-44A44,44,0,0,0,538,315Zm-82-45c0,41.9-33.6,76-75,76s-75-34-75-75.9S336.5,196,381,196c16.4,0,31.6,3.5,44,12.6V165.1c0-8.3,7.3-15.1,15.5-15.1s15.5,6.8,15.5,15.1Zm-75,45a44,44,0,1,0-44-44A44,44,0,0,0,381,315Z" style="fill:#8f8f8f"/><path d="M224,346a75,75,0,1,1,75-75A75,75,0,0,1,224,346Zm0-31a44,44,0,1,0-44-44A44,44,0,0,0,224,315Z" style="fill:#714b67"/></svg>

package/payload/skills/view-dev/assets/icon-small.svg

@@ -0,0 +1,5 @@
+<svg width="400" height="400" viewBox="0 0 400 400" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="400" height="400" fill="white"/>
+<circle cx="200.5" cy="199.5" r="176.5" fill="#5D3854"/>
+<circle cx="200.5" cy="199.5" r="107.5" fill="white"/>
+</svg>

package/payload/skills/view-dev/references/actions.md

@@ -0,0 +1,277 @@
+# 操作
+
+> 来源：`https://docs.odoo.sbggai.top/developer/reference/backend/actions.html`
+>
+> 本文件从 Odoo 动作参考文档整理而来，以下内容尽量保留原意，仅做分节与轻量排版。
+
+动作定义了系统对用户操作（登录、点击按钮、选择记录等）的响应行为，既可以以数据库记录形式存在，也可以在按钮方法里直接返回字典。
+
+## 目录
+
+- [动作共有属性](#动作共有属性)
+- [获取动作](#获取动作)
+- [绑定](#绑定)
+- [窗口动作 (`ir.actions.act_window`)](#窗口动作-iractionsact_window)
+- [视图生成](#视图生成)
+- [URL 动作 (`ir.actions.act_url`)](#url-动作-iractionsact_url)
+- [服务端动作 (`ir.actions.server`)](#服务端动作-iractionsserver)
+- [报告动作 (`ir.actions.report`)](#报告动作-iractionsreport)
+- [客户端动作 (`ir.actions.client`)](#客户端动作-iractionsclient)
+- [计划动作 (`ir.cron`)](#计划动作-ircron)
+
+---
+
+## 动作共有属性
+
+所有动作都包含两个必填字段：
+
+| 字段 | 说明 |
+| --- | --- |
+| `type` | 动作类别，决定可用字段以及如何解释它。 |
+| `name` | 动作的简短、面向用户的描述，客户端可能会显示。 |
+
+## 获取动作
+
+客户端可以通过以下几种形式获取动作：
+
+- `False`：如果当前有任何动作对话框正在打开，则关闭它。
+- 字符串：若匹配到 [客户端动作](#客户端动作-iractionsclient) 的 `tag`，则解释为客户端动作；否则当作数字使用。
+- 数字：从数据库读取相应的动作记录，可以是数据库 ID 或 external id。
+- 字典：作为客户端动作描述符处理并执行。
+
+## 绑定
+
+部分动作（窗口/报告等）会出现在某个模型的上下文菜单中，以下字段控制动作的挂载方式：
+
+| 字段 | 说明 | 备注 |
+| --- | --- | --- |
+| `binding_model_id` | 指定绑定的模型 | 服务端动作使用 `model_id`。 |
+| `binding_type` | 决定动作出现在哪张菜单下 | `action` 表示“操作”菜单，`report` 表示“打印”菜单。 |
+| `binding_view_types` | 以逗号分隔的视图类型 | 例如 `list,form`，默认同时在列表和表单中展示。 |
+
+> [!note]
+> `binding_model_id` 只针对绑定动作；服务端动作通过 `model_id` 控制挂载模型。
+
+## 窗口动作 (`ir.actions.act_window`)
+
+窗口动作让某个模型在特定视图中可视化（表单、列表、图表等），通常用于按钮、菜单或行为跳转。
+
+| 字段 | 说明 | 备注 |
+| --- | --- | --- |
+| `res_model` | 要展示的模型 | |
+| `views` | `(view_id, view_type)` 对列表 | 第二项是视图类型（`form`/`list`/`graph`...），第一项可选数据库 ID；默认会取模型对应类型的缺省视图。 |
+| `res_id` | 默认打开的记录 | 仅 `form` 视图时有效，其他视图会创建新记录。 |
+| `search_view_id` | `(id,name)` 对 | 指定用于此动作的搜索视图（否则默认）。 |
+| `target` | 打开方式 | 可选值：`current`（默认）、`fullscreen`、`new`（弹窗）、`main`（清除面包屑）。 |
+| `context` | 额外上下文 | 传递给视图的字典，可注入默认值、隐藏字段等。 |
+| `domain` | 额外筛选条件 | 隐式追加到视图的默认搜索中。 |
+| `limit` | 列表默认记录数 | Web 客户端默认 80。 |
+
+```json
+{
+    "type": "ir.actions.act_window",
+    "res_model": "res.partner",
+    "views": [[false, "list"], [false, "form"]],
+    "domain": [["customer", "=", true]],
+}
+```
+
+```json
+{
+    "type": "ir.actions.act_window",
+    "res_model": "product.product",
+    "views": [[false, "form"]],
+    "res_id": a_product_id,
+    "target": "new",
+}
+```
+
+### 数据库视图字段
+
+| 字段 | 说明 | 备注 |
+| --- | --- | --- |
+| `view_mode` | 逗号分隔的视图类型 | 不要带空格，所有类型会出现在生成的 `views` 列表中（至少有一个 `False`）。 |
+| `view_ids` | 多对多视图对象 | 定义 `views` 的初始内容。技术上不是标准多对多关系，因为它还带有顺序字段，并且可以只定义视图类型而不带视图 ID。 |
+| `view_id` | 指定的具体视图 | 如果该类型未被 `view_ids` 填充，仍会追加到 `views`。 |
+
+> [!note]
+> 若想为模型允许多个固定视图，建议使用 `ir.actions.act_window.view`：
+> ```xml
+> <record model="ir.actions.act_window.view" id="test_action_tree">
+>    <field name="sequence" eval="1"/>
+>    <field name="view_mode">list</field>
+>    <field name="view_id" ref="view_test_tree"/>
+>    <field name="act_window_id" ref="test_action"/>
+> </record>
+> ```
+
+### 视图生成
+
+服务器端 `views` 的生成逻辑：
+
+1. 先按 `view_ids` 中的 `(id,type)`（按 `sequence`）添加。
+2. 若 `view_id` 对应的类型尚未填充，追加该 `(id,type)`。
+3. 对 `view_mode` 中尚未覆盖的类型追加 `(False,type)`。
+
+## URL 动作 (`ir.actions.act_url`)
+
+用于打开指定 URL（内部网页、外部页面或下载）。
+
+| 字段 | 说明 | 备注 |
+| --- | --- | --- |
+| `url` | 目标地址 | |
+| `target` | 打开方式 | `new`（新标签页）、`self`（当前内容替换）或 `download`。 |
+
+```json
+{
+    "type": "ir.actions.act_url",
+    "url": "https://odoo.com",
+    "target": "self",
+}
+```
+
+## 服务端动作 (`ir.actions.server`)
+
+服务器动作可自动执行（例如规则触发），也可手动通过“更多”菜单运行。支持多种行为（执行 Python 代码、创建记录、写入记录、执行多个动作）。
+
+| 字段 | 说明 | 备注 |
+| --- | --- | --- |
+| `id` | 要运行的服务端动作 | 数据库 ID。 |
+| `context` | 运行时上下文 | 字典，可传递默认值、记录 ID 等。 |
+| `model_id` | 对应模型 | |
+| `state` | 动作的执行方式 | `code`/`object_create`/`object_write`/`multi`。 |
+
+### 状态字段
+
+| 字段 | 说明 | 适用状态 |
+| --- | --- | --- |
+| `code` | 执行的 Python 代码段 | `code` |
+| `crud_model_id` | 创建记录时的目标模型 | `object_create` |
+| `link_field_id` | 指向 `ir.model.fields` 的 m2o | 创建时把新记录写入指定字段，模型需匹配。 |
+| `fields_lines` | 覆盖字段的 `One2many` | 一个 `One2many` 配置表，内部包含 `col1` / `value` / `type`。 |
+| `child_ids` | 多动作下要执行的子动作 | `multi` |
+
+`fields_lines` 内部字段示例如下：
+
+| 字段 | 说明 |
+| --- | --- |
+| `col1` | 要设置的字段（创建时为 `crud_model_id`，更新时为 `model_id`）。 |
+| `value` | 要赋的值，依据 `type` 解释。 |
+| `type` | `value` 表示字面值，`equation` 表示 Python 表达式。 |
+
+如果某个子动作返回动作，`child_ids` 的最终结果会把最后一个动作交给客户端。
+
+#### Python 代码示例
+
+```xml
+<record model="ir.actions.server" id="print_instance">
+    <field name="name">Res Partner Server Action</field>
+    <field name="model_id" ref="model_res_partner"/>
+    <field name="state">code</field>
+    <field name="code">
+        raise Warning(record.name)
+    </field>
+</record>
+```
+
+如果满足特定条件，可以把 `action` 变量返回给客户端：
+
+```xml
+<record model="ir.actions.server" id="print_instance">
+    <field name="name">Res Partner Server Action</field>
+    <field name="model_id" ref="model_res_partner"/>
+    <field name="state">code</field>
+    <field name="code">
+        if record.some_condition():
+            action = {
+                "type": "ir.actions.act_window",
+                "view_mode": "form",
+                "res_model": record._name,
+                "res_id": record.id,
+            }
+    </field>
+</record>
+```
+
+### 求值上下文
+
+- `model`：通过 `model_id` 链接到的模型对象。
+- `record` / `records`：触发动作的记录集（可能为空）。
+- `env`：当前 Odoo 环境。
+- `datetime`/`dateutil`/`time`/`timezone`：对应 Python 模块。
+- `log:log(message,level='info')`：向 `ir.logging` 写调试信息。
+- `Warning`：用于抛出 `Warning` 异常。
+
+## 报告动作 (`ir.actions.report`)
+
+用于触发打印报告。如需在模型视图的“打印”菜单中显示，还必须设定绑定的 `binding_model_id`（`binding_type` 可不填，`report` 会隐式设置）。
+
+| 字段 | 说明 | 备注 |
+| --- | --- | --- |
+| `name` | 报告名称 | 如未指定 `print_report_name`，此值即文件名；否则仅作为描述。 |
+| `model` | 关联模型 | |
+| `report_type` | 渲染方式 | `qweb-pdf` 用于 PDF，`qweb-html` 用于 HTML。 |
+| `report_name` | 渲染模板名 | 使用 qweb 模板（external id）。 |
+| `print_report_name` | 文件名称表达式 | 可以通过 Python 表达式定义。 |
+| `groups_id` | 查看/打印权限 | `Many2many` 指向用户组。 |
+| `multi` | 是否在表单中隐藏 | `True` 时不会出现在表单视图。 |
+| `paperformat_id` | 纸张格式 | `Many2one` 指向纸张格式；未设则用公司默认。 |
+| `attachment_use` | 首次生成后复用 | `True` 时只生成一次并复用。 |
+| `attachment` | 报告名称表达式 | 运行时可通过 `object` 访问当前记录。 |
+
+## 客户端动作 (`ir.actions.client`)
+
+客户端动作完全在前端实现，服务器只负责下发指令。
+
+| 字段 | 说明 | 备注 |
+| --- | --- | --- |
+| `tag` | 动作标签 | 任意字符串，客户端需识别并处理。 |
+| `params` | 附加参数 | Python 字典，会与 `tag` 一起发送。 |
+| `target` | 打开位置 | `current`（默认）、`fullscreen`、`new`。 |
+
+```json
+{
+    "type": "ir.actions.client",
+    "tag": "pos.ui"
+}
+```
+
+> [!seealso]
+> - [教程：客户端动作](../../tutorials/web.html#howtos-web-client-actions)
+
+## 计划动作 (`ir.cron`)
+
+计划动作按预定义频率自动触发模型方法。
+
+| 字段 | 说明 | 备注 |
+| --- | --- | --- |
+| `name` | 计划名称 | 主要用于日志。 |
+| `interval_number` | 时间间隔数 | 与 `interval_type` 组合定义频率。 |
+| `interval_type` | 单位 | `minutes`/`hours`/`days`/`weeks`/`months`。 |
+| `model_id` | 触发模型 | |
+| `code` | 要执行的表达式 | 通常写 `model.<method>()`。 |
+| `nextcall` | 下次执行时间 | 日期/时间格式。 |
+| `priority` | 优先级 | 同时执行时的排序。 |
+
+### 高级用法：批处理
+
+为避免长时间占用工作线程，建议在计划动作中分批处理：
+
+```python
+self.env['ir.cron']._notify_progress(done=XX:int, remaining=XX:int)
+```
+
+该 API 让调度器知道进度，默认每次处理 10 个批次，剩余任务会尽快再调度。
+
+### 高级用法：触发器
+
+需要时可直接从业务代码触发计划动作：
+
+```python
+action_record._trigger(at=XX:date)
+```
+
+### 安全性
+
+- 连续三次错误或超时会跳过当前执行。
+- 连续五次失败且至少七天内，动作会被停用并通知管理员。

package/payload/skills/view-dev/references/activity.md

@@ -0,0 +1,65 @@
+# 活动
+
+> 来源：`docs/obsidian/07 知识库/odoo文档/03_开发者/03_参考/03_用户界面/02_视图架构.md`
+> 原文章节：`## 活动`
+> 本文件从原始文档中拆分而来，以下内容尽量保留原文，仅做拆分与轻量排版。
+
+活动视图用于显示与记录关联的活动。数据以图表形式显示：记录构成行，活动类型构成列。每行的第一个单元格显示一张代表对应记录的卡片（可通过 `templates` 定制，渲染方式与看板卡片类似）。点击其他单元格时，会显示该记录中对应活动类型的详细信息。
+
+## 目录
+
+- [可用条件](#可用条件)
+- [根元素与根属性](#根元素与根属性)
+- [子元素](#子元素)
+- [`templates` 与 QWeb 上下文](#templates-与-qweb-上下文)
+
+---
+
+## 可用条件
+
+> [!warning]
+> 活动视图仅在安装了`mail`模块且模型继承自`mail.activity.mixin`时可用。
+> 
+
+## 根元素与根属性
+
+活动视图的根元素是 `activity`：
+
+```xml
+<activity string="Activities">
+    ...
+</activity>
+```
+
+根属性如下：
+
+| 属性 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `string` | 视图标题，应描述该活动视图。 | `string` | `''` |
+
+## 子元素
+
+活动视图支持的主要子元素如下：
+
+### `field`
+
+用于声明活动视图逻辑所需字段。如果字段仅用于显示，不一定需要提前声明。
+
+`field` 的可用属性：
+
+| 属性 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `name` | 要获取的字段名称。 | `string` | 必填 |
+
+### `templates`
+
+用于定义 QWeb 模板。为保持清晰，卡片结构可拆分为多个模板，但活动视图必须至少定义一个根模板 `activity-box`，该模板会为每条记录渲染一次。
+
+## `templates` 与 QWeb 上下文
+
+活动视图主要使用 JavaScript QWeb。模板上下文中提供以下变量：
+
+| 变量 | 说明 |
+| --- | --- |
+| `widget` | 当前 `ActivityRecord()` 对象，可用于读取元信息；相关方法通常也能直接在模板上下文中调用。 |
+| `record` | 包含所有请求字段的对象；每个字段都提供 `value` 与 `raw_value`。 |

package/payload/skills/view-dev/references/calendar.md

@@ -0,0 +1,92 @@
+# 日历
+
+> 来源：`docs/obsidian/07 知识库/odoo文档/03_开发者/03_参考/03_用户界面/02_视图架构.md`
+> 原文章节：`## 日历`
+>
+> 本文件从原始文档中拆分而来，以下内容尽量保留原文，仅做拆分与轻量排版。
+
+日历视图将记录显示为每日、每周、每月或每年日历中的事件。
+
+## 目录
+
+- [基础说明](#基础说明)
+- [根元素与上下文](#根元素与上下文)
+- [根属性](#根属性)
+- [`field` 子元素](#field-子元素)
+- [`field` 附加属性](#field-附加属性)
+- [模型通用](#模型通用)
+
+---
+
+## 基础说明
+
+> [!note]
+> 默认情况下，日历视图会围绕当前日期（今天）居中。可以在 action 的 `context` 中传入 `initial_date`，将初始焦点定位到该日期所在时段（结合 `mode` 生效）。
+
+## 根元素与上下文
+
+日历视图的根元素是 `calendar`：
+
+```xml
+<calendar>
+    ...
+</calendar>
+```
+
+## 根属性
+
+下表按原文章节顺序整理日历视图可用的根属性。
+
+| 属性 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `string` | 视图标题，仅在 action 无名称且 `target="new"`（如对话框）时显示。 | `string` | `''` |
+| `create` | 在视图中禁用/启用记录创建。设为 `false` 可禁用创建。 | `bool` | `True` |
+| `edit` | 在视图中禁用/启用记录编辑。 | `bool` | `True` |
+| `delete` | 通过“操作”下拉菜单禁用/启用删除。设为 `false` 可禁用删除。 | `bool` | `True` |
+| `date_start` | 保存事件开始日期的字段名。 | `string` | `''` |
+| `date_stop` | 保存事件结束日期的字段名。配置后事件可在日历中拖拽移动。 | `string` | `''` |
+| `date_delay` | `date_stop` 的替代项，表示事件持续时间（单位：天）。 | `string` | `''` |
+| `color` | 用于颜色分段的字段名。相同分段记录会使用同一高亮颜色，侧栏展示 `display_name` 或头像。 | `string` | `''` |
+| `form_view_id` | 创建或编辑事件时打开的表单视图。未设置时回退到当前 action 的表单视图（若有）。 | `string` / `int` | `''` |
+| `event_open_popup` | 设为 `true` 时在 `FormViewDialog` 中打开事件，否则通过 `do_action` 在新表单页打开。 | `bool` | `False` |
+| `quick_create` | 启用点击快速创建：先仅输入名称创建，失败则回退完整表单对话框。 | `bool` | `False` |
+| `quick_create_view_id` | 启用 `quick_create` 时，指定创建事件弹出的视图。 | `string` / `int` | `''` |
+| `create_name_field` | 快速创建时用于保存记录文本表示（名称）的字段。 | `string` | `''` |
+| `all_day` | 布尔字段名，标记事件是否为全天事件。 | `string` | `''` |
+| `mode` | 初始显示模式。可选：`day`、`week`、`month`、`year`。 | `string` | `''` |
+| `scales` | 可用刻度列表（逗号分隔）。默认全部可用，取值同 `mode`。 | `string` | `''` |
+
+## `field` 子元素
+
+`calendar` 内可声明 `field` 子元素，用于：
+
+- 声明要聚合或参与日历卡片逻辑的字段；
+- 或在日历卡片中直接展示字段值。
+
+```xml
+<calendar>
+    <field name="name"/>
+    <field name="user_id"/>
+</calendar>
+```
+
+## `field` 附加属性
+
+`field` 在日历视图中可使用以下附加属性（按原文整理）：
+
+| 属性 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `invisible` | 设为 `True` 时隐藏卡片中的该字段值。 | `bool` / 表达式 | `False` |
+| `avatar_field` | 仅适用于 `x2many` 字段，在卡片中显示头像而非 `display_name`。 | `string` | `''` |
+| `write_model` | 定义过滤结果写入的目标模型。 | `string` | `''` |
+| `write_field` | 定义过滤结果写入的目标字段。 | `string` | `''` |
+| `filter_field` | 可选，指定用于保存过滤器状态的字段。 | `string` | `''` |
+| `filters` | 设为 `True` 时将该字段加入侧栏过滤器。 | `bool` | `False` |
+| `color` | 与 `filters` 配合，为侧栏过滤复选框指定着色字段。 | `string` | `''` |
+
+> [!note]
+> 原文说明：可添加一个过滤器并将结果保存到定义模型中；`filter_field` 为可选项，用于保存过滤状态。
+
+## 模型通用
+
+用于默认日历视图的字段。