「佛光尋光記：三好之旅」結合傳統視覺小說與 AI 語意判定，是一款以佛光大學「三好」精神為核心的互動敘事遊戲。玩家在校園故事中遇到各種情境，用自己的話自由輸入回應，由 AI 評估這份回應是否展現出真誠與善意，藉此實踐「做好事、說好話、存好心」。
它不是預設選項的選擇題，而是讓玩家真實表達——這也是整個遊戲設計上最核心的取捨。
同樣的善意可以有很多種表達方式，重點在是否發自內心、是否具體，而非用字是否華麗。在校園情境中，以實際行動幫助他人，體會純粹的善意無需回報。
在溝通的場合展現禮貌與尊重，感受語言能建立的溫暖連結。
在畢業的感恩時刻，發自內心地真誠祝福，體會善念是一種生活態度。
在新生訓練中遇見星雲大師的精神化身，獲得一塊空白石板，展開尋找三好之石的旅程。
同學找不到 AirPods Pro 很著急，用實際行動回應。
到課外活動組繳交企劃書，在校園事務的往來中，練習禮貌而尊重的溝通。
在畢業典禮的感恩時刻，獻上真誠的祝福。
三顆寶石合一，領悟三好精神的真諦。
※ 每章由 AI 依該章對應的三好面向，評估玩家回應是否真誠、具體。遊戲刻意不提供標準答案——重點不在用字是否華麗，而在是否發自內心。
主要使用 Google Gemini 進行語意分析，理解複雜語境與情感意圖、給予個性化回饋；無金鑰時自動降級為本地正則比對模式，離線也能體驗。
透過 ListModels 自動挑選當下可用的模型（偏好 flash-lite / flash 等免費友善模型），Google 更新或淘汰模型時無需改程式；偵測結果快取 24 小時，遇 404 自動清快取重新偵測。
API 金鑰一律由玩家自行輸入。「在此裝置記住金鑰」存 localStorage（30 天自動清除）；「僅本次瀏覽期間」存 sessionStorage（關閉即清，適合共用電腦）——不寫進原始碼、不上傳伺服器。
API 失敗時依 400 / 403 / 404 / 429 顯示明確原因並自動切換本地模式；遇 404 會自動清快取重新偵測，對被安全機制攔截的空回應也有防呆。
自動清除貼上時夾帶的空白、換行、看不見的控制字元等雜質——使用者不用擔心「明明複製對了卻無法用」的情況，這種瑣事直接由程式吸收。
技術規格：HTML5 + CSS3 + Vanilla JavaScript（無框架、無依賴）；響應式設計支援桌機 / 平板 / 手機（5 組 media query）；含背景音樂、角色語音與音效；localStorage 存檔系統（單一存檔槽）。支援 Chrome / Firefox / Safari / Edge 90+ 與行動裝置瀏覽器。
每章的關卡會請學生自由輸入自己的回應，由 AI（Gemini）依該章對應的「三好」面向評估回應是否展現出真誠與善意，並給予個別化回饋。沒有單一標準答案——同樣的善意可以有很多種表達方式，重點在是否發自內心、是否具體，而非用字是否華麗。（若未設定金鑰，會改用本地的正則比對作備援，準確度較低，僅供離線體驗。）
| 章節 | 三好面向 | AI 主要看的是 |
|---|---|---|
| 第一章 做好事 | 身 · 善行之石 | 是否展現主動幫助的具體行動與同理心，而非冷漠、推託或嘲諷。 |
| 第二章 說好話 | 口 · 慧語之石 | 是否展現禮貌、尊重與感謝的溝通，而非命令、敷衍或無禮。 |
| 第三章 存好心 | 心 · 淨念之石 | 是否展現真誠的善念與祝福、不求回報，而非交易心態或冷淡。 |
引導學生的建議（不破梗）：鼓勵具體、重視真誠、完整表達；每個關卡有「提示」按鈕但不給答案；把重點放在課後帶學生討論「為什麼這樣回應是三好的展現」，這才是價值所在。
本遊戲適合品德教育、新生訓練、團體討論教材與遊戲式學習實驗。歡迎教育工作者使用並提供反饋。
遊戲引擎、故事節點系統、雙模式 AI 判定、Gemini API 整合與模型自動偵測、金鑰生命週期管理、存讀檔與響應式實作。
故事文案撰寫、角色與場景圖像、角色語音等內容創作（非程式部分）。
本專案結合佛光大學三好精神與現代教育理念，採 MIT 授權，適合用於品德教育、新生訓練與遊戲式學習。
config.js：金鑰一律改由使用者在網頁上輸入，不再依賴設定檔。ListModels 自動挑選當下可用的模型，Google 更新或淘汰模型時無需修改程式；遇到 404 會自動清快取並重新偵測。localStorage，30 天自動清除）與「僅本次瀏覽期間」（sessionStorage，關閉瀏覽器即清除）；選單新增「重新設定 API 金鑰」可隨時更換或清除。無需安裝、開啟即玩。準備好自己的 Google Gemini 金鑰（免費方案即可），就能體驗最完整的 AI 判定；沒有金鑰也能用本地模式離線體驗。
▶ 開始遊玩