项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1786
使用教程
环境要求
- Python 3（仅用于启动本地静态文件服务）
- 现代支持 WebGL 的浏览器（项目使用 Three.js r149 / WebGL 渲染）
- 无需 Node.js、包管理器或构建步骤
安装与启动步骤
-
1获取项目代码
把仓库克隆到本地，后续所有命令都在仓库根目录执行。
git clone https://github.com/MengTo/kage.git cd kage -
2启动本地静态服务
项目是纯静态站点，没有构建步骤，用任意等价静态服务器即可。
python3 -m http.server 4173 --bind 127.0.0.1 -
3在浏览器中访问
打开本地地址即可进入夜间山寺场景，上下滚动页面会推进五个章节。
如何确认成功
浏览器访问 http://127.0.0.1:4173/ ，能看到 WebGL 渲染的夜间山寺场景并随页面滚动推进章节，即启动成功。
常见问题
Q：需要 npm install 或构建吗？
A：不需要。README 明确说明项目没有构建步骤、没有环境变量，Three.js r149 已内置（vendored），不依赖包管理器。
Q：为什么用 Python 启动？
A：Python 只用来在本地提供静态文件服务，任何等价的静态服务器都可以替代，不参与页面渲染逻辑。
Q：端口 4173 被占用怎么办？
A：可以换一个未被占用的端口启动，例如把命令中的 4173 改成 8000，然后访问对应的本地地址。
Q：运行需要联网吗？
A：不需要。README 说明项目没有运行时网络依赖、没有分析脚本，静态资源已随仓库提供。
注意事项
- 必须在仓库根目录启动静态服务，否则页面引用的资源会 404。
- index.html 内含文档结构、CSS、程序化场景构建、滚动编排与交互逻辑，可作为 Three.js 学习参考。
- 项目自带响应式移动端布局、减少动效（reduced-motion）行为与自定义光标，无需额外配置。
核心亮点
- 实时渲染的夜间光影效果，氛围感强
- 五章叙事结构清晰，交互引导自然
- 基于 Three.js，技术栈轻量，易于二次开发
不足之处
- 内容量有限，体验时长较短
- 文档和社区支持待观察
适用场景
- 数字文化展览中的虚拟漫游
- Three.js 学习与教学案例
- 沉浸式 Web 艺术项目原型
替代项目
A-Frame、Babylon.js、model-viewer
上一篇：repath-studio
下一篇：sketch-a-day
同类项目推荐
transitions.dev
开源
复制即用的精致 UI 过渡，AI 帮你按场景生成动效
UI motion agent, a library of 43+ crafted transitions, a skill that fits your workfl···
poster-design
开源
浏览器里拖拽做海报，几分钟出图直接导出
迅排设计 - 图片编辑器、AI 在线海报设计，仿稿定设计，适用于多种场景：海报生成、电商产···
genmedia-creative-studio
开源
一个 Notebook 玩转 Gemini 全家桶生成图像语音音乐视频
GenMedia Creative Studio is a generative media user experience highlighting the use ···
qiaomu-design
开源
让 Claude Code 写前端不再千篇一律
偏执型设计顾问：反 AI 味设计 + 风格试衣间 + 58 站设计系统库的 Claude Code Skill | Op···
fireworks-tech-graph
开源
一句话生成可上生产的架构图与流程图
Generate production-quality SVG+PNG technical diagrams from natural language. 7 styl···
claude-skill
开源
给 Claude 装上电影级落地页设计技能
Free Claude skill: make Claude build award-level, cinematic landing pages. By Motion···
generative-noodles
开源
用代码生成流畅线条，直接驱动绘图仪作画
A generative art sketch for creating plotter art in Processing
onlook
开源
在真实代码上做设计，AI 帮你直接改界面
The Developer Tool for Visual Engineers • An Open-Source AI-First Design tool • Vi···
kage
开源
在浏览器里夜游京都山寺，沉浸式体验五章叙事
An interactive five-chapter night walk through a Kyoto mountain temple, rendered liv···