開源的冷製皂配方計算機與油品資料庫。50 支常見油脂的皂化價與脂肪酸剖析、材料與成本試算、成品特性診斷，以及一個大家可以共同編輯的配方庫。
線上版： https://jueyi0206.github.io/soap-notes/
開始做皂 — 選一個目標（萬用皂、洗臉皂、洗髮皂、家事皂、嬰幼兒皂…），直接載入範本配方，算好每一樣材料要準備幾克。不知道從哪裡開始的人從這裡進來。
油品庫 — 50 支油，依硬油／軟油／脂類／特殊分類。每一支都有皂化價（NaOH 與 KOH 雙欄）、INS、碘價、八種脂肪酸的百分比剖析、建議用量上限。其中 20 支台灣常用油另有使用心得與常見搭配。
配方計算機 — 選油、填比例或克數，即時算出：
- 氫氧化鈉用量（含超脂率）、水量、皂液總重、約可切成幾塊
- 六大成品特性：硬度、清潔力、滋潤度、起泡度、細緻泡沫、碘價，加上 INS
- 一段白話診斷：「這鍋洗起來會是什麼感覺」
- 水量三種講法即時對照：台灣式鹼量倍數 ↔ 鹼水濃度％ ↔ 佔油重％
- 精油與粉類添加物的克數與安全用量上限
- 成本試算（單價存在你自己的瀏覽器，不會上傳）
- 踩到安全紅線時會標紅並說明後果，但不會擋你——家事皂本來就該踩線
- 一鍵輸出 Markdown 或配方 JSON，方便貼到筆記或發 PR
配方庫 — 10 個內建範本加上社群分享的配方，都能載入計算機改成自己的版本。
新手入門 — 設備清單、操作順序、看懂數字、常見失敗的判斷，以及安全與法規。
因為瀏覽器的安全限制，直接雙擊 index.html 會讀不到 JSON 資料。請用任一種本地伺服器：
python -m http.server或
npx serve沒有任何建置流程，也沒有任何相依套件。純 HTML + CSS + JavaScript。
改完資料後可以自己先檢查格式：
node scripts/validate.mjs- Fork 或 clone 這個 repo
- 進 repo 的 Settings → Pages
- Source 選 Deploy from a branch，分支選
main、資料夾選/ (root) - 等一分鐘，網站就會出現在
https://<你的帳號>.github.io/soap-notes/
油品庫、添加物與配方庫都歡迎貢獻，三者都是單純的 JSON 檔，不需要會寫程式也能改。完整說明請看 CONTRIBUTING.md。
- 想新增油品、修正皂化價 → 改
data/oils.json - 想補寫某支油的使用心得 → 一樣改
data/oils.json，目前有 30 支的心得欄是空的 - 想分享自己的配方 → 改
data/recipes.json - 不想碰 JSON → 直接開 Issue，有人會幫你加
每個 PR 都會自動跑格式檢查：JSON 語法、必填欄位、皂化價的合理範圍、NaOH 與 KOH 的換算關係、脂肪酸加總、配方比例是否為 100%、以及所有交叉引用。
這個網站的內容分成兩種，可信度不一樣，請分開看待：
可查證的公開資料 — 皂化價、INS、碘價、脂肪酸剖析。整理自公開的皂化價表，數值本身可以覆核。但不同產地、榨法與批次的油脂本來就有差異，正式製作請以供應商提供的實測數據為準。
社群撰寫的心得 — 每支油的使用心得、常見搭配、配方的實作筆記。目前 20 支核心油的心得皆標示 "verified": false，代表整理自公開資料、尚未經實作驗證。做過的人歡迎來修正並把 verified 改成 true。
成品特性數值（硬度、清潔力…）來自業界通用的經驗公式，不是實驗室量測值。它們能可靠地告訴你「A 配方比 B 配方硬」，但「硬度 42」這個絕對數字本身沒有物理意義。建議範圍是參考線，不是及格線。
氫氧化鈉（NaOH）是強鹼，接觸皮膚會造成化學灼傷，濺入眼睛可能導致永久失明。
- 操作時務必配戴護目鏡與手套，保持通風，並隔離小孩與寵物
- 溶鹼永遠是鹼倒入水，不是水倒入鹼——反過來會暴沸噴濺
- 不可使用鋁製容器，鋁與強鹼反應會產生氫氣
- 本站的皂化價為公開參考值，第一次做某個配方請先小批量測試
- 手工皂熟成未滿 4 週前鹼性仍高，不要使用
- 做給嬰幼兒、孕婦或敏感肌的皂，請避開精油與色料並拉長熟成
- 自製皂在台灣屬於化粧品，販售需完成產品登錄、符合標示規定並具備產品資訊檔案（PIF）
本站內容僅供自製手工皂的學習參考，不構成醫療、安全或法規建議。
- 程式碼：MIT
- 油品、添加物與配方內容：CC BY-SA 4.0