update

desktop.ini

@@ -0,0 +1,6 @@
+[.ShellClassInfo]
+IconResource=D:\other_thing\2�N���лP��Ƨ�\�N�׭�����Ƨ�\���A�Y�N�ת��B��\��.ico,0
+[ViewState]
+Mode=
+Vid=
+FolderType=Generic

firebase_progress.py

@@ -81,6 +81,73 @@ def log_solution_viewed(student_id: str, unit: str, solution_id: str) -> None:
       .set({"solutions_viewed_count": _increment(1), "last_seen": _now()}, merge=True)
 
 
+def log_choice_option(unit: str, qid: str, option_key: str) -> None:
+    """記錄某題某選項被選擇的次數（全班統計，存在 question_stats 集合）。"""
+    db = get_db()
+    ref = (
+        db.collection("question_stats")
+          .document(f"{unit}__{qid}")
+    )
+    ref.set({
+        "unit": unit,
+        "qid":  qid,
+        f"option_{option_key}": _increment(1),
+    }, merge=True)
+
+
+def log_quiz_question_stat(unit: str, qid: str, correct: bool) -> None:
+    """記錄某題全班答對/答錯次數（存在 question_stats 集合）。"""
+    db = get_db()
+    ref = db.collection("question_stats").document(f"{unit}__{qid}")
+    field = "correct_count" if correct else "wrong_count"
+    ref.set({"unit": unit, "qid": qid, field: _increment(1)}, merge=True)
+
+
+def get_all_question_stats() -> list[dict]:
+    """讀取所有題目的答題統計（老師後台用）。"""
+    db = get_db()
+    docs = db.collection("question_stats").stream()
+    return [d.to_dict() for d in docs]
+
+
+def register_question(
+    unit: str,
+    qid: str,
+    qtype: str,
+    prompt_runs: list | None = None,
+    prompt_md: str = "",
+    options: list | None = None,
+    correct_answer: str | list | None = None,
+) -> None:
+    """
+    在學生作答時，記錄題目原始內容到 question_stats。
+    每次都更新（允許覆蓋），確保每道題目各自正確記錄。
+    prompt_runs:    題目的 run 清單（含文字與 LaTeX）
+    prompt_md:      題目的 markdown 純文字（備援）
+    options:        選項清單 [{"key": "a", "text": "..."}, ...]
+    correct_answer: 正確答案 key（單選為 str，多選為 list）
+    """
+    db = get_db()
+    ref = db.collection("question_stats").document(f"{unit}__{qid}")
+    update: dict = {"unit": unit, "qid": qid, "qtype": qtype}
+    if prompt_runs is not None:
+        # 只存 text/latex 欄位，避免多餘 key 佔空間
+        update["prompt_runs"] = [
+            {k: v for k, v in r.items() if k in ("text", "latex", "kind", "style", "newline")}
+            for r in (prompt_runs or [])
+        ]
+    if prompt_md:
+        update["prompt_md"] = prompt_md[:300]
+    if options:
+        update["options"] = [{"key": o.get("key", ""), "text": o.get("text", "")} for o in options]
+    if correct_answer is not None:
+        if isinstance(correct_answer, list):
+            update["correct_answers"] = [str(k).lower() for k in correct_answer]
+        else:
+            update["correct_answers"] = [str(correct_answer).lower()]
+    ref.set(update, merge=True)
+
+
 def log_hint_used(student_id: str, unit: str, qid: str) -> None:
     """記錄學生使用了 AI 提示。"""
     log_event(student_id, "hint_used", unit=unit, qid=qid)

layout/renderer/dt_callbacks.py

@@ -94,8 +94,14 @@ def _cb_check_fill(n_check, n_hint, user_input, meta, prev_pass, student_id, pat
             qid = trig.get("qid", "")
             unit = (pathname or "").strip("/").replace("/", "_") or "unknown"
             try:
-                from firebase_progress import log_quiz_result
-                log_quiz_result(student_id, unit, qid, True)
+                from firebase_progress import log_quiz_result, log_quiz_question_stat, register_question
+                _meta = meta or {}
+                if qid:
+                    register_question(unit, qid, "fill",
+                        prompt_runs=_meta.get("prompt_runs"),
+                        prompt_md=_meta.get("prompt_md", ""))
+                log_quiz_result(student_id, unit, qid, True, answer=user_input or "")
+                log_quiz_question_stat(unit, qid, True)
             except Exception as e:
                 print(f"[Firebase] fill correct 失敗：{e}")
         return _feedback_child(right_msg), "green", "light", {}, True
@@ -103,8 +109,14 @@ def _cb_check_fill(n_check, n_hint, user_input, meta, prev_pass, student_id, pat
         qid = trig.get("qid", "")
         unit = (pathname or "").strip("/").replace("/", "_") or "unknown"
         try:
-            from firebase_progress import log_quiz_result
-            log_quiz_result(student_id, unit, qid, False)
+            from firebase_progress import log_quiz_result, log_quiz_question_stat, register_question
+            _meta = meta or {}
+            if qid:
+                register_question(unit, qid, "fill",
+                    prompt_runs=_meta.get("prompt_runs"),
+                    prompt_md=_meta.get("prompt_md", ""))
+            log_quiz_result(student_id, unit, qid, False, answer=user_input or "")
+            log_quiz_question_stat(unit, qid, False)
         except Exception as e:
             print(f"[Firebase] fill wrong 失敗：{e}")
     return _feedback_child(wrong_msg), "red", "light", {}, False
@@ -246,8 +258,26 @@ def _cb_check_choice(n_submit, n_hint, val, meta, student_id, pathname):
             qid = trig.get("qid", "") if isinstance(trig, dict) else ""
             unit = (pathname or "").strip("/").replace("/", "_") or "unknown"
             try:
-                from firebase_progress import log_quiz_result
-                log_quiz_result(student_id, unit, qid, ok)
+                from firebase_progress import log_quiz_result, log_quiz_question_stat, log_choice_option, register_question
+                _meta = meta or {}
+                options = _meta.get("options", [])
+                if qid:
+                    _correct = _meta.get("answers") if qtype == "multi" else _meta.get("answer")
+                    register_question(unit, qid, qtype,
+                        prompt_runs=_meta.get("prompt_runs"),
+                        prompt_md=_meta.get("prompt_md", ""),
+                        options=options or None,
+                        correct_answer=_correct or None)
+                # 記錄答題結果（含答案）
+                selected_answer = ",".join(sorted(selected)) if qtype == "multi" else (val or "")
+                log_quiz_result(student_id, unit, qid, ok, answer=selected_answer)
+                log_quiz_question_stat(unit, qid, ok)
+                # 記錄各選項被選次數（選擇題）
+                if qtype == "choice" and val:
+                    log_choice_option(unit, qid, str(val))
+                elif qtype == "multi":
+                    for sel_key in selected:
+                        log_choice_option(unit, qid, str(sel_key))
             except Exception as e:
                 print(f"[Firebase] choice 失敗：{e}")
 

layout/renderer/dt_quiz.py

@@ -160,6 +160,8 @@ def render_quiz(node: dict):
 
         meta = {
             "qtype": qtype, "prompt_text": full_prompt_text,
+            "prompt_runs": prompt_runs,
+            "prompt_md": prompt_md,
             "options": opts, "answer": q.get("answer", ""),
             "answers": q.get("answers", []), "explain": q.get("explain", ""),
             "msg_right": q.get("msg_right", "✔ 正確！"),
@@ -222,6 +224,8 @@ def render_quiz(node: dict):
             "normalize": q.get("normalize", []),
             "msg_right": node.get("right_msg", ""), "msg_wrong": node.get("wrong_msg", ""),
             "prompt_text": full_prompt_text,
+            "prompt_runs": prompt_runs,
+            "prompt_md": prompt_md,
             "ai": {
                 "enabled": str(node.get("ai", "1")).lower() not in ("0", "false", "no", "off"),
                 "provider": node.get("ai_provider") or "gemini",

layout/shell/header.py

@@ -1,3 +1,4 @@
+from dash_iconify import DashIconify
 # header.py (或你專案中產生 header 的檔案)
 from dash import html
 import dash_mantine_components as dmc
@@ -39,6 +40,19 @@ def generate_header():
         align="center",
         children=[
             create_student_badge(),
+            dmc.Anchor(
+                href="/teacher",
+                children=dmc.Tooltip(
+                    label="老師後台",
+                    children=dmc.ActionIcon(
+                        DashIconify(icon="tabler:layout-dashboard", height=18),
+                        size="md",
+                        variant="subtle",
+                        color="gray",
+                    ),
+                ),
+                style={"lineHeight": 0},
+            ),
             dmc.Switch(
                 id="color-scheme-switch", size="lg", color="gray",
                 onLabel="🌙", offLabel="☀️", persistence=True

pages/firebase_progress.py

@@ -0,0 +1,175 @@
+"""
+firebase_progress.py
+--------------------
+學生學習進度的讀寫邏輯。
+放在專案根目錄，由 dt_callbacks.py 和頁面呼叫。
+
+Firestore 資料結構：
+  students/{student_id}/
+    profile:  { name, student_id, last_seen }
+    progress: { quiz_correct, solutions_viewed, ai_hints_used, ... }
+    events:   [ { type, unit, qid, ts, ... }, ... ]  ← 子集合
+"""
+from __future__ import annotations
+import datetime
+from firebase_init import get_db
+
+# ─── 時間戳 ────────────────────────────────────────────────────────────────
+def _now() -> str:
+    return datetime.datetime.now(datetime.timezone.utc).isoformat()
+
+
+# ─── 學生個人資料 ──────────────────────────────────────────────────────────
+
+def upsert_student(student_id: str, name: str = "") -> None:
+    """建立或更新學生個人資料。"""
+    db = get_db()
+    ref = db.collection("students").document(student_id)
+    ref.set({
+        "student_id": student_id,
+        "name": name or student_id,
+        "last_seen": _now(),
+    }, merge=True)
+
+
+# ─── 記錄事件 ─────────────────────────────────────────────────────────────
+
+def log_event(student_id: str, event_type: str, **kwargs) -> None:
+    """
+    記錄一筆學習事件到 students/{student_id}/events 子集合。
+
+    event_type 範例：
+        "quiz_correct"    - 填空/選擇題答對
+        "quiz_wrong"      - 答錯
+        "solution_viewed" - 展開詳細解法
+        "hint_used"       - 按下 AI 提示
+        "quiz_ai_done"    - AI 批改完成
+    """
+    db = get_db()
+    payload = {
+        "type": event_type,
+        "ts": _now(),
+        **kwargs,  # unit, qid, answer, ...
+    }
+    db.collection("students").document(student_id)\
+      .collection("events").add(payload)
+
+
+def log_quiz_result(
+    student_id: str,
+    unit: str,
+    qid: str,
+    correct: bool,
+    answer: str = "",
+) -> None:
+    """記錄一題答題結果，同時更新 progress 計數。"""
+    event_type = "quiz_correct" if correct else "quiz_wrong"
+    log_event(student_id, event_type, unit=unit, qid=qid, answer=answer)
+
+    # 更新統計計數
+    db = get_db()
+    ref = db.collection("students").document(student_id)
+    field = "quiz_correct_count" if correct else "quiz_wrong_count"
+    ref.set({field: _increment(1), "last_seen": _now()}, merge=True)
+
+
+def log_solution_viewed(student_id: str, unit: str, solution_id: str) -> None:
+    """記錄學生展開了某個解法區塊。"""
+    log_event(student_id, "solution_viewed", unit=unit, solution_id=solution_id)
+    db = get_db()
+    db.collection("students").document(student_id)\
+      .set({"solutions_viewed_count": _increment(1), "last_seen": _now()}, merge=True)
+
+
+def log_choice_option(unit: str, qid: str, option_key: str) -> None:
+    """記錄某題某選項被選擇的次數（全班統計，存在 question_stats 集合）。"""
+    db = get_db()
+    ref = (
+        db.collection("question_stats")
+          .document(f"{unit}__{qid}")
+    )
+    ref.set({
+        "unit": unit,
+        "qid":  qid,
+        f"option_{option_key}": _increment(1),
+    }, merge=True)
+
+
+def log_quiz_question_stat(unit: str, qid: str, correct: bool) -> None:
+    """記錄某題全班答對/答錯次數（存在 question_stats 集合）。"""
+    db = get_db()
+    ref = db.collection("question_stats").document(f"{unit}__{qid}")
+    field = "correct_count" if correct else "wrong_count"
+    ref.set({"unit": unit, "qid": qid, field: _increment(1)}, merge=True)
+
+
+def get_all_question_stats() -> list[dict]:
+    """讀取所有題目的答題統計（老師後台用）。"""
+    db = get_db()
+    docs = db.collection("question_stats").stream()
+    return [d.to_dict() for d in docs]
+
+
+def register_question(unit: str, qid: str, prompt_text: str, qtype: str, options: list | None = None) -> None:
+    """
+    在第一次有學生作答時，記錄題目內容到 question_stats（若尚未存在）。
+    prompt_text: 題目文字（純文字，不含 LaTeX 標記也可）
+    options: [{"key": "a", "text": "..."}, ...] 或 None
+    """
+    db = get_db()
+    ref = db.collection("question_stats").document(f"{unit}__{qid}")
+    doc = ref.get()
+    if doc.exists and doc.to_dict().get("prompt_text"):
+        return  # 已有紀錄，不重複寫
+    update = {"unit": unit, "qid": qid, "qtype": qtype}
+    if prompt_text:
+        update["prompt_text"] = prompt_text[:300]  # 截斷避免過長
+    if options:
+        update["options"] = [{"key": o.get("key", ""), "text": o.get("text", "")} for o in options]
+    ref.set(update, merge=True)
+
+
+def log_hint_used(student_id: str, unit: str, qid: str) -> None:
+    """記錄學生使用了 AI 提示。"""
+    log_event(student_id, "hint_used", unit=unit, qid=qid)
+    db = get_db()
+    db.collection("students").document(student_id)\
+      .set({"ai_hints_used_count": _increment(1), "last_seen": _now()}, merge=True)
+
+
+# ─── 讀取 ────────────────────────────────────────────────────────────────
+
+def get_student_progress(student_id: str) -> dict:
+    """讀取單一學生的 progress 計數（老師後台用）。"""
+    db = get_db()
+    doc = db.collection("students").document(student_id).get()
+    if doc.exists:
+        return doc.to_dict()
+    return {}
+
+
+def get_all_students() -> list[dict]:
+    """讀取所有學生的 profile（老師後台列表用）。"""
+    db = get_db()
+    docs = db.collection("students").stream()
+    return [d.to_dict() for d in docs]
+
+
+def get_student_events(student_id: str, limit: int = 100) -> list[dict]:
+    """讀取某學生最近的事件記錄。"""
+    db = get_db()
+    docs = (
+        db.collection("students").document(student_id)
+          .collection("events")
+          .order_by("ts", direction="DESCENDING")
+          .limit(limit)
+          .stream()
+    )
+    return [d.to_dict() for d in docs]
+
+
+# ─── Firestore 遞增輔助 ───────────────────────────────────────────────────
+
+def _increment(n: int):
+    from google.cloud.firestore import Increment
+    return Increment(n)

pages/teacher.py

@@ -63,9 +63,32 @@ def layout():
                     dmc.Text("📚 單元答題統計", fw=700, size="lg", mb="sm"),
                     html.Div(id="teacher-unit-stats"),
 
+                    # 每題答題統計
+                    dmc.Divider(my="lg"),
+                    dmc.Text("📊 每題答題統計", fw=700, size="lg", mb="sm"),
+                    dmc.Text("（包含各選項被選次數）", size="sm", c="dimmed", mb="sm"),
+                    html.Div(id="teacher-question-stats"),
+
                     # 個別學生事件
                     dmc.Divider(my="lg"),
                     html.Div(id="teacher-events-section"),
+
+                    # 題目 doc_ids Store（由 load_dashboard 寫入）
+                    dcc.Store(id="teacher-question-doc-ids", data=[]),
+
+                    # 題目預覽 Modal
+                    dmc.Modal(
+                        id="teacher-question-modal",
+                        opened=False,
+                        centered=True,
+                        size="lg",
+                        title=dmc.Group([
+                            DashIconify(icon="tabler:file-text", height=20),
+                            dmc.Text("題目內容", fw=700),
+                        ], gap="xs"),
+                        children=html.Div(id="teacher-question-modal-body"),
+                    ),
+                    dcc.Store(id="teacher-question-modal-store", data=None),
                 ]),
         ],
     )
@@ -134,7 +157,11 @@ def clear_all_data(n):
                 "ai_hints_used_count": 0,
                 "solutions_viewed_count": 0,
             }, merge=True)
-        print("[Teacher] 已清除所有答題記錄")
+        # 清除每題統計
+        q_stats = db.collection("question_stats").stream()
+        for qs in q_stats:
+            qs.reference.delete()
+        print("[Teacher] 已清除所有答題記錄（含每題統計）")
     except Exception as e:
         print(f"[Teacher] 清除失敗：{e}")
     return 1  # 觸發重新整理
@@ -146,24 +173,25 @@ def clear_all_data(n):
     Output("teacher-stats-cards", "children"),
     Output("teacher-student-table", "children"),
     Output("teacher-unit-stats", "children"),
+    Output("teacher-question-stats", "children"),
     Input("teacher-auth-store", "data"),
     Input("teacher-refresh-btn", "n_clicks"),
     prevent_initial_call=False,
 )
 def load_dashboard(auth, _):
     if not auth:
-        return no_update, no_update, no_update
+        return no_update, no_update, no_update, no_update
 
     try:
         from firebase_progress import get_all_students, get_student_events
         students = get_all_students()
     except Exception as e:
         err = dmc.Alert(f"讀取失敗：{e}", color="red")
-        return err, err, err
+        return err, err, err, err
 
     if not students:
         empty = dmc.Text("目前沒有學生資料。", c="dimmed")
-        return empty, empty, empty
+        return empty, empty, empty, empty
 
     # ── 統計卡片 ──
     total   = len(students)
@@ -247,7 +275,73 @@ def load_dashboard(auth, _):
             dmc.TableTbody(dmc.TableTr(dmc.TableTd("沒有記錄"))),
         ])
 
-    return stats_cards, table, unit_table
+    # ── 每題答題統計 ──
+    try:
+        from firebase_progress import get_all_question_stats
+        q_stats_raw = get_all_question_stats()
+    except Exception:
+        q_stats_raw = []
+
+    question_rows = []
+    question_doc_ids = []  # 與 question_rows 同索引，對應 Firestore doc id
+    for qs in sorted(q_stats_raw, key=lambda x: (x.get("unit", ""), x.get("qid", ""))):
+        unit_raw  = qs.get("unit", "")           # 原始格式，如 "Ch14_6"
+        qid_raw   = qs.get("qid", "")            # 原始格式，如 "flow-15::step-1::q1"
+        unit_label = unit_raw.replace("_", "/")  # 顯示用
+        qid_label  = qid_raw
+        c = qs.get("correct_count", 0)
+        w = qs.get("wrong_count",   0)
+        t = c + w
+        rate = f"{c/t*100:.0f}%" if t > 0 else "—"
+
+        # 選項統計
+        option_keys = sorted([k for k in qs if k.startswith("option_")])
+        correct_answers = qs.get("correct_answers", [])  # list of correct key strings
+        if option_keys:
+            badges = []
+            for k in option_keys:
+                opt_key = k.replace("option_", "").lower()
+                is_correct = opt_key in [str(a).lower() for a in correct_answers]
+                badges.append(dmc.Badge(
+                    f"{opt_key.upper()}：{qs[k]}",
+                    color="green" if is_correct else "red",
+                    variant="light",
+                    size="sm",
+                ))
+            option_badges = dmc.Group(gap=4, children=badges)
+        else:
+            option_badges = dmc.Text("（填空題）", size="xs", c="dimmed")
+
+        question_rows.append(dmc.TableTr([
+            dmc.TableTd(unit_label, style={"fontSize": "12px"}),
+            dmc.TableTd(qid_label, style={"fontSize": "11px", "color": "#888"}),
+            dmc.TableTd(str(c), style={"color": "green", "fontWeight": 600}),
+            dmc.TableTd(str(w), style={"color": "red",   "fontWeight": 600}),
+            dmc.TableTd(rate),
+            dmc.TableTd(option_badges),
+            dmc.TableTd(dmc.Button(
+                "查看題目",
+                id={"type": "teacher-view-question", "idx": len(question_rows)},
+                size="xs", variant="subtle",
+                leftSection=DashIconify(icon="tabler:eye", height=12),
+            )),
+        ]))
+        question_doc_ids.append(f"{unit_raw}__{qid_raw}")
+
+    question_table = html.Div([
+        dcc.Store(id="teacher-question-doc-ids", data=question_doc_ids),
+        dmc.Table(
+            striped=True, withTableBorder=True,
+            children=[
+                dmc.TableThead(dmc.TableTr([dmc.TableTh(h) for h in
+                    ["單元", "題目 ID", "答對次數", "答錯次數", "正確率", "各選項次數", ""]])),
+                dmc.TableTbody(question_rows) if question_rows else
+                dmc.TableTbody(dmc.TableTr(dmc.TableTd("沒有記錄"))),
+            ]
+        ),
+    ])
+
+    return stats_cards, table, unit_table, question_table
 
 
 # ─── 個別學生事件 ─────────────────────────────────────────────────────────
@@ -276,12 +370,15 @@ def show_events(n_clicks_list):
     for ev in events:
         etype = ev.get("type", "")
         _, color = _event_style(etype)
+        answer_val = ev.get("answer", "")
+        answer_cell = dmc.Text(str(answer_val)[:40], size="xs", c="dimmed") if answer_val else dmc.Text("—", size="xs", c="dimmed")
         rows.append(dmc.TableTr([
             dmc.TableTd(dmc.Badge(etype, color=color, variant="light", size="sm")),
             dmc.TableTd(ev.get("unit", "—").replace("_", "/"),
                         style={"fontSize": "12px"}),
             dmc.TableTd(ev.get("qid") or ev.get("solution_id", "—"),
                         style={"fontSize": "11px", "color": "#888"}),
+            dmc.TableTd(answer_cell),
             dmc.TableTd((ev.get("ts", "")[:16] or "—").replace("T", " "),
                         style={"fontSize": "12px", "color": "#888"}),
         ]))
@@ -291,13 +388,120 @@ def show_events(n_clicks_list):
         dmc.Table(striped=True, withTableBorder=True,
             children=[
                 dmc.TableThead(dmc.TableTr([dmc.TableTh(h) for h in
-                    ["事件", "單元", "題目", "時間"]])),
+                    ["事件", "單元", "題目", "學生答案", "時間"]])),
                 dmc.TableTbody(rows) if rows else
                 dmc.TableTbody(dmc.TableTr(dmc.TableTd("沒有記錄"))),
             ]),
     ])
 
 
+# ─── 查看題目 Modal ──────────────────────────────────────────────────────
+
+@callback(
+    Output("teacher-question-modal", "opened"),
+    Output("teacher-question-modal-body", "children"),
+    Input({"type": "teacher-view-question", "idx": ALL}, "n_clicks"),
+    State("teacher-question-doc-ids", "data"),
+    prevent_initial_call=True,
+)
+def open_question_modal(n_clicks_list, doc_ids):
+    trigger = dash.callback_context.triggered_id
+    if not trigger or not isinstance(trigger, dict):
+        return no_update, no_update
+
+    # 確認是真正的點擊（n_clicks > 0），避免重整時觸發
+    idx = trigger.get("idx")
+    if idx is None:
+        return no_update, no_update
+    triggered_clicks = n_clicks_list[idx] if idx < len(n_clicks_list) else 0
+    if not triggered_clicks or triggered_clicks < 1:
+        return no_update, no_update
+
+    doc_ids = doc_ids or []
+    if idx >= len(doc_ids):
+        return no_update, no_update
+    doc_id = doc_ids[idx]
+
+    if not doc_id:
+        return no_update, no_update
+
+    try:
+        from firebase_init import get_db
+        db = get_db()
+        doc = db.collection("question_stats").document(doc_id).get()
+        if not doc.exists:
+            return True, dmc.Alert("找不到題目資料（學生尚未作答此題）。", color="yellow")
+        data = doc.to_dict()
+    except Exception as e:
+        return True, dmc.Alert(f"讀取失敗：{e}", color="red")
+
+    unit    = data.get("unit", "—").replace("_", "/")
+    qid     = data.get("qid", "—")
+    qtype   = data.get("qtype", "—")
+    options = data.get("options", [])
+
+    qtype_label = {"fill": "填空題", "choice": "單選題", "multi": "多選題", "order": "排序題"}.get(qtype, qtype)
+
+    # 把 prompt_runs 轉成 Markdown 字串（含 $...$ LaTeX）
+    prompt_runs = data.get("prompt_runs") or []
+    prompt_md   = data.get("prompt_md", "")
+
+    def runs_to_md(runs):
+        parts = []
+        for r in runs:
+            if "latex" in r:
+                latex = r["latex"].strip()
+                if r.get("kind") in ("math_block", "block_math", "display_math"):
+                    parts.append("\n\n$$\n" + latex + "\n$$\n\n")
+                else:
+                    parts.append(f"${latex}$")
+            elif "text" in r:
+                parts.append(r["text"])
+            if str(r.get("newline", "false")).lower() == "true":
+                parts.append("\n\n")
+        return "".join(parts).strip()
+
+    prompt_display = runs_to_md(prompt_runs) if prompt_runs else prompt_md
+
+    if not prompt_display:
+        prompt_component = dmc.Text(
+            "（此題題目文字嵌在上下文卡片中，請參考下方選項識別題目。）",
+            size="sm", c="dimmed", style={"fontStyle": "italic"},
+        )
+    else:
+        prompt_component = dcc.Markdown(
+            prompt_display,
+            mathjax=True,
+            style={"fontSize": "0.95rem", "lineHeight": "1.7"},
+        )
+
+    body_children = [
+        dmc.Group([
+            dmc.Badge(qtype_label, color="violet", variant="light"),
+            dmc.Text(f"單元：{unit}", size="sm", c="dimmed"),
+            dmc.Text(f"題目 ID：{qid}", size="sm", c="dimmed"),
+        ], gap="xs", mb="md"),
+        dmc.Divider(mb="md"),
+        dmc.Text("📝 題目：", fw=700, size="sm", mb=4),
+        dmc.Paper(prompt_component, p="sm", radius="sm", withBorder=True, mb="md"),
+    ]
+
+    if options:
+        body_children.append(dmc.Text("🔘 選項：", fw=700, size="sm", mb=4))
+        for op in options:
+            key  = op.get("key", "?")
+            text = op.get("text", "")
+            body_children.append(
+                dmc.Group([
+                    dmc.Badge(key.upper(), variant="outline", size="sm", color="blue"),
+                    dcc.Markdown(text, mathjax=True,
+                        style={"display": "inline", "fontSize": "0.9rem", "margin": 0}),
+                ], gap="xs", mb=4, align="center")
+            )
+
+    return True, html.Div(body_children)
+
+
 # ─── 輔助 ────────────────────────────────────────────────────────────────
 
 def _stat_card(label, value, icon, color):