# 12 天衝刺規劃（roadmap）

> 開案日：2026-06-11（Day 1）。每天的「完成定義」都列出來，方便逐日打勾與跨 session 接手。
> 進度標記：✅ 完成 / 🔶 部分完成 / ⬜ 未開始

## Day 1 ✅ 分析 repo，建立課程骨架（2026-06-11）

- ✅ 四個 repo 的當日實查分析 + 比較表（docs/repo-analysis/ 五份）
- ✅ 專案目錄骨架、README、PROGRESS、setup.md、本 roadmap
- ✅ 七章教材骨架（docs/chapters/，固定格式 + 內容大綱）
- ✅ 提前完成 Day 5 / Day 10 的互動 demo 初版與 Day 7 的 notebook 初版（見下）
- 完成定義：新 session 只讀 PROGRESS.md 就能無縫接手 ✅

## Day 2 ⬜ 完成 Chapter 0–1 本文

- ch00、ch01 從骨架擴寫成全文（每章 2000–3500 字，固定格式十節齊全）
- ch00 的「精度—成本階梯」SVG 圖解（assets/）
- 完成定義：給一位真實碩士生試讀 15 分鐘能複述「三層工具」

## Day 3 ⬜ Local Deep Research 教材與知識庫 demo

- `notebooks/deep-research-demo.ipynb`：mock 檢索器（內建小語料）+ 真 API 開關
- `interactive/rag-pipeline.html`：切塊 → embedding 散點 → top-k 檢索視覺化
- `docs/teacher-notes/ch01.md`：教師演示腳本（含 LDR 實裝指南一頁：接 chem-kb 的步驟與限制）
- 完成定義：斷網狀態下 RAG 概念仍能完整演示

## Day 4 ⬜ 完成 Chapter 2（DFT→MLIP）本文

- ch02 全文 + 「force = 3N 個標籤」圖解
- `notebooks/mace-minimal-demo.ipynb` 前半（資料/split/learning curve）與 ch02 內文對齊
- 完成定義：學生能解釋 train/val/test 與外推風險

## Day 5 🔶 GNN / message passing 互動 demo + Chapter 3 本文

- ✅ `interactive/gnn-message-passing.html` 初版（Day 1 提前完成）
- ⬜ ch03 全文擴寫；demo 依試教回饋微調文案
- 完成定義：學生操作 demo 5 分鐘後能答對「兩輪後中心原子知道誰」

## Day 6 ⬜ MACE 教材（ch04 本文 + 投影片）

- ch04 全文：equivariance 直覺、higher-order、工作流、license 地圖
- `slides/ch04-mace.html`（Reveal.js，套用實驗室 slide_style_spec 配色）
- 完成定義：投影片可獨立講 40 分鐘

## Day 7 🔶 MACE minimal notebook

- ✅ `notebooks/mace-minimal-demo.ipynb` 初版（Day 1 提前完成：Morse 假 DFT → 描述符 → split → learning curve → 外推測試 → force=梯度 → Colab 真跑開關）
- ⬜ Colab 實測一輪（含 mace-torch 安裝 cell），修正執行時間與輸出
- 完成定義：mock 模式在乾淨環境 3 分鐘內全部跑完

## Day 8 ⬜ CHGNet / MatterSim 教材（ch05 本文 + 投影片）

- ch05 全文：能力邊界框架、softening、leaderboard/license 素養
- `slides/ch05-pretrained-models.html`
- 完成定義：學生能列出三個安全用法、三個危險用法

## Day 9 ⬜ Pretrained model demo

- `notebooks/pretrained-model-concept-demo.ipynb`：mock（誤差量級對照、分布內外切換）+ Colab 真跑（CHGNet relax LiMnO₂ + magmom→氧化態）
- 互動候選：foundation model 家族樹 + license 地圖
- 完成定義：notebook 講清楚「為什麼 zero-shot 吸附能不可信」

## Day 10 🔶 HEA active-site distribution（ch06 本文 + notebook）

- ✅ `interactive/hea-active-site-distribution.html` 初版（Day 1 提前完成）
- ⬜ ch06 全文；`notebooks/hea-adsorption-distribution-demo.ipynb`（numpy 同模型 + bootstrap）
- ⬜ 待用戶提供實際體系元素後更換 demo 預設組成
- 完成定義：demo + notebook 能支撐一場 20 分鐘的組會報告

## Day 11 ⬜ 投影片與練習題總整理

- 其餘投影片（ch00–ch03、ch06）；exercises/ 每章學生版+解答版；prompts/ 提示詞範本
- 完成定義：七章皆有 slides + exercises

## Day 12 ⬜ 總檢查、修正、展示首頁、部署

- `interactive/index.html` 展示首頁（課程地圖 + 所有 demo/投影片入口）
- 全站手機檢查、離線檢查、中文文案順讀
- 部署：`npx wrangler pages deploy` → 新專案 `ai-chem-course`，綁 ai-chem-course.ccllab-tw.com（依 CLAUDE.md 部署規則）
- 完成定義：手機開啟網址能完整走完一條學習路徑

## 風險與緩衝

- Colab Python 版本變動（影響 mattersim）→ Day 7/9 各留實測時間
- 投影片量大 → Day 11 只保證「每章可講」，美化列入課後迭代
- 用戶實際 HEA 體系資訊未到 → demo 以可調參數設計，換預設值是 10 分鐘的事