開源文檔庫 (docs_opensource) 現況同步與全面升級計畫

開源文檔庫 (docs_opensource) 現況同步與全面升級計畫

依據應用程式目前最新發布版本（Build 255）、多科目架構擴充、Gemini 3.7 Flash 旗艦思考模型、Firebase Remote Config 動態調度、NotebookLM 學習工作區、RAG 知識庫四層防禦、雙 Supabase 資料庫架構、圖文對照檢視系統、EPUB 3 / Google Play 圖書有聲書發布工具鏈，以及 Android 15/16 與 Play Store 2026 品質標準，全面同步更新 docs_opensource/ 中的開源文檔套件。

📋 升級與調整範疇

1. 品牌重塑與多科目題庫擴充 (Brand & Multi-Subject Architecture)

• 品牌更名：由原專案限定名更新為通用開源認證練習平台 PassExam。
• 題庫規模與支援科目：從單一 CCNA 擴充為涵蓋 Cisco CCNP/CCIE 及跨雲端/專業領域等 18+ 科目、5,000+ 題庫之通用平台。
• 雙 Supabase 資料庫架構：
  • Supabase (A)：主要核心資料庫（CCNA 200-301、PowerSync 離線同步、向量 Embeddings）。
  • Supabase (B)：二號專業考科資料庫（Cisco 300-xxx / 350-xxx 等專業科目與社群審核機制）。

2. 旗艦思考模型與端側 AI 引擎 (Gemini 3.7 Flash & Gemma 4 Dual Engine)

• Gemini 3.7 Flash 旗艦思考模型：整合 Dynamic Thinking / Hybrid Reasoning、過濾 thought: true 推理歷程、自適應 Temperature 1.0 與 medium thinking level，支援 Google 官方 Model Aliases。
• 四層階層式 AI 調度架構：
  $$\text{本機自訂覆寫 (Local Override)} \rightarrow \text{RTDB 全域廣播} \rightarrow \text{Firebase Remote Config} \rightarrow \text{靜態預設值}$$
• 端側 Gemma 4 (2B) 離線引擎全面解鎖：輸出預算提升至 4096 tokens，解除 200 字限制，支援生活化通俗比喻、5 階段循序漸進解析與手把手 CLI 指令逐步指引。
• 雙軌 Persona 系統：當教材庫無檢索切片時，AI 助教自動切換為「業界頂尖顧問 / CCIE 首席架構專家」，避免冷冰拒答。

3. 通用 NotebookLM 學習工作區與 RAG 知識庫 (NotebookLM & RAG Pipeline)

• 跨領域通用工作區：支援 Markdown 表格與代碼高亮、5+1 大 Studio 工具（含自訂專屬產出 Custom Artifact）與自訂聚焦提示詞 (Custom Focus Prompts)。

• 四層防禦 RAG Pipeline：智慧頁面分類器、切片品質評分器 (5 大維度過濾)、PDF 頁面範圍與過濾設定、檢索端品質加權排序。

4. 全平台圖文對照與企業級三位一體安全矩陣

• 圖文對照檢視系統 (QuestionImageReferenceDialog)：全平台考題圖片常駐懸浮預覽與上下分屏圖文對照檢視，高對比多語系解析渲染。
• 三位一體安全矩陣：
  1. 動態個人化浮水印 (EnhancedSecurityWatermark)：8 列 4 欄 UID 與姓名半透明浮水印，防實體側錄。
  2. 原生安全防護 (SecureScreenService)：FLAG_SECURE 防截圖、防螢幕錄影、防投影。
  3. Web 端安全防禦 (WebSecurityWrapper)：禁用右鍵、禁用文字複製、DevTools 開發者工具監控。

5. Google Play 圖書與語音有聲書發布工具鏈 (Books & Audiobook Toolchain)

• 自動化腳本工具鏈：fetch_supabase_books.py、generate_book_cover.py、build_ccna_epub.py（EPUB 3 可重排版面、語音無障礙導讀）、publish_to_play_books.py（ONIX 3.0 / CSV 中繼資料）。

6. Android 15/16 + Google Play 2026 品質與編譯規範

• Android 15/16 Edge-to-Edge 全面沉浸式無邊框相容。
• NDK 28.2.13676358 鎖定、JDK 21 LTS 鎖定、R8 Full Mode。
• SafeImageWidget 1024 降取樣防 OOM、Base64 安全解析與 FormatException 防護。
• 主執行緒大文字與 StringBuffer ANR 防禦（使用 compute() 派生至獨立 Isolate）。

📂 預計修改文件清單

🔍 驗證計畫

1. 文檔一致性審查：
   • 確保所有英文 (/en/) 與繁體中文 (/zh-TW/) 檔案內容 1:1 對齊。
   • 確保所有超連結、Markdown 語法與 Mermaid 流程圖語法正確無誤。
2. 術語與在地化標準：
   • 嚴格遵守繁體中文在地化與台灣網路專業術語規範。
3. 靜態分析驗證：
   • 執行 flutter analyze lib 與 flutter test，確保原始碼無受任何影響。

PassExam 未來開源釋出文檔套件 (docs_opensource/) 升級成果

PassExam 未來開源釋出文檔套件 (docs_opensource/) 升級成果

依據本 App（PassExam）目前的最新實況與架構演進，我們已全面檢驗並重構了 docs_opensource/ 開源文檔套件中的核心中英文文件，確保未來釋出開源社群時能精準反映專案的企業級架構與創新成果。

🛠️ 本次調整與升級亮點彙整

1. 🌐 全新品牌識別與跨科目題庫架構 (PassExam Branding & Multi-Subject Routing)

• 品牌對齊：由單一題庫升級為多認證科目品牌 PassExam。
• 題庫規模：涵蓋 CCNA 200-301 與 18+ Cisco CCNP/CCIE 專業科目（300-215, 300-410, 300-435, 350-401, 350-601 等，題庫總量達 5,000+ 題）。
• 雙 Supabase (A/B) 實例與 RepositoryFactory：
  • Supabase (A)：存放 200-301 核心題庫 + 768 維度 pgvector 語意搜尋 + PowerSync 離線 SQLite 同步。
  • Supabase (B)：存放 18+ Cisco 專業科目題庫與社群審核機制，透過 RepositoryFactory 依據 examId 自動隔離路由。

2. 🧠 Google 旗艦思考模型 Gemini 3.7 Flash 與 4 層階層調度

• Gemini 3.7 Flash (Hybrid Reasoning)：支援 Dynamic Thinking 動態思考深度，底層自動過濾 thought: true 思考歷程區塊，自適應鎖定 Temperature 1.0。
• 4 層階層調度架構：$$\text{本機覆寫} \rightarrow \text{RTDB 廣播} \rightarrow \text{Remote Config 雲端基準} \rightarrow \text{靜態預設}$$
• 端側離線 Gemma 4 (2B)：輸出預算解鎖至 maxTokens: 4096，徹底消除 200 字截斷限制，提供 5 階段深入淺出教學、生活化通俗比喻破題與 Cisco IOS CLI 逐步配置。
• 雙軌 Persona 系統：當教材庫無檢索切片時，無縫切換為「業界頂尖顧問 / CCIE 首席架構專家」。

3. 📚 NotebookLM 學習工作區與 RAG 四層防禦 Pipeline

• 去雜訊切片。
• 四層防禦管線：
  1. 智慧頁面分類器 (classifyPdfPageType)
  2. 切片品質評分器 (computeChunkQualityScore)
  3. PDF 頁面範圍與過濾對話框
  4. 檢索端品質加權 (Retrieval Quality Weighting)
• 5+1 Studio 工具：研讀指南、FAQ、簡介、時間軸、CLI 速查表、✨ 自訂專屬產出 (支援自訂聚焦提示詞)。

4. 🛡️ 三位一體安全防護矩陣 (Triple-Defense Security Matrix)

• 實體側錄防禦：EnhancedSecurityWatermark 8 列 4 欄個人化動態浮水印，覆蓋主考場與上下分屏圖文對照視窗 (QuestionImageReferenceDialog)。
• 原生系統防禦：SecureScreenService (FLAG_SECURE) 防截圖、防錄影、防投影與 3 秒輪詢投放監控。
• Web 端防禦：WebSecurityWrapper 禁用右鍵、禁用文字選取複製、DevTools 開啟監控與後端異常回報。

5. 📖 Google Play 圖書與語音有聲書出版工具鏈

• 完整記載 fetch_supabase_books.py、generate_book_cover.py、build_ccna_epub.py（EPUB 3 / 語音無障礙導讀標籤）、publish_to_play_books.py（ONIX 3.0）與 run_book_pipeline.ps1 自動化出版工作流。

📂 更新文件對應清單

🔍 代碼與環境檢驗

• 執行 flutter analyze lib 驗證通過（0 Errors，無任何阻塞性編譯錯誤）。
• 專案內部路線圖 project_docs/project_status_and_roadmap.md 已動態同步至最新狀態。