@meshflow/core
v0.5.5
Published
A logic orchestration engine utilizing topological scheduling and watermark control to resolve asynchronous race conditions in complex dependency linkages.
Downloads
1,455
Maintainers
Readme
@meshflow/core
基于水位线调度(Watermark Scheduling)的轻量级拓扑逻辑引擎。
🏗️ 引擎定位
@meshflow/core 不预设任何业务场景。它是一个纯粹的逻辑计算骨架,负责管理节点(TaskNode)之间的拓扑依赖关系。
它只做三件事:
- 构建拓扑图:通过 Schema 定义节点及其层级。
- 编排任务流:管理节点间的联动规则(Rule)。
- 确定性执行:利用水位线(Watermark)机制,确保异步任务在复杂的依赖网中,依然能按正确的顺序提交。
🎯 核心能力
1. 任务依赖编排 (Topology)
引擎会自动解析节点间的依赖关系(A -> B, C -> D)。当上游节点变化时,下游节点会根据拓扑层级进行原子化更新,完美解决“循环计算”和“重复触发”问题。
2. 异步水位线调度 (Watermark)
在异步任务流中,由于网络波动,旧的任务可能比新的任务更晚返回。引擎通过内置的水位线令牌,确保只有最新的任务结果会被采纳,彻底杜绝异步竞态导致的数据覆盖风险。
3. 计算路径剪枝 (Pruning)
引擎会自动比对节点的值(Value Check)。如果某个节点的计算结果与之前一致,引擎将自动截断该路径的后续传播,实现极致的性能优化,支持 500+ 节点的实时复杂联动。
✨ 特性
- 🏗️ 纯粹 Headless:无 UI 绑定,适配 Vue/React/Solid 或 Node.js 环境。
- ⚡ 极致类型推导:提供完整的路径感知能力,支持超大规模 Schema 的深度类型检查。
- 🧩 开放式模块系统:通过
modules注入,你可以轻松给引擎套上“表单”、“动画”或“工作流”的壳子。 - 🚨 循环依赖检测:在规则注册阶段即进行环检测,防止逻辑死循环。
- 📦 极简体积:产物仅 ~19KB,零第三方依赖。
🚀 核心概念演示
- [数据表单场景] 👉 使用 @meshflow/form (基于 Core 封装的专业表单逻辑层)。
