Liquid Orb Editor

一个使用 React、WebGPU/WGSL 和 Toolcraft UI 构建的实时液态玻璃球编辑器。

在线使用：https://lersent001.github.io/orb/

• 12 个可编辑的动态球体预设
• 根据浏览器语言自动显示中文或英文界面，并可随时切换
• 颜色、速度、形状、玻璃折射和外发光参数
• 球体预览与实际场景预览
• 参数通过 URL hash 保存，可直接分享当前效果
• 导出独立 Web 页面和 SwiftUI/Metal 代码
• Web 与 SwiftUI 导出使用同一份参数快照
• 场景模式和球体模式导出同一份球体动画代码

本项目处于持续迭代维护中。作者持续优化预设、运动模型、编辑器稳定性以及 WebGPU 与 SwiftUI/Metal 的输出一致性，并使用 OpenAI Codex 辅助代码实现、回归验证和发布。

需要 Node.js 22、pnpm 11，以及支持 WebGPU 的浏览器。

pnpm install
pnpm dev

生产构建：

pnpm build
pnpm preview

• src/presets.ts：预设和参数默认值
• src/orb-uniforms.ts：编辑器参数到 GPU uniform 的唯一映射
• src/orb-renderer.ts：WebGPU 渲染器
• src/code-export.ts：Web 与 SwiftUI 导出
• effect.wgsl：浏览器着色器
• effect.metal：SwiftUI 导出的 Metal 着色器

项目代码使用 MIT License。src/toolcraft 包含的 Toolcraft UI 代码保留其原始 MIT 版权声明，详见 TOOLCRAFT_LICENSE.md。