# 小柚的課程知識庫與寒暄

## 知識庫(`app/Services/KnowledgeBase.php`)
- **來源**:整門課的文字與實作單元(`text`、`lab`)的講義,依 `【小標題】` 切成段落。小標題就是學員會問的概念。
  測驗題、即時小測、解答、終端機/機器人的標準答案**不會**進知識庫(測試 `TutorTest` 有檢查)。
- **自動維護**:索引依「單元數量與最後更新時間」快取 12 小時,教材一改自動重建,不需要另外維護問答集。
- **檢索**:先拿掉客套與疑問詞(「請問」「什麼是」「怎麼」…),中文用二字組、英數用單字,BM25 計分;小標題命中權重最高,
  目前單元與同章略加權。保守原則:問題裡有太多教材沒出現的詞、或只在內文零星沾到邊,就回「沒有找到」,不硬湊。
- **有 AI 金鑰**:目前單元教材 + 知識庫找到的其他單元段落(標明單元名稱)一起交給模型。
- **沒有 AI**:直接呈現最相關的 1–2 段,標明來源單元,並附可點的單元連結。
- **已知限制**:沒有同義詞表(問「轉彎」但教材寫「偏折」會找不到);單一漢字主題(力、熱)只認小標題;
  各章若沒有【小標題】,整段當成一節。

## 建議問題
輸入框上方的快捷問題,由目前單元的小標題自動產生(「『密度的意義』是什麼意思?」)。

## 基本禮貌(`app/Services/SmallTalk.php`)
你好、早安、謝謝、再見、自我介紹、你是誰、你會什麼、好的、加油…。**整句話**是寒暄才回應(「謝謝,請問密度是什麼?」仍會查教材),
固定回覆、不呼叫模型、不佔每日提問次數、不算「沒答到」。回覆跟隨介面語言(四種語言翻譯在 `lang/_work/tutor-kb.json`)。
