5 步掌握 Qwen3.5-4B-3D-Coder 提示词技巧:Three.js 3D 场景 Prompt 编写完全教程(含 System Prompt)
【免费下载链接】Qwen3.5-4B-3D-Coder项目地址: https://ai.gitcode.com/hf_mirrors/ccore/Qwen3.5-4B-3D-Coder
Qwen3.5-4B-3D-Coder是一款由 CCORE 基于 Qwen3.5-4B 微调的 4B 级小模型,能把自然语言提示词变成可直接运行的 Three.js 交互式 3D 场景——从樱花寺院到体素风发射场。本教程用 5 步带你吃透标准 System Prompt、用户 Prompt 模板和生成参数,新手也能一次生成属于自己的 3D 场景页面。
💡 这是官方标注的 Early preview(早期预览)版本:模型兼顾通用编码与高质量 3D 场景生成,配套训练数据集(4,146 条场景样例)也已开源。
第 1 步:选对模型与生成参数 📦
仓库提供了两种量化的 GGUF 模型文件,可直接导入 LM Studio 或 llama.cpp 等推理框架:
| 文件 | 说明 |
|---|---|
| Qwen3.5-4B-3D-Coder-Q4_K_M.gguf | 体积更小,适合普通显卡 |
| Qwen3.5-4B-3D-Coder-Q8_0.gguf | 精度更高,显存允许时更推荐 |
官方推荐生成参数(两种量化通用,详见 README.md):
| 参数 | 推荐值 |
|---|---|
| Temperature | 0.6–0.8 |
| Top P | 0.90–0.95 |
| Repeat penalty | 1.0 |
| Top K | 20–40 |
⚠️重要:在 LM Studio 中运行时,务必关闭模型的MTP(多 token 预测),否则输出会异常。参见 README.md。
第 2 步:别跳过 System Prompt 🎯
输出稳定的关键,是一段"Three.js 约束"System Prompt。直接把下面这段文字设为系统提示词:
Use only the Three.js core ES module from https://cdnjs.cloudflare.com/ajax/libs/three.js/0.160.0/three.module.min.js. Do not import addons or legacy examples/js paths; implement any camera controls directly inside the HTML.为什么这样写?
- 只用核心 ES 模块:不引入 addons,大幅降低"页面加载后报错跑不起来"的概率;
- 相机控制自己实现:把轨道控制等交互逻辑直接写在 HTML 里,页面真正做到自包含;
- 版本锁定 0.160.0:同一 CDN 来源,行为可复现,方便对比不同生成结果。
System Prompt 原文见 README.md。
第 3 步:掌握用户 Prompt 三段式模板 ✍️
官方示例 Prompt(README.md)全部遵循同一个三段结构,照抄模板即可:
- 任务说明:
Please create one self-contained HTML file with Three.js from cdnjs showing …——明确交付物是一个自包含 HTML; - 场景细节:描述场景里有什么、空间布局、功能分区;
- 渲染风格:
Render it as a deliberate 3D voxel model built from visible cubic blocks, with clear depth, readable silhouettes…——风格要求,可选。
最简单的官方 Prompt 只有一句话,但已经包含第 1、2 段:
Please create one self-contained HTML file with Three.js from cdnjs showing a canal lock and weir complex with a central island.第 3 段的体素风格要求,效果见下图:
第 4 步:像"导演"一样写场景描述 🎬
描述越具体,一次成功率越高。官方"驭龙人巢穴"示例(README.md)就很典型,它示范了三个技巧:
- 用"尺度"引导布局:大象栖息地示例写道
Use the elephant's scale and movement clearance to guide the layout——用主体的尺度锚定整体布局,场景就不会比例失调; - 给明确的空间关系:
Four projecting stone perches ring the central hatchery… switchback stairs connect the perches to a boathouse——ring、connect、between 这类方位词对 3D 布局非常有效; - 动画要明说:塔台示例直接写了
rotating radar、turns continuously,不说明模型不会主动加动画。
第 5 步:迭代打磨,提升一次成功率 🔁
4B 小模型偶尔会翻车,官方的建议很简单:没生成好就再来一次。已观察到的已知问题大多是变量名重复之类的小 bug,少见结构性大错(见 README.md)。
迭代时记住这几条:
- ✅ System Prompt 保持不变,只改用户 Prompt 重新生成;
- ✅ 想要体素风,务必带上 "visible cubic blocks" 风格句;
- ✅ 不需要动画的场景,明确写出不加动画;
- ✅ 两个 GGUF 均已包含 10 月 27 日更新的 checkpoint,一次成功率与场景质量明显提升,下载过旧文件的话请重新下载。
下面是更多用这套 Prompt 方法生成的 Three.js 3D 场景作品:
常见问题速答
Q4_K_M 和 Q8_0 怎么选?同一权重、不同量化:Q8_0 更保真,Q4_K_M 更省资源,生成参数完全相同。
为什么 LM Studio 必须关 MTP?LM Studio 默认开启多 token 预测,该模型不兼容,需在模型设置中手动关闭。
生成的页面能直接运行吗?只要使用了标准 System Prompt,输出就是自包含 HTML 文件,仅依赖 cdnjs 上的 Three.js 核心模块,浏览器打开即可交互。
项目基于 Apache-2.0 协议 开源,训练数据集与完整精度权重、技术报告也已陆续放出。用上面的 5 步方法,你现在就可以开始写自己的第一个 Three.js 3D 场景 Prompt 了 🚀
【免费下载链接】Qwen3.5-4B-3D-Coder项目地址: https://ai.gitcode.com/hf_mirrors/ccore/Qwen3.5-4B-3D-Coder
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考