【2026 最新】CCORE GLB-3D-Coder 教學：Q4 出錯怎麼查？從完整 HTML 到 Godot 驗收

你下載了小模型，輸入「做一張低多邊形工作桌」，結果收到一大段文字，卻找不到 3D 檔。這篇 CCORE GLB-3D-Coder 教學從這個卡點開始：先辨認模型交出的東西，再找出哪一段出了錯，最後把道具送進 Godot。

本文專為剛接觸 AI 3D 資產的新手寫。你會學會保存完整 HTML、安排 Q4／Q8 同條件對照，並檢查尺寸、材質與節點。這是一套依官方文件整理的操作與驗收方法，文中的工作桌是練習需求，未填入 AlphaLab 的模型生成成績。

先說結論：可用道具＝完整程式＋正確幾何＋匯入驗收

模型寫的是「做道具的食譜」，瀏覽器才把食譜煮成可匯出的 3D 資產。截至 2026 年 11 月 10 日，官方模型卡將它定位為以 Qwen3.5-4B 微調的低多邊形資產程式模型，產生帶預覽及 Export GLB 按鈕的 Three.js HTML。GLB 是二進位 glTF 容器，可承載網格、材質、節點與動畫；檔案格式的背景可讀 glTF 簡介。

先把故障分四層：文字沒寫完、網頁沒跑起來、幾何做錯、匯入結果不符需求。從第一個失敗的關卡往回修，比一看到白畫面就換模型更容易找到原因。

一、CCORE GLB-3D-Coder 教學：先固定版本與生成條件

1. 檔名一樣，真的是同一版嗎？

用版本紀錄辨認權重。官方特別要求，2026 年 11 月 5 日以前下載的檔案須重新下載，因為 GGUF 檔名未改。先備份自己的紀錄，再依模型卡更新；記下儲存庫 revision、檔名、下載日期與檔案 SHA-256。這次查核的模型倉庫 revision 為 8f32a199f8b22fe3157b9c5c8b42b052a0750dd3，它代表倉庫快照，並非另一個模型產品名稱。

在支援 Qwen3.5 的執行器，例如 LM Studio，搜尋完整名稱 ccore/Qwen3.5-4B-GLB-3D-Coder，先載入一種 GGUF。Q4_K_M 與 Q8_0 是兩份不同量化檔；量化像把數字用較短的刻度保存，下載容量和執行品質都值得分開檢查。不要只核對「4B」就把舊版、不同模板或不同量化混在一起。

2. 為什麼等很久，還只有半份 HTML？

先讓思考與答案有完成空間。模型卡目前建議 thinking 開啟，不另設思考 effort 或 thinking-token 上限；最大輸出在支援時使用 unlimited／-1。這個數值是模型卡針對相容執行器的建議，不能照抄到任意 API 欄位。LM Studio 參數文件可用來核對你所用介面的設定方式。

作者說明，8K 輸出上限可能在思考或 HTML 完成前停下；這是作者的使用建議，不是每份資產固定需要多少 Token 的承諾。取消輸出上限後，context、記憶體與執行器限制仍存在。先確認設備能載入，再一次只生成一件簡單物件；遇到資源不足，先縮小需求並保留停止原因。

把模型卡的 System prompt 複製進系統提示欄，英文原文如下。它約定了完整 HTML、預覽、GLB 匯出及按需求加入動畫；使用者需求另放一般訊息欄，別把兩者合成一句短提示。

Create game assets for the Godot editor, which uses GLB files. Create whatever the user requests as a good-quality low-poly asset using only Three.js in one complete standalone HTML file. The HTML must show the asset and include an Export GLB button that downloads a working GLB. If the requested asset needs animation, add it and include the animation in the exported GLB; otherwise make it static.

二、做一張工作桌：先寫驗收，再比較 Q4／Q8

先把成功條件寫清楚：桌面、四支桌腳、小提燈，靜態、底部落在地面，總高度以一公尺作為練習目標。複雜角色有太多關節，一開始就拿來比較，很難分辨到底是哪個零件失敗。

可貼上的練習需求：Create a low-poly wooden workbench with four legs and one small lantern on top. Keep it static. Use simple solid-color materials, no external models or textures. Make the total asset height 1 meter, with its bottom at y=0 and its front facing +Z. Put all asset parts in one Group named asset, keep preview lights and the floor outside that group, and expose it as window.__ASSET__. Include an Export GLB button that exports only the asset group.

這是本文設計的測試規格，不是已驗收成品。作者的展示專案起始提示也採用獨立 asset 群組、保存原始回應、修正後另存與資產驗證的流程。展示專案的 top_p 寫為 0.9，目前模型卡則列 0.95；本篇以後者作起點，避免混用兩份配置。

3. 怎麼比較，才知道差異在哪裡？

同題配對，一次換一個條件。Q4 跑完並保存原始輸出，再載入同一發布版本的 Q8，用相同 system prompt、需求、模板、thinking、context 與取樣設定重跑。執行器支援時記下並固定 seed；同 seed 仍不表示跨量化逐字一致。不要一邊換 Q8，一邊改提示或提高輸出上限，否則很難歸因。

• 每次建立獨立資料夾，例如 workbench-q4-run01，保存需求、設定、權重雜湊、完整回應與 original.html。
• 記下是否自然結束、輸出限制、總等待時間、Console 第一個錯誤，以及四層關卡各自通過或失敗。
• 修正另存 patched.html 並記差異；原始版失敗仍算失敗，別讓人工修好後的圖蓋掉紀錄。

社群原始討論中有一位使用者自述，六次 Q4 嘗試遇到程式或變換問題，作者追問版本與條件以便重現。這是單一使用者的回報，不足以估計整體失敗率，也不足以證明換 Q8 必然成功。配對紀錄的目的，是找出你這一件道具在哪層卡住。

三、CCORE GLB-3D-Coder 教學：四層排錯依序走

4. 第一層：「食譜有沒有寫完？」

保存最終答案中的完整 HTML。保留原始回應，再把 HTML 程式區塊另存為 original.html；不要把 Markdown 圍欄或思考內容一起存進網頁。檢查開頭、結尾、script 區塊與匯出事件是否完整，並回查執行器的停止原因。看到 </html> 只是線索，仍需下一層執行驗證。

若因輸出上限中止，先依目前設備調整預算或縮小物件再生成。直接替半份程式補一個結尾，可能只讓它看起來像完整檔案；尚未產出的幾何與匯出邏輯仍需補齊。可觀察的通過條件，是生成正常結束，而且完整頁面能進入執行檢查。

5. 第二層：「瀏覽器有沒有煮起來？」

先看 Console 與 Network。在瀏覽器開啟開發者工具，查看第一個 JavaScript 錯誤及模組請求狀態。語法錯誤、找不到識別字、CDN 載入失敗、版本混用，要分別記錄。白畫面本身不能告訴你是哪一種。模型卡也提醒，HTML 可能從 CDN 讀取 Three.js 與附加模組。

第一次打開前，先檢查 HTML 的外部網址與腳本，在不含私人資料的獨立瀏覽器環境開啟，不授予額外檔案權限。若模組因本機檔案開啟方式受阻，而電腦已有 Python 3，可在只放本次 HTML 的資料夾依 Python 官方本機伺服器說明執行 python3 -m http.server 8000 --bind 127.0.0.1，再開 http://127.0.0.1:8000/original.html。用完按 Ctrl+C 停止；這是提供本機網頁的方法，不會修正語法錯誤。

Three.js 官方安裝說明提醒核心與 addons 使用相同版本、相同 CDN。修改時釘住同一版，再看第一個錯誤是否消失、場景與匯出按鈕是否都能運作。一次修一項，才知道修到了哪裡。

6. 第三層：「桌腳真的接在桌面上嗎？」

分開看物件階層與座標。從正面、側面、上方旋轉檢查：四支腳是否落地、提燈是否漂浮、背面是否缺面。把群組想成一個托盤：子物件的位置相對托盤，移動父群組會一起影響孩子。若先旋轉父層、又把子層當世界座標擺放，就可能出現方向或位置不符預期的結果。

對照程式中的 position、rotation、scale 與 add() 關係。瀏覽器整個場景還含預覽燈、地板與相機；匯出目標應核對為道具群組，避免把展示台當成作品的一部分。這一關的通過標準是物件結構符合需求，單純 Console 安靜仍不夠。

7. 第四層：「GLB 裡面裝了什麼？」

核對匯出器的輸入與選項。依 GLTFExporter 官方文件，binary: true 用來輸出二進位 GLB，animations 選項用來提供要匯出的 AnimationClip。先確認按鈕實際下載檔案，再驗證網格、材質與節點。預覽中用每幀改 rotation 的動作，不應直接當成已匯出的動畫軌。

這次工作桌先保持靜態。要加旋轉提燈時，另開一輪需求，明確指定動作、樞軸與匯出動畫；再到 Godot 檢查是否有對應動畫及正確播放。作者模型卡也明確要求逐件檢查動畫是否隨 GLB 帶出。

四、匯入 Godot：用五項條件驗收作品

把下載的 workbench.glb 放進 Godot 專案資料夾。依 Godot 匯入設定文件，在 FileSystem 點選檔案可查看 Import；雙擊可開 Advanced Import Settings，預覽模型與動畫。確認後把資產拖入場景，另存自己的場景與遊戲邏輯，保留原始 GLB 方便重新匯入。

• 尺寸：以一公尺參考物核對練習規格，檢查根節點與子節點是否重複縮放；大小不對先追來源與匯入比例。
• 方向與原點：底部是否在地面，前方是否符合需求。Godot 官方方向慣例區分相機看向 −Z 與模型正面 +Z，別因兩個「前方」不同而多轉一次。
• 材質：檢查木頭、金屬與透明部件，分清材質數值和場景燈光造成的差異。先用簡單實色，降低排錯變數。
• 節點：桌面、腳與提燈能否辨認，是否夾帶預覽地板，相對位置是否保留。
• 動畫：靜態練習核對靜止狀態；有動畫的版本則檢查動畫清單、軌道目標、樞軸及播放結果。

一個能顯示的 GLB，與一個適合遊戲的道具還差驗收。碰撞、互動腳本與你的效能預算，也要按專案需求加入；這次先交付外觀、尺寸、結構合格的靜態資產，不把完整遊戲系統塞進首輪生成。

五、常見問題：先下判斷，再決定下一步

1. 模型回答 HTML，代表下載錯了嗎？

不一定。這個模型的預期輸出就是建立幾何及匯出 GLB 的 HTML／JavaScript；先核對完整模型名稱與模型卡。

2. Q4 出錯就直接改 Q8 嗎？

先分層。截斷、模組載入與幾何錯誤的處理不同。保存 Q4 原始版，再用同條件 Q8 對照，才能判讀這次差異。

3. unlimited 代表不需要管記憶體嗎？

不是。取消生成上限，仍受 context 與資源限制；先確認載入及生成條件，別把 −1 當成無限硬體。

4. 看到結尾標籤，就算 HTML 合格嗎？

還不算。繼續檢查瀏覽器執行、按鈕匯出與 Godot 匯入；文字完整只是第一關。

5. 瀏覽器好看，Godot 也會一樣嗎？

不一定。官方模型卡提醒材質、燈光和動畫可有差異，應在實際使用的場景檢查。

6. 為何轉動父節點，桌腳也跟著跑？

這是階層變換的結果。先確認桌腳是否在正確父群組、使用哪個局部座標，再調整位置與旋轉。

7. 網頁在轉，代表 GLB 有動畫嗎？

還需檢查。匯出器需取得動畫資料；下載後再看 Godot 的動畫清單與播放結果。

8. 新手第一件作品選什麼？

選簡單靜態道具。先讓工作桌依四層檢查通過，再加透明材質、活動零件或角色，逐步增加變數。

給新手的三個重點

• 先保存版本與完整回應，才有比較的起點。
• 先找第一個失敗關卡，再決定調整輸出、程式或幾何。
• 以 Godot 裡的交件條件收尾，別讓漂亮縮圖代替作品驗收。