@meshflow/core

Appearance

路线图 & 演进规划 ​

这里记录了 MeshFlow 正在进行的改进以及未来的架构设想。

1. 副作用设计 (Side Effect) ​

  • [ ] 背景：自循环约束闭环：解决节点计算完成后，需要根据结果「原子化」修正自身其他属性的需求。核心在于解决“自身属性变更影响自身值”导致的非一致性问题。
  • [ ] 目标：引入 effect 钩子：支持通过 effectArgs 声明式获取当前节点不同属性桶（defaultValue, options, min, max 等）的计算结果。
  • [ ] 实现：同步执行帧合并：在 finalizeExecution 阶段同步执行副作用，通过 Patch 对象实现 Object.assign 原子化修改，消除 UI 纠偏带来的二次 Flow 感知延迟。

2. 多源头并行触发机制 (Multi-Source Acceleration) ​

  • [ ] 背景：打破层级阻塞：当前系统在初次变更或首屏加载时，主要依赖拓扑序按层 Promise.all 执行，整体效率受限于拓扑链路的总物理长度。
  • [ ] 设计目标 - 计算消减 (Deduplication)：深度优化阻力计算算法，确保多路径汇聚节点（如：总价依赖多个并发配置项）在多源头变动时，仅在最后一次依赖到位后执行一次有效计算。

3. 多源头赋值权重竞争策略 ​

  • [ ] 背景：并发冲突治理：多路径并发执行时，可能出现“系统推导值（自动联动）”与“用户手动意图”在同一时刻修改同一属性产生的覆盖冲突。
  • [ ] 意图优先原则：引入赋值权重机制，定义由触发源（User Input）直接产生的值拥有最高权重，能够有效覆盖由拓扑链路推导出的低权重“系统推荐值”。
  • [ ] 核心价值：确保在极高频、复杂的并发联动中，用户的主观操作不会被系统的“推荐逻辑”意外覆盖，从底层保障数据的一致性与用户受控感。

4. 状态管理与历史回溯 (State & History) ​

  • [ ] History Module 重构 (Time Travel 2.0)
    • 副作用感知 (Side-Effect Awareness)：历史栈不再仅记录用户 Action，而是升级为记录 “事务级 Patch”。确保由 Side Effect 产生的隐式数据变更（如合规性自动纠偏）能被完整捕获。