📖 霖楓學苑 · 完整使用指南
從講義生產到網站部署,從招生行銷到教學營運,全部功能一次搞懂。
🚀 3分鐘快速開始
1
打開總控制台:在瀏覽器打開 G:\lam-fung-academy\launchpad.html
(或網上版:https://www.lfacademyhk.com/launchpad.html)
2
瀏覽講義:點擊「講義總索引」→ 搜尋或按年級瀏覽 208 份講義
3
生成答案冊:VS Code 終端機貼上:
python scripts/auto_answer_key.py --grade P5
4
發送家長報告:打開「家長報告生成器」→ 填寫 → 一鍵複製到 WhatsApp
5
部署到網站:終端機貼上:
python scripts/deploy.py --push
🌐 網站部署
你的網址
https://www.lfacademyhk.com
網站結構
| 網址 | 內容 | 用途 |
/ | 首頁(品牌介紹+課程+CTA) | 公開 Landing Page |
/enroll.html | 報名頁面 | 招生轉換 |
/testimonials.html | 學生見證牆 | Social Proof |
/sspa_rescue_package.html | SSPA急救包 | 高單價產品 |
/blog_trap_teaching.html | Blog·陷阱教學法 | SEO內容行銷 |
/講義/master_index.html | 講義總索引 | 全部208堂講義 |
/launchpad.html | 總控制台 | 內部營運(非公開) |
/講義/P5/LF-P5-上-L08_*.html | 小五第8堂講義 | 學生/家長下載 |
每次更新講義後部署
python scripts/deploy.py --push
這會自動 commit 所有變更 + push 到 GitHub。1-2分鐘後網站自動更新。
💡 自動同步架構:
本地編輯講義 → python scripts/deploy.py --push → GitHub Pages 自動更新 → https://www.lfacademyhk.com 即時生效
📚 講義系統
如何查找講義
1
打開 講義/master_index.html(可搜尋關鍵詞:如「面積」「分數」)
3
點擊任何講義 → 瀏覽器打開 → Ctrl+P 列印 PDF
講義結構(每份包含)
| 區塊 | 內容 |
| 封面 | Logo·課題·日期·SSPA關聯·前置知識·目標·陷阱 |
| 一、熱身啟動題 | 5題·5分鐘·複習前置知識 |
| 二、核心知識精講 | 3個知識點·3個例題·3個陷阱盒 |
| 三、分層練習 | 🌱基礎6題·🌿進階5題·🌳挑戰5題·🏔️極限2題 |
| 四、應用題 | 8題SSPA文字題 |
| 五、課後功課 | 基礎必做9題·進階選做5題 |
| 六、易錯點總結 | 7行易錯表·口訣·自我檢查框 |
| 七、解題四步卡 | 4步驟解題框架 |
| 家長角落 | 白話文摘要·3大陷阱·檢查問句 |
| 教師參考 | 重點題號·答案提示 |
如何生成答案冊
python scripts/auto_answer_key.py --grade P5 # 只做小五
python scripts/auto_answer_key.py # 全部年級
答案冊自動生成在講義同目錄下,檔名 _AK.html。目前33%題目可自動解答。
👩🏫 教學工作流程
上課前
上課中(65分鐘流程)
| 時間 | 環節 | 做什麼 |
| 0-5分 | 熱身啟動題 | 學生獨立完成 → 老師快速檢查答案 |
| 5-20分 | 核心知識精講 | 講解3個KP → 示範3個例題 → 強調陷阱盒 |
| 20-40分 | 課堂分層練習 | 🌱必做 → 🌿選做 → 🌳挑戰。老師巡視指導 |
| 40-52分 | 應用題 | SSPA文字題實戰 → 討論陷阱點 |
| 52-60分 | 總結 | 回顧易錯點 → 讀口訣 → 自我檢查 |
| 60-65分 | 功課佈置 | 明確指出必做題號 → 預告下堂 |
下課後(2分鐘內完成)
📣 行銷工作流程
招生漏斗
| 階段 | 工具 | 行動 |
| 1. 吸引 | SEO Blog + FB/IG廣告 | 發布陷阱教學文章 → 導流到免費診斷 |
| 2. 獲取 | 報名頁面 + 免費診斷測驗 | 家長預約 → WhatsApp自動回覆 |
| 3. 培育 | WhatsApp 5階段序列 | 診斷後3天跟進 → 提供價值 → 自然轉換 |
| 4. 轉換 | SSPA急救包 + 常規課程 | 個人化建議 → 早鳥優惠 → 報名 |
| 5. 留存 | 課後報告 + 進度追蹤 | 每堂報告 → 學期總結 → 升級推薦 |
| 6. 轉介 | 轉介獎勵 | 介紹朋友 → 雙方送堂 → 口碑擴散 |
按月份行銷重點
參考 學年行銷日曆 — 每月一個核心主題,對齊香港學校行事曆。
| 月份 | 重點 | 行動 |
| 6-7月 | 🔥 暑假招生 | 暑期營早鳥·下學年預留 |
| 9月 | 🔥 開學搶客 | 免費診斷·開學焦慮廣告 |
| 10-11月 | 🟡 呈分試1 | SSPA急救包·呈分試Webinar |
| 1月 | 🔥 成績單補底 | 成績單跟進·補底方案 |
| 3-4月 | 🟡 呈分試2 | 第二波SSPA急救包 |
| 5-6月 | 🟡 呈分試3 | 終極衝刺+暑假預告 |
🔧 常用自動化指令
| 要做什麼 | 指令(在 VS Code 終端機貼上) |
| 重建總索引 | python scripts/pipeline_master_index.py |
| 品質審計 | python scripts/pipeline_quality.py --issues-only |
| 生成答案冊 | python scripts/auto_answer_key.py |
| 注入SVG圖形 | python scripts/inject_figures.py |
| 升級v6 CSS | python scripts/upgrade_css.py |
| 修復學生體驗 | python scripts/fix_student_experience.py |
| 加入教師/家長功能 | python scripts/upgrade_teacher_parent.py |
| EN 翻譯 | python scripts/pipeline_en_translate.py --grade P5 |
| HTML→PDF 批次 | python scripts/pipeline_html2pdf.py --grade P5 |
| OCR 題庫搜尋 | python scripts/pipeline_ocr_extract.py --search "除法" |
| 部署到網站 | python scripts/deploy.py --push |
⚠️ 重要:每次修改講義後,必須執行 deploy 指令才能同步到網頁版!
python scripts/deploy.py --push → 自動 commit + push → 1-2分鐘後 https://www.lfacademyhk.com 更新
📱 跨平台支援
所有頁面已支援
| 平台 | 狀態 | 說明 |
| 🖥️ 桌面瀏覽器 | ✅ 完整 | Chrome/Edge/Firefox/Safari |
| 📱 手機瀏覽器 | ✅ 完整 | 全部頁面有響應式設計 |
| 📲 iPad/平板 | ✅ 完整 | 自適應螢幕尺寸 |
| 🖨️ 列印 PDF | ✅ 完整 | Ctrl+P → 自動優化列印版面 |
| 💬 WhatsApp 分享 | ✅ 完整 | 家長報告一鍵複製到 WhatsApp |
| 📧 Email 發送 | ✅ 可用 | 講義可作為附件發送 |
🔄 更新同步流程
講義更新 → 網頁同步
📝 修改講義 HTML(本地 G: 盤)
│
▼
🔧 python scripts/deploy.py --push
│
├─ git add 所有變更
├─ git commit 自動提交
└─ git push origin main
│
▼
🌐 GitHub Pages 自動建置(1-2分鐘)
│
▼
✨ https://www.lfacademyhk.com 更新完成
💡 提示:可以在修改多份講義後才執行一次 deploy。所有變更會一次性同步到網站。