搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

dmitrykurash/holospot

多媒体与设计

把物理计算的全息烫金、闪粉和立体全息材质接入 three.js 场景,并专为交给 AI Agent 配置而设计。

134
9
TypeScript
MIT
创建于 1 天前

项目介绍

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 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. wesbos/3d-model-anything用 iPhone LiDAR 扫描房间,再通过 AI 编程 Agent 的工作流重建为可编辑的 Three.js 场景。Swift1,589
  2. Leonxlnx/athenaion用 three.js 纯代码生成的古希腊 3D 世界,适合研究程序化建模与离线渲染,而非复用资产或做游戏。JavaScript296
  3. AIRzZ90/study-materials-fork基于 Tauri 2 的跨平台音视频浏览与播放应用,使用 React 界面和 hls.js 播放。TypeScript113
  4. mromidev/claude-animated-shortsClaude 技能:在本机用 three.js 与 Remotion 渲染 55–70 秒竖屏动画故事短片。TypeScript108