核心用法
CitrineOS Assistant 是面向电动车充电基础设施的开源 OCPP（Open Charge Point Protocol）服务器管理工具，通过自然语言交互帮助用户完成 CitrineOS 的安装、配置与日常运维。
安装路径：
- Docker 路径（推荐）：检测环境后，克隆
citrineos-core仓库，执行npm run install-all && npm run build，通过docker-compose up -d启动包含 CitrineOS、RabbitMQ、PostgreSQL、MinIO、Hasura 的完整服务栈 - 非 Docker 路径：根据操作系统（Windows/macOS/Linux）提供 Docker Desktop 安装指引，完成后跳转 Docker 路径
- 云端部署：支持 AWS EC2、DigitalOcean、Linode、Vultr 等 VPS，以及 Railway/Render/Fly.io 等 PaaS 平台，需配置防火墙规则（8080-8082、5432、5672 端口）
API 操作能力：
- 健康检查：
/health - 文档浏览：
/docs（Swagger UI） - 充电站管理：REST CRUD 操作 ChargingStation、Transaction 等实体
- OCPP 消息：支持 RequestStartTransaction、Reset、GetVariables 等标准 OCPP 2.0.1 指令
显著优点
1. 开源生态完整：CitrineOS 是 LF Energy 基金会孵化的开源项目，代码透明可查，无供应商锁定
2. 全栈容器化：Docker Compose 一键部署，内置消息队列（RabbitMQ）、数据库（PostgreSQL）、对象存储（MinIO）、GraphQL 控制台（Hasura），降低运维复杂度
3. OCPP 2.0.1 原生支持：紧跟最新充电协议标准，兼容主流充电桩厂商设备
4. 多云就绪：提供 AWS、GCP、Azure 及主流 VPS 的部署指引，适配企业级生产环境
潜在缺点与局限性
1. 技术门槛：需具备 Docker、Node.js、git 基础，纯业务用户学习曲线陡峭
2. 硬件依赖：本地开发需 4GB+ 内存运行完整容器栈，低配设备可能卡顿
3. 网络暴露风险：WebSocket 端口（8081/8082）和 API 端口（8080）直接面向充电桩，公网部署若未配置 TLS/防火墙易遭攻击
4. 生态成熟度：相比商业方案（如 ChargePoint、GreenFlux），社区插件和可视化报表功能较弱
适合人群
- 充电站运营商：需自建 OCPP 后端管理中小型充电网络
- EV 硬件厂商：测试充电桩与 OCPP 2.0.1 服务器的协议兼容性
- 能源行业开发者：基于开源代码二次开发定制充电管理平台
- 技术评估人员：验证开源方案替代商业 OCPP 服务器的可行性
常规风险
- 端口冲突：8080 端口被占用时需手动调整 Docker 端口映射
- 权限问题：Linux 用户需加入 docker 用户组，否则执行失败
- 数据持久化：生产环境需配置 PostgreSQL 和 MinIO 的持久化卷，避免容器重启数据丢失
- 凭证安全：环境变量中可能包含数据库密码、AMQP 凭证，需避免提交至版本控制