chadandyou/jrames

项目介绍

JRAMES 是一个在浏览器里运行的互动图像小说，讲述与 Solana 迷因币有关的故事，另有一个独立 Web 应用解释代币价格为什么波动。本仓库只包含网站部分：大理石雕像在堆满死币的大厅中醒来，选中唯一还活着的币，通过长按把它从胶囊里撕出来，滚动与长按推动剧情 README lines 31–51。

技术上的特色在视觉呈现：自定义 GLSL 排线与雕版着色器，基于 Three.js 和 React Three Fiber 渲染，模型使用 CC0 人体模型和公有领域博物馆扫描件，授权说明在单独的模型许可文件中 模型许可。场景由 GSAP 与 Lenis 驱动，尊重减少动态效果的系统设置；配乐用 Web Audio API 实时合成，会跟随场景变化，而不是循环播放录音。

配套 App 部署在别处，后端私有，本仓库不是完整产品 README lines 22–30。它适合想在一个 React 应用里同时研究滚动叙事、着色器插画和生成式音频的开发者。

本地运行

需要 Node 22.12 或更高版本。在仓库根目录执行：

npm install   # 或 npm ci
npm run dev   # 启动 http://localhost:5173

命令和本地地址来自 README 的运行说明 README lines 91–111。修改后可用同一节列出的校验命令：

npm test          # Vitest，jsdom
npm run typecheck # tsc -b
npm run lint      # Biome
npm run build     # tsc -b && vite build，输出到 dist/
npm run e2e       # Playwright，自行启动开发服务器

目录组织上，场景、音频和 UI 放在 src/features/，共享工具在 src/lib/，设计令牌在 src/styles/tokens.css，3D 模型在 public/models/。README 还列出了配色和字体，改视觉系统时可以直接参考。

使用约束

仓库为保留所有权利，查看或运行网站不代表获得复用许可 许可证。只有网站是公开的：架构图中的 App、API 网关、鉴权、数据摄入、评分和社交服务均为私有，克隆本仓库无法复现线上证据应用 架构说明。

网站是重视觉、重音频的体验，3D 模型和着色器渲染是核心部分，并且明确支持减少动态效果。README 把网站定位为 Solana 迷因币的叙事载体，并声明该代币没有内在价值或财务回报预期——这是理解项目定位的背景，不代表应把它当作投资产品。

HotRepo 点评

该项目于 2026-11-03 出现在 HotRepo 新项目榜，在从当天 12:40 UTC 开始、16:45 UTC 观测的增长窗口内记录到 108 个 Star、0 个 Fork。这只是单条短窗口快照，能说明早期关注来得快，不足以判断趋势或采用情况。从技术材料看，亮点是把自定义雕版着色器和实时 Web Audio 放进同一条滚动叙事里；即使证据型 App 仍然闭源，这套渲染与音频实现本身仍值得考察。