vvvv 补丁设计模式

数据流基础

• 从左到右、从上到下 的执行顺序
• 连接线（Links） 在垫片（pads，即输入/输出连接点）之间传递数据
• 铺展（Spreading） —— 将 Spread 连接到单值输入时，节点会自动迭代执行
• 每一帧，整个已连接的图都会被求值；未连接的子图则被跳过

无论是可视化补丁（visual patch）还是 C# 源码项目，均运行于实时环境之中——编辑操作会在程序运行期间立即生效。补丁修改会保留节点状态；而 C# 代码修改则会触发节点重启（即先调用 Dispose，再调用构造函数）。你可以在实时查看效果的同时，动态调整参数、添加连接或重构补丁结构。

何时使用补丁 vs 编写 C# 代码

通用原则：用补丁组织数据流，用代码实现算法逻辑。

区域（Regions）

区域是用于控制执行流程的可视化结构：

补丁中的过程节点（Process Nodes）

过程节点是为补丁引入状态的主要方式：

• 具备一个 Create 区域（仅执行一次）和一个 Update 区域（每帧执行一次）
• 内部状态在帧之间持续存在
• 可嵌套子补丁以实现复杂逻辑

通道（Channels）——响应式数据流

通道提供双向数据绑定能力：

• IChannel —— 可观察值容器
• .Value —— 读取或写入当前值
• 通道状态可在会话间持久化
• 可在节点之间连接通道，实现无需显式连线的响应式更新

事件处理

• Bang —— 持续一帧的 true 脉冲信号（用作触发器）
• Toggle —— 在 true 和 false 之间交替切换
• FrameDelay —— 将数值延迟一帧（用于打破循环依赖）
• 使用 Changed 节点检测某值在帧之间是否发生变化

补丁组织规范

命名约定

• 补丁名称与节点名称采用 PascalCase 风格
• 将相关操作归类至同一类别下
• 使用具有描述性的名称，体现操作语义（动词 + 名词）

结构设计

• 保持补丁职责单一——每个补丁只完成一项明确任务
• 将可复用逻辑提取为子补丁
• 使用 IOBox 节点暴露参数
• 添加 Pad 节点，在补丁边界创建输入/输出引脚

常见反模式（Anti-Patterns）

1. 循环依赖 —— 使用 FrameDelay 打破循环
2. 单个补丁内节点过多 —— 提取为子补丁
3. 轮询而非响应 —— 使用 Channels 实现响应式更新
4. 忽略 Nil 值 —— 始终优雅地处理 null 或空 Spread 输入

有关常见模式的参考，请查阅 patterns.md。