作品集 工程记录 01 / 03

三维叙事 · 六章滚动 · 一人 + AI Agent

一塔五境:把 6.9 MB 的不可控,做成可选、可降级、可兜底

按六张设计稿把广州塔做成可滚动的三维叙事。这一页不写「做完多好看」,只写三件事: 动手前我先定下了什么判据、它真的在哪里错过、现在拿什么证明它没再错。

打开作品 →
6章滚动叙事
33 万三角形 / 204 calls
43份探针记录
160 KB弱机静帧兜底

01 交付了什么

先说清边界,再说判断

六个章节、一条连续时间线:滚动进度归一化成 f = scrollY / innerHeight,poseAt(f) 在章内前 54% 保持构图、后段用 smoothstep 过渡到下一章。塔是程序化的 600 米塔体,五段独立 Group(A 0–84 / B 84–334 / C 334–376 / D 376–450 / E 450–488),24 根主柱 × 40 个扭转面板。拆解只移动这五段真实存在的结构,加摩天轮和天线——同一段内部的杆件不假装成独立零件。

入口分成三层:enter.html 先说清「这是什么、要下多少」,点了才加载并显示真实进度;不支持 WebGL2 的机器直接给 160 KB 静帧;3D 是增强项,不是门槛。

02 动手前先写下的判据

这几行写进了 README,后来每一版都按它验

判据怎么测结果
六章能正放、倒放、停在任意一帧 ?ch=2.5 定点截图,逐屏与设计稿比对构图 六章逐屏通过
爆炸必须能归位,来回滚不累计误差 ?drift=1 跑 2.5 → 0 → 2.5 → 3.9 → 2.5,读五段位移 三次读数一致
五段与右侧标签始终对得上 标签按各分段中心投影,SVG 引线连到真实锚点 投影点落在对应分段包围盒内
弱机、老机器、手机都不能白屏 关掉 WebGL2 强制降级;390×844 逐屏截图 静帧兜底正常显示

03 真的错过的四处

每条都按「现象 → 怎么发现的 → 改成什么 → 现在拿什么证明」写

01爆炸越滚越散:来回滚一段比一段远

怎么发现的
用 ?drift=1 做往返读数时,第二次回到中间位置,五段位移比第一次大——不是视觉问题,是数在漂。
改成了什么
不再用「相对位移累加」,改成每段从保存的 baseY 出发、按固定 GAPS=[34,44,54,64,74] 算绝对位置:y = baseY + acc*k。反向滚动走同一条式子,天然原路返回。
现在的证据
漂移序列 2.5 → 0 → 2.5 → 3.9 → 2.5 三次跑读数一致;这行断言留在验收脚本里,改代码就自动重跑。

02章节边界硬切:镜头刚到位,文字已经走了

怎么发现的
逐屏截图时看到章末一帧里,文字已经进下一章、镜头还停在这一章——两边各走各的。
改成了什么
把进度拆成「保持段」和「过渡段」:章内前 0.54 锁死构图,后 0.92 才用 smoothstep 推过去,相机、拆解、云海、城市、桥各自用同一条曲线族。
现在的证据
六章各取章首、章中、章末三帧定格,构图与文案始终同章。

03「看一眼」不是验收——环境里根本看不到图

怎么发现的
无头环境跑起来后,没办法靠肉眼判断渲染对不对;而我最初的标准就是「看起来差不多」。
改成了什么
把审美判断降级成可测问题:平均亮度、亮点占比、6×10 网格分布判断画面是否过暗/空白,OCR 抄回文案验证文字没丢,截图逐张叠对比看偏移。
现在的证据
_check/ 里 43 份探针记录(*3.txt 是每轮定点检查、*5.txt 是复验),每份都带读数而不是「已检查」。

04首屏 6.9 MB,弱机会直接白屏

怎么发现的
手机流量实测:进站到能操作要等十几秒,中途没有任何信息告诉用户「在等什么、还要等多久」。
改成了什么
拆成三个入口:先讲清成本、再加载、加载时给真实进度;不支持 WebGL2 只加载 6 张 webp 静帧(共 160 KB);站点从 358 MB 瘦到 14.6 MB(设计稿与校准截图全部归档)。
现在的证据
弱机路径只请求静帧页;手机端逐屏截图;站点体积表与归档清单写在 README 里。

04 如果给它加一层 AI,我会怎么验收

设计推演 · 未实现 —— 写在这里是因为它决定了「加不加」

设计推演 · 未实现

让模型写章节导语和二级页说明,但五段结构不许它碰

现在六章文案是我写的。换成模型写,判据得先定死,否则「读起来更顺」会悄悄改掉事实:

① 每段只能写该段真实存在的功能(塔顶游乐 / 云端餐饮 / 空中酒廊 / 娱乐体验 / 塔基服务),出现未披露的事实即判错;
② 字数 40–70 字,超出即判错——这一条是为了让模型别把卡片撑破,也顺便防「越写越像广告」;
③ 生成后回到几何里验一遍:标签投影位置必须仍落在对应分段的包围盒内,模型不许改坐标。

最关键的一条是拒答:结构不确定的段落,模型应该输出「未披露」,而不是补一句听着合理的解释。这和看板里「统计局没披露的年份留空」是同一条规矩——缺就缺,不能编。

评测怎么做:拿现在的六章人工文案当基线,同一批结构数据让模型生成 20 版,逐个按上面三条判对错,只统计「事实错」和「越界」两类,不看文采。

05 局限