SuperAPI AI 工具集

vvvv-troubleshooting

通用与其它

查看项目

更新于 10-16 01:12

技能介绍

用途:该技能面向 vvvv gamma 开发中的排错场景,帮助定位并修复 C# 节点、SDSL 着色器以及运行时行为方面的常见错误,例如出现异常、崩溃、红节点、节点不显示、帧率下降等问题。

主要能力:

  1. C# / ProcessNode 问题:类名不应带 "Node" 后缀;Update 签名中 out 参数必须放在最前;节点未出现在 Node Browser 时按顺序检查 [assembly: ImportAsIs]、[ProcessNode]、net8.0 目标、DLL 位于 lib/net8.0/ 路径、项目可正常构建。
  2. 性能问题:Update 循环中的分配会导致 GC 尖峰与掉帧,常见来源包括 new、LINQ(Where/Select/ToList)、字符串拼接、装箱;修复方式是缓存、预分配缓冲区、移除热路径中的 LINQ。缺少变更检测会导致 CPU 占用高,应比较输入与缓存值,仅在变化时重算。下游节点收到 null/default 时,需始终输出缓存结果。
  3. SDSL 着色器:语法规则与常见错误参见 vvvv-shaders/syntax-rules.md,关键点包括 static const 作用域、缺少分号、缺少 override、枚举绑定格式。
  4. 运行时问题:内存泄漏可能源于未实现 IDisposable、ComPtr<T> 未释放、事件订阅未取消;线程安全需在构造函数中捕获 SynchronizationContext,再用 Post 将后台结果封送回主线程;循环依赖可插入 FrameDelay 节点打破。
  5. 构建问题:目标框架不匹配需确保 .csproj 指向 net8.0;程序集版本冲突需与 vvvv 自带版本对齐,可参考其 lib/ 目录。

使用方式:在遇到上述症状时调用该技能获取对应的诊断与修复指引;详细错误到解决方案的映射参见 error-catalog.md。

限制:资料未提供具体安装命令、收费方式或平台支持信息;部分细节(如 SDSL 完整语法规则)需查阅配套文档。