用途：这是一套针对多版本 Odoo 企业环境（14-19）的 Docker 基础设施与部署技能，用于生产部署、nginx 反向代理、CI/CD 流水线、性能调优、安全加固和容器排障。项目初始化、compose 生成、部署与构建通过 /odoo-docker 子命令执行；nginx 配置、调试和性能调优可用自然语言触发。
主要能力：生成带 nginx、SSL、PostgreSQL 调优和资源限制的 docker-compose；用 GitHub Actions 并行构建并推送多版本镜像（amd64 + arm64）；按压力测试结果给出 workers 与 PostgreSQL 参数建议（如 workers=(CPU*2)+1）；生成含 gzip、WebSocket 与资源缓存优化的 nginx 配置；自动识别 Odoo 版本、扫描模块并生成配置与 IDE 集成；容器排障与镜像构建、打标、推送。
使用方式：核心原则是源码挂载而非烘焙进镜像——Docker Hub 提供预构建基础镜像，源码与自定义模块以只读方式挂载，一份镜像可运行多个容器，无需按项目重建。集中式工作区包含 sources、projects、conf、compose、logs、scripts 等目录，常用命令有 docker compose build、docker compose up -d、docker compose logs -f odoo；集成脚本如 ./scripts/start.sh <project>、./scripts/shell.sh <project> 19。容器目录约定为源码 /opt/odoo/source（只读）、自建模块 /opt/odoo/custom-addons、配置 /etc/odoo/odoo.conf（只读）、日志 /var/log/odoo，端口 8069（HTTP）、8072（WebSocket）、5678（远程调试）。CI/CD 需配置 DOCKERHUB_USERNAME 与 DOCKERHUB_TOKEN；生产 HTTPS 需启用 nginx 模板中被注释的 SSL 配置并挂载 Let's Encrypt 证书。
限制与注意：需先配置 data_dir=/var/lib/odoo，否则 JS 资源返回 500；生产建议 proxy_mode=True、list_db=False 并设置强 admin_passwd；workers=0 仅适合开发；v14-16 使用 longpolling_port，v17 及以上使用 gevent_port，写错会导致 WebSocket 失效；重启后首次请求需编译资源（25-120 秒），生产模板含预热服务。首次使用需确认镜像前缀等配置，用户可在 ~/.claude/odoo-docker.local.md 覆盖默认值。