☰
5 步掌握 Qwen3.5-4B-3D-Coder 提示词技巧:Three.js 3D 场景 Prompt 编写完全教程(含 System Prompt)
2026/11/4 7:09:38 网站建设 项目流程

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):

参数推荐值
Temperature0.6–0.8
Top P0.90–0.95
Repeat penalty1.0
Top K20–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)全部遵循同一个三段结构,照抄模板即可:

  1. 任务说明:Please create one self-contained HTML file with Three.js from cdnjs showing …——明确交付物是一个自包含 HTML;
  2. 场景细节:描述场景里有什么、空间布局、功能分区;
  3. 渲染风格: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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询