霖楓學苑霖楓學苑 ← 返回首頁

📖 霖楓學苑 · 完整使用指南

從講義生產到網站部署,從招生行銷到教學營運,全部功能一次搞懂。

🚀 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.htmlSSPA急救包高單價產品
/blog_trap_teaching.htmlBlog·陷阱教學法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(可搜尋關鍵詞:如「面積」「分數」)
2
按年級瀏覽:P3/P4/P5/P6 各40+堂
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%題目可自動解答。

👩‍🏫 教學工作流程

上課前

1
打開講義 → 預覽封面資訊(陷阱·目標)
2
檢查「教師參考」區 → 確認本堂重點題號
3
如需要,打開答案冊(_AK.html)參考

上課中(65分鐘流程)

時間環節做什麼
0-5分熱身啟動題學生獨立完成 → 老師快速檢查答案
5-20分核心知識精講講解3個KP → 示範3個例題 → 強調陷阱盒
20-40分課堂分層練習🌱必做 → 🌿選做 → 🌳挑戰。老師巡視指導
40-52分應用題SSPA文字題實戰 → 討論陷阱點
52-60分總結回顧易錯點 → 讀口訣 → 自我檢查
60-65分功課佈置明確指出必做題號 → 預告下堂

下課後(2分鐘內完成)

1
打開「家長報告生成器」 → 填寫學生表現
2
點擊「生成報告」 → 自動複製到剪貼簿
3
WhatsApp 貼上發送給家長
4
(可選)更新「學生進度追蹤器」記錄分數

📣 行銷工作流程

招生漏斗

階段工具行動
1. 吸引SEO Blog + FB/IG廣告發布陷阱教學文章 → 導流到免費診斷
2. 獲取報名頁面 + 免費診斷測驗家長預約 → WhatsApp自動回覆
3. 培育WhatsApp 5階段序列診斷後3天跟進 → 提供價值 → 自然轉換
4. 轉換SSPA急救包 + 常規課程個人化建議 → 早鳥優惠 → 報名
5. 留存課後報告 + 進度追蹤每堂報告 → 學期總結 → 升級推薦
6. 轉介轉介獎勵介紹朋友 → 雙方送堂 → 口碑擴散

按月份行銷重點

參考 學年行銷日曆 — 每月一個核心主題,對齊香港學校行事曆。

月份重點行動
6-7月🔥 暑假招生暑期營早鳥·下學年預留
9月🔥 開學搶客免費診斷·開學焦慮廣告
10-11月🟡 呈分試1SSPA急救包·呈分試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 CSSpython 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。所有變更會一次性同步到網站。
🪤 霖楓學苑 · LF Academy · 完整使用指南 v1.0 · 回 Launchpad