无限隧道
一条数学闭合的隧道,一个不需要骨骼动画的滑手,一套可以一直往下出的预设。 v0.1 是一个构想;这一版把它拆成能施工的工程:目录、数据契约、帧预算、里程碑和判死门。
01样机 · 先看结果Live Prototype
下面这一帧是可直接运行的 2D Canvas 样机,不到 600 行,零依赖。它不负责证明 Three.js 能跑,它只负责证明三件事:构图成立、速度舒适、循环看不见。
怎么读这一帧:发光拱肋每 9m 一道,是隧道里的钠灯灯带;它们沿闭合曲线退向消失点,所以「永远向前」不需要长度,只需要闭合。 点「跳到接缝」会直接跳到环的接缝处——你能看见它被一次过曝光吃掉。这就是正式版隐藏接缝的手法。
样机与正式版的关系:取景、光比、循环逻辑、预设字段完全一致;差别只在渲染器。样机用线条光(零依赖、可截图自检),正式版换成 Three.js 的马蹄形管壁、湿路面材质与体积雾。换句话说,这一页的代码就是产品原型,也是数据契约的活文档。
02一页纸One Pager
三个判断(它们决定了后面所有取舍)
01 · 无限由闭环保证
不由素材长度保证。295 m 的路径首尾相接,几何、纹理、灯光三相同周期,于是「永远向前」是一个数学事实,不是一个剪辑技巧。
→ 内存恒定,帧率恒定,可跑八小时
02 · 情绪由光和剪影承担
不由模型精度承担。人物亮度压到 8% 以下,只需要一个可信的轮廓和重心;代价是省掉整套骨骼绑定、动画资产与版权谈判。
→ 角色成本从「两周一个」降到「半天一个」
03 · 靠「每圈 1% 的不同」留住人
不由首帧惊艳承担。壁纸要被看几个月,不是三十秒。第 N 圈墙上多一道门、远处多一辆车,成本几乎为零,感知价值最高。
→ 这是唯一能让人「留着不换」的理由
不做什么(v1 的边界,写死,防止范围失控)
- 不做叙事解谜。没有目标、没有关卡、没有失败。桌面不需要第二个游戏。
- 不做操作玩法。默认零交互;可选的三件交互全部默认关闭。
- 不做角色商城。角色是轮廓,不是商品。v1 只做两套剪影。
- 不做在线加载。所有资源本地化、相对路径、可离线运行——这是 Lively 环境的硬约束。
- 不做真实运动模糊。用「拉长的灯光」表达速度,比后处理便宜且更干净。
产品定位一句话:不是「一段能动的壁纸」,是「一个可以一直挂着、并且会慢慢变的隧道」。前者卖一次,后者能卖一年。
03美术圣经Art Bible
壁纸是被看的,不是被玩的。所以第一个要定死的不是代码,是三张锚定帧——所有实现都要能复现这三张。
锚定帧 A · 入弯
灯带从左上斜切进来,弯心在左。滑手贴在路面上,重心压向内侧,板底反出一条冷光。画面几乎全黑,只有三道亮线:灯带、路缘、板底。
锚定帧 B · 出洞口
0.4 秒过曝。白光从消失点漫过来,吃掉整张画面,只留一个更黑的剪影。接缝就是在这里被抹掉的——观众以为是被光晃了一下。
锚定帧 C · 长直道
灯距被拉开,两道灯带退成平行线。滑手成为画面里唯一的黑色形状,速度感全靠灯带掠过眼睛的频率。
硬约束(可量化,可验收)
| 维度 | 规则 | 数值 / 做法 | 为什么 |
|---|---|---|---|
| 光源 | 全场景 ≤ 3 类 | 顶灯带 + 洞口天光 + 板底冷光 | 第四种光就会开始「假」 |
| 主色温 | ≤ 2 个 | 钠灯 2100K / 天光 6500K,比例 8:2 | 冷暖对撞出空间,多了就脏 |
| 人物亮度 | ≤ 8% | 剪影 RGB ≤ #141414,仅留 1 px 边缘光 | 剪影一灰,就像贴纸 |
| 墙面细节 | 低频 | 纹理周期 ≥ 2 m,禁止高频噪点 | 远看会糊成噪点,且抢图标 |
| 雾 | 45 m 见底 | 透过率 0.15,远端溶进天光而非黑色 | 黑洞会显得画面「塌了」 |
| 构图 | 人物锚点 | 脚点 0.56W / 0.80H,消失点在 0.46W / 0.42H | 偏一点就变成「游戏截图」 |
| 屏幕中心 | 压暗 | 中心 40% 区域平均亮度 ≤ 22% | 桌面图标要能被看见 |
| 质感 | 胶片感 | 颗粒 0.010 + 暗角 0.42 + 轻微色差 0.5px | 抗色带,去 CG 味 |
三套预设的色板
sodium · 钠灯山体隧道
主色 #ffab4d,凌晨四点、湿沥青、钠灯的橙。默认预设。
cold · 冷白工业管廊
主色 #d6e9ff,隧道养护作业的灯,灯距更密、节奏更硬。
neon · 霓虹下穿道
主色 #3fe3ff,城市下穿道 + 广告灯箱,给「夜班人群」的那一套。
五条禁令
- 不许速度线。线条会暴露「这是特效」。速度用灯带的掠过频率表达。
- 不许镜头抖动。这是壁纸,抖动会让人晕,且八小时后是折磨。
- 不许 FOV 呼吸。视场角是世界观,不是情绪工具。
- 不许常驻 UI。任何文字、按钮、水印默认不出现。
- 不许真实运动模糊。代价高、效果脏,不如把灯拉长。
04体验规格Experience Spec
壁纸的时间尺度和短片不同:短片是 90 秒,壁纸是八小时。所以循环必须分三层:看得见的、感觉得到的、说不出来的。
| 层 | 周期 | 改什么 | 目的 |
|---|---|---|---|
| 主环 | 32.8 s | 位置 s 走完 295 m,回到原点 | 「一直在动」,不被察觉的重复 |
| 大周期 | 18 min | 色温 ±400 K、雾密度 ±15%、灯带相位漂移 ±1.5 m | 「好像不一样了」,但说不出哪里 |
| 极慢漂移 | 8 h | 只改一个参数:天光颜色从夜到晨 | 挂一整天的人,傍晚会发现「天亮了」 |
| 微事件 | 3–7 min | 远处车灯 0.8 s / 墙上一道涂鸦 / 一只飞虫 / 通风机低频 | 「它在发生什么事」的钩子 |
首次 90 秒规则:启动后 90 秒内必须出现至少一次能被明确注意到的变化(一次过曝出洞、一辆对向车灯)。否则用户会怀疑壁纸卡住了,然后关掉它。
交互边界
- 默认零交互。移动鼠标、点击画面,什么都不发生——这是壁纸的礼貌。
- 可选三件(设置里默认关闭):双击暂停 / 滚轮调速 / 长按显示小时钟。
- 暂停时必须是一张好静帧。静止状态会被截图,也会被当成「桌面背景」用。
- 切换预设 < 1 s,且不重建整条曲线(只换材质与灯光参数,必要时换路径)。
桌面可读性预算
这不是审美问题,是可用性问题。把壁纸放在 20 个 32 px 图标后面,仍然要能一眼找到图标。
- 中心 40% 区域平均亮度 ≤ 22%,对比度 ≤ 2.5:1。
- 高光只允许出现在消失点与灯带上,不落在图标区。
- 提供「省电模式」:亮度 −30%,灯带减半,帧率降到 20。
05系统架构Architecture
五层,依赖单向向下。关键约束:场景层不认识 DOM,核心层不知道 Lively 的存在。这样同一份代码才能在浏览器、Lively、Wallpaper Engine 三个宿主里跑。
模块职责与体积预算
| 模块 | 只做一件事 | 行数预算 | 禁止 |
|---|---|---|---|
core/loop | 闭合曲线 + 弧长表 + 任意 s 取点/切线 | ≤ 120 | 禁止碰材质 |
core/frames | 重力对齐标架,退化保护 | ≤ 60 | 禁止引入 RMF(v1) |
core/tube | 截面函数 → 环形/实例化几何 | ≤ 180 | 禁止读预设 |
core/camera | 三种机位、阻尼、弯道 roll | ≤ 110 | 禁止写 DOM |
core/budget | 帧时采样与降级阶梯 | ≤ 90 | 禁止改用户设置 |
core/rng | 种子随机,保证每圈装饰一致 | ≤ 30 | 禁止 Math.random |
scene/rider | 程序化姿态 + 弯道侧倾 | ≤ 160 | 禁止骨骼动画(v1) |
scene/events | 微事件时间轴与触发 | ≤ 140 | 禁止阻塞主循环 |
为什么标架不用 RMF:旋转最小化标架(RMF)在数学上更漂亮,但相机和路面会跟着管子一起滚——壁纸里滚镜头等于劝退。v1 用重力对齐标架(世界向上剔除切向分量),路永远是路面,镜头永远不歪。RMF 留给 v2 的海底/太空管。
06工程目录Repository
可以直接照这个建仓。文件数克制在 30 个以内,每个文件只负责一件事——这是能在两周内独立完成的规模。
infinite-tunnel/ ├─ index.html # 壳:canvas + 预载提示,≤ 6 KB ├─ app.js # 装配与启动,≤ 4 KB ├─ core/ │ ├─ loop.js # 闭合曲线 + 弧长表 │ ├─ frames.js # 重力对齐标架 │ ├─ tube.js # 马蹄形截面 → 环形几何(InstancedMesh) │ ├─ camera.js # 三种机位 + 阻尼 │ ├─ budget.js # 帧预算与降级阶梯 │ └─ rng.js # 确定性随机 ├─ scene/ │ ├─ tunnel.js # 管壁、路面、标线、灯带 │ ├─ rider.js # 剪影 + 程序化姿态 │ ├─ lights.js # 灯带光、洞口天光、板底光 │ ├─ atmosphere.js # 体积雾、尘、颗粒 │ └─ events.js # 微事件时间轴 ├─ ui/ │ ├─ panel.js # 设置面板(键盘 F2 呼出) │ └─ hud.js # debug=1 时显示帧时/预算 ├─ platform/ │ ├─ lively.js # livelyWallpaperPaused / Resumed │ ├─ wallpaper-engine.js # WE 的暂停与音频事件 │ └─ browser.js # ?preset=&t=&debug=1 ├─ presets/ │ ├─ tunnel.sodium-mountain.json │ ├─ tunnel.cold-utility.json │ ├─ tunnel.neon-underpass.json │ ├─ rider.silhouette-a.json │ └─ event.drift.json ├─ assets/ │ ├─ models/rider_silhouette.glb # ≤ 400 KB,单网格 │ ├─ textures/wall_noise_512.png # ≤ 180 KB,可平铺 │ └─ audio/ # v1 空着,v1.2 再放 ├─ build/ │ ├─ bundle.mjs # 打成单文件 classic script │ ├─ make-thumb.mjs # 自动抓 t=0.2 帧出缩略图 │ └─ verify.mjs # 曲线闭合/曲率/帧预算回归 ├─ LivelyInfo.json ├─ project.json # Wallpaper Engine └─ dist/ # 构建产物:单文件 + 缩略图
构建产物(交付形态)
dist/index.html
单文件:内联 CSS/JS、模型转 base64、config 打成常量。目标 ≤ 2.2 MB,冷启动 ≤ 1.5 s。
为什么单文件:file:// 下的 module / fetch 会被拦
LivelyInfo.json
Type: 1,Arguments: --pause-event true,缩略图与预览共用 thumbnail.jpg。
你现有的 巨映山河 就是这个结构,直接复用
project.json
Wallpaper Engine 的 web 类型工程:type: "web",file: "index.html",同一份 dist 直接打包。
一份代码,两个商店
07数据契约Data Contract
整个项目只有一个原则:所有会变的东西都进 JSON,所有不会变的东西才写进代码。这样「换一套隧道」是编辑数据,不是改程序;也才能让非程序员参与内容生产。
tunnel.<主题>.json
{
"schema": 1, // 契约版本,读到不认识的版本就降级到默认值
"id": "sodium-mountain",
"name": "钠灯山体隧道",
"loop": { // 中心线:Fourier 级数,天然闭合、天然 C∞
"type": "fourier",
"coef": [43.61, 12.20, 45.45, 6.54, 1.90, 1.29],
"phase": [4.1085, 4.1083, 4.2432, 2.8956],
"length": 295.0, // 构建期算出并写入,运行时校验偏差 < 0.5 m
"minRadius": 19.4 // 曲率半径下限,必须 > 管半径 × 1.5
},
"section": { // 马蹄形截面:拱 + 平地面
"radius": 3.15,
"floorRatio": 0.585, // 地面高度 / 半径
"segments": 64,
"ribSpacing": 9.0 // 拱肋 / 灯带间距(米)
},
"lighting": {
"ribColor": "#ffab4d",
"ambient": "#1b2230",
"portalColor": "#ffd7a2", // 洞口天光颜色
"flash": { "dur": 0.42, "peak": 0.86 } // 接缝掩体:一次过曝
},
"atmosphere": {
"fogColor": "#3a2b1a",
"fogDensity": 0.038, // 45 m 处透过率 ≈ 0.18
"grain": 0.010,
"vignette": 0.42,
"dust": 60 // 尘埃粒子数,0 = 关
},
"palette": { "wall": "#241d15", "road": "#16140f", "line": "#b7ab93" }
}
rider.<风格>.json
{
"schema": 1, "id": "silhouette-a",
"model": "assets/models/rider_silhouette.glb",
"height": 1.62, // 米,用来和隧道尺度对齐
"style": { "albedo": "#121212", "rimWidth": 0.012, "rimColor": "#ffc27a" },
"pose": {
"crouch": 0.22, // 0=站, 1=深蹲;程序化姿态的基准
"leanGain": 1.6, // 曲率 → 侧倾 的放大系数
"leanMax": 0.38, // 弧度,约 22°
"bobAmp": 0.012, "bobFreq": 2.0
},
"board": { "length": 0.82, "pitchGain": 0.9 }
}
event.<剧本>.json
{
"schema": 1, "id": "drift",
"loop": 18, // 每 18 分钟一轮剧本
"events": [
{ "at": 0.12, "type": "headlights", "dur": 0.8, "side": "left" },
{ "at": 0.34, "type": "graffiti", "texture": "tag_02.png", "ring": 3 },
{ "at": 0.61, "type": "moth", "dur": 6.0 },
{ "at": 0.88, "type": "fanHum", "game": "audio" }
]
}
版本规则:schema 只增不改。读到未知字段直接忽略;读到更高版本就退回内置默认预设并记一条日志——壁纸不能因为一个 JSON 写错就黑屏。所有数值字段都要有 min/max 夹取,坏数据必须降级成默认值,而不是抛异常。
08运行时管线Frame Pipeline
壁纸是常驻进程,所以每一帧都要有预算。下面是 60 fps(16.6 ms)下的分配,以及 30 fps 上限档(33.3 ms)的余量。
| 阶段 | 做什么 | 60fps 预算 | 超支后的动作 |
|---|---|---|---|
| 0 · lifecycle | 暂停/恢复、可见性、切屏 | 0.1 ms | — |
| 1 · advance | s += v·dt,取弧长点与切线 | 0.1 ms | — |
| 2 · camera | 机位求解 + 阻尼插值 | 0.3 ms | 降阻尼 → 直跟 |
| 3 · cull | 可见环窗口(前后 60 m) | 0.3 ms | 窗口缩到 40 m |
| 4 · tube | 环形几何绘制 / 实例化 | 4.5 ms | 环距 ×1.6 |
| 5 · rider | 姿态求解 + 侧倾 | 0.4 ms | 固定姿态 |
| 6 · light & fog | 灯带、天光、体积雾 | 2.5 ms | 雾改屏幕空间近似 |
| 7 · post | 颗粒 + 暗角 + 接缝过曝 | 1.2 ms | 颗粒关 |
| 8 · headroom | 留给宿主与 GC | 7.2 ms | — |
主循环(伪代码)
function frame(now) {
dt = min((now - last) / 1000, 0.05); // 夹住 dt:切回前台不会瞬移
last = now;
if (paused) { requestAnimationFrame(frame); return; }
s = (s + speed * dt) % loop.length; // ← 无限的核心只有这一行
if (s < prevS) flash.trigger(); // 跨过接缝:过曝掩体
prevS = s;
camera.solve(s, dt);
tube.beginFrame(s); // 只更新可见环窗口
rider.pose(s, curvature(s + 6)); // 预读前方 6 m 的曲率做侧倾
lights.update(s, tSlow);
atmosphere.update(s, tSlow);
budget.sample(dt); // 滚动平均 → 触发降级阶梯
renderer.render();
requestAnimationFrame(frame);
}
接缝掩体:三层同周期 + 一次过曝
- 几何同周期——路径闭合,环窗口按
s % length取,第 0 环与第 N 环是同一个环。 - 贴图同周期——UV 用弧长归一化,
u = s / length,保证接缝处纹理连续。 - 灯光同周期——灯带间距必须能整除周长:
length / spacing取整后回写spacing,否则接缝处会错半个灯。 - 过曝掩体——第 0 米处放一个「洞口」,跨过时 0.42 s 过曝。这是主动掩盖,不是被动对齐:允许 1 px 的错位,因为没人能在全白的一瞬间看见它。
为什么灯距要整除周长:295 m / 9 m = 32.8,不整除。运行时会把 spacing 改成 length / round(length/spacing) = 295/33 ≈ 8.94 m。差 6 cm,肉眼不可见,但接缝处不会出现半盏灯。
09关键算法Core Algorithms
9.1 弧长参数化(速度均匀的唯一步骤)
直接对参数 u 线性推进,速度会忽快忽慢,闭环处最明显。必须先建一张弧长表,再按米取点。
// 一次构建,之后每帧 O(1)
const N = 4096, pts = [], cum = [0];
for (let i = 0; i <= N; i++) pts.push(pathAt(i / N * TAU));
for (let i = 1; i <= N; i++) cum[i] = cum[i - 1] + dist(pts[i - 1], pts[i]);
const total = cum[N];
// 均匀重采样成 0.5 m 一格,得到 pos[] 与 tan[]
const step = 0.5, M = round(total / step);
for (let k = 0; k < M; k++) { // 二分查找 u,线性插值
const u = uAtLength(k * step);
pos[k] = pathAt(u);
tan[k] = normalize(dlengthAt(u));
}
9.2 重力对齐标架(镜头不歪的关键)
function frameAt(T) { // T = 单位切线
let U = sub([0, 1, 0], scale(T, T[1])); // 世界上向剔除切向分量
if (len(U) < 1e-3) U = [0, 0, 1]; // 竖直段退化保护
U = normalize(U);
const R = normalize(cross(U, T)); // 右
return [R, cross(T, R)]; // 右, 上
}
9.3 马蹄形截面(拱 + 平路面)
function sectionAt(deg) {
if (deg >= 225 && deg <= 315) { // 底部 90° 压成弦,就是路面
const t = (deg - 225) / 90;
return [W_FLOOR * (-1 + 2 * t), FLOORY];
}
const a = deg * Math.PI / 180;
return [RAD * Math.cos(a), RAD * Math.sin(a)];
}
9.4 曲率 → 侧倾(姿态可信的全部秘密)
滑手不需要骨骼动画,只需要三件事:膝盖随节奏微屈、身体压向弯心、板面随坡度俯仰。曲率从前方 6 m 预读,避免「先歪后弯」。
const kappa = curvatureAt(s + 6); // 1/m,带符号
const lean = clamp(kappa * speed² * gain, -MAX, MAX); // 向心加速度 → 侧倾角
const bob = Math.sin(t * bobFreq) * bobAmp; // 呼吸/蹬地节奏
const pitch = -slopeAt(s) * pitchGain; // 上坡抬板头
rider.rotation.set(pitch, yaw(s), lean);
rider.knees(crouch + bob); // 只有一个自由度
为什么这两个公式够用:在 100 px 高的背影上,人眼能分辨的信息只有「重心高低、朝向、板的角度」。这三个量恰好都有物理来源(曲率、坡度、节奏),所以看起来「像真的在滑」,而不像在飘。
9.5 确定性随机(每圈必须一模一样)
墙上的装饰、裂缝、涂鸦位置如果用 Math.random(),每圈都会变——那就不是闭环了。所有装饰的随机种子 = 环索引。
function rng(seed) { return () => (seed = (seed * 1664525 + 1013904223) >>> 0) / 4294967296; }
const r = rng(ringIndex * 7919); // 第 7 环永远长在同一个位置
10内容管线Content Pipeline
你的强项是「出图 + 分镜」,这个项目要把它接上 3D。接法不是从零建模,而是用图定调,用代码造形。
-
出 12 张氛围图,只选 1 张当锚定帧
用你现有的出图流程(超分、统一色调)跑 12 张隧道氛围稿,只挑一张作为「色彩与光的宪法」。其余 11 张的价值是排除法。
-
从那张图里只提取 5 个值
主色、辅色、暗部色、雾色、高光色。写进
palette字段。图的其余信息一律不追——纹理靠程序生成,形状靠代码。 -
隧道由代码生成,只做贴图
管壁、拱肋、路面全部程序化。唯一需要的外部资产是一张 512×512 可平铺噪声,用来打破 CG 的均匀感。这是整个项目里最省成本的决定。
-
滑手用「低模 + 剪影」,不从零绑定
一个 8k 面的基础人形,摆出一个滑行基准姿势,压成纯黑材质,加 1 px 边缘光。不做绑定、不做动画——姿态由 9.4 的三个公式驱动。
-
预设化,然后批量出缩略图
每套预设自动抓
t=0.2的一帧生成thumbnail.jpg,保证商店页风格统一。这一步必须自动化,否则做十套预设会崩。
资产预算
| 资产 | 规格 | 体积 | 备注 |
|---|---|---|---|
| 滑手 GLB | ≤ 8k 三角面,单网格,单材质 | ≤ 400 KB | 剪影不需要法线细节 |
| 墙面噪声 | 512²,可平铺,灰度 | ≤ 180 KB | PNG-8 足够 |
| 颗粒噪声 | 128²,程序生成 | 0 KB | 运行时用 canvas 生成 |
| 预设 JSON | 3 套 | ≤ 6 KB | 人可读、可手改 |
| 音频(v1.2) | 1 条 8 s 循环环境音 | ≤ 900 KB | 默认静音 |
命名规范
- 预设:
tunnel.<主题>.json,主题用 kebab-case,例:tunnel.sodium-mountain.json。 - 角色:
rider.<风格>.json。 - 版本:
v0.x内部迭代,v1.0起对外;schema与产品版本解耦。 - 构建产物:
无限隧道-<预设>-<分辨率>.png,与你现有文件命名一致。
11平台与分发Platform & Shipping
一份代码,三个宿主。差异集中在一个 200 行以内的适配层里——这也是为什么架构要把平台放在最顶层。
| 项 | Lively Wallpaper | Wallpaper Engine | 浏览器(开发) |
|---|---|---|---|
| 内核 | WebView2(Edge) | CEF(Chromium) | Chrome / Edge |
| 入口 | LivelyInfo.json,Type 1 | project.json,type:"web" | index.html?preset=… |
| 暂停信号 | livelyWallpaperPaused 事件 | wallpaperRegisterAudioListener / 可见性 | visibilitychange |
| 资源协议 | file://(受限) | file://(受限) | file:// 或 http:// |
| 音频 | 默认关闭 | 可读系统音频做可视化 | 需用户手势 |
| 多屏 | 每屏一个实例 | 每屏一个实例 | — |
| 调试 | 打包前必须单文件 | 同左 | 完整 devtools |
file:// 陷阱清单(第一件事就要验证)
| 写法 | 在 file:// 下 | 替代方案 |
|---|---|---|
<script type="module"> | ✕ 被 CORS 拦 | 打成 classic script,或全内联 |
fetch('presets/x.json') | ✕ 常被拦 | 构建期转成 const PRESETS = {…} |
XHR 读本地 .glb | △ 看宿主标志 | 模型转 base64 内联,或改用 <img> 纹理 |
@font-face 本地字体 | △ 部分版本静默失败 | 系统字体栈,或转 woff2 内联 |
| Worker / WASM | ✕ 基本不可用 | v1 不用;全部主线程 |
这不是理论风险。你现有的 巨映山河 能跑,正是因为它是一个内联 <script>、没有 import、没有 fetch。新项目一旦按「现代前端」的习惯写 type="module" + fetch,在 Lively 里就是白屏。M1 的第一个任务不是渲染,是验证这三件事。
分辨率与宽高比
- 垂直 FOV 锁定:不管 16:9 还是 21:9,垂直视角固定 56°,超宽屏自然获得更多左右(隧道壁),不会把人物拉变形。
- 21:9 / 32:9:人物锚点从
0.56W右移到0.62W,避免在超宽屏上正中悬空。 - 竖屏 / 双屏:竖屏时把机位抬高、FOV 收窄;双屏时两台实例相位错开
length/2,避免两个屏完全同步(同步会显得假)。 - 4K:
dpr上限 1.5,几何不变,只提采样;4K 下强制 30 fps 上限。
12性能预算Performance
3D 壁纸的成本和 2D 不是一个量级:你现在这版 巨映山河 是一张图加 canvas 调度,几乎不占 GPU;3D 是常驻渲染。所以预算必须写死在验收标准里,而不是「跑起来看看」。
| 指标 | 目标(1440p) | 红线 | 监测方式 |
|---|---|---|---|
| 帧率 | 60 fps(上限 30 fps 可配) | ≥ 30 fps | 滚动 60 帧平均 |
| 单帧 GPU | ≤ 6 ms | ≤ 12 ms | EXT_disjoint_timer_query |
| 单帧 CPU | ≤ 8 ms | ≤ 14 ms | performance.now 分段 |
| 三角面 | ≤ 120 k | ≤ 200 k | renderer.info |
| Draw call | ≤ 45 | ≤ 80 | renderer.info |
| 显存 / 内存 | ≤ 220 MB / 180 MB | ≤ 320 MB | 任务管理器 + 8 h 采样 |
| 冷启动 | ≤ 1.5 s | ≤ 3 s | 首帧时间戳 |
| 稳态 CPU 占用 | ≤ 8% | ≤ 15% | 挂机 30 min 采样 |
降级阶梯(自动,逐级下探,不回弹)
Q0 · 满配
dpr 1.5 · 环距 1.5 m · 尘埃 60 · 颗粒开 · 体积雾
帧时 < 12 ms 时保持
Q1 · 轻降
dpr 1.25 · 环距 2.0 m · 尘埃 30
帧时 > 12 ms 触发
Q2 · 中降
dpr 1.0 · 环距 2.5 m · 尘埃关 · 雾改屏幕空间近似
帧时 > 16 ms 触发
Q3 · 保命
dpr 0.75 · 环距 3.5 m · 30 fps 上限 · 颗粒关
帧时 > 22 ms 触发
降级只降不升是有意的:反复横跳比一直低画质更难受,而且会让 GPU 占用震荡。每 10 分钟允许尝试回升一级,失败就锁定。
与现有 2D 壁纸的成本对照
| 巨映山河 · 渡口(2D) | 无限隧道(3D) | |
|---|---|---|
| 资产 | 1 张 5 MB 底图 | 1 个 GLB + 1 张噪声 + 3 个 JSON |
| 每帧绘制 | 1 次 drawImage + 若干渐变 | 约 40 次 draw call |
| GPU 占用 | ≈ 0 | 2–6 ms |
| 换风格成本 | 重新出图(小时级) | 改 JSON(分钟级) |
| 能否交互 | 能(已做双击) | 能,但 v1 刻意不做 |
| 风险 | 低 | 中(发热、驱动差异) |
13里程碑与判死门Milestones & Gates
五个阶段,总共约五周(业余时间)。每个阶段末尾有一个判死门:不通过就回到上一阶段,而不是「先做完再看」。这是防止两周做出一个不好看的东西的唯一办法。
判死门怎么用:不过门就不进入下一阶段,先修当前阶段。M0 不过(静帧不好看)→ 不做 3D;M1 不过(跑不到 30 fps)→ 退回「预渲染环 + 2D 视差」,那是你已经有能力交付的形态;M2 不过(人看不出在滑板)→ 把角色改成纯剪影+速度拖影,放弃可识别性。
14风险矩阵Risk Matrix
| 风险 | 概率 | 影响 | 缓解 | 预警信号 |
|---|---|---|---|---|
| 滑手「在飘」 | 高 | 高 | 剪影 + 程序化姿态(曲率驱动侧倾);先做 M2 盲测再投入 | 自己看 30 秒觉得假 |
| file:// 白屏 | 中 | 致命 | 单文件 classic script;M1 第一天先验证 import/fetch/GLB 三件事 | Lively 导入后全黑 |
| 发热与掉帧 | 高 | 中 | 30 fps 上限 + 降级阶梯 + 全屏独占时暂停 | 风扇起飞、笔记本烫手 |
| 接缝被看出来 | 中 | 高 | 几何/贴图/灯光三同周期 + 洞口过曝掩体 | 盯着某个灯看两圈能对上 |
| 审美疲劳 | 高 | 中 | 18 min 大周期 + 3–7 min 微事件 + 8 h 天光漂移 | 自己挂一天没发现任何变化 |
| 范围膨胀 | 高 | 高 | 「不做什么」清单写死;每个阶段只有一个判死门 | 开始想加玩法、加角色、加剧情 |
| 模型版权 | 低 | 高 | 只用自制或明确可商用的低模;剪影本身就规避了大部分相似性 | 找不到可商用滑板模型 |
| 商店审核/分发 | 低 | 中 | 先本地分发(直接给文件夹),上架作为可选步骤 | — |
15验收清单Acceptance
每一条都必须能当场演示,不允许「大概可以」。
- 无缝:连续观察 40 分钟,指出循环接缝的具体秒数——做不到即通过。
- 姿态:截取 5 张不同弯道的静帧,滑手重心方向与弯心方向一致。
- 尺度:人物身高与隧道净高比例在 1:3.2 ± 0.2 之间(一眼不像玩具)。
- 可读性:叠加 20 个 32 px 桌面图标后,图标识别时间 < 1.2 s。
- 切换:三套预设切换均 < 1 s,且切换瞬间不闪黑、不重建曲线。
- 性能:1440p 下稳态 ≥ 30 fps,挂机 30 min 后帧率不低于首帧的 90%。
- 长时:挂机 8 h 不崩、不内存泄漏(显存增长 < 30 MB)。
- 宿主机:Lively 与 Wallpaper Engine 均可安装、可暂停、可恢复。
- 单文件:
dist/index.html双击即可运行,不依赖本地服务器。 - 降级:手动把帧率压到 20 fps,能观测到 Q1→Q3 的自动降级。
16路线图Roadmap
v1 是「一条隧道做得足够好」,v2 才是「很多条隧道」。顺序不能反——系列化的前提是第一个能挂住。
钠灯山体 / 冷白管廊 / 霓虹下穿。双平台可装,缩略图自动化。这是「可以给别人看」的第一个版本。
18 分钟大周期、微事件剧本、可选环境音(默认静音)。这一步决定它能不能被挂一个月。
让用户改三件事:灯色、灯距、坡度。不做曲线编辑器——那会毁掉美术下限。改完可导出成 JSON 分享。
换标架(RMF)、换介质(水)、换生物(鱼群剪影)。技术复用 80%,是验证「引擎可系列化」的关键一步。
废弃矿道 / 极地管线 / 太空环。做成「卷」的合集(Vol.1–3),Wallpaper Engine 上架 + 本地直发双轨。
收入模型(如果要做):不卖单张,卖「卷」。一卷 = 3 套隧道 + 1 套角色轮廓,定价按壁纸引擎的常规区间。真正的长期价值是 v1.5 的自定义导出——用户生成的预设会变成免费的内容更新。
17附录Appendix
v0.1 → v1.1 变更记录
| v0.1 写的 | v1.1 改成 | 为什么 |
|---|---|---|
| 「角色切换」与「隧道切换」并列两个维度 | 隧道为主轴,角色降级为「轮廓皮肤」 | 两者成本差一个数量级,并列会误导排期 |
| MVP:两套角色 + 两套隧道 + Lively 导入 | M0 只做一条曲线、一个剪影、一套预设 | 先验证构图,再验证功能 |
| 验收:「20–30 秒无明显接缝」 | 验收:「40 分钟看不出重复」 | 壁纸的时间尺度是小时 |
| 未提美术设定 | 三张锚定帧 + 八条可量化硬约束 | 壁纸是被看的,不是被跑的 |
| 未提分发 | Lively + Wallpaper Engine 双发,一份 build | 边际成本几乎为零,市场大一个量级 |
| 技术栈未约束打包方式 | 单文件 classic script,禁用 module/fetch | file:// 下的真实约束 |
| 「可选神秘感」若干条 | 18 min / 8 h 三层时间 + 微事件剧本 | 把「神秘感」变成可排期的功能 |
| 风险:5 条定性描述 | 风险矩阵:概率/影响/缓解/预警信号 | 风险要能触发行动,不是罗列 |
术语
| 词 | 含义 |
|---|---|
| 闭环 / 主环 | 首尾相接的中心线,走完一圈回到原点,是「无限」的数学来源 |
| 弧长参数化 | 按米推进而不是按参数推进,保证速度均匀 |
| 重力对齐标架 | 让路面永远水平、镜头永远不歪的局部坐标系 |
| 接缝掩体 | 用一个自然事件(出洞口过曝)主动掩盖循环接缝 |
| 判死门 | 每个阶段末尾的硬性验收,不过不进入下一阶段 |
| 降级阶梯 | 按帧时自动降低画质,只降不升 |
| 三同周期 | 几何、贴图 UV、灯距都必须与周长整除,否则接缝会错位 |