update

app.py

@@ -22,6 +22,7 @@ import os
 import io
 import time
 import json
+from datetime import timedelta
 from urllib.parse import urlparse, parse_qs
 
 from google.cloud import storage
@@ -347,6 +348,18 @@ def docx_to_text(file):
 
 
 # ---- YouTube link ----
+def parse_time(time_str):
+    """將時間字符串 'HH:MM:SS' 或 'MM:SS' 轉換為 timedelta 物件。"""
+    parts = list(map(int, time_str.split(':')))
+    if len(parts) == 3:
+        hours, minutes, seconds = parts
+    elif len(parts) == 2:
+        hours = 0  # 沒有小時部分時，將小時設為0
+        minutes, seconds = parts
+    else:
+        raise ValueError("時間格式不正確，應為 'HH:MM:SS' 或 'MM:SS'")
+    return timedelta(hours=hours, minutes=minutes, seconds=seconds)
+
 def format_seconds_to_time(seconds):
     """将秒数格式化为 时:分:秒 的形式"""
     hours = int(seconds // 3600)
@@ -1188,10 +1201,13 @@ def generate_key_moments(formatted_simple_transcript, formatted_transcript):
     print(key_moments)
     print("=====key_moments=====")
     image_links = {entry['start_time']: entry['screenshot_path'] for entry in formatted_transcript}
+
     for moment in key_moments:
-        start_time = moment['start']
-        end_time = moment['end']
-        moment_images = [image_links[time] for time in image_links if start_time <= time <= end_time]
+        start_time = parse_time(moment['start'])
+        end_time = parse_time(moment['end'])
+        # 使用轉換後的 timedelta 物件進行時間比較
+        moment_images = [image_links[time] for time in image_links 
+                        if start_time <= parse_time(time) <= end_time]
         moment['images'] = moment_images
 
     return key_moments

educational_material.py

@@ -49,7 +49,7 @@ class EducationalMaterial:
 
     def _generate_worksheet_prompt(self):
         bloom_worksheet_prompt = """
-        你是個專業的教師，，遇到數學符號或是敘述請用 Latex 語法($...$)，例如：$x^2$。
+        你是個專業的教師，遇到數學符號或是敘述請用 Latex 語法($...$)，例如：$x^2$。
         熟悉布魯姆(Benjamin Bloom, 1964) 的認知理論。布魯姆認為人類的能力，大致可分為三個領域(domains)，即認知領域(cognitive domain)、情意領域(affective domain)、技能領域 (psychomotor domain)。
         
         【認知領域】涉及知能及其運作，著重心智、學習以及問題解決的工作。認知目標從簡單的認識或記憶能力到複雜的評鑑能力。大部分的教育目標都屬於這個領域。認知領域的目標分為六個層次，每個層次代表不同的心智功能。
@@ -70,33 +70,33 @@ class EducationalMaterial:
         其中，「重點」的題目請用挖空的填空題；在「想一想」的程序性問題請以單選題或填空題的形式來建立，需要 3 個題目；「延伸與應用」請使用問答題的形式來建立，一題即可。
         題目和題目之間要換行，並加上 point 符號，像是 "-" 或是 "1." 等等
 
-        這是範例格式：
-        🌐【主題】：認識公里
+        輸出 Markdown，這是範例格式：
+        ### 🌐【主題】：認識公里
 
-        🎓【對象】 
+        ### 🎓【對象】 
         - 科目： 數學
         - 年級： 三年級
         - 難度： 基礎
 
-        🏞️【情境描述】
+        ### 🏞️【情境描述】
         - 狐狸貓和家人出遊，過程中認識測量較長距離的單位「公里」。
 
-        🔑【影片重點】
+        ### 🔑【影片重點】
         - 公里是用來測量長距離的單位，通常用於測量很遠的距離。
         - 1公里等於＿＿＿公尺，也稱為千米。
         - 公里的英文簡寫是 ＿＿＿＿。
 
-        🌟【概念】
+        ### 🌟【概念】
         - 請問公里通常用於測量什麼類型的距離？
         - 如果一圈操場是200公尺，那跑5圈是多少公尺？多少公里？
         - 為什麼我們需要使用公里這個單位來測量距離？
 
-        🔢【想一想】
+        ### 🔢【想一想】
         1. 一圈操場是200公尺，跑10圈是多少公里？(A) 1公里 (B) 2公里 (C) 3公里 (D) 4公里
         2. 如果你跑了5圈操場，運動手環上會顯示你跑了多少公里？
         3. 6000公尺等於多少公里？
 
-        💡【延伸與應用】
+        ### 💡【延伸與應用】
         - 假設你參加一場慈善路跑活動，全程是5公里。如果你已經跑了3公里，還剩下多少公里？你覺得這樣的活動對你的體能有什麼影響？
         """
 
@@ -112,39 +112,43 @@ class EducationalMaterial:
         請以此設計學習單並依據文本跟難度給予題目
         請一定要使用 zh-TW
         
-        這是範例格式：
-        🌐 主題：【概念】認識公里
+        輸出 Markdown，這是範例格式：
+        ## 🌐 主題：【概念】認識公里
 
-        🎓【對象】
+        ### 【對象】
         - 科目： 數學
         - 年級： 三年級
         - 難度： 基礎
 
-        🏞️【情境描述】
-        狐狸貓和家人出遊，過程中認識測量較長距離的單位「公里」。
+        ### 🏞️【情境描述】
+        - 狐狸貓和家人出遊，過程中認識測量較長距離的單位「公里」。
 
-        ❓【給出問題】
+        ### ❓【給出問題】
         - 如果日月潭環潭自行車道共30公里，狐狸貓騎行了13.7公里後休息，剩餘多少公里尚未騎行？
         
-        🤔【理解問題】
+        ### 🤔【理解問題】
+
         首先，我們必須完全理解問題的所有細節。在此情境中，我們需要釐清以下幾點：
         - 日月潭環潭自行車道的總長度為30公里。
         - 狐狸貓已經騎行了13.7公里。
         - 我們的目標是計算狐狸貓還剩下多少公里未騎行。
 
-        🧭【設計解題策略】
+        ### 🧭【設計解題策略】
+
         接下來，根據我們對問題的理解來設計解決問題的計劃。在此步驟中，我們決定採用哪種策略來解決問題。對於這個問題，最直接的計劃是使用算術減法：
         - 總公里數（30公里）減去已騎行的公里數（13.7公里）。
 
-        📝【按步解題】
+        ### 📝【按步解題】
+
         按照設計的計劃執行解題步驟。在這裡我們執行減法運算：
-        30−13.7=16.3
+        $$ 30−13.7=16.3 $$
         這意味著狐狸貓還有16.3公里未騎行。
 
-        ✨【回顧解答】
-        最後，解題完成後，我們回顧和反思整個解題過程。在這一步，我們驗證「想一想」的結果是否符合邏輯��是否正確解決了原問題。
-        同時，考慮是否有更有效或簡便的方法來解決類似的問題。在這個例子中，使用直接減法是最簡單直接的方法。
-        但在其他情境下，可能需要考慮使用圖形、表格或代數表達式等其他策略來解決問題。
+        ### ✨【回顧解答】
+
+        - 最後，解題完成後，我們回顧和反思整個解題過程。在這一步，我們驗證「想一想」的結果是否符合邏輯，是否正確解決了原問題。
+        - 同時，考慮是否有更有效或簡便的方法來解決類似的問題。在這個例子中，使用直接減法是最簡單直接的方法。
+        - 但在其他情境下，可能需要考慮使用圖形、表格或代數表達式等其他策略來解決問題。
         """
         
         # CRA教學法
@@ -158,25 +162,26 @@ class EducationalMaterial:
         最後一個階段，即抽象(A)階段，是一個抽象的“符號”階段， 在這一階段， 教師使用數字、字母等數學符號(如:2, 6, 3x, +,-等)來進行教學。
         運用CRA的前提是學生在學習“規則”前必須學會概念。使用過加工材料的學生，其思維更加明確，更容易理解該方式，同時其學習動機、專注行爲、 理解力以及對這些概念的運用能力也會得到較大改善( Hrrison & Harison, 1986 )。
         CRA策略可以有效地幫助學生理解以下幾個概念：早期數量關係、位值、計算、分數、小數、測量、幾何、貨幣、百分數、數基、應用題、概率以及統計等
-        這是範例格式：
-        🌐 主題：【概念】認識公里
+        
+        輸出 Markdown，這是範例格式：
+        ### 🌐 主題：【概念】認識公里
 
-        🎓【對象】
+        ###【對象】
         - 科目： 數學
         - 年級： 三年級
         - 難度： 基礎
 
-        【實例(C)階段】
+        ### 【實例(C)階段】
         1. 用彩色圓片來解釋什麼是分數？
         2. 用立方體來解釋什麼是體積？
         3. 用十進位積木來解釋什麼是小數？
 
-        【描述(R)階段】
+        ###【描述(R)階段】
         1. 用手繪圖片來解釋什麼是分數？
         2. 用貼紙來解釋什麼是體積？
         3. 用手繪圖片來解釋什麼是小數？
 
-        【抽象(A)階段】
+        ###【抽象(A)階段】
         1. 用數字來解釋什麼是分數？
         2. 用字母來解釋什麼是體積？
         3. 用數字來解釋什麼是小數？
@@ -204,6 +209,7 @@ class EducationalMaterial:
             3. 【課程大綱】的工作項目請嚴格遵守【課程時間】的時間長度，總和時間不要超過或不足
             4. 時間安排盡量以五分鐘的倍數為一個單位
             5. 並且根據課程目標安排教學內容
+            6. 遇到數學符號或是敘述請用 Latex 語法($...$)，例如：$x^2$。
             Step1. 你是一個精通於課程設計的老師，能夠運用 ADDIE 教學策略來設計一門適合學生的課程。
             Step2. 接下來，當使用者按下  "Conversation staters" 的 "請上傳逐字稿"，你將依據輸入的影片逐字稿 (請使用 python 程式來分析、解讀內容)，來規劃一堂 40 分鐘以 ADDIE 模型作為架構的課程，內容請使用台灣口語 (zh_TW)。
             - 以下是 ADDIE 的說明：
@@ -231,38 +237,38 @@ class EducationalMaterial:
             Step4. 請在「設計」和「實施」階段請使用合適的範例做說明。
             Step5. 請使用 Markdown 語法，標題與段落文字的字級需有所區隔。
 
-            example:
-            # 課程設計：面積的實測與估測
+            output Markdown，example as below:
+            ## 課程設計：面積的實測與估測
             
-            # 教學重點
+            ### 教學重點
             1. 面積的概念：解釋什麼是面積，以及它在日常生活中的應用。
             2. 面積的計算：教授如何計算不同形狀的面積（例如矩形、三角形）。
             3. 實測與估測的區別：比較實際測量面積和估算面積的不同方法。
             4. 應用實例：使用日常生活中的例子，例如給麥麥的生日卡片大小的比較，來說明面積的重要性。
             
-            # 分析（Analysis）
+            ### 分析（Analysis）
             - 目標學習者：小學高年級學生。
             - 學習需求：理解面積概念，掌握基本面積計算方法。
             - 學習風格：結合視覺教材和互動活動。
             
-            # 設計（Design）
+            ### 設計（Design）
             - 課程目標：學生能夠理解面積概念，並能透過實際操作學會估算和計算面積。
             - 學習單元：（a）面積基礎概念（b）計算面積（c）實測與估測的比較。
             - 教學策略：透過互動遊戲、��例討論和實作活動進行教學。
             - 評估方法：透過小測驗和課堂參與情況進行評估。
             
-            # 開發（Development）
+            ### 開發（Development）
             - 教材準備：準備視覺化教學幻燈片，設計互動遊戲和實作活動。
             - 教學活動：設計面積估測遊戲，讓學生在實際操作中學習。
             
-            # 實施（Implementation）
+            ### 實施（Implementation）
             - 課程時間分配：（a）面積基礎概念（10分鐘）（b）計算面積（15分鐘）（c）實測與估測比較（10分鐘）（d）總結與回顧（5分鐘）。
             - 教學範例：
                 - 面積基礎概念：介紹面積是如何在日常生活中應用，例如計算桌布的大小。
                 - 計算面積：透過計算教室黑板或門的面積來教學。
                 - 實測與估測比較：讓學生估計並實際測量教室中物品的面積，比較結果。
             
-            # 評估（Evaluation）
+            ### 評估（Evaluation）
             - 教材評估：確保教材能清楚傳達面積概念。
             - 學習者反應：觀察學生參與情況，收集反饋以改善教學。
             - 學習成就：透過小測驗評估學生對面積概念的理解。
@@ -282,6 +288,7 @@ class EducationalMaterial:
             3. 【課程大綱】的工作項目請嚴格遵守【課程時間】的時間長度，總和時間不要超過或不足
             4. 時間安排盡量以五分鐘的倍數為一個單位
             5. 並且根據課程目標安排教學內容
+            6. 遇到數學符號或是敘述請用 Latex 語法($...$)，例如：$x^2$。
             
             Lesson Planner 5E is specialized in developing lesson plans for various subjects including Mathematics, Physics, Chemistry, and Biology, using the 5E instructional model. Teachers can input transcripts or text related to these subjects, and the GPT will analyze the content to create a comprehensive lesson plan. The plan will follow the 5E stages: Engagement, Exploration, Explanation, Elaboration, and Evaluation. Each stage will be customized to suit the subject matter, ensuring that students are engaged and the learning objectives are met. For Mathematics, the GPT might suggest problem-solving activities; for Physics, interactive experiments; for Chemistry, lab demonstrations; and for Biology, field studies or observations. The GPT's goal is to make science and math subjects accessible and interesting for students, fostering a deeper understanding through hands-on and inquiry-based learning.
 
@@ -298,34 +305,35 @@ class EducationalMaterial:
 
             Step2：請根據逐字稿的內容描述，以 5E 架構來創建一份 Lesson Plan (課程計畫)。請依循並參考以下輸出範例來設計課程計畫)，需使用 markdown 語法：
 
-            ## 輸出範例：
+            ---
+            output Markdown，example as below:
 
-            課程主題：同分母分數的加減 (使用影片或逐字稿的標題)
-            課程重點：(列出逐字稿內容的重要概念或教學重點)
-            年級：四年級 (依據詢問的年齡或年級填入)
-            課程長度：45-50 分鐘（根據課程數入時間訂定）
+            ## 課程主題：同分母分數的加減 (使用影片或逐字稿的標題)
+            ###  課程重點：(列出逐字稿內容的重要概念或教學重點)
+            ###  年級：四年級 (依據詢問的年齡或年級填入)
+            ###  課程長度：45-50 分鐘（根據課程數入時間訂定）
 
-            【參與】（5 分鐘）
+            ### 【參與】（5 分鐘）
 
             - 透過在黑板或投影機上顯示切成不同部分的披薩的圖片來開始課程。
             - 讓學生與夥伴討論他們注意到分數的什麼以及如何將它們加在一起或減在一起。
             - 幾分鐘後，請幾位學生與全班分享他們的觀察和想法。
 
-            【探索】（10 分鐘）
+            ###【探索】（10 分鐘）
 
             - 發給每位學生分數操作工具（例如分數條、分數圓）。
             - 為每個學生提供一份工作表，其中包含幾個涉及具有相同分母的分數的加法和減法問題。
             - 指導學生使用操作工具解決工作表上的問題。
             - 在房間裡走動，觀察學生的理解情況，並根據需要提供指導。
 
-            【解釋】（10 分鐘）
+            ###【解釋】（10 分鐘）
 
             - 讓全班同學重新聚集在一起，討論相同分母分數加法和減法的策略和方法。
             - 介紹關鍵詞彙：分子、分母、分數、同分母。
             - 顯示並解釋公式：如果兩個分數具有相同的分母，則將分子相加或相減，然後寫出公分母的和或差。
             - 提供同分母分數加減法的例子，示���步驟和計算。
 
-            【學習共同體】（15 分鐘）
+            ###【學習共同體】（15 分鐘）
 
             - 將學生分成兩人一組或小組。
             - 向每組分發一組分數加法和減法任務卡。
@@ -333,23 +341,24 @@ class EducationalMaterial:
             - 鼓勵學生互相解釋他們的想法和推理。
             - 在教室裡走動以了解學生的進度並在需要時提供支持或澄清。
 
-            【評估】（10 分鐘）
+            ###【評估】（10 分鐘）
 
             - 要求每個小組選擇一張任務卡並向全班展示他們的解決方案。
             - 作為一個班級，討論各小組使用的不同策略並評估他們解決方案的正確性。
             - 提供回饋並澄清討論期間出現的任何誤解。
             - 收集學生的工作表和任務卡，作為他們理解的形成性評估。
 
-            【總結】
+            ###【總結】
 
             - 總結課程中討論的重點，強調分數加減法時分母相同的重要性。
             - 請學生反思他們的學習，並寫一兩句話來說明他們認為今天的課程有挑戰性或有趣的地方。
 
-            【學習評估】
+            ###【學習評估】
 
             - 形成性評估：探索和細化階段的觀察以及討論和演示將深入了解學生對相同分母分數加法和減法的理解。
             - 總結性評估：收集並審查學生的工作表和任務卡，以評估他們解決涉及具有相同分母的分數的加法和減法問題的能力。
         """
+        
         lesson_plan_prompt = lesson_plan_ADDIE_prompt
 
         return lesson_plan_prompt
@@ -368,42 +377,46 @@ class EducationalMaterial:
         2. 該換行就換行，盡量滿足 word .doc 的格式 
         3. 規劃限定時間內，學生能夠完成的出場券習題，共有 5 題，請使用 3 個單選題 (四選項) 以及 2 個填空題，題目必須能夠符合此逐字稿內容描述的數學學習目標，以類題方式建立。
         4. 此出場券習題最末請公布各題的答案。
+        5. 遇到數學符號或是敘述請用 Latex 語法($...$)，例如：$x^2$。
 
-        example:
-        出場券習題：公里、公尺和公分的換算
-        選擇題（請從四個選項中選出一個正確答案）
+
+        output Markdown，example as below:
+        
+        ## 出場券習題：公里、公尺和公分的換算
+        ### 目標：這套出場券習題旨在幫助學生掌握公里、公尺、和公分之間的換算關係，通過實際的例子加深學生對這些單位之間轉換的理解。
+        
+        ### 選擇題（請從四個選項中選出一個正確答案）
 
         1. 1公里等於多少公尺？
-        A) 100公尺
-        B) 1000公尺
-        C) 10,000公尺
-        D) 100公分
+        - (A) $100$ 公尺
+        - (B) $1000$ 公尺
+        - (C) $10,000$ 公尺
+        - (D) $100$ 公分
 
         2. 5公尺等於多少公分？
-        A) 50公分
-        B) 500公分
-        C) 5,000公分
-        D) 50,000公分
-        
-        3. 如果你走了2.5公里的路程，這段路程等於多少公尺？
-        A) 250公尺
-        B) 2,500公尺
-        C) 25,000公尺
-        D) 250,000公尺
+        - (A) $50$ 公分
+        - (B) $500$ 公分
+        - (C) $5000$ 公分
+        - (D) $50000$ 公分
 
-        填空題
+        ### 填空題
         1. 100公分等於___公尺？（請填入數字）
         2. 1公尺等於___公分？（請填入數字）
 
 
-        答案公布
-        答案：B) 1000公尺
-        答案：B) 500公分
-        答案：B) 2,500公尺
-        答案：A) 3公尺
-        答案：1公尺
+        /n
+        /n
+        /n(空三行)
+
+        ## 答案公布
+        ### 選擇題
+        1. (B) 1000 公尺
+        2. (B) 500 公分
+        
+        ### 填空題
+        1. 1 公尺
+        2. 100 公分
 
-        這套出場券習題旨在幫助學生掌握公里、公尺、和公分之間的換算關係，通過實際的例子加深學生對這些單位之間轉換的理解。
         """
         return exit_ticket_prompt
 
@@ -432,10 +445,11 @@ class EducationalMaterial:
             {specific_feature_text}
             
             請根據逐字稿進行以下工作：
-            不要提到 【逐字稿】 這個詞，直接給出工作內容即可
-            如果是中文素材，請嚴格使用 zh-TW
-            請用 {self.grade} 年級的口吻，不要用太難的詞彙
-            {self.generate_content_prompt()}
+            - 不要提到 【逐字稿】 這個詞，直接給出內容即可
+            - 遇到數學符號或是敘述請用 Latex 語法($...$)，例如：$x^2$。
+            - 如果是中文素材，請嚴格使用 zh-TW
+            - 請用 {self.grade} 年級的口吻，不要用太難的詞彙
+            - {self.generate_content_prompt()}
         """
         print("====User content====")
         print(user_content)