按 → 可直接進入封面
PUBLIC CODE ・ MIT LICENSE

科技教育創新專區
阿凱老師

公共程式平臺上架內容報告

報告人 黃凱揚 資訊組長(阿凱老師)
桃園市龍潭區石門國民小學
2026.11.06(五)・數位發展部

SCAN REPORT ・ 2026.10.28
Fortify 中風險以上0
Mend 中風險以上0
開源授權MIT
平臺上架標準✓ 通過
// AGENDA

今天的 20 分鐘

01為什麼要做一個人的資訊組,面對全校老師的需求2 min
02怎麼做到老師提需求,AI 協作寫程式,自動上線3 min
03現場示範入口網、工具索引神器、主推工具4 min
04校園使用情形真實數據與帶課情境2 min
05上架之路與資安檢測Fortify 六次掃描、Mend 元件掃描3 min
06維運與被找到錯誤通報、Google Chat、SEO 與 GEO3 min
07開源與建議一鍵複製提示詞、給平臺的回饋4 min
// 01 WHY

一個人的資訊組,全校的需求

老師的日常需求
  • 班級經營:加扣分、抽籤分組、聯絡簿
  • 備課與上課:互動教材、即時投票
  • 行政:禮堂、專科教室、平板車預約
  • 需求很細,而且每天都在變
市售工具的門檻
  • 要註冊帳號,學生還要另外登入
  • 免費版有廣告或功能限制
  • 學生資料上傳到來源不明的伺服器
  • 流程不合學校實際作法,還是得手動補

→ 目標:免安裝、免註冊、照學校需求量身打造,老師打開就能用。

// 02 HOW

老師提需求,AI 協作寫程式

🗣️

提出需求

用口語描述
老師遇到的問題

🤖

AI 協作開發

AI Agent 寫程式
我負責審核與決策

🧪

自動測試

每次修改都
跑過檢查

🚀

自動上線

推上 GitHub
幾分鐘就更新

🔁

收回饋

老師用了再提
下一輪修改

134款教學工具
1,261次程式提交紀錄
22個月2025.01 開始至今
7大類依教學情境分類
// 02 HOW ・ CATALOG

從 6 款到 134 款,七大類一站找到

實用工具44
趣味遊戲26
教學資源24
即時互動16
語言學習14
親師溝通7
閱讀理解3
cagoooo.github.io/Akai
科技教育創新專區首頁截圖
// 04 USAGE

老師真的在用

7,861次入口網累計造訪
11,917次從入口網點開工具
2026 每月造訪次數
243
414
145
311
1,199
1,146
1,141
705
996
567
1月2月3月4月5月6月7月8月9月10月

斜線=不滿一個月(1/15 起記錄,10 月統計至 10/30)。資料來源:網站即時統計,2026.10.30 擷取。

// 04 USAGE ・ TOP 3

點開次數最多的三款

#10 ・ 實用工具
3,756次

班級小管家

學生名單、加扣分、抽籤分組、計時器、聯絡簿、作業檢查、監考,八大功能;多班級資料自動分開。

#81 ・ 教學資源
2,175次

資訊科技教學駕駛艙

三、五、六年級整學期的互動教學艙:從電腦入門、Scratch、micro:bit 到 AI 創作與媒體識讀。

#46 ・ 實用工具
1,222次

場地與平板車預約

禮堂、專科教室、平板車線上預約;熱力圖看使用情形,AI 自動撰寫學期使用報告。

// 05 PUBLIC CODE ・ TIMELINE

三週走完上架流程

10/06

收到上架說明

平臺寄來提交表與上架 SOP

10/07

完成送件

自行檢測:Semgrep、npm audit、機密掃描、防毒,皆 0 項

10/08

Fortify 初掃

237 筆,其中中風險以上 40 筆

10/13–15

四次複掃

逐筆修補,中風險以上降到 0

10/22

Mend 元件掃描

檢查第三方套件弱點與授權

10/28

複掃合格・送審

Fortify、Mend 中風險以上皆 0

→ 平臺標準:不得有中風險(含)以上弱點。每次收到報告,原則上當天修完、當天回覆。

// 05 PUBLIC CODE ・ SCAN

每一次掃描的結果

日期掃描總筆數中風險以上
10/08Fortify 初掃23740
10/13第 1 次複掃21834
10/14第 2 次複掃1966
10/15第 3 次複掃1931
10/15第 4 次複掃1920
10/28第 5 次複掃1890

剩下 189 筆皆為低風險,多數是建置腳本讀檔、開發用伺服器記錄等,不在正式網站執行。

FORTIFY 中風險以上
0/ 初掃 40
MEND 套件弱點
1/ 原 15剩 1 筆低風險(10/27 新公布)
// 05 PUBLIC CODE ・ FIXES

修了什麼:從掃描學到的事

開發用伺服器走一般 HTTP→改為只走加密的 HTTPS(TLS 1.2)
檔案路徑未檢查就讀寫→先正規化、限定資料夾再存取
用一般亂數產生識別碼→改用加密等級的安全亂數
第三方套件有已知弱點→升級到修補版本
沒在用、沒標授權的元件→直接移除,改用自己寫的程式
說明文字被誤判成密碼→改寫措辭,金鑰值一律放雲端金鑰庫

→ 心得:資安不是額外的工作,是讓其他學校敢拿去用的前提。

// 06 OPERATIONS ・ ALERT

出狀況時,系統會自己通報

💥

瀏覽器出錯

訪客畫面發生
程式錯誤

📡

兩處記錄

Sentry 追蹤
+雲端錯誤日誌

🧹

雲端函式過濾

去雜訊、分三級
同一錯誤限流

💬

Google Chat

卡片即時通知
手機馬上看到

🧾

自動開 Issue

AI 協助診斷
不直接改程式

SENTRY ・ 瀏覽器端

錯誤追蹤

  • 只在正式網站啟用
  • 不錄影、不追蹤個人行為
  • 頁面閒置後才載入,不拖慢首頁
  • 連線金鑰放 GitHub Secrets
雲端函式 ・ 後端

分級與限流

  • 嚴重(畫面白屏):同一錯誤 15 分鐘通知一次
  • 警告(功能壞、畫面在):60 分鐘一次
  • 擴充套件等雜訊:只記錄、不通知
GOOGLE CHAT

手機即時通知

  • 錯誤、新註冊、許願、評論
  • 每天 02:00 自動健檢,異常才通知
  • 免費,取代每月 200 則上限的 LINE
// 06 OPERATIONS ・ SEO / GEO

讓搜尋引擎與 AI 都找得到、讀得懂

三層導流:問題 → 文章 → 工具頁 → 實際工具
134頁

工具介紹頁

每款工具一頁:完整介紹、作者與學校、開源原始碼連結,附結構化資料。

135篇

教學情境長文

回答「老師怎麼用」,搜尋引擎讀到的就是全文,並連回相關工具。

→實際使用

工具本體

老師真正開啟、帶學生使用的網頁。

SEO ・ 給搜尋引擎
  • sitemap 列出 274 個本站網址
  • 每頁獨立標題與分享預覽圖
  • 每頁用結構化資料標明原始碼位置
GEO ・ 給 AI 引用
  • llms.txt:給 AI 讀的內容索引
  • robots.txt 明確允許 GPTBot、ClaudeBot、PerplexityBot 等
  • 每月用常見問題自測:AI 會不會推薦到我們
// 07 OPEN SOURCE

一個儲存庫,其他學校也能用

github.com/cagoooo/Akai ・ MIT
Akai/
├─ client/            # 前端網站
├─ functions/         # 後端雲端函式
├─ firestore.rules    # 資料庫安全規則
├─ .github/workflows/ # 自動測試與部署
├─ docs/security/     # 檢測與修補紀錄
└─ LICENSE            # MIT 授權

另外 92 個工具 repo 的說明文件,都連回入口網、工具介紹頁與教學文章,並標上教育、國小、臺灣等主題標籤。

① 複製一份程式

在 GitHub 上一鍵 Fork

② 換成自己學校的設定

建立自己的 Firebase 專案、改校名與工具清單

③ 推上去就自動上線

GitHub Pages 免費代管,不用架伺服器

+ 92 個工具各有公開 repo

工具介紹頁標題下方的「開源原始碼」按鈕 ← 一鍵直達 GitHub
// 07 OPEN SOURCE ・ REUSE

一鍵複製,貼給 AI 就能改成自己的版本

1

按下文章左下角的按鈕

「複製 AI 開發提示詞」,每篇文章各有一份

2

貼給自己的 AI 助手

ChatGPT、Claude、Gemini 都可以

3

填上自己的情境

身分、想解決的問題、環境限制

4

AI 讀原始碼、一步步改造

先提方案,每步都由老師確認

提示詞已附原始碼連結、金鑰不進程式碼、學生個資提醒、沿用須標註來源。

cagoooo.github.io/Akai/blog/…
部落格文章頁,左下角有複製 AI 開發提示詞按鈕 ← 一鍵複製
// 07 FEEDBACK

感謝與建議

感謝數位發展部與公共程式平臺團隊:三週內協助完成 6 次 Fortify、2 次 Mend 掃描,每份報告都逐項列出,讓一所小學也能把資安做到位。
01 ・ 最關鍵的幫助

平臺協助檢測

Fortify、Mend 這類商用工具,學校自己很難負擔。建議把「平臺協助檢測」做成學校送件的固定服務。

02 ・ 降低門檻

學校版上架指引

學校多半沒有資安人力。若有給學校的檢測流程、報告範本與常見問答,會有更多老師的作品願意上架。

03 ・ 節省時間

常見誤判說明

「近似比對」把常見檔案判成別人的專案、說明文字被當成密碼,查證很花時間。有判讀說明,雙方都省事。

04 ・ 擴大效益

教育類交流與再利用

讓教育類公共程式容易被其他學校找到、沿用,真正做到「一校開發,各校受惠」。

// END

一位老師開始,讓更多學校受惠

桃園市龍潭區石門國民小學 教務處資訊組|黃凱揚 資訊組長|謝謝聆聽,敬請指教