3D 智慧裝櫃規劃:離線運作、自動配貨與視覺微調

3D 智慧裝櫃規劃:離線運作、自動配貨與視覺微調,AI 生成情境封面

工具實測與開發案例 / 測試日期:2026 年 11 月 19 日 / v2.9

貨物的總體積小於貨櫃,為什麼現場還是裝不下?因為裝櫃還要看尺寸、方向、棧板、疊放與作業先後。這套 3D 智慧裝櫃規劃工具,把庫存清單轉成有座標、有順序、可以旋轉檢查的空間方案,讓規劃人員在搬貨之前,先看見配置。

本文以目前專案的程式、介面與離線操作為依據,介紹已完成的功能和技術架構。所有操作圖均重新載入虛構貨品 DEMO-A、DEMO-B、DEMO-C,未使用企業名稱、真實料號、訂單或客戶案例;封面為 AI 生成情境圖,內文六張圖則是工具的實際截圖與輸出。

去識別化操作總覽,紅框標出貨櫃條件、3D 配貨結果與庫存匯入區
圖 1 從左側設定條件,右側直接檢查配貨結果;點圖可查看原尺寸。

30 秒看重點

  • 一個 HTML 即可離線使用:正式交付檔已內嵌程式、樣式與第三方套件。
  • 條件先設定,配置再計算:支援 SKU 優先順序、合法方向、棧板、疊放、配比與載重條件。
  • 結果可以繼續調整:3D 選取、位移、轉向和復原,搭配整櫃幾何驗證。
  • 成果能交給現場:輸出 Excel、CSV、三視圖 PNG,並以瀏覽器列印另存 PDF。

01把一份庫存,變成一櫃可檢查的方案

這個工具處理的是「從可出貨庫存挑選單櫃配置」。匯入的數量代表可用庫存,系統會建議本櫃選哪些品項、裝多少件,沒有選上的顯示為保留庫存。計算本身不會扣減庫存,也不會自動產生第二個貨櫃。

操作可分成五步:選貨櫃、輸入庫存、計算配貨、人工微調、輸出成果。常用貨櫃提供尺寸預設,也能自行輸入有效內尺寸;長度統一使用 mm,重量使用 kg,統計體積使用 m³,減少資料在表格與畫面之間轉換時的混淆。

工作需求工具如何處理
一次整理多種貨品手動新增或匯入 CSV/Excel,設定 SKU、名稱、長寬高與庫存數量。
規劃整櫃擺放綜合可用尺寸、姿態、間隙、棧板與支撐等條件,為裝載單元產生實際座標。
向不同人員說明3D 圖例以顏色區分 SKU,並同步顯示件數、保留庫存與貨物容積利用率。

02把現場規則寫進資料,配置才有意義

優先順序:先處理閉端,再向櫃門推進

每個 SKU 可以填寫裝櫃優先順序,數值越小越優先,空白排在有填寫的級別之後。同一級別會先利用靠閉端區段的寬度與可疊高度,再往櫃門方向推進。尺寸、支撐、載重及啟用的件數配比仍需符合設定;優先級不會讓原本放不下的貨物變得可行。

另外可選寬度優先、容積優先或同 SKU 集中等排列目標。寬度排得更滿,可能伴隨較少裝載件數,因此規劃人員可以依作業需求比較,而不是只追求一個漂亮的百分比。

虛構貨品 DEMO-A 設定表,紅框圈出優先順序與棧板條件
圖 2 品項規則包括方向、重量、疊放與棧板;點圖可查看原尺寸。

棧板、姿態與疊放限制一起計算

貨品可設定允許平放、側放或立放,並填入棧板高度、自重與每板件數上限。符合條件的品項可開啟同 SKU 整板疊放;禁止上方壓貨或必須落地的品項,也有對應選項。這些設定會影響實際候選方案與最終驗證,不只是表格上的備註。

系統也提供嚴格或彈性的件數配比、最大載重與左右重量平衡。啟用重量條件時,產品與棧板重量需完整;前後重量及重心資訊可供參考,左右平衡設定不代表前後重量必須各半。實際承壓能力與運輸安全仍需另行確認。

人工微調也要重新檢查整櫃

在 3D 畫面點選貨件,或由清單選取,即可按設定步距沿 X、Y、Z 移動、水平轉 90 度或切換合法姿態,也能批次轉向。每次操作會先在複本上嘗試,通過整櫃邊界、碰撞、支撐與疊放規則後才套用;不合法的操作保留原結果。

例如移走底層貨物時,系統會一併檢查原本位於上方的貨物,避免只看被移動的那一件。使用者可以復原上一步,或恢復自動配置,再比較不同擺法。

人工調整控制區,以紅框標示移動、旋轉、切換姿態與驗證提示
圖 3 按鈕微調與復原,讓規劃人員保留判斷空間;點圖可查看原尺寸。

03看見剩餘空間,並輸出可以溝通的成果

只知道還有多少立方公尺,仍無法判斷能否放進另一個箱子。剩餘空間模式把空位分解為互不重疊的長方體區塊,可從 3D 或清單點選,查看編號、長寬高、座標與體積。

剩餘空間模式,以紅色高亮選中區塊並顯示尺寸與座標
圖 4 空間分析讓尺寸與位置變得可見;點圖可查看原尺寸。

幾何空位不等於一定能再裝貨

剩餘空間分析扣除產品、棧板與預留區,但不等於已確認搬運路徑、所有水平間隙、配比與載重。區塊分解也不會列出所有可能跨區塊的大空間,應搭配整櫃條件判讀。

成果輸出控制區,紅框圈出整櫃裝載報告 PDF 與 Excel 清單
圖 5 圖檔、裝載清單與列印選項集中管理;點圖可查看原尺寸。

Excel 與 CSV 可輸出裝載清單、SKU 摘要等資料,包含尺寸、件數、棧板與順序資訊。Excel 的 SKU 欄以文字處理,保留前導零;圖檔則可輸出目前視角,或將整櫃俯視與左右櫃門斜視合成一張 PNG。整櫃報表透過瀏覽器列印,選擇另存 PDF 即可保存。

工具實際產生的俯視與兩個櫃門斜視圖,示範共 146 件、16 板
圖 6 同一份配置輸出成三個視角,方便交接與討論;點圖可查看原尺寸。

04技術架構:模組化開發,單一檔案交付

這個專案採用 HTML、CSS 與原生 JavaScript,核心流程在瀏覽器內執行。開發時拆分畫面、資料轉換、配貨引擎、3D 與輸出模組;交付時再把它們和第三方套件一起合成 HTML。使用者以完整桌面瀏覽器開啟交付檔,不需安裝 Node.js 或 Python,也不需登入或呼叫雲端 API。

全部在使用者的瀏覽器內執行資料輸入與檢查手動表單、CSV/Excel、專案 JSON畫面、狀態與操作協調app.js:計算、取消、選取、復原背景配貨計算Worker+幾何驗證3D 視覺化Three.js+互動選取報表與圖檔Excel、CSV、PNG本機保存:暫存輸入/專案 JSON
圖 7 輸入、計算、視覺化與保存各自分工;箭頭表示主要資料流。
技術/模組在專案中的工作
HTML+CSS
index.html、styles.css
表單、表格、分步工作區與響應式排版。
原生 JavaScript
app.js、feedback-ui.js
畫面狀態、操作事件、取消計算、復原與分析資訊。
配貨引擎
packing-engine.js
合法方向、棧板單元、多策略啟發式搜尋,以及邊界、碰撞和支撐驗證。
Web Worker
Blob 內建腳本
將配貨搜尋移到背景執行緒,回報進度;不支援時採合作式非同步計算。
Three.js+OrbitControls
three-viewer.js
建立 3D 場景、旋轉縮放、貨件選取與高亮,透過 InstancedMesh 減少重複物件的繪製負擔。
SheetJS+檔案處理
import-export.js、units.js
Excel/CSV 轉換、欄位檢查與單位處理。
圖檔、報表與保存
drawing.js、JSON、localStorage
三視圖與列印、專案重開,以及目前瀏覽器的輸入暫存。

配貨引擎不是只用總體積相除

引擎會比較不同的貨物排序、合法姿態和放置偏好,在候選點嘗試配置,檢查邊界、碰撞與真實頂面支撐,再比較可行方案。支撐檢查計算底面接觸面積的聯集,避免多個底件的重疊區域被重複計入。

資料模型也刻意分開:Product 保存貨品規格;裝載單元表示散件或同 SKU 的堆疊;PlacedUnit 記錄實際位置、方向與件數;PackingResult 彙整整櫃結果。3D 物件由資料產生,不直接充當庫存資料,因此同一份配置能供清單、視覺化與報表共用。

大量庫存採壓縮計數,實際放入本櫃時才建立配置單元,避免把全部庫存逐件展開。這是資料結構的設計,並不代表任何資料規模都能立即算出高品質方案;時間預算、SKU 數量及配置單元仍有控制。

離線能力來自封裝方式

tools/build.cjs 會內嵌 CSS、應用程式與套件,產生離線單檔。這次核對版本為應用程式 v2.9.0、Three.js r128、OrbitControls r128、SheetJS CE 0.18.5;這些是本案使用版本,不代表各套件的最新版本。Node.js 用於開發建置,Playwright 用於瀏覽器驗證,兩者都不是終端使用者的安裝需求。

本機暫存與專案備份用途不同

localStorage 主要暫存輸入與設定,會受瀏覽器與檔案開啟方式影響。需要換電腦、長期保存或保留調整後配置時,應主動下載專案 JSON,並妥善保管。

05實測結果、使用邊界與下一步

本次使用三個虛構 SKU、總庫存 146 件,開啟瀏覽器離線模式測試。觀察到背景 Worker 正常執行、3D 無初始化錯誤、配置通過程式幾何驗證,並成功下載 Excel 與三視圖 PNG;測試期間記錄到的 HTTP/HTTPS 請求為 0。

單次示範觀察結果與解讀
裝入件數/棧板146 件/16 板,為本次虛構資料的結果。
貨物容積利用率約 66.2%,計算產品本體體積;含棧板空間占用率約 69.1%,兩者定義不同。
離線與匯出Worker、3D、Excel 與 PNG 流程通過;未對實體倉庫裝載作業進行驗證。

這些數字不是效益保證

本次展示用於核對功能與公開畫面,不是和人工規劃的對照實驗,無法據此宣稱節省多少時間、提升多少裝載率。實際結果會隨尺寸、方向、庫存組合、條件與搜尋時間改變。

工具提供的是受設定條件約束的長方體幾何可行方案,不保證全域最佳解。支撐率是幾何面積條件,沒有完整模擬承壓、傾覆、綁固、叉車空間或動態裝入路徑;虛構資料的成功配置,也不能直接作為實際貨物的安全認證。

目前核心範圍是單櫃、本機使用,尚未提供多櫃連續規劃、多人協作或雲端庫存同步。完整操作以桌面 Chrome/Edge 為主要使用情境,手機與其他平台仍應依實際瀏覽器及裝置驗證。這些邊界清楚,才能讓後續導入和擴充有明確依據。

企業可以先從一份資料完整的小案例開始

  • 先整理資料:確認外箱實際尺寸、數量、重量、可放方向與棧板規則,避免把缺漏資料當成無限制。
  • 再比較方案:用同一份輸入比較寬度、容積或作業順序的偏好,讓倉管人員共同檢查 3D 與清單。
  • 最後回到現場:核對櫃門、搬運空間、承壓與固定方式,記錄差異,再決定下一個應補入的規則。

這個案例的價值,在於把作業規則轉成能看見、能檢查、能修改的工具,讓現場經驗與程式計算一起參與規劃。

延伸學習

想了解瀏覽器 3D 如何用於實際專案,可以搭配閱讀:政策島怎麼做:拆解 3D 技術與 AI 提示詞。也可從 TempEDU 課程清單尋找 AI 與數位工具的相關學習資源。

本文重點

  • 透過可設定的貨品規則,將單櫃庫存選貨、3D 檢查與成果輸出串成流程。
  • 以原生 JavaScript、Three.js、Worker 與 SheetJS 分工,開發模組化、交付單檔化。
  • 把演算法結果交給人員檢查,並明確區分幾何可行、實際施工與運輸安全。

想一想

你的工作中,有哪一段反覆靠試排、試算或口頭交接的流程,也能先整理成資料、規則與可檢查的畫面?

資料來源與核對範圍

  1. 本案 v2.9.0 原始程式、README、架構文件與 2026 年 11 月 19 日去識別化離線操作紀錄;專案與企業資料未公開。
  2. Three.js 官方文件:3D 場景與渲染相關技術。
  3. MDN:Web Workers API:背景執行緒與畫面執行緒的分工。
  4. SheetJS 官方文件:試算表資料讀取與輸出。

官方文件用於解釋技術角色;本案實際功能與套件版本以程式及操作紀錄為準。封面為 AI 生成情境圖;圖 1–6 為虛構資料實際畫面與輸出,圖 7 為依程式責任整理的架構示意。


Edit with Tr.Bug

Follow me on:LinkedIn | 探教育TempEDU