# Odoo开发插件集

`Odoo` `Claude Code` `插件` `开发工具` `MCP`

# ☁️ Odoo 插件市场 — Claude Code 的 Odoo 插件

> **7 个专业 Odoo 开发插件**，适用于 [Claude Code](https://claude.ai/code) — 覆盖 Odoo 开发全生命周期，包括版本迁移升级、测试、安全审计、国际化和服务器生命周期管理。

[![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin%20Marketplace-blue)](https://claude.ai/code)
[![Odoo Versions](https://img.shields.io/badge/Odoo-14%20→%2019-purple)](https://www.odoo.com)
[![License](https://img.shields.io/badge/License-LGPL--3-green)](./LICENSE)

---

## 快速安装

```bash
# 一次性安装全部 7 个 Odoo 插件
claude mcp add cloud-market [https://github.com/ahmed-lakosha/odoo-plugins.git]
```

也可以通过引用此仓库，从插件市场单独安装各个插件。

---

## 插件列表

### 🔄 odoo-upgrade
**全面的 Odoo 模块升级助手，支持版本间迁移（14-19）**

处理 XML 视图转换（`<tree>`→`<list>`、`attrs`→内联写法）、Python API 变更、
OWL 1.x→2.0 生命周期钩子、控制器类型迁移、SCSS 变量重构
及 RPC 服务替换。内置 150+ 模式识别和 75+ 自动修复方案。

命令：`/odoo-upgrade`

---

### 🎨 odoo-frontend
**集成 MCP 的 Odoo 网站主题开发工具，支持 Bootstrap 版本管理**

完整的 publicWidget 框架、暗色模式切换模式、RTL/LTR 切换器、Figma→Odoo
转换、`$o-website-values-palettes` 参考、主题镜像模型架构
以及适用于 Odoo 18+ 的 OWL 2.0 组件模式。

命令：`/odoo-frontend`、`/create-theme`、`/theme_web_rec`

---

### 📄 odoo-report
**专业的 Odoo QWeb 报表与邮件模板工具包，支持 Odoo 14-19**

创建、调试、迁移和验证 QWeb PDF 报表及邮件模板。包含
二维码/条码模式（ZATCA/沙特标准）、报表向导模板、阿拉伯语/英语双语
排版，以及 Odoo 19 公司品牌迁移指南。

命令：`/odoo-report`、`/create-qweb-report`、`/create-email-template`、`/debug-template`、
`/migrate-template`、`/validate-template`、`/fix-template`、`/preview-template`

---

### 🧪 odoo-test
**Odoo 测试工具包 — 测试生成、模拟数据、覆盖率分析（v14-19）**

通过 AST 解析从模型定义生成 `TransactionCase` 测试骨架，
以彩色输出和 JUnit XML 报告运行测试，按字段类型创建真实模拟数据，
并生成 HTML/JSON 格式的测试覆盖率缺口分析报告。

命令：`/odoo-test`、`/test-generate`、`/test-run`、`/test-coverage`、`/test-data`

---

### 🔒 odoo-security
**Odoo 安全审计 — 访问规则、路由鉴权、sudo() 分析与风险评分**

审计 `ir.model.access.csv` 完整性，验证 `@http.route auth=` 参数，
对每个 `sudo()` 调用进行上下文分类分析（危急/高/中/低），
并生成统一风险评分（0-100）及修复建议。支持 CI 集成，提供退出码。

命令：`/odoo-security`、`/security-audit`、`/check-access`、`/find-sudo`、`/check-routes`

---

### 🌐 odoo-i18n
**Odoo 国际化工具包 — 提取、验证、缺失翻译报告、阿拉伯语/RTL 支持（v14-19）**

通过 AST 解析从 Python/XML/JS/QWeb 中提取可翻译字符串到 `.pot`/`.po` 文件，
验证翻译完整性并支持阿拉伯语复数形式（nplurals=6），
按语言查找缺失翻译，以及合并/清理/转换 `.po` 文件。内置完整的阿拉伯语/RTL 排版模式。

命令：`/odoo-i18n`、`/i18n-extract`、`/i18n-missing`、`/i18n-validate`、`/i18n-export`

---

### ⚙️ odoo-service
**完整的 Odoo 服务器生命周期管理器 — 在任意环境和 IDE 中运行、部署、初始化**

自动检测本地 venv 或 Docker 来启动/停止 Odoo，初始化新环境
（venv + PostgreSQL + .conf 生成），管理数据库（pg_dump 备份/恢复、创建/删除、
管理员重置），编排 Docker（构建、启动、停止、查看日志、进入 shell、为
14-19 所有版本生成 Dockerfile），并自动生成 PyCharm 和 VSCode 的 IDE 配置。

命令：`/odoo-service`、`/odoo-start`、`/odoo-stop`、`/odoo-init`、`/odoo-db`、`/odoo-docker`、`/odoo-ide`

---

## Odoo 版本支持

| 插件 | 14 | 15 | 16 | 17 | 18 | 19 |
|------|----|----|----|----|----|----|
| odoo-upgrade | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| odoo-frontend | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| odoo-report | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| odoo-test | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| odoo-security | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| odoo-i18n | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| odoo-service | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |

---

## 仓库结构

```
cloud-market/
├── .claude-plugin/
│   └── marketplace.json          ← 插件注册表（v1.1.0，共 7 个插件）
├── odoo-upgrade-plugin/          ← 升级迁移工具包
├── odoo-frontend-plugin/         ← 主题与前端开发
├── odoo-report-plugin/           ← QWeb 报表与邮件模板
├── odoo-test-plugin/             ← 测试与覆盖率
├── odoo-security-plugin/         ← 安全审计
├── odoo-i18n-plugin/             ← 国际化
├── odoo-service-plugin/          ← 服务器生命周期与部署
├── validate_plugin.py            ← 插件验证工具
├── CLAUDE_CODE_PLUGIN_DEVELOPMENT_GUIDE.md
└── LICENSE
```

---

## 作者

**ahmed-lakosha** — [ahmed.lakosha94@gmail.com](mailto:ahmed.lakosha94@gmail.com)

---

## 许可证

[LGPL-3](./LICENSE)