---
name: hk-dse-study-notes
slug: hk-dse-study-notes
displayName: 香港DSE學習教材生成器
version: 2.0.0
description: 為香港中三升中四 / DSE 學生設計的學習教材生成器。一次配置產出完整筆記（中/英）+ Q&A 播客音頻（中/英）+ 章節中心頁（中/英）。涵蓋物理 / 數學 / 化學 / 生物四科配色方案與三層難度練習。基於 2026-08-10~11 完成的 4 章物理 + 2 章數學教材沉澱而成，於 2026-08-11 優化一鍵整合流程。
namespace: global
allowed-tools: Read,Write,Bash,WebSearch
tags:
  - 香港DSE
  - 中三升中四
  - 物理
  - 數學
  - 化學
  - 生物
  - 教材生成
  - TTS
  - 中英雙語
author: openclaw-workspace
homepage: file:///home/ubuntu/.openclaw/workspace/skills/hk-dse-study-notes
license: MIT
---

# 香港 DSE 學習教材生成器 v2

## 🎯 一句話說明

**1 個 JSON + 1 行命令 = 4 件套學習材料**（中英筆記 + Q&A 播客 + 章節中心頁）

## 📚 4 件套交付物

| # | 類型 | 語言 | 格式 | 用途 |
|---|------|------|------|------|
| 1 | 📘 完整筆記 | 中文 | HTML | 圖文並茂，可手機觀看 |
| 2 | 📘 完整筆記 | 英文 | HTML | 全英文寫作（LLM 級，非機器替換）|
| 3 | 🎧 Q&A 播客 | 普通話 | MP3 | 婷婷（小藝）+ 阿明（雲揚）雙人考問 |
| 4 | 🌐 章節中心頁 | 中英 | HTML | 含 MP3 播放器 + 材料卡片網格 |

## 🚀 5 分鐘上手（推薦）

### 一鍵整合腳本

```bash
bash /home/ubuntu/.openclaw/workspace/skills/hk-dse-study-notes/scripts/make_chapter.sh \
    2026-08-11/chapter2_refraction.json \
    /home/ubuntu/.openclaw/workspace/
```

完成後自動產出：
```
物理/chapter2_refraction/
├── chapter2_refraction_notes_zh.html     # 中文筆記
├── chapter2_refraction_notes_en.html     # 英文筆記
├── chapter2_refraction.qa.txt            # Q&A 腳本
├── qa_podcast.mp3                          # Q&A MP3（小藝+雲揚）
├── index.html                              # 中文章節頁
└── index_en.html                           # 英文章節頁
```

### 逐步驟（自訂流程）

```bash
# Step 1: 中英雙語筆記
python3 scripts/bilingual_notes_generator.py <chapter.json> <output_dir>

# Step 2: 章節頁（中英）
python3 scripts/chapter_page_generator.py <chapter.json> <output_dir> <subject_dir>

# Step 3: Q&A 腳本（用 qa-podcast-gen skill）
python3 /home/ubuntu/.openclaw/workspace/skills/qa-podcast-gen/scripts/qa_podcast_generator.py \
    <chapter.json> <output_dir>/{base}.qa.txt

# Step 4: Q&A MP3
python3 /home/ubuntu/.openclaw/workspace/scripts/qa_to_mp3.py \
    <output_dir>/{base}.qa.txt <output_dir>/qa_podcast.mp3
```

## 📋 JSON 配置格式

```json
{
  "title": "Chapter 5：波的性質",
  "h1": "🌊 Chapter 5：波的性質（Wave Properties）",
  "subject": "physics",
  "filename_base": "chapter5_waves",
  "textbook": "Pan Lloyds Pre-DSE Optics Ch5",
  "total_questions": 12,
  "duration_min": 30,
  "sections": [
    {
      "title": "5.1 波的定義",
      "content": ["<h3>📐 定義</h3>", "<p>...</p>"],
      "tts_content": ["<p>波是能量的傳遞...</p>"]
    }
  ],
  "summary": ["<div class=\"keypoint\">核心：</div>"],
  "common_errors": ["<div class=\"warning\">⚠️ 易錯...</div>"],
  "quick_quiz": ["<div class=\"example\"><strong>練習：</strong>...</div>"]
}
```

## 🎨 配色主題（永久）

| 主題 key | 學科 | 主色調 |
|---------|------|--------|
| `physics` | 物理 | 青藍（#00acc1）|
| `math` | 數學 | 天空藍（#0288d1）|
| `chemistry` | 化學 | 紫（#7b1fa2）|
| `biology` | 生物 | 綠（#2e7d32）|

## 🔧 可用 CSS class（內容區用得到）

| class | 用途 |
|-------|------|
| `.formula` | 公式框 |
| `.keypoint` | 重點提示（綠底）|
| `.important` | 重要警示（紅邊）|
| `.note` | 補充說明（橘底）|
| `.example` | 範例框（藍底）|
| `.tip` | 小提示 |
| `.warning` | 警告 |
| `.summary-box` | 總結框（金色）|
| `.memory-tip` | 記憶口訣（粉紅）|
| `.step` | 解題步驟 |
| `.highlight` | 段落高亮 |

## 🎙️ 語音配置（永久，2026-08-11 起）

| 用途 | 語音 | Edge TTS 代碼 |
|------|------|--------------|
| 🎧 Q&A 播客女聲（婷婷）| 小藝 Xiaoyi | `zh-CN-XiaoyiNeural` |
| 🎧 Q&A 播客男聲（阿明）| 雲揚 Yunyang | `zh-CN-YunyangNeural` |
| 📖 筆記朗讀女聲 | 曉曉 Xiaoxiao | `zh-CN-XiaoxiaoNeural` |

語音服務：`http://193.112.101.212:3500/api/tts/raw`

## 📁 Skill 檔案結構

```
hk-dse-study-notes/
├── SKILL.md                              # 本文件
├── templates/                            # HTML 模板（已內嵌於生成器）
├── scripts/
│   ├── generate_study_pack.py            # 主生成器（單檔版）
│   ├── bilingual_notes_generator.py      # 中英雙語筆記 v2
│   ├── chapter_page_generator.py         # 章節中心頁生成器
│   └── make_chapter.sh                   # ⭐ 一鍵整合腳本（推薦）
└── examples/
    └── chapter5_waves.json               # 範例配置
```

## 📝 英文筆記規則（永久，2026-08-11）

英文版必須是 **100% native English** 寫作：

❌ **禁止**：
- 中文逐字翻譯
- 中英混雜（如「折射率是 n = c/v」）
- 簡單單詞替換（如「折射」→「Refraction」）

✅ **必須**：
- LLM 級英文寫作
- 物理/數學術語用國際標準英文
- 公式保留、SVG 保留、表格改寫為英文
- 符合香港 DSE 國際認可的英文教材風格

## ⚠️ 自動觸發關鍵詞

當用戶說這些詞，立即按 4 件套執行：
- 「做 Chapter X」「新章節」「新科目」
- 「中英文筆記」「Q&A 音頻」
- 「小藝雲揚」「曉曉」

## ✅ 已完成章節（截至 2026-08-11）

```
✅ 物理/chapter2_refraction/  (折射) - 4 件套
✅ 物理/chapter3_lenses/      (透鏡) - 4 件套
✅ 物理/chapter4_em_spectrum/ (電磁波譜) - 4 件套
✅ 物理/chapter5_waves/       (波的性質) - 4 件套
✅ 數學/math1_factorize/      (因式分解) - 4 件套
✅ 數學/math2_indices/        (指數) - 4 件套
⏳ 化學 / 生物 章節（待規劃）
```

## 🔗 相關 Skills

- **qa-podcast-gen**：Q&A 腳本自動生成（婷婷+阿明）
- **podcastfy**（GitHub）：TTS MP3 生成
- **math-mistake-review-skill**：錯題照片分析
- **super-ocr-pro**：教科書圖片 OCR
- **english-vocab-booster**：英文詞彙（未啟用）
- **exam-sprint-planner-new**：DSE 備考規劃（未啟用）