工具分享｜3D 列印線材庫存管理，讓 Notion 也看得到耗材
文／Node｜JAN1 LAB 工作室工具筆記
01 / 工具發表
每一捲線材，都有清楚的紀錄。
「那捲白色 PLA 應該還有吧？」
如果你也常在開始列印前，才發現記憶裡很滿的線材，實際只剩一圈，這篇就是寫給你的。
我們把工作室管理耗材的需求，做成了一個可以自行部署的網站：Filament Inventory｜3D 列印線材庫存管理。現在已在 Gumroad 發布，下載後可以建立自己的庫存系統，再把需要的資訊放進 Notion 工作頁。
線材會用完。人的記憶也會。我先把兩件事分開管理。
02 / 耗材登記
新增進貨、登記消耗，讓庫存跟著使用更新
這個工具從每一捲線材開始記錄。品牌、材質／系列與顏色，都能依自己的耗材整理；可以使用內建色票，也可以建立自訂顏色。
買了新線材，就登記進貨；列印用掉多少，就記錄消耗；實際秤重後，也能透過盤點調整剩餘數量。用量輸入提供 50、100、200 g 快捷選項，需要更精確時，可以手動填入克數。
更新記錄後，就能回到總覽確認剩餘重量與補貨狀態，不用再用「看起來大概還有半捲」作為唯一依據。
這裡的更新是依你輸入的進貨、消耗與盤點資料計算，不會自動連接列印機或偵測用量。例如一次列印用了 120 g，就登記 120 g；有了紀錄，剩餘量才有依據。
「應該還有」可以是一句安慰，但不適合當庫存數字。
把數字變成看得懂的庫存畫面
總覽不只列出清單，也用圖像呈現耗材狀態：
- 總捲數與剩餘重量：掌握目前登記的庫存。
- 材質／系列與顏色：先確認手邊有沒有需要的線材。
- 品牌庫存分布：比較各品牌剩餘的耗材重量。
- 線材視覺總覽：用捲軸圖像辨識不同線材與顏色。
- 補貨提醒與材質比例圖：查看哪些需要補買，以及庫存的組成。
對工作室來說，這些圖表的用途很實際：開始一個新案子之前，先看材料夠不夠，再決定要補什麼。介面也支援繁體中文、英文與日文切換，並提供異動紀錄與 CSV 匯出。
03 / Notion 看板
庫存，也可以放進你的 Notion
如果你的專案、待辦與製作排程都在 Notion，就不必為了看庫存再多開一個分頁。
系統提供六種庫存小工具。複製需要的連結，貼到 Notion 並選擇嵌入，就能把總捲數／重量、種類／顏色、補貨提醒、品牌分布、線材視覺總覽與材質比例，安排在自己的工作頁面。
小工具約每 15 秒更新一次，適合當作工作頁上的庫存看板。Notion 嵌入是唯讀查看；新增耗材、進貨與用量登記，仍回到庫存系統操作。
你可以只放一張補貨提醒，也可以排成自己的耗材儀表板。工作頁怎麼用，就讓資訊怎麼擺。
04 / 自行部署
下載之後，建立自己的庫存網站
Gumroad 提供的是網站原始碼與教學包。下載 ZIP、解壓縮後，依說明設定自己的網站與資料庫，再開始加入手上的耗材。
目前套件為 v1.2.0，包含完整原始碼、繁中／英文／日文三份圖文 PDF 教學、雙語開始說明，以及 AI 助手部署指引。
部署大致分成四步：
- 下載並解壓縮完整專案，依教學準備 Node.js 22.13 以上的環境。
- 先在電腦預覽，安裝所需套件，確認空白庫存能正常開啟。
- 部署到自己的 Cloudflare，建立 D1 資料庫並完成專案設定。
- 加入自己的耗材，再複製小工具連結，嵌入 Notion。
實際安裝會從空白庫存開始。本文圖片裡的品牌、數量與重量，是工作室使用畫面與教學示範，不會直接變成你的庫存。
05 / Codex 協助
也可以請 Codex 協助部署
如果你希望有人陪著讀設定，可以用具備檔案與終端機操作能力的 AI 開發工具，例如 Codex，開啟完整專案資料夾，請它先讀 README.md 與 AI_DEPLOYMENT.md，再依隨附教學協助預覽與部署。
可以從這段需求開始：
請先讀 README.md 和 AI_DEPLOYMENT.md，協助我在電腦預覽這個線材庫存管理網站，確認正常後，再依文件部署到我的 Cloudflare 帳號與 D1 資料庫。遇到登入、授權或需要我確認的步驟，請告訴我。
你仍需要自己的 Cloudflare 帳號與相關服務。下載包不包含代部署、代管、雲端或 AI 服務費，也不包含日後維護與備份。
另外，這個版本沒有內建登入驗證：能開啟公開管理網址的人，就能修改庫存。私人庫存請另外設定存取限制；客戶唯讀展示頁與 Notion 小工具，不能取代管理頁的存取保護。
給每一捲線材，一個清楚的位置
我們做這個工具，是想把工作室裡反覆發生的小問題整理好：新買的線材有地方登記，用掉的重量有地方記錄，要補貨時也有畫面可以看。
如果你也想建立自己的耗材庫存，可以到商品頁查看功能、下載內容與部署需求，再依自己的工作方式設定。
前往 Gumroad：Filament Inventory｜3D 列印線材庫存管理
原始碼採 MIT 授權，使用、修改與散布依授權條款辦理；品牌色票與商標另依各自來源說明。
— Node
