龜甲易占 (Turtle Shell I-Ching)

About

# 🐢 龜甲易占 (Turtle Shell I-Ching) — 簡易使用與開發說明

這是一個基於傳統易經金錢卦與**宋代哲學家朱熹《易學啟蒙》**斷卦理路的 Chrome 擴充功能（Manifest V3）。具備精美的龜甲搖卦動畫、爻線動態繪製、中文爻位標記、手動查卦、歷史紀錄存檔，以及豐富的易經基礎與斷卦規則教學。

## 🌟 核心特色
1. **金錢卦起卦模擬**：透過點擊搖動龜甲，模擬三枚銅板落下的陰陽面，依序起出初爻至上爻共六爻，動態繪製成卦。
2. **朱熹《易學啟蒙》解卦引擎**：
   * 根據實際起卦時產生的變爻個數（0~6個變爻），自動套用朱熹斷卦規則。
   * 精準標記出該次占卜的「主占爻」與「輔助爻」，方便閱讀對應爻辭。
3. **手動構卦與快速查卦**：提供互動式爻線面板，點擊即可切換陰陽爻，由下至上快速查閱易經六十四卦的詳細解釋。
4. **歷史紀錄本地存檔**：自動記錄您的占卜問題、起卦日期與卦象，保存在瀏覽器本地存儲空間（`chrome.storage`），安全且防丟失。
5. **易學與斷卦知識庫**：內建「斷卦規則」專屬分頁，提供陰陽爻、六爻結構、先天八卦對應表及起卦流向圖等基礎知識。
6. **雙欄響應式與全螢幕**：
   * 在 Chrome 擴充功能的彈出視窗（Popup, 450px）中，採用單欄切換的緊湊佈局。
   * 點擊「全螢幕」按鈕可彈出獨立分頁，在寬螢幕下以「左側操作/起卦、右側解卦/閱讀」的精美雙欄響應式版面展現。


## 📖 使用指引

### 1. 🐢 起卦（占卜）
* 切換至 **「起卦」** 分頁。
* 在輸入框中輸入您想占問的事情（例如：*問事業發展*、*問健康狀況*）。
* 點擊 **「搖動龜殼」** 按鈕（或點擊龜甲本體），龜殼將會震動，並在下方擲出三枚銅板顯示陰陽。
* 重複點擊 **6次** 即可起出完整的六個爻（由下而上）。
* 起卦完成後，系統會自動在右側（或跳轉頁面）顯示本卦、變卦（若有變爻）、當前斷卦依據，以及詳細的卦辭與變爻爻辭解析。

### 2. 🔍 查卦（手動構卦）
* 切換至 **「查卦」** 分頁。
* 您可以在上方的搜尋框輸入卦名（如：*乾*、*坤*）或序號進行搜尋。
* 或者，在下方的 **「手動構卦」** 區域，由下而上點擊六條爻線來變更陰陽，構出您想查詢的卦象，點擊 **「查找此卦」** 即可閱讀該卦解析。

### 3. 📜 歷史
* 切換至 **「歷史」** 分頁，即可瀏覽所有歷史占卜紀錄。
* 點擊 **「查看」** 可重新載入該次占卜的詳細解卦內容。
* 點擊 **「刪除」** 或右上角的 **「清除所有紀錄」** 來整理紀錄。