🌍 THE EARTH MIGRATION PROJECT

The Earth Migration Project（地球迁移计划） 是一个纯前端的电影级交互式 WebGL 体验，灵感源自《流浪地球》：太阳即将熄灭，人类在地球上建造了上万台行星发动机，推动整个星球离开太阳系，前往 4.37 光年外的比邻星——一段两千五百年、上百代人的旅程。

程序分为两部，共用同一套渲染与模拟底座：

全部使用 three.js r160 实时渲染，无构建步骤、无 CDN——three.js 与全部资源均已内置，克隆后起一个静态服务器即可运行，完全可离线。

一部 约 62 秒的“导演影片”：六幕分镜、运镜、字幕、程序化配乐与点火音效全部由代码实时驱动，支持暂停 / 拖动进度条 / 跳章。

拖拽环绕、滚轮缩放、点击任意建筑直接飞抵；数字键 1–9 一键跳转地标；F 进入第一人称飞行；C 电影巡航模式（自动环游全部地标）；O 返回自由探索。

入口：beyond.html —— “Part II of The Earth Migration Project”。 Humanity's Journey from a Dying Sun to the Galactic Sea（从垂死太阳到星辰大海的旅程）。

• 25 个目的地，分三组（地球与舰队 9 · 太阳系 11 · 星际 5），点击列表或标记即可飞抵： 地球、月球、重型发动机阵列、赤道转向阵列、太空电梯、同步轨道环、领航者旗舰、护航舰队、深空观测站 / 太阳系全景、太阳、水星、金星、火星、木星、土星、天王星、海王星、冥王星、阋神星 / 南门二 A·B、G 云、昴星团、猎户座大星云、船底座。
• 对数尺度飞行：从地表 100 km 连续缩放到 100,000 光年；底部标尺横跨 PLANET → ORBIT → 1 AU → HELIOPAUSE → 1 LIGHT-YEAR → LOCAL ARM → MILKY WAY，点击标尺即可飞到该尺度。
• 时间压缩：拖动 VOYAGE 时间轴从 2078 滑到 4578 年，公转速度可选 REAL TIME / 1 年:25 秒 / 1 年:3 秒 / TIME-LAPSE。
• 实时遥测：船钟、阶段/章节进度、MOSS 链路延迟（8.3 分钟，即地日光行时）、速度、与太阳距离、光行时、 南门二距离、预计抵达年（43,653 年）、银河坐标航向、所在区域，以及 26 条事件日志 （点火、时间压缩、土星环面交叉、弓形激波稳定、减速点火……）。
• 页面底部有章节条；影片中滚动滚轮可 穿越时间（“SCROLLING THROUGH TIME · PRESS ▶ TO RESUME”）。

第二部要同时容纳 63.7 km 的地表与 10 万光年的银河，代码把世界分成三层，各自独立模拟、合成到同一个 HDR 画面：

• 合成管线（js/beyond/post.js）：三层先合成进一张多重采样 HDR 帧（只解析一次），再做三个全屏通道——稳定（NaN/Inf 防护 + 热扰动 + 时域稳定）→ 泛光（双滤波 mip 链 + 云隙光）→ 终合（泛光混合 + 镜头效果 + ACES + 调色），比“每层各自 4×MSAA”的老方案省去约 8 个全分辨率通道。
• 硬表面建模（js/fx/kit.js + js/beyond/craft.js）：电梯攀爬器、缆绳桁架、中间站、同步环枢纽与领航者级旗舰，全部由几百个基元“拼装”（kitbash）后按材质合并——数百个零件只花几个 draw call。
• 评分音轨（js/beyond/audio.js）：纯 Web Audio 合成——次低音持续音、逐章变化的和弦垫（D 小调 → F 大调 → A 小调 → 降 E 利底亚 → D 大调）、引擎隆隆声、深空微光与揭示时刻的低频轰鸣。

已在 Steam 创意工坊 发布：流浪地球互动 - 泥嚎糕手版 - 桌面右上角切换 → https://steamcommunity.com/sharedfiles/filedetails/?id=3817164734

这是第二部的“桌面形态”，同样实时 WebGL 渲染：

• 四种模式（平滑运镜切换，场景永不重建）： LANDING 着陆视角——鼠标左右移动在三种设计机位间滑移（也可在控制面板固定机位），停手后缓慢漂移； INSPECT 检视——环绕发动机、太空电梯、空间站、旗舰、转向阵列、地球、月球、土星或太阳，拖拽旋转、滚轮缩放； CINEMATIC 电影——面板上按播放才开始的影片，单次播放或无缝循环； FLIGHT 飞行——沿着影片第一章的航线受引导飞行，鼠标左右控制前进/后退与速度。
• 桌面控制面板：默认收成右上角一枚小图标，点击展开，点击别处或闲置数秒自动收起；时钟与实时遥测都在壁纸上。
• 30 项壁纸引擎设置（全部实时生效）：默认模式、循环、交互灵敏度、面板位置/展开/自动收起、闲置回位、巡检自转速度、发动机音频律动反应、生成式音轨与音量、字幕、章节卡、电影黑边、时钟（12/24 小时、四角）、遥测、亮度、画质、帧率上限、省电模式、渲染比例等。
• 四档画质、实时切换：Low（集成显卡）· Medium（推荐）· High · Ultra；分辨率不足时自动降采样（最低 60%）并降低阴影刷新率，有余量后缓慢恢复。

ES Modules 与本地资源必须通过 HTTP 访问（直接双击 HTML 无法运行）：

git clone https://github.com/oxomkbk/earth-migration.git
cd earth-migration
python3 serve.py            # → http://localhost:8080/beyond.html（可指定端口：python3 serve.py 9000）

serve.py 会直接打开第二部；http://localhost:8080/index.html 进入第一部（第一部页面上也有通往第二部的入口）。其他任意静态服务器也可以，例如 npx http-server -c-1 .。

从源码构建壁纸引擎版（生成自包含文件夹，可离线、file:// 运行）：

npm i esbuild               # 或设置 ESBUILD=/path/to/esbuild
node tools/build-wallpaper.mjs [输出目录]      # 默认输出到仓库外的 ../wandering-earth-wallpaper

打包器把 three.js、第二部全部代码与壁纸控制器合并成一个经典脚本，所有图片/模型/音效以 data: URI 内嵌（pack/*.js），字体也内嵌——因此 Wallpaper Engine 从磁盘打开时无需任何网络请求。构建完成后按 wallpaper/README.txt 的说明导入 Wallpaper Engine 并发布。

要求：现代桌面浏览器（Chrome / Edge / Firefox / Safari），支持 WebGL2，独立 GPU 体验最佳；移动端会自动切换低画质档位。

第一部（index.html）

第二部（beyond.html）

The Earth Migration Project is a fully front-end, cinematic interactive WebGL experience inspired by The Wandering Earth. It ships in two parts sharing one rendering and simulation core:

Everything is rendered in real time with three.js r160. No build step, no CDN — three.js and every asset are vendored, so cloning the repo and starting any static server is enough. Works fully offline.

A ~62-second directed film: six chapters of camera work, subtitles, a procedural score and ignition SFX — all driven by code in real time. Pause, scrub and skip chapters at will (chapter table: The Dying Sun → Ignition → Turning the World → The Space Elevator → Jupiter → The Long Night, see the Chinese section above).

Drag to orbit, scroll to zoom, click any structure to fly there; keys 1–9 jump between nine landmarks (Earth overview, Engine Array 017, Equatorial Steering Array, Equatorial Anchor, Tianshu Apex Station, Habitat Ring Aurora, Kuiper-7 Mining Platform, Deep Space Array, Luna). F enters first-person flight, C is an automatic cinematic tour, O returns to free exploration.

Entry: beyond.html — “Part II of The Earth Migration Project”. Humanity's Journey from a Dying Sun to the Galactic Sea.

• 25 destinations in three groups (Earth & Fleet 9 · Solar System 11 · Interstellar 5) — click a list entry or a marker to fly there: Earth, the Moon, the Heavy Engine Array, the Equatorial Steering Array, the Space Elevator, the Geostationary Ring, the Navigator flagship, the escort fleet, the deep-space observatory / the whole system, the Sun, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Eris / Alpha Centauri A·B, the G-Cloud, the Pleiades, the Orion Nebula, Carina.
• Log-scale flight: a continuous zoom from 100 km above the surface to 100,000 light-years; the bottom ruler spans PLANET → ORBIT → 1 AU → HELIOPAUSE → 1 LIGHT-YEAR → LOCAL ARM → MILKY WAY and clicking it flies to that scale.
• Time compression: drag the VOYAGE timeline from 2078 to 4578, with orbit speeds REAL TIME / 1 yr : 25 s / 1 yr : 3 s / TIME-LAPSE.
• Live telemetry: ship clock, stage/chapter progress, MOSS link latency (8.3 min — the one-way light time from Sol), velocity, distance from Sol, light delay, Alpha Centauri distance, ETA (year 43,653), galactic heading, region, and a 26-entry event log (ignition, time compression, ring-plane crossing, bow shock stable, deceleration burn…).
• A chapter strip sits at the bottom; during the film, scrolling the wheel travels through time (“SCROLLING THROUGH TIME · PRESS ▶ TO RESUME”).

To hold both a 63.7 km surface and a 100,000 ly galaxy, the world is split into three layers, each simulated independently and composited into one HDR frame:

• Compositing pipeline (js/beyond/post.js): the three layers resolve once into a single multisampled HDR frame, then three full-screen passes — stabilise (NaN/Inf guard + heat haze + temporal stabiliser) → bloom (dual-filter mip chain + crepuscular rays) → final (bloom composite + lens + ACES + grade) — replacing what used to be ~8 full-resolution MSAA half-float passes.
• Hard-surface modelling (js/fx/kit.js + js/beyond/craft.js): the elevator climber, tether truss, waystations, ring hub stations and the Navigator-class flagship are kitbashed from hundreds of primitives and merged per material — hundreds of parts cost a handful of draw calls.
• Generative score (js/beyond/audio.js): pure Web Audio — a sub-bass drone, a chord pad that changes per chapter (D minor → F major 7 → A minor → E♭ lydian → D major), engine rumble, deep-space shimmer and low booms on the big reveals.

Published on the Steam Workshop: 流浪地球互动 - 泥嚎糕手版 - 桌面右上角切换 → https://steamcommunity.com/sharedfiles/filedetails/?id=3817164734

The desktop form of Part II, also rendered live in WebGL:

• Four modes (eased camera flights; the scene is never rebuilt): LANDING — the Earth and its engines, three designed views chosen by the cursor (or pinned), slow drift when idle; INSPECT — orbit the engines, elevator, station, flagship, steering array, Earth, Moon, Saturn or Sun (drag to orbit, wheel to zoom); CINEMATIC — the film, which plays only from the panel's Play control, one-shot or seamless loop; FLIGHT — a guided flight along the film's chapter-1 path where the cursor sets speed and direction.
• On-screen control panel at the top edge (top right by default): collapsed to a small dim icon, opens on click, closes on click-outside or after a few seconds. Clock and telemetry live on the wallpaper.
• 30 Wallpaper Engine properties, all applied live: default mode, loop, interaction sensitivity, panel open/collapse/position/offset, idle return, inspect auto-rotate, audio-reactive engines, generative soundtrack and volume, captions, chapter cards, letterbox, clock (12/24 h, four corners), telemetry, brightness, quality, frame-rate cap, power saver, render scale.
• Four quality tiers, switched live: Low (integrated graphics) · Medium (recommended) · High · Ultra. If frames arrive late the wallpaper lowers its own resolution (down to 60 %), then refreshes the shadow map less often, and recovers slowly when there is headroom.

ES modules and local assets must be served over HTTP (opening the HTML from disk will not work):

git clone https://github.com/oxomkbk/earth-migration.git
cd earth-migration
python3 serve.py            # → http://localhost:8080/beyond.html  (custom port: python3 serve.py 9000)

serve.py opens Part II directly; http://localhost:8080/index.html is Part I (which links on to Part II). Any static server works too, e.g. npx http-server -c-1 .

Building the Wallpaper Engine edition from source (self-contained folder, offline, file://):

npm i esbuild               # or set ESBUILD=/path/to/esbuild
node tools/build-wallpaper.mjs [outDir]     # defaults to ../wandering-earth-wallpaper, outside the repo

The bundler merges three.js, all of Part II and the wallpaper controller into one classic script, and inlines every image/model/sound as data: URIs (pack/*.js) plus the fonts — so Wallpaper Engine needs no network access at all. Then follow wallpaper/README.txt to import and publish.

Requires a modern desktop browser with WebGL2 (a discrete GPU is recommended); mobile devices automatically switch to a lower quality profile.

Part I (index.html)

Part II (beyond.html)

• Sky 星空： NASA/Goddard Space Flight Center Scientific Visualization Studio, Deep Star Maps 2020 (Gaia DR2, Hipparcos-2, Tycho-2) — public domain. 银河全景与星表由 milkyway_2020_4k.exr 和 hiptyc_2020_8k.exr 派生。银河系俯视图 / Milky Way plan view: NASA Goddard / CI Lab — public domain (assets/sky/milkyway_top_2k.jpg).
• Planet maps 行星贴图（第二部）： Solar System Scope (solarsystemscope.com/textures) — CC BY 4.0 (assets/planets/). Pluto: NASA/JHUAPL/SwRI — public domain.
• Models 模型： NASA 3D Resources (github.com/nasa/NASA-3D-Resources) — International Space Station (B), Hubble Space Telescope (A), Mobile Launcher. Public domain; NASA does not endorse this project.
• Textures 贴图： Poly Haven (polyhaven.com) — metal_plate_02, painted_metal_shutter, gray_rocks, blue_metal_plate, aerial_ground_rock. CC0.
• Earth / Moon maps 地月贴图： three.js example textures (NASA Blue Marble / Black Marble derived), MIT-licensed repository, vendored in assets/earth/; a procedural planet is generated if they fail to load.
• Fonts 字体： Orbitron, Rajdhani, JetBrains Mono (SIL Open Font License 1.1).
• 声明：本作品是受《流浪地球》启发的同人创作（fan work），与权利方无关联。 / A fan work inspired by The Wandering Earth; not affiliated with its rights holders.