核心用法
Flux 是一个事件溯源（Event Sourcing）架构的共享世界状态引擎，专为多智能体系统设计的协调基础设施。核心工作流围绕事件发布-状态派生循环：智能体通过 CLI 工具或 API 将不可变事件（如传感器读数、状态变更）发布到指定流（Stream），Flux 自动合并属性并派生实体（Entity）的规范状态，供所有授权智能体查询。
关键操作路径：
- 事件发布：
flux.sh publish <stream> <source> <namespaced-entity-id> <properties-json> - 状态查询：
flux.sh get <entity-id>获取派生后的完整实体状态 - 批量处理：
flux.sh batch支持单次 10MB 的多事件原子提交 - 实时订阅：WebSocket 端点
/api/ws提供流式状态更新
命名空间（Namespace）是强制隔离边界，公共实例采用 namespace/entity-id 格式（如 dawn-coral/sensor-01），缺失前缀将在鉴权实例被拒绝。属性采用增量合并策略——仅传输变更字段，服务端自动与历史状态聚合。
显著优点
1. 强一致性协调：事件溯源保证状态变更可追溯，消除分布式系统中常见的竞态条件和数据冲突
2. 智能体原生设计：流（Stream）、源（Source）、实体的抽象天然契合多智能体协作场景，无需额外协调层
3. 运维友好：内建 NATS JetStream 持久化 + 快照机制，状态 survive 服务重启；CLI 工具屏蔽了时间戳生成、UUID 分配等样板代码
4. 弹性扩展：公共实例支持 namespace 级速率限制配置（默认未披露上限），本地实例可完全离线部署
潜在局限与风险
架构层面：
- 单事件 1MB / 批量 10MB 的大小限制对高频高吞吐场景（如视频流元数据）可能构成瓶颈
- 无内建查询语言（如 SQL-like 过滤），复杂条件检索需客户端拉取全量后过滤
- WebSocket 实时订阅未披露重连、背压（backpressure）策略，生产环境需自行实现容错
运维风险：
- 公共实例
flux-universe.com依赖第三方商业服务，SLA、数据驻留合规性未明确 - 命名空间 token 是全局鉴权凭证，泄漏即导致该 namespace 完全暴露；
FLUX_ADMIN_TOKEN权限过大，缺乏 RBAC 细粒度控制 - 批量删除操作（
POST /api/state/entities/delete）无软删除/回收站机制，误操作不可逆
适合人群
- 多智能体系统开发者：需协调 2-N 个 autonomous agents 共享环境观测的场景
- IoT/边缘计算团队：传感器聚合、设备影子（device shadow）状态的集中化管理
- 快速原型构建者：希望用 bash CLI 而非自建消息队列 + 数据库组合验证协调逻辑的工程师
常规风险
- 数据持久化承诺模糊：文档提及 "survives restarts via NATS JetStream + snapshots"，但未披露快照频率、RPO（恢复点目标）、备份策略
- 供应商锁定：公共实例的命名空间购买流程和 token 体系与 flux-universe.com 商业实体强绑定，迁移成本未评估
- 输入验证风险：
properties_json为自由格式对象，服务端 schema 校验规则未披露， malformed 事件可能导致派生状态异常