在浏览器里建一座桃花源

💡 原文中文,约6000字,阅读约需15分钟。
📝

内容提要

作者开源了一个基于《桃花源记》的浏览器水墨青绿3D世界,纯静态无后端,支持桌面与手机。项目以陶渊明原文为核心,设三幕叙事与自由闲居,刻意去除体力、背包、经验条等游戏化压力。世界包含800×800地形、六大圈层、四时十二时辰与天气联动,采用低多边形、顶点色和极简光照。工程上仅依赖Three.js,注重合批、LOD与性能,附93项回归测试,并以MIT许可开源。

🔎

延伸解读

“去游戏化”设计如何落地

文章明确将“没有体力、饥饿、背包合成与买卖、经验值与百分比收集焦虑条”写入负面红线,并取消头顶感叹号和强制引导弹窗。这并非简单删减 UI,而是用三幕叙事闭环(15–25 分钟)和随时可搁置的闲居模式替代任务驱动。对想借鉴的开发者而言,关键启示是:先定义“不做什么”,再围绕它设计交互与反馈,避免传统游戏套路回潮。

视觉契约与性能预算的取舍

项目禁用 PBR 材质、点光源和全局阴影,仅保留 1 个方向光与 1 个半球光,所有造型采用低多边形 flatShading 加顶点色。这种克制既服务于水墨青绿风格,也直接降低渲染开销。文章给出明确预算:桌面 1080p 稳定 ≥60fps、同屏 draw calls <260,移动端 30–45fps。对同类 Web 3D 项目,先锁定视觉边界再谈优化,比事后堆后处理更可控。

AI 长期协作的工程规矩

作者开源了 PROJECT_BRIEF.md 与 PROMPTS.md,并总结两条经验:不要锁死文件字节,否则 AI 会在别处硬编码覆盖或挂“寄生字段”;应改用 93 项 npm test 锁死行为与几何契约。新增区域需走“九件套”接入流程,少一环就会穿帮。此外,无头浏览器的 SwiftShader 只能验证几何与合批,不能当作真机 GPU 帧率。这些规矩对多轮 AI 协作的大世界项目有直接参考价值。

❓

Q&A

这个浏览器里的《桃花源记》3D 世界是什么?怎么访问?

这是一个基于陶渊明《桃花源记》的浏览器水墨青绿 3D 活态世界,纯静态构建、无后端、无运行时外部请求,桌面键鼠和手机触屏都能用。在线体验主站为 taohuayuan.fomal.cc(Vercel 自动部署),备用域名 taohuayuan.fomal.cn,GitHub Pages 镜像为 github.fomal.cc/taohuayuan。代码以 MIT 许可开源,仓库地址 github.com/fomalhaut1998/taohuayuan。

这个桃花源世界为什么刻意不做体力条、背包、经验值这些游戏化设计?

作者认为陶渊明《桃花源记》最打动人的恰恰是没有紧迫感,渔人只是忘路之远近、忽逢桃花林,并无任务压力。因此项目把体验拆成双层节奏:15–25 分钟可走完的三幕叙事闭环,以及随时可搁置主线的桃源闲居。同时死守负面红线:没有体力、饥饿、背包合成与买卖、经验值与百分比收集焦虑条,也没有头顶感叹号和强行打断视角的引导弹窗。

游戏里的四时、十二时辰和天气是怎么联动的?

整座山谷挂在东晋太元十一年(公元 386 年)二十四节气公历时钟上,与十二时辰(晨/昼/暮/夜)、四候(春深落英/夏初新荷/秋熟金粟/冬寂薄雪)以及四态天气(晴/雨/雾/冬雪)连续联动。冬候不是简单改雾色:进冬后地面渐进积雪、池溪边缘结岸冰、舆图换雪韵底色、雪地留足迹、晴天正午屋檐滴化雪水;切回春候时所有顶点色、实例色和显隐状态逐字节无损还原。

这个 3D 世界的地形有多大?分为哪些区域?

整张地形为 800×800,共 24 处 POI、20 个命名分区,并配有探索迷雾舆图(走过的地方才逐片揭晓)。按地理纵深分为六个圈层:武陵溪口与外郊(浅滩、桃花夹岸、渡口芦苇)、山口一线天(窄峡山洞与微光洞口,兼做声学与视野门户)、核心村落与良田美池(农耕家宅、桑竹、水碓、六博案几、大池与木桥)、谷地边野(观云亭、晒秋坪、避秦残碑、牧羊坡、望稼楼、三叠泉、药庐茶灶)、外山秘境与深坳幽壑(烂柯石枰、古窑、鹿柴望川台、松风茶寮、云樵茅舍、冷泉幽轩等),以及散落山野角落的 7 处隐秘风景与彩蛋。

这个项目在美术和声音上是怎么保持水墨青绿风格的?

美术上定了严格的视觉契约:禁写实、禁 PBR,禁用 MeshStandardMaterial/MeshPhysicalMaterial、粗糙度/法线/金属度贴图、照片级位图、PointLight/SpotLight 和全局 shadowMap,也不用全屏后处理滤镜。母本色板为宣纸 #F2EAD9、墨 #262626、桃花 #E8A0A8、青绿 #7BA05B 等;所有 3D 造型用低多边形 flatShading + 顶点色,全场景核心照明仅 1 DirectionalLight + 1 HemisphereLight。声音上走“大音希声”路线:原生 Web Audio 空间混音,进山洞触发洞门声学遮蔽,远处声音按距离空气吸收,脚步声随材质切换,仅叠约 0.36 MiB 本地短采样,留白稀疏、不吵闹,也不发任何外部音频或在线 TTS 请求。

这个项目在工程性能上做了哪些优化?运行时依赖什么?

运行时只依赖 Three.js(ES Modules),构建用 Vite 6,不引 React Three Fiber 或第三方物理引擎。优化包括:桃林、竹林、芦苇、落英雪片、群鱼飞鸟等全走 InstancedMesh 批次合并,社区村民收进共享合批池,远景 LOD 减面约 73%–81%;ground-surface.js 用 8m 空间网格加速地表查询;山口一线天充当 Portal Culling 边界;每帧 update 循环禁止新建临时对象以避免 GC 抖动。性能预算为桌面 1080p 稳定 ≥60fps、同屏 draw calls <260,集显轻薄本 ≥55fps,移动端 30–45fps 并动态封顶 DPR ≤1.5。另有 93 项自动化回归检查(npm test)覆盖几何完整性、合批、碰撞安全、音频许可与热路径分配规则。

作者开源了哪些跟 AI 协作开发 3D 世界的经验?

作者在仓库根目录放出了 PROJECT_BRIEF.md(世界契约 v3.0)和 PROMPTS.md(提示词模板 v3.0),并总结了几条踩坑规矩:不要锁死文件字节,否则 AI 会在别的模块硬编码覆盖值或挂寄生字段导致架构腐化,正确做法是用 93 项 npm test 锁死行为与几何契约、放开源码正道重构;新区域接入需完成“九件套”(地面高度与材质采样、低障碰撞、天色注册、四候双向还原、静态可见性与 LOD、洞门高空联动、舆图迷雾与图鉴、静听/落座/避雨、画卷题跋识别),少一环就会穿帮;还要分清软件光栅与真机帧率,无头浏览器的 SwiftShader 只能验证几何与合批,不能当作真机 GPU 帧率。

🏷️

标签

➡️

继续阅读