這是我的去識別化網頁工具作品
CovenantPromptKey
**互動式關鍵字替換介面 | 聖經查詢系統**
GitHub Pages (Live Site)
https://bod3612272.github.io/CovenantPromptKey/
📖 Overview
CovenantPromptKey 是一款專為保護敏感資訊而設計的 Web 應用,讓您在使用 AI 服務時能夠安全地遮罩機密內容。透過直覺的關鍵字映射系統,您可以將公司名稱、產品代號、個人資訊等敏感內容替換為安全的替代詞,待 AI 回覆後再將替代詞還原為原始內容。
此外,本應用程式亦整合了聖經查詢系統,提供聖經經文搜尋、閱讀及互動遊戲功能。
Hosting Model(WebAssembly-first, Dual-hosting)
- Primary(browser-hosted / Blazor WebAssembly):可部署為純靜態資產(GitHub Pages / Azure Static Web Apps),並支援 offline-first(成功載入一次後可離線啟動)。
- Legacy fallback(Blazor Server):保留既有 Server host 以利相容/回退;現階段兩個版本維持 feature parity,但未來主要發展方向以 Web(WASM)版本為主。
PWA / Service Worker Notes(Update behaviour)
本專案的 browser-hosted(GitHub Pages / Azure SWA)採用 Service Worker 提供 offline-first;因此在部署環境更新時,瀏覽器可能會短暫沿用快取資產。
- 開發環境(localhost):預設不註冊 Service Worker,並會嘗試清除既有註冊/快取,避免「看起來沒更新」的 false positive。
- 部署環境(例如 GitHub Pages):若遇到版本未即時更新,請先 關閉所有分頁後重新開啟;仍不行再做 Hard Refresh(Ctrl+F5) 或清除該站台的 Site Data。
✨ Features
🔐 互動式關鍵字替換介面
- 智慧關鍵字偵測:使用高效 Aho-Corasick 演算法進行多模式字串匹配
- 三欄式互動佈局:原文 / 控制面板 / 結果區,支援即時視覺化標示
- 精準控制:可選擇性勾選欲替換的關鍵字,避免誤傷內容
- 上下文語境警示:自動偵測可能破壞中文詞組的替換並顯示警示
- 字典管理:支援手動新增/編輯/刪除關鍵字,CSV 格式匯入/匯出
- AI 回應還原:將遮罩詞彙反向還原為原始機敏關鍵字
- 工作階段保存:自動儲存工作狀態,避免刷新頁面導致資料遺失
- Debug Log 追蹤:完整的操作日誌記錄,方便問題排查

📖 聖經查詢系統
- 經文搜尋:支援關鍵字搜尋、模糊搜尋、多關鍵字 AND 搜尋
- 聖經閱讀:書卷導航、章節跳轉、上下章切換
- 閱讀設定:自訂字形、字體大小、文字顏色、背景顏色
- 書籤管理:自動記錄最近閱讀的經文(最多 10 筆)
- 經文導出:支援三種 Markdown 格式導出
- 經文猜猜遊戲:透過遊戲熟悉聖經經文出處,含錯題複習功能

🛠️ Technology Stack
| 技術 | 版本/說明 |
|---|---|
| Framework | .NET 10.0 (Preview) |
| UI Framework | Blazor WebAssembly(Primary) + Blazor Server(Legacy fallback) |
| CSS Framework | Bootstrap 5 |
| CSV Processing | CsvHelper 33.1.0 |
| Markdown Parsing | Markdig 0.44.0 |
| Bible Data | BibleData DLL (.NET Standard 2.1) |
| Storage | Browser localStorage / sessionStorage |
🚀 Quick Start
關鍵字替換功能
- 新增關鍵字:前往「設定」頁面,新增機敏詞與對應的安全替代詞
- 貼上文本:在「替換與還原」頁面的「遮罩」頁籤貼上包含機敏資訊的文本
- 選擇關鍵字:系統會自動偵測並列出所有關鍵字,您可勾選欲替換的項目
- 執行替換:點擊「執行替換」按鈕,確認後獲得遮罩後的安全文本
- 還原回應:將 AI 回應貼入「還原」頁籤,系統會自動將替代詞還原
聖經查詢功能
- 點選側邊欄「聖經」展開子選單
- 選擇「聖經查詢」進行經文搜尋
- 選擇「聖經閱讀」瀏覽特定書卷章節
- 選擇「聖經遊戲」測試您對經文的熟悉度