为什么值得关注

它通过非欧几里得缩放技巧和零依赖的本地服务器或完全客户端的浏览器版本来实现，将文件导航转化为超现实的 3D 体验，融合了实用性与艺术和游戏。

适合谁使用

对 3D 文件可视化感兴趣的开发者
创意编码者和数字艺术家
喜欢实验性界面的科技爱好者
热衷于文件系统射击游戏的玩家

典型使用场景

在沉浸式 3D 环境中探索文件夹层次结构
演示 three.js 和 WebAudio 的功能
作为奇特的桌面玩具或艺术装置
学习非欧几里得渲染和浏览器文件系统 API

项目优势

本地模式仅依赖 Python 标准库，零外部依赖
支持本地服务器和仅浏览器（通过文件系统访问 API）两种部署方式
创造性地融合文件浏览与游戏（入侵者模式、音乐响应）
客户端模式下不上传任何数据，保护隐私

使用前须知

完整模式仅限于本地主机（无法网络访问）
仅浏览器模式缺少操作系统集成（无法打开应用或显示在访达中）
需要使用 Chrome 或 Edge 浏览器才能使用文件系统访问 API，并非通用

README 快速开始

◆ GEODE

Your filesystem, spatialized. Pilot a little glowing dart through space where every folder is a hollow geodesic sphere with a glowing aperture. Fly through the opening and the geode balloons around you: bigger on the inside, containing its own suns, orbiting sub-geodes, and rings of file cards.

Run

Two ways to fly:

Full mode (local server):

python3 server.py          # opens http://127.0.0.1:4747 in your browser

Whole disk, open-in-app, reveal-in-Finder, ?start=/deep/links. Python 3 stdlib only; three.js is vendored in web/vendor. Localhost only.

Browser-only mode (GitHub Pages): open the hosted page in Chrome or Edge and click GRANT A FOLDER — the File System Access API lets you explore any folders you grant, fully client-side. Nothing is uploaded; there is no backend. Previews and music reactivity all work; open-in-app / reveal don't (no OS on the other side of a web page).

Fly

input	action
MOUSE	steer
W / S	thrust forward / back
A / D	strafe
SPACE / C	lift / sink
Q / E	roll
SHIFT	booster (heat-limited)
CLICK / F	autopilot to target · open file
R	reveal target in Finder
BACKSPACE	eject up one level
H	toggle hidden files
M	mute
L	invaders mode — the files fight back

Fly into a geode's glowing ring to enter it. Fly out the exit aperture (the pulsing ring, marked EXIT on your HUD) to go back up. Files open in their default app when you board them. Sealed red geodes are permission-denied.

When the files fight back

Press L inside any folder. The lights go neon, a four-note bass line starts marching, and every file in the room becomes a Space Invaders phalanx — a sphere of enemies that side-steps around you in chunky synchronized beats and contracts inward, faster as their numbers thin. Hold click for twin hitscan lasers; files die in one hit and explode in their filetype's color, folders take three and crack open. Divers telegraph with a siren before they charge. Grazing a bolt pays points, chained kills climb a pentatonic ladder, O cycles CHILL / NORMAL / NIGHTMARE.

No files are harmed — it's a costume over the live scene. Press L again and everything glides back to exactly where it was.

How it works

server.py — zero-dependency Python stdlib server: static files + /api/list, /api/roots, `

Geode