工具實測與開發案例 / 測試日期:2026 年 11 月 19 日 / v2.9
貨物的總體積小於貨櫃,為什麼現場還是裝不下?因為裝櫃還要看尺寸、方向、棧板、疊放與作業先後。這套 3D 智慧裝櫃規劃工具,把庫存清單轉成有座標、有順序、可以旋轉檢查的空間方案,讓規劃人員在搬貨之前,先看見配置。
本文以目前專案的程式、介面與離線操作為依據,介紹已完成的功能和技術架構。所有操作圖均重新載入虛構貨品 DEMO-A、DEMO-B、DEMO-C,未使用企業名稱、真實料號、訂單或客戶案例;封面為 AI 生成情境圖,內文六張圖則是工具的實際截圖與輸出。

30 秒看重點
- 一個 HTML 即可離線使用:正式交付檔已內嵌程式、樣式與第三方套件。
- 條件先設定,配置再計算:支援 SKU 優先順序、合法方向、棧板、疊放、配比與載重條件。
- 結果可以繼續調整:3D 選取、位移、轉向和復原,搭配整櫃幾何驗證。
- 成果能交給現場:輸出 Excel、CSV、三視圖 PNG,並以瀏覽器列印另存 PDF。
01把一份庫存,變成一櫃可檢查的方案
這個工具處理的是「從可出貨庫存挑選單櫃配置」。匯入的數量代表可用庫存,系統會建議本櫃選哪些品項、裝多少件,沒有選上的顯示為保留庫存。計算本身不會扣減庫存,也不會自動產生第二個貨櫃。
操作可分成五步:選貨櫃、輸入庫存、計算配貨、人工微調、輸出成果。常用貨櫃提供尺寸預設,也能自行輸入有效內尺寸;長度統一使用 mm,重量使用 kg,統計體積使用 m³,減少資料在表格與畫面之間轉換時的混淆。
| 工作需求 | 工具如何處理 |
|---|---|
| 一次整理多種貨品 | 手動新增或匯入 CSV/Excel,設定 SKU、名稱、長寬高與庫存數量。 |
| 規劃整櫃擺放 | 綜合可用尺寸、姿態、間隙、棧板與支撐等條件,為裝載單元產生實際座標。 |
| 向不同人員說明 | 3D 圖例以顏色區分 SKU,並同步顯示件數、保留庫存與貨物容積利用率。 |
02把現場規則寫進資料,配置才有意義
優先順序:先處理閉端,再向櫃門推進
每個 SKU 可以填寫裝櫃優先順序,數值越小越優先,空白排在有填寫的級別之後。同一級別會先利用靠閉端區段的寬度與可疊高度,再往櫃門方向推進。尺寸、支撐、載重及啟用的件數配比仍需符合設定;優先級不會讓原本放不下的貨物變得可行。
另外可選寬度優先、容積優先或同 SKU 集中等排列目標。寬度排得更滿,可能伴隨較少裝載件數,因此規劃人員可以依作業需求比較,而不是只追求一個漂亮的百分比。

棧板、姿態與疊放限制一起計算
貨品可設定允許平放、側放或立放,並填入棧板高度、自重與每板件數上限。符合條件的品項可開啟同 SKU 整板疊放;禁止上方壓貨或必須落地的品項,也有對應選項。這些設定會影響實際候選方案與最終驗證,不只是表格上的備註。
系統也提供嚴格或彈性的件數配比、最大載重與左右重量平衡。啟用重量條件時,產品與棧板重量需完整;前後重量及重心資訊可供參考,左右平衡設定不代表前後重量必須各半。實際承壓能力與運輸安全仍需另行確認。
人工微調也要重新檢查整櫃
在 3D 畫面點選貨件,或由清單選取,即可按設定步距沿 X、Y、Z 移動、水平轉 90 度或切換合法姿態,也能批次轉向。每次操作會先在複本上嘗試,通過整櫃邊界、碰撞、支撐與疊放規則後才套用;不合法的操作保留原結果。
例如移走底層貨物時,系統會一併檢查原本位於上方的貨物,避免只看被移動的那一件。使用者可以復原上一步,或恢復自動配置,再比較不同擺法。

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

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

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

04技術架構:模組化開發,單一檔案交付
這個專案採用 HTML、CSS 與原生 JavaScript,核心流程在瀏覽器內執行。開發時拆分畫面、資料轉換、配貨引擎、3D 與輸出模組;交付時再把它們和第三方套件一起合成 HTML。使用者以完整桌面瀏覽器開啟交付檔,不需安裝 Node.js 或 Python,也不需登入或呼叫雲端 API。
| 技術/模組 | 在專案中的工作 |
|---|---|
| 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 分工,開發模組化、交付單檔化。
- 把演算法結果交給人員檢查,並明確區分幾何可行、實際施工與運輸安全。
想一想
你的工作中,有哪一段反覆靠試排、試算或口頭交接的流程,也能先整理成資料、規則與可檢查的畫面?
資料來源與核對範圍
- 本案 v2.9.0 原始程式、README、架構文件與 2026 年 11 月 19 日去識別化離線操作紀錄;專案與企業資料未公開。
- Three.js 官方文件:3D 場景與渲染相關技術。
- MDN:Web Workers API:背景執行緒與畫面執行緒的分工。
- SheetJS 官方文件:試算表資料讀取與輸出。
官方文件用於解釋技術角色;本案實際功能與套件版本以程式及操作紀錄為準。封面為 AI 生成情境圖;圖 1–6 為虛構資料實際畫面與輸出,圖 7 為依程式責任整理的架構示意。
Edit with Tr.Bug
Follow me on:LinkedIn | 探教育TempEDU

