3D Vibe Coding 手册

从一句话到能跑的场景：GPT-6 Astra × Tripo 全流程实测

一个不会写代码的人，怎么用 AI 生成 3D 资产，再把它们真正接进一个能跑的项目。 386 页、25.6 万字、260 张图，六个可玩 demo，所有数字都可核，翻车也没删。

当前版本 v260914c（2026-09-14）。

作者：花叔（AI Native Coder）· 本书是做那座能开车逛的巴黎时的实测记录

---

先读哪一页

你的情况	去哪
没用过图生 3D，想先跑通一次	§01 十分钟跑通第一次图生3D
模型生成出来了，不知道下一步	§03 生成之后
面数太高、想减面	§04 减面与重拓扑
要让角色动起来	§06 绑骨与动画
积分不够用	§07 怎么把积分花在刀刃上
已经动手了，卡在某个具体症状上	附录B 踩坑索引，按症状查，五张表

在线阅读：book/index.html（仓库转公开后可直接用 GitHub Pages 打开） PDF：见 Releases

---

资源包（11 个，按需下载）

不出整包。 冲着绑骨来的人不需要 8K 贴图原档，每个包能单独用，各带 README 和 SHA256。

包	体积	对应章节	内容
01-样例三件套.zip	6.2 MB	§01 §04 §05 §06	三件资产走完「设计图→提示词→GLB」一条链路，含一件带骨骼的。想先看看这条路长什么样，下这个就够。
02-巴黎街景模型-1K.zip	22.8 MB	§16 §17	巴黎那座城的 19 件主资产，1K 贴图档。建筑、车辆、街具，风格成套。
03-巴黎街景-512与植被街具.zip	14.8 MB	§04 §17	同样 19 件的 512 贴图减面版（对照 §04 的减面下限实验），加 6 件植被与街具。
04-游乐设施-8K原档.zip	29.0 MB	§14	6 件游乐设施的 8K 贴图原档，没有压过。想看「默认档到底多大」就下这个。
05-绑骨与动画.zip	4.0 MB	§06 §15	带骨骼和行走动画的 GLB，加三模式对照那 3 件。§06 整节讲的就是它们怎么来的。
06-设计图与提示词-巴黎.zip	37.0 MB	§08 §09	巴黎两批资产的全部设计图与提示词原文（jobs.jsonl）。
07-设计图与提示词-游乐园与小王子.zip	50.6 MB	§09 §22	游乐设施参考图与小王子星球的输入图，含提示词。
08-demo-巴黎来信.zip	11.9 MB	§12 §18	可驾驶巴黎的程序化城市层参考实现。起个 http 服务打开 index.html。
09-demo-发动机.zip	18.8 MB	§20	单缸四冲程发动机，能拆能转，机构按真实曲柄滑块运动学算。
10-demo-星月夜.zip	33.6 MB	§21	把一幅画拆成五层，两层换成 Tripo 真 3D，可切「全平面／真立体」。
11-工具脚本.zip	0.0 MB	§04 §17	减面极限、批量流水线、GLB 解析与渲图等 11 个脚本，零依赖或只依赖 gltf-transform。

合计 229 MB。第一次来建议先下 01-样例三件套（6 MB），三件资产走完「设计图 → 提示词 → GLB」一条链路。

---

仓库里有什么

book/        手册 HTML 版 + 260 张图
demos/       三个 demo 的源码（GLB 走资源包，代码在这里直接能读）
scripts/     11 个工具脚本：减面极限、批量流水线、GLB 解析与渲图
manifest/    逐件资产清单、分发包索引

关于模型资产

全部由花叔用自己的 Tripo 积分生成。逐件规格（三角面、顶点、贴图档、体积、生成参数、花了多少积分）见手册附录A。

第三方

• Three.js — MIT License，随各 demo 附带许可证全文
• OpenStreetMap — 巴黎 demo 的路网与河道几何源自 OSM 贡献者，按 ODbL 使用；本应用为艺术化改编，不是导航地图
• 巴黎的程序化城市层复用自花叔自己的「巴黎3D地图-202608」项目，各 demo 的 ATTRIBUTION.txt 有完整署名

授权

本作品采用 CC BY-NC-SA 4.0 许可：署名、非商业使用、相同方式共享。

书里的 3D 资产同样按此许可提供，可自由用于学习、练手、非商业项目。 第三方部分（Three.js MIT、OpenStreetMap ODbL）按其自身许可，见上一节。