iT邦幫忙

2026 iThome 鐵人賽
0
Build on Google AI

將考國際證照的應用程式變成開源系列 第 59 篇

提升 AI 助教功能

18th鐵人賽
103 瀏覽

  • 分享至 

  • xImage
    •  

Searched for "生活化觀念破題"
Searched for "Exam Watch"
Viewed ai_offline_reasoning_engine.dart:40-100
Viewed ai_service.dart:1-75
Viewed ai_service.dart:250-300
Viewed ai_tutor_screen.dart:170-240
Viewed ai_tutor_screen.dart:295-340
Searched for "PersonaSelectorWidget"
Viewed persona_selector_widget.dart:1-73
Viewed app_localizations.dart:64-64
Viewed app_localizations.dart:1-64
Viewed translations.dart:30-75
Viewed translations.dart:76-120
Viewed ai_offline_reasoning_engine.dart:100-140
Viewed ai_offline_reasoning_engine.dart:240-305
Searched for "friendlyTutor"
Viewed ai_offline_reasoning_test.dart:1-92
Viewed ai_offline_reasoning_engine.dart:120-250
Viewed ai_service.dart:100-130
Viewed ai_service.dart:320-372
Viewed ai_service.dart:300-320
Viewed ai_offline_reasoning_engine.dart:1-85
Viewed ai_offline_reasoning_engine.dart:100-235
Viewed ai_offline_reasoning_engine.dart:45-75
Viewed translations.dart:80-140
Viewed translations.dart:170-230
Viewed translations.dart:270-309
Viewed ai_tutor_screen.dart:590-640
Viewed ai_tutor_screen.dart:700-760
Viewed ai_tutor_screen.dart:760-804
Viewed ai_tutor_screen.dart:355-405
Viewed ai_offline_reasoning_engine.dart:100-235
Edited ai_service.dart
Edited ai_service.dart
Edited translations.dart
Edited translations.dart
Viewed persona_selector_widget.dart:20-45
Edited persona_selector_widget.dart
Viewed ai_offline_reasoning_engine.dart:50-90
Viewed ai_offline_reasoning_engine.dart:230-305
Viewed ai_offline_reasoning_engine.dart:120-235
Edited ai_offline_reasoning_engine.dart
Viewed ai_offline_reasoning_engine.dart:220-300
Edited ai_offline_reasoning_engine.dart
Viewed ai_offline_reasoning_engine.dart:90-140
Edited ai_offline_reasoning_engine.dart
Viewed ai_offline_reasoning_test.dart:1-60
Edited ai_offline_reasoning_test.dart
Ran command: flutter test test/unit/ai_offline_reasoning_test.dart
Used tool: schedule
Viewed ai_offline_reasoning_test.dart:1-25
Viewed ai_offline_reasoning_engine.dart:88-104
Edited ai_offline_reasoning_engine.dart
Ran command: flutter test test/unit/ai_offline_reasoning_test.dart
Used tool: schedule
Ran command: flutter analyze
Used tool: schedule

正在執行靜態程式碼分析以確保無任何語法錯誤...

Used tool: manage_task
Used tool: schedule

持續等待靜態分析完成...

Used tool: manage_task
Used tool: schedule
Ran command: flutter test
Used tool: schedule

靜態分析 0 錯誤通過！正在執行全專案單元與整合測試...

Ran command: git status -s
Ran command: git add lib/ test/ && git commit -m "feat(ai): elevate persona to domain expert consultant and remove simple analogies and exam watch"
Ran command: git push origin main
Ran command: pwsh -File .\deploy.ps1
Used tool: schedule

正在將頂尖專家/首席顧問規格更新版本自動打包並部署至 Google Cloud Run，請稍候...

Used tool: manage_task
Used tool: schedule

Cloud Build 正進行 Flutter Web release 編譯中...

Used tool: manage_task
Used tool: schedule

建置已接近尾聲，完成後將立即自動切換流量至最新修訂版本...

Ran command: curl -sI https://openpassexam-web-nphsu7ckja-de.a.run.app

🎉 已完成設定與發布通知

已依照您的要求，完成以下所有調整並全數部署至正式生產環境：

🛠️ 完成的核心改造項目

  1. 全面取消通俗比喻與考試重點陷阱區塊：

    • 移除原有的 [ 生活化觀念破題 (1 秒秒懂) ]。
    • 移除原有的 [ 認證考試重點陷阱 (Exam Watch) ]。
    • 不再輸出口語化比喻（如外送物流、大樓門牌等），直接切入專業底層架構。

  2. 升級為「領域頂尖專家與首席技術顧問」角色定位：

    • 雲端 Prompt 系統提示詞升級：在 ai_service.dart 中注入 20 年以上經驗的頂尖技術專家與首席顧問角色（涵蓋網路架構、雲端原生、分散式系統、資安防護與全方位專業認證）。
    • 端側離線推論引擎升級：在 ai_offline_reasoning_engine.dart 中以頂尖專家標準重構輸出流程，提供白皮書等級的 RFC 規範、硬體 ASIC / TCAM 轉發原理、完整企業級實戰指令與架構師權衡分析。

  3. 回答深度與詳細度極大化：

    • 涵蓋 RFC 標準規範（如 RFC 4632 CIDR 數學位址模型、RFC 3021 /31 點對點最佳化、IEEE 802.1Q 4-Byte 訊框標籤 PCP/DEI/VID 拆解）。
    • 提供 企業級全方位實戰配置（如 OSPF 參考頻寬調整至 100G、Passive Interface Default 安全原則、MD5/SHA Cryptographic 認證、CoPP 控制平面防禦、RSTP PortFast/BPDU Guard 防護）。
    • 結合 首席架構師思維（模組化、單點故障 SPOF 消除、BFD 50ms 快速故障檢測、串流遙測 Streaming Telemetry）。

  4. 介面選單與語系同步升級：

    • AI Tutor 頁籤全面重塑：
      • 頂尖專家深度剖析（原生活化比喻）
      • 資深工程師實戰指引（實戰 CLI 配置與排錯）
      • 首席架構顧問諮詢（全域架構設計與權衡）

🚀 驗證與發布狀態

  • 靜態程式碼分析：flutter analyze ➔ No issues found!（0 errors, 0 warnings）
  • 單元與邏輯測試：flutter test ➔ 全部 50/50 項測試通過
  • 版本控制：Commit 899821a 已同步推送到 GitHub main 分支。
  • Google Cloud Run 部署：

現在無論在線上使用雲端模型或端側離線模式提問，AI 都會以頂尖專家與首席顧問的身分提供最極致詳盡、專業且嚴謹的回答！

Viewed c:\alan\google cloud app\OpenPassExam\lib\models\chat_message.dart:2-101
Searched for "class ChatMessage"
Viewed ai_tutor_controller.dart:1-60
Viewed ai_tutor_controller.dart:61-140
Viewed ai_tutor_screen.dart:50-95
Viewed ai_tutor_screen.dart:295-355
Searched for "package:web"
Viewed pubspec.yaml:30-60
Viewed notebooklm_controller.dart:1-60
Viewed notebooklm_screen.dart:1-100
Viewed notebooklm_screen.dart:180-259
Viewed c:\alan\google cloud app\OpenPassExam\lib\core\utils\file_exporter.dart:2-101
Viewed compute_helper.dart:1-56
Viewed ai_tutor_controller.dart:100-130
Viewed ai_service.dart:140-180
Viewed ai_service.dart:180-200
Viewed ai_tutor_controller.dart:100-140
Viewed ai_tutor_screen.dart:65-95
Viewed ai_tutor_screen.dart:300-355
Viewed ai_tutor_screen.dart:280-300
Viewed c:\alan\google cloud app\OpenPassExam\lib\core\utils\file_exporter_stub.dart:2-101
Viewed local_persistent_cache.dart:1-60
Viewed secure_vault_service.dart:1-60
Ran command: flutter analyze
Created c:\alan\google cloud app\OpenPassExam\lib\core\utils\file_exporter.dart
Ran command: pwsh -Command "New-Item -ItemType File -Force -Path 'lib\core\utils\file_exporter.dart'"
Ran command: pwsh -Command "New-Item -ItemType File -Force -Path 'lib\core\utils\file_exporter_stub.dart'; New-Item -ItemType File -Force -Path 'lib\core\utils\file_exporter_web.dart'"
Edited file_exporter_stub.dart
Edited file_exporter_web.dart
Edited file_exporter.dart
Ran command: flutter analyze lib/core/utils/
Viewed pubspec.yaml:30-50
Edited pubspec.yaml
Ran command: flutter pub get && flutter analyze lib/core/utils/
Used tool: schedule

正在安裝 web 相依套件並檢查 utils 靜態分析...

Viewed ai_tutor_controller.dart:1-45
Viewed ai_tutor_controller.dart:100-130
Edited ai_tutor_controller.dart
Viewed ai_tutor_controller.dart:105-145
Edited ai_tutor_controller.dart
Viewed ai_tutor_controller.dart:1-15
Edited ai_tutor_controller.dart
Viewed ai_tutor_screen.dart:70-95
Viewed ai_tutor_screen.dart:310-355
Viewed ai_tutor_screen.dart:185-210
Viewed ai_tutor_screen.dart:1-25
Edited ai_tutor_screen.dart
Edited ai_tutor_screen.dart
Viewed ai_tutor_screen.dart:190-215
Viewed ai_tutor_screen.dart:285-365
Edited ai_tutor_screen.dart
Viewed ai_tutor_screen.dart:200-250
Edited ai_tutor_screen.dart
Viewed ai_tutor_screen.dart:380-440
Edited ai_tutor_screen.dart
Ran command: flutter analyze
Viewed c:\alan\google cloud app\OpenPassExam\test\unit\ai_tutor_controller_test.dart:2-101
Ran command: pwsh -Command "New-Item -ItemType File -Force -Path 'test\unit\ai_tutor_export_test.dart'"
Edited ai_tutor_export_test.dart
Ran command: flutter test test/unit/ai_tutor_export_test.dart
Viewed question.dart:15-40
Edited ai_tutor_export_test.dart
Ran command: flutter test test/unit/ai_tutor_export_test.dart
Ran command: flutter test
Used tool: schedule

全套測試執行中...

Ran command: git status -s
Ran command: git add lib/ pubspec.yaml test/ && git commit -m "feat(ai-tutor): add Markdown export for single question and all conversations with timestamp filename"
Ran command: git push origin main
Ran command: pwsh -File .\deploy.ps1
Used tool: schedule

正在為您將「AI 助教 Markdown 匯出功能（支援個別問題與全部對話、時間戳記檔名、模型與異常診斷明細）」建置並部署至 Google Cloud Run...

Used tool: manage_task
Used tool: schedule

雲端映像檔編譯中，即將完成並部署...

Used tool: manage_task
Used tool: schedule

正將建置映像檔發布至 Cloud Run 服務...

Ran command: curl -sI https://openpassexam-web-nphsu7ckja-de.a.run.app

🎉 已完成實作並成功發布至 Google Cloud Run

已為您在 OpenPassExam [ AI 助教 ] 中實作完整的 Markdown 匯出功能，支援「個別詢問問題」與「全部詢問問題」的完整紀錄匯出，並嚴格遵循規格自動命名為 「西元年月日時分秒.md」。

🌟 功能亮點與規格實作

  1. 兩種匯出方式：

    • 單一問題匯出：在每一則 AI 回答訊息卡片的頂部右側，新增了 [ 📥 匯出此題 Markdown ] 按鈕，點擊即可單獨匯出該次問答。
    • 全部問題匯出：在 AI 助教頂部 AppBar 右上方，新增了 [ 📥 匯出全部對話 ] 圖示按鈕，點擊即可一次匯出整個會話的全部歷史問答清單。

  2. 檔案命名規則：

    • 檔名嚴格採用「西元年月日時分秒.md」（例如：20260903_231545.md）。
    • 匯出單題時以該則回答的時間戳記命名；匯出全部對話時以當前匯出時間戳記命名。

  3. 匯出 Markdown 內容完整度：

    • 學員提問：完整保留學員詢問的問題內容。
    • 關聯考題：若該問題是點擊考題解析提問，會附上考題名稱與領域。
    • 推論模型規格：明確記錄推論使用的模型名稱（如 gemini-2.5-flash、Gemma 4 (2B) 離線、Gemma 4 (2B) 接管 等）。
    • 模型無法使用的具體原因明細：若雲端模型連線失敗、配額耗盡或未填寫 API Key，會清楚記錄完整的連線診斷原因（例如：您設定的 Google Gemini API Key 無效或尚未啟用、未配置 Google Gemini API Key (BYOK) 等）。
    • 專家角色規格：記錄當時回答所採用的專家顧問視角。
    • 完整回答內容：完整保存白皮書等級的排錯步驟、RFC 原理與架構配置。

  4. 跨平台原生 Blob 下載支援：

    • 在 Web 端使用標準 Blob 與 URL.createObjectURL 自動觸發瀏覽器下載。
    • 匯出完成後會彈出 SnackBar 提示：「✅ 已成功匯出問答紀錄：20260903_231545.md」。

🧪 驗證與發布狀態

  • 單元測試：新撰寫的 ai_tutor_export_test.dart 及全專案 54/54 項測試全部通過。
  • 靜態程式碼分析：flutter analyze ➔ 0 issues found。
  • GitHub 同步：提交 436c311 已推送至公開倉庫 main 分支。
  • Google Cloud Run 部署：

上一篇
OpenPassExam - Google Cloud Run 重新部署與刪除舊網站驗證報告
下一篇
將 App 調整成符合 Gemini 3.8 Flash 模型要求
系列文
將考國際證照的應用程式變成開源 共 64 篇
  1. 60
    將 App 調整成符合 Gemini 3.8 Flash 模型要求
  2. 61
    什麼是 Google Cloud Run 自動化發布管線？
  3. 62
    驗證使用 [ AI 助教 ] 後的結果
  4. 63
    Gemini 3 系列 ( 如: Gemini 3.8 ) 和 Gemini 2 系列 和 Gemini 1 系列在參數或設定或程式要求上是不太一樣的
  5. 64
    [ AI 助教] 整個排錯、架構調整與線上發布已全部到位
完整目錄
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言
iThome鐵人賽
參賽組數
493 組
團體組數
20 組
累計文章數
5207 篇
最後報名日
9/15
iT+看影片追技術 看影片追技術 看更多
熱門tag
15th鐵人賽 16th鐵人賽 13th鐵人賽 14th鐵人賽 17th鐵人賽 12th鐵人賽 11th鐵人賽 鐵人賽 2019鐵人賽 javascript 2018鐵人賽 18th鐵人賽 python 2017鐵人賽 windows php c# linux windows server css
熱門問題
熱門回答
熱門文章
IT邦幫忙