SuperAPI AI 工具集

vvvv-fileformat

编程与开发

查看项目

更新于 10-16 01:26

技能介绍

用途:描述并安全编辑 vvvv gamma 的 .vl 可视化数据流程序(XML 格式),包括文档结构、ID 体系、节点、引脚、Pad、Link、可见帮助注释与编辑器几何信息。

主要能力:说明 Document/Patch/Node/Pin/Pad/Link/Canvas/ProcessDefinition/Slot 等元素层级;解释 22 字符 VL 编码 GUID(须用 GUIDEncoders.GuidTobase62 生成,不可仅凭形状臆造);区分操作调用、类型定义与区域(Region)的 NodeReference 写法;处理 Link 的 Ids 序列(源在前、汇在后,允许中间路由枢纽);强调依赖项必须直接放在 Document 下而非 Patch 内。附带可复用 Python 编辑器及对应 MCP/CLI 适配器,提供 vlpatch validate、apply --remove-incomplete-links --connect、new_vl_id()、PatchSession.add_slot_read/add_input_placement/add_matrix_repeat_builder 等操作。

主要用法:编辑已有文档时保留未知 XML、声明顺序、ID、节点宽度与既有几何;仅在实际需要时移动。XML 语法正确不等于节点表面、引脚顺序或布局正确。Process 应用必须含同名 Create/Update 兄弟 Patch 及指向两者的启用 ProcessDefinition Fragment,否则数据流不会执行。

适用场景:vvvv gamma 补丁文件的校验、生成、自动布局与语义化重命名等程序化编辑。

限制:不得凭 22 字符形状发明 ID 编解码;不得从邻近关系推断缺失端点;不可丢弃三 ID 链接;XML 解析成功不代表 Output 真正到达渲染组,须在 vvvv 中重开验证。公开引脚及顺序必须来自实时反射目录或生产签名,不可杜撰;字体大小、类型注解及着色器引脚类型须与真实消费端契约一致。收录维护、上游比较与更新流程另有规定,缺失事实暂未提供。