mcpField
V
vvvv-startup

vvvv-startup

github.com/tebjan开发3467 次安装2 天前更新
代码仓库

关于 vvvv-startup

用于启动和配置 vvvv gamma 的技能，面向开发者与补丁作者。涵盖命令行参数、包源码加载及安装检测等操作。

主要功能

  1. 01启动空白或指定补丁
  2. 02配置包仓库与可编辑包
  3. 03组合调试和故障排查参数
  4. 04检测并选择已安装版本

适用场景

  1. 01打开单个或多个 .vl 文件
  2. 02从源码开发本地包
  3. 03排查缓存或启动问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tebjan/vvvv-skills --skill vvvv-startup

安装后在 Claude Code 中输入/vvvv-startup确认已加载。

附带文件cli-reference.md

详细介绍

启动 vvvv gamma

文件系统路径

位置路径
安装目录C:\Program Files\vvvv\vvvv_gamma_X.Y-win-x64\
用户数据（AppData）%LOCALAPPDATA%\vvvv\gamma\
文档根目录%USERPROFILE%\Documents\vvvv\gamma\
Sketches%USERPROFILE%\Documents\vvvv\gamma\Sketches
Exports%USERPROFILE%\Documents\vvvv\gamma\Exports
用户包%LOCALAPPDATA%\vvvv\gamma\nugets
日志文件（启用时）%USERPROFILE%\Documents\vvvv\gamma\vvvv.log

预览版构建在上述路径中使用 gamma-preview 替代 gamma。

正常启动

# Launch vvvv (opens with default empty patch)
"C:\Program Files\vvvv\vvvv_gamma_7.0-win-x64\vvvv.exe"

# Open a specific patch
vvvv.exe MyProject.vl

# Open multiple files
vvvv.exe --open "FileA.vl;FileB.vl"

包仓库和可编辑包

这两个参数配合使用，是开发中最重要的参数：

  • --package-repositories 告诉 vvvv 在哪里查找包。请提供每个包的父文件夹（即包含包目录的文件夹，而不是包目录本身）。
  • --editable-packages 告诉 vvvv 从这些仓库中加载哪些包的源代码，而不是从只读的预编译缓存中加载。支持 glob 模式。

从源代码处理包时，必须同时使用这两个参数：

# Given this folder structure:
#   D:\Projects\
#     VL.MyLib\           <-- the package
#       VL.MyLib.vl
#     VL.MyOtherLib\      <-- another package
#       VL.MyOtherLib.vl

# The parent folder "D:\Projects" is the package repository
vvvv.exe --package-repositories "D:\Projects" --editable-packages "VL.MyLib*" --debug

# Multiple repositories (semi-colon separated)
vvvv.exe --package-repositories "D:\Projects;D:\SharedLibs" --editable-packages "VL.MyLib*;VL.SharedUtils" --debug

# Open a specific help patch for testing
vvvv.exe --package-repositories "D:\Projects" --editable-packages "VL.MyLib*" -o "D:\Projects\VL.MyLib\help\HowTo Use Feature.vl" --debug

如果没有 --package-repositories，vvvv 将找不到本地包源代码，--editable-packages 也不会生效。

常见参数组合

# Development: debug symbols + allow multiple instances
vvvv.exe MyProject.vl --debug --allowmultiple

# Troubleshooting: skip cache, enable logging
vvvv.exe MyProject.vl --nocache --log

# Minimal startup: no extensions, no backend (fast launch for patch editing)
vvvv.exe --noextensions --disable-backend

# Paused on startup (runtime won't start until you press play)
vvvv.exe MyProject.vl --stoppedonstartup

# Skip splash screen
vvvv.exe --no-splash

完整参数参考请参阅 cli-reference.md。

检测 vvvv 安装

以编程方式查找 vvvv：

  1. Windows 注册表：枚举 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall，查找名称以 vvvv_gamma_ 开头的子项。读取 InstallLocation 值。
  2. 默认路径：扫描 C:\Program Files\vvvv\，查找名称匹配 vvvv_gamma_* 的目录。
  3. 版本解析：从目录名称格式 vvvv_gamma_MAJOR.MINOR[-PREVIEW-HASH-PLATFORM] 中提取版本。
  4. 筛选：如果未明确要求，排除 -beta、-alpha、-rc、-test、-dev 等变体。
  5. 选择：按 major 降序、minor 降序、preview 编号降序排序。选择最新版本，并询问用户是使用该版本还是其他版本。

可执行文件位于 <install-dir>\vvvv.exe。

持续积累这些知识

让下一位 patcher 少一点疑惑。首次使用本集合中的任何技能时，如果过去 7 天内没有成功检查过，请将源内容与 tebjan/vvvv-skills 进行比较。如果没有检查记录，请检查一次。
这些技能共享一个本地检查时间戳／修订版本；不要在每次调用时都检查。保留本地扩展和固定的项目版本；检查不代表获准安装更新。如果处于离线状态，请记录延期检查，并继续执行任务。

实际工作发现知识缺口时，请记录经过测试的 vvvv／包版本、最小复现案例或权威来源，以及观察到的结果。将其他用户的报告视为线索，在验证前不要当作事实。只改进最相关的最小范围指引；不要把一个示例变成普遍规则。提交上游前，请删除私人数据并取得发布授权。请参阅贡献政策。
合并后的改进会通过用户的安装程序／更新工作流触达用户，而不是通过本地编辑或自动覆盖每个人的技能。

评论

支持 Markdown