dmitrykurash/holospot
多媒体与设计把物理计算的全息烫金、闪粉和立体全息材质接入 three.js 场景,并专为交给 AI Agent 配置而设计。
项目介绍
holospot 把集换卡式彩虹烫金、全息闪粉和安全标里的立体全息效果带进普通 three.js 场景。它没有用移动渐变冒充彩虹,而是对每个像素、每个波长求解表面细槽如何把每盏灯的光折向眼睛;闪光来自各自朝向不同的细片和刻面,立体全息则是把记录的三维对象重放出来。
套件提供 Prism Rainbow、Gold Shatter、Nebula Glitter、Sky Sparkle、Gilded Vortex、Volume Hologram、Foil Emboss 七种材质,每种都有色调、颗粒、光泽和磨损等通俗参数。适用场景是网页三维:商品模型、随光标倾斜的卡片、logo 以及逐帧渲染的短视频。绘制代码直接取自 holo.spot,仓库里有像素级比对测试保证两边一致 同源说明。
快速开始
准备:Node.js 22.18 或更新版本,以及 r170+ 的 three.js 场景。
git clone https://github.com/dmitrykurash/holospot.git
cd holospot
npm install
npx vite
打开 卡片示例,recipes/ 下每页都是可直接复制的完整示例,覆盖把材质套到网格、在已有场景中嵌入全息物体、拖入 .glb、指针倾斜卡片、带贴纸的纸质卡片、立体全息、透明画布和视频转盘。
接入普通场景只需要三次调用:
import { Holo } from "holospot";
const holo = new Holo(renderer);
holo.apply(mesh, { material: "nebula", sizeMm: 120 });
renderer.setAnimationLoop(() => holo.render(scene, camera));
全息物体合成进你原有的渲染结果,其他物体、灯光和色调映射照常绘制。单页使用可以不安装,通过 import map 从 jsDelivr 构建加载 dist/holo.js。
想先在界面上调效果,可以打开 holo.spot,调整材质、灯光和颜色后点 Copy settings,把复制出的设置交给 Agent,或作为 settings 传入。
Agent 工作流
仓库围绕编程 Agent 使用来写:把仓库交给 Agent,用大白话描述想要的结果,让它复制文件、运行页面并截图自查。AGENTS.md 是 Agent 的入门手册,一页篇幅,人也能直接读。提供三项信息能明显提高一次成功的概率:真实世界尺寸(sizeMm)、材质名称或描述、页面是深色还是浅色。
使用约束
- 固定棚拍灯光。 物体由自带棚灯照亮,不受你场景里灯的影响;棚灯可以移动和修改,但效果依赖它们。
- 图形负载较重。 在较新的笔记本上调校;提供三档画质,手机应使用最低档,并在目标设备上实测。
- 仅支持 WebGL。 需要
THREE.WebGLRenderer,不支持 WebGPU 渲染器。 - 自备模型。 除七个小全息主体外不附带三维模型;官网上的动态场景(风中旗帜、可拉扯布料、可揭贴纸)也不在套件里。
- 设计站非必需。 运行时不从 holo.spot 加载任何内容,它只是调参数的地方。
许可证为 MIT,允许商用、修改和分发,只要保留许可证文本 许可证。
HotRepo 点评
holospot 在 2026-11-18 进入 HotRepo 的 TypeScript 新项目榜,统计窗口自 2026-11-17 起,记录 102 个 Star、4 个 Fork;没有记录到 GitHub 全语言日榜名次。这只是单个短窗口的观察,不足以说明持续热度。更值得留意的是它把 Agent 当作主要入口:仓库既是一个 three.js 包,也是给编程 Agent 的使用手册;与 holo.spot 的像素比对测试则具体说明分发的材质确实与官网一致,而不是一句宣传。
效果不佳时
若材质看起来发平、发暗,可按 README 建议给物体加慢速旋转或倾斜,核对真实尺寸与深色/浅色设置。全息效果需要光线和运动才显得出来。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- wesbos/3d-model-anything用 iPhone LiDAR 扫描房间,再通过 AI 编程 Agent 的工作流重建为可编辑的 Three.js 场景。
- Leonxlnx/athenaion用 three.js 纯代码生成的古希腊 3D 世界,适合研究程序化建模与离线渲染,而非复用资产或做游戏。
- AIRzZ90/study-materials-fork基于 Tauri 2 的跨平台音视频浏览与播放应用,使用 React 界面和 hls.js 播放。
- mromidev/claude-animated-shortsClaude 技能:在本机用 three.js 与 Remotion 渲染 55–70 秒竖屏动画故事短片。