voyager-so/vork

项目介绍

vork 是一个无头的 3D 与 VFX 引擎，没有编辑器，预期由智能体或脚本驱动：写一个场景、渲染、看结果、再改场景。场景用 JSON 描述；材质、相机、光传播、模拟和合成可以通过 Slang 程序扩展，运行在 GPU 上。渲染在 Linux/Windows 走 Vulkan、在 Apple Silicon 走 Metal，默认结合光栅可见性与硬件光线追踪光照，也提供路径追踪器。

随仓库附带的示例展示了它的目标场景：百万只 Slang 程序驱动的椋鸟越过潟湖、VFX 合成到实拍素材、类施瓦西光线的黑洞透镜、扫描资产的产品式渲染、从 Blender 导入的 splash 场景，以及 GPU 液体模拟 示例。

快速开始

从 releases 页面 下载对应平台的发行包，确认 vork --version 可用，再运行 vork help——入门帮助约 2,500 tokens，包含一个完整的首个场景 帮助说明。

把场景保存为 shot.json，可以直接用仓库里的 first-scene.json：

{"version":2,"nodes":[
  {"type":"mesh","geometry":{"std":"sphere","radius":1},
   "materials":[{"inputs":{"base_color":[0.12,0.35,0.65],"specular_roughness":0.3}}]},
  {"type":"mesh","translation":[0,-1,0],"geometry":{"std":"grid","size":[10,10]},
   "materials":[{"inputs":{"base_color":[0.35,0.35,0.35]}}]},
  {"type":"light","shape":"rectangle","translation":[-3,5,4],"target":[0,0,0],
   "energy":700,"size":4,"color":[1,0.92,0.8]},
  {"type":"camera","translation":[3,2,5],"target":[0,0,0]}
],"render":{"resolution":[640,480]}}

然后分别渲染预览和最终静帧：

vork render shot.json --profile std/previs --out preview.png
vork render shot.json --profile std/final --out final.png

首次渲染包含新程序的场景可能编译数分钟且没有输出，这不是卡死。渲染视频时传入帧范围，例如 --frame-start 0 --frame-end 47 --out clip.mp4 渲染示例。

渲染档位与采样

std/previs 用于迭代；std/draft 使用 4 采样，std/final 默认 8 采样并启用内置 OIDN 降噪。--set samples=N 覆盖档位预算（1–4096），--set denoise=false 关闭降噪。没有快速 GPU 降噪器时，draft 和 final 会退回 16/32 采样且不降噪。场景内容与画质档位分离，同一镜头可以从预览切到最终而不改场景 档位说明。

平台与硬件要求

• Linux： x64、glibc 2.35+（Ubuntu 22.04+）、近期 NVIDIA GPU 及支持硬件光追的 Vulkan 驱动；MP4 封装需要 FFmpeg。
• Windows： x64 Windows 10/11、同样的 NVIDIA GPU 与 Vulkan 要求，FFmpeg 需在 PATH 中。
• Mac： 仅 Apple Silicon，不支持 Intel Mac；H.264 使用 VideoToolbox，FFmpeg 可选。

安装脚本会校验发行包校验和、装到用户目录并运行 vork setup，后者可能编译约 3 分钟且没有输出。升级 vork 或更换 GPU 驱动后需重新运行 vork setup 安装说明。安装目录需要整体保留——Slang、OIDN、库、示例和 SDK 都是二进制的运行时配套文件。

SDK 与场景编写

场景可以直接写 JSON，也可以用随包附带的 Python 和 TypeScript SDK。SDK 从 vork 安装目录安装，不在 PyPI 或 npm 上：python3 -m pip install "$HOME/.local/lib/vork/python" 和 npm install "$HOME/.local/lib/vork/sdk"（Node 22.18+）。npm 上名为 vork 的包与项目无关 SDK 安装。

研究预览限制

当前是研究预览版。雾和参与介质会被忽略并给出警告；大场景与密集透明可能失败，Mac 上也可能出现。4/8 采样下细密立面与毛发会丢细节，景深边缘可能出现颗粒，稀疏高光会改变亮度和颜色，增加采样则耗时上升。液体模拟是均匀网格实验，没有双向刚体耦合，不能替代成熟的模拟软件。VFX 示例的单视图相机解算和浮雕是估算值；黑洞镜头是数值近似，不是精确的相对论求解。确定镜头前先读 vork help limits 限制。

基准与声明

README 给出了与 Blender EEVEE、Cycles 的计时对比，但明确说明这不是等画质的加速：采样数、降噪、启动与传输边界不同，部分对比来自更早的构建或是外推值而非实测。路径追踪器在列出的三个场景里比 Cycles 慢。方法与记录见 benchmarks/RESULTS.md。

HotRepo 点评

vork 在 2026-11-06 进入 HotRepo 的 Rust 新项目榜，记到 119 Star 和 6 Fork，这些增量都落在仓库公开窗口的第一天；目前没有 GitHub 全语言日榜名次，也没有 HN 讨论数据。只有一天历史，快照只能说明它很快吸引了关注，不能说明热度是否持续。对潜在用户更有用的信号是公开材料的完整度：多个带署名的成品示例、明确的失败记录（百万只鸟场景显存不足、Mac 可靠性未在 Linux 跑中复验）以及基准口径的说明，让读者可以按限制而不是按星数判断是否适合自己。