一、它是什么:把 3D 网页特效打包成「可抄作业」的目录

Three.js 的沉浸式网页——液态金属、玻璃反光、烟雾粒子、天气渲染——效果很顶,但自己从零调 shader、调材质、调光照,苦工量巨大。ThreeUI(MengTo/threeui,MIT,2026-08-21 刚开源,官网 threeui.com)的思路是:把 160+ 个基于 Three.js 的现成 3D 网页组件/页面打包成一个目录,按按钮、落地页、天气等分类,每个都有可交互的实时渲染(live renderer),你能直接在页面上拨弄参数看效果。

它最直接的用法就是「抄成熟设计」:看中哪个特效,看它的源码 tab 和配套实现,把代码 / 提示词丢给你的 AI 编程 Agent(Codex、Claude 都行),让它基于这段参考产出你自己的沉浸式 3D 页面——相当于把别人的成熟设计翻译成 Agent 能执行的活儿,省掉自己盲调样式的苦工。

二、目录里有什么:164 个浏览结果 + 实时渲染

GitHub 开源的是 Community 版(免登录),官方「Included」清单实查(截至 2026-09-12):

  • 50 个父组件、111 条路由
  • 141 条免费变体记录 + 23 个单例组件 = 164 个浏览结果(就是宣传口径的「160+」)
  • 完整 Community 实现源码 + 所需素材,带搜索、主题、响应式、变体选择器
  • Pro / Beta 组件不在开源范围内——目录页会看到「Get Pro」入口指向官网付费档

每个组件页不只是截图:它有活的 WebGL 渲染器和控件,你调滑块、切变体的过程,就是「这个效果怎么来的」的最好教程。

三、两条使用路径:当提示词库,或直接装包用

路径一:给 Agent 当参考(视频里讲的核心玩法)

1. 打开 threeui.com,按分类(按钮 / 落地页 / 天气 / 粒子…)挑中意效果
2. 打开该组件的 source tab,复制它的实现思路 + 关键代码
3. 连同你的需求丢给 Codex / Claude Code
4. Agent 产出带液态金属、玻璃反光、烟雾粒子等效果的 3D 页面

路径二:直接当 React 组件库装(它同时是 npm 包):

npm install @designcodeio/threeui
// 全量导入
import { AtTheHorizon } from "@designcodeio/threeui";
import "@designcodeio/threeui/style.css";
// 或最小导入图
import { AtTheHorizon } from "@designcodeio/threeui/components/AtTheHorizon";

注意:渲染完整 HTML 文档的组件需要把运行时文件复制到你的 public 目录(或覆盖 sourceUrl / assetBaseUrl prop),README 写得很清楚。

四、开源边界,别误会

  • 开源的是 Community 版:全部免费变体和控件都保留,但 Pro / Beta 组件及其实现源码刻意不发布(Pro 源码要登录付费账号)
  • 项目走赞助模式(README 里挂着 $500/月起 的赞助位),这是它维持社区版免费的方式,不是你要付的钱
  • MIT 协议,6,392 星(截至 2026-10 实查,此前 09-12 记的 5,643 已过时),开源才一个多月,节奏很快

五、适合谁、怎么用得值

适合「想给产品加 3D 沉浸感、但不想从 shader 语法啃起」的前端 / 全栈开发者和 AI 编程重度用户。用得值的关键是把它当参考系而不是黑盒:先 live 调参看明白每个效果的参数逻辑,再让 Agent 基于参考改写,你的 3D 页面既有质感又可控。纯当提示词库复制粘贴当然也行,但看完「它为什么这么调」再让 Agent 动手,成品差距明显。

仓库:github.com/MengTo/threeui · 官网 / 目录:threeui.com · npm:@designcodeio/threeui · 星标 6,392(截至 2026-10 实查,MIT,2026-08-21 开源;09-12 那版记的 5,643 已过时)

六、我把官网目录跑起来截了几张实跑图

它最大的卖点就是「可交互实时渲染」。我把 ThreeUI 站(vite 起的 React 目录站,Three.js 0.149)在 1920×1080 无头浏览器里真跑了一遍截了图——左侧栏 + 组件网格,每个缩略图都是实时 WebGL 渲染(Predictive Arc 系列的绿弧 / 紫粒子 / 橙波纹都真画出来了,SwiftShader CPU 软渲染也能出),证明「160+ 组件全可交互」不是虚标。

ThreeUI 目录网格 · 160+ 组件缩略图均为实时 WebGL 渲染 1920×1080
ThreeUI 目录网格 · 160+ 组件缩略图均为实时 WebGL 渲染 1920×1080
ThreeUI 组件详情页 · Sketchbook「新加坡手绘作品集」3D 场景(可拖拽旋转)实跑渲染 1920×1080
ThreeUI 组件详情页 · Sketchbook「新加坡手绘作品集」3D 场景(可拖拽旋转)实跑渲染 1920×1080

截图跑完即销毁(停 vite、删 /tmp 源 + Chrome 缓存),服务器不留垃圾。