核心用法
CitrineOS Assistant 是一款面向电动汽⻋充电基础设施的运维辅助技能，帮助用户通过自然语言完成 CitrineOS（开源 OCPP 2.0.1 服务端）的安装、配置与管理。该技能支持三种部署路径：本地 Docker 环境（Path A）、无 Docker 环境先安装后部署（Path B），以及 AWS/GCP/Azure/VPS 等云端托管方案（Path C）。
操作流程遵循「环境诊断 → 路径选择 → 分步执行」模式：首先检测 docker/node/git 版本，随后根据环境状态引导用户完成仓库克隆、依赖安装、容器编排启动及服务验证。对于云端部署，技能会提示防火墙规则（8080/8081/8082/5432/5672）、安全组及环境变量配置。
核心功能覆盖：Docker Compose 服务生命周期管理（citrine/rabbitmq/postgresql/minio/hasura）、REST/HTTP API 调用（健康检查、充电站列表、交易启停）、常见故障排查（端口冲突、权限不足、数据库连接失败）。
显著优点
- 流程标准化：将官方仓库指南转化为交互式分步指引，降低 OCPP 服务端部署门槛
- 环境自适应：自动识别本地/云端/Docker 状态，动态选择最优安装路径
- 安全意识强：明确禁止远程脚本管道执行，优先使用 apt/brew/winget 等包管理器
- 运维覆盖全：不仅限于安装，延伸至日常操作（日志查看、服务启停、API 调试）
潜在缺点与局限性
- 依赖官方镜像：未提供离线包或镜像加速方案，网络受限环境可能拉取失败
- 云厂商差异大：Path C 仅提供通用指引，AWS/GCP/Azure 具体配置仍需用户自行补充
- 权限操作风险：涉及 docker 组修改、防火墙开放等系统级变更，误操作可能影响主机安全
- 无高可用方案：当前仅覆盖单节点部署，未涉及集群、备份或负载均衡架构
适合人群
- EV 充电运营商技术团队，需快速验证或部署 OCPP 服务端
- 物联网/能源领域开发者，希望基于 CitrineOS 进行二次开发
- 具备基础 Linux/Docker 知识，但不熟悉 OCPP 协议细节的工程师
常规风险
- 网络暴露风险：默认端口 8080-8082 若直接暴露公网，可能成为攻击面，需配合反向代理（nginx/traefik）及 TLS
- 密钥管理：MinIO/PostgreSQL/RabbitMQ 默认凭证需生产环境强制修改，技能未内置凭证轮换提醒
- 数据持久化：用户可能误删 Docker volume 导致交易数据丢失，需明确备份策略
- 协议合规：OCPP 2.0.1 实现需通过 OCPI/Plug&Play 认证，技能不保证商业合规性