EcoflowEmbed contiene la capa operativa de los agentes: sus definiciones, prompts,
scripts de publicación y las variantes del widget embebible. No contiene el código
fuente de Flowise ni una base de datos local.
El fork, la compilación y el entorno local de Flowise viven en el repositorio hermano
Ecoflow. La separación permite actualizar el producto base sin mezclarlo
con configuraciones de clientes y evita publicar datos de ejecución.
projects/: definición canónica versionada de cada agente y su plantilla base.scripts/: automatización de creación, actualización, auditoría, sincronización y QA.ops/: automatización de infraestructura que debe revisarse antes de incorporarse a producción.packages/bubble/: fuente del widget propio<ecoflow-chat>(web component con Shadow DOM, Preact). Un solo código produce el IIFE para HTML plano y el ESM + wrapper para React;dist/se versiona y se sirve por CDN igual que los.min.js.ecoflow-*.min.jsyecoflow-template.js: artefactos públicos del widget (builds legacy de terceros; los sitios nuevos deben usarpackages/bubble).analytics/: panel y herramientas analíticas.
flowise-local/y.flowise-local-data*: una copia o runtime local de Flowise..env*, certificados, llaves y archivos de acceso.- Backups puntuales de agentes, snapshots del servidor, IDs generados por replay y reportes de ejecuciones.
Nada de esa información se debe agregar a Git. Las credenciales se cargan por variables de entorno o se configuran en el entorno de Flowise; una definición versionada nunca incluye una clave.
- Crear o editar el JSON canónico en
projects/mediante los scripts documentados. - Ejecutar validación o QA contra el entorno local/QA antes de tocar producción.
- Guardar resultados de una corrida en
artifacts/o una ruta ignorada. - Revisar
git diff --cachedpor secretos, datos de conversación y cambios no relacionados antes de publicar.
La guía de creación de agentes está en AGENTS_GUIDE.md; la clasificación de los scripts está en scripts/README.md.