← Back
alchaincyf

alchaincyf/3d-vibe-coding-handbook

《3D Vibe Coding 手册》配套仓库:书的 HTML 版、demo 源码、工具脚本与资源包索引

View on GitHub ↗https://alchaincyf.github.io/3d-vibe-coding-handbook/ ↗
3dai-3dgltfimage-to-3dorange-bookthree-jstripovibe-coding
Stars
270
Forks
40
Watchers
270
Open issues
0
Contributors
1
Language
HTML
License
—
Default branch
master
Created Sep 13, 2026Updated Sep 15, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

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

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

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