class SheetService:

app.py

@@ -2164,7 +2164,7 @@ def get_sheet_data(sheet_url, range_name):
 def update_sheet_data(sheet_url, qa_result, video_id):
     # 根據 url 找到 sheet ，根據 video_id 找到 sheet 中的 video_id 的 row number
     sheet_data = SHEET_SERVICE.get_sheet_data_by_url(sheet_url)
-    print(f"sheet_data: {sheet_data}")
+    # print(f"sheet_data: {sheet_data}")
 
     if not sheet_data or len(sheet_data) < 1:
         print("錯誤：工作表資料為空或缺少標頭列。")
@@ -2175,7 +2175,7 @@ def update_sheet_data(sheet_url, qa_result, video_id):
 
     # 直接指定要尋找的欄位名稱
     target_column_name = '均一平台 YT Readable ID'
-    target_qa_column_name = "QA"
+    target_qa_column_name = "QA" # 假設 QA 欄位的標題是 "QA"
 
     try:
         # 1. 找到 '均一平台 YT Readable ID' 所在的欄位索引 (column index)
@@ -2190,89 +2190,221 @@ def update_sheet_data(sheet_url, qa_result, video_id):
     for i, row in enumerate(data_rows):
         # 確保該列有足夠的欄位，並且該欄位的值等於 video_id
         if len(row) > video_id_col_index and row[video_id_col_index] == video_id:
-            target_row_index = i + 1 # 找到匹配的列，其在原始 sheet_data 中的索引是 i + 1
+            target_row_index = i + 1 # 找到匹配的列，其在原始 sheet_data 中的索引是 i + 1 (因為 data_rows 從 sheet_data[1] 開始)
             break # 找到後即可跳出迴圈
 
     if target_row_index != -1:
-        print(f"找到 video_id '{video_id}' 於欄位 '{target_column_name}' 的第 {target_row_index + 1} 列 (工作表列號)") # +1 是為了顯示給人類看的行號
+        # target_row_index 是 video_id 在 sheet_data (含標頭) 中的 0-based 索引
+        # 例如，第一筆資料的 target_row_index 是 1
+        actual_target_row_number = target_row_index + 1 # 這是實際的 1-based 工作表列號 (例如 2)
+        print(f"找到 video_id '{video_id}' 於欄位 '{target_column_name}' 的第 {actual_target_row_number} 列 (工作表列號)")
 
-        # --- 以下是更新邏輯 (需要取消註解並確保 qa_column 也正確) ---
+        # --- 以下是更新邏輯 ---
         try:
-            # 找到 QA 欄位的索引 (假設 qa_column 參數傳入的是正確的標題文字, e.g., 'QA')
+            # 找到 QA 欄位的索引
             qa_col_index = header_row.index(target_qa_column_name)
 
-            # 更新 sheet 中的 qa_column 和 qa_result
-            # 確保目標列有足夠的欄位可以更新
-            if len(sheet_data[target_row_index]) > qa_col_index:
-                # 注意：這裡直接修改 sheet_data 列表可能不會直接更新 Google Sheet
-                # 你需要使用 SHEET_SERVICE 的更新方法
-                # sheet_data[target_row_index][qa_col_index] = qa_result
-                print(f"準備更新 第 {target_row_index + 1} 列, 欄位 '{target_qa_column_name}' (索引 {qa_col_index}) 為 '{qa_result}'")
-                # --- 實際更新 Google Sheet 的程式碼
-                SHEET_SERVICE.update_sheet_cell(sheet_url, target_row_index, qa_col_index, qa_result)
+            # 取得目標列的實際資料
+            target_row_data = sheet_data[target_row_index]
+
+            # 檢查目標列是否有足夠的欄位可以更新
+            if len(target_row_data) > qa_col_index:
+                # *** 修正點：傳遞給 update_sheet_cell 的列號減 1 ***
+                # 因為觀察到 update_sheet_cell(N) 會更新到 N+1 列
+                # 所以我們傳遞 N-1，讓它內部 +1 後剛好是 N
+                row_index_to_pass = actual_target_row_number - 1 # 將 1-based 列號減 1
+
+                # 為了 log 清晰，仍然顯示 1-based 的目標列號
+                print(f"準備更新 第 {actual_target_row_number} 列, 欄位 '{target_qa_column_name}' (索引 {qa_col_index}) 為 '{qa_result}'")
+                # 添加一行 log 來確認傳遞的值
+                print(f"  (傳遞給 update_sheet_cell 的 row_index: {row_index_to_pass})")
 
+                # --- 實際更新 Google Sheet 的程式碼 ---
+                # 傳遞調整後的索引 row_index_to_pass
+                SHEET_SERVICE.update_sheet_cell(sheet_url, row_index_to_pass, qa_col_index, qa_result)
             else:
-                 print(f"錯誤：第 {target_row_index + 1} 列沒有足夠的欄位來更新 QA (索引 {qa_col_index})。")
+                 # 如果目標列的長度不足以包含 qa_col_index
+                 print(f"錯誤：第 {actual_target_row_number} 列 (資料長度 {len(target_row_data)}) 沒有足夠的欄位來更新 QA (需要索引 {qa_col_index})。")
 
         except ValueError:
-            print(f"錯誤：在標頭列 {header_row} 中找不到 QA 欄位名稱 '{qa_column}'")
+            print(f"錯誤：在標頭列 {header_row} 中找不到 QA 欄位名稱 '{target_qa_column_name}'")
         # --- 更新邏輯結束 ---
 
     else:
         # 如果找不到 video_id，印出錯誤訊息
         print(f"錯誤：��欄位 '{target_column_name}' 中找不到 video_id '{video_id}'。")
 
-def refresh_video_LLM_all_content_by_sheet(sheet_url, sheet_qa_column, video_ids): # 移除 sheet_video_column
-    video_ids = video_ids.replace('\n', ',').split(',')
-    video_ids = [vid.strip() for vid in video_ids if vid.strip()]
-
-    success_video_ids = []
-    failed_video_ids = []
-
+def refresh_video_LLM_all_content_by_sheet(sheet_url, sheet_qa_column, video_ids_input): # 參數名稱改為 video_ids_input 避免混淆
+    print("=== 開始批次處理工作表刷新 ===")
+    target_id_column_name = '均一平台 YT Readable ID'
+    target_qa_column_name = "QA"
     sheet_qa_success_tag = "OO"
     sheet_qa_failed_tag = "XX"
+    bucket_name = 'video_ai_assistant'
 
-    for video_id in video_ids:
+    # 1. 解析輸入的 video_ids
+    video_ids_list = video_ids_input.replace('\n', ',').split(',')
+    video_ids_list = [vid.strip() for vid in video_ids_list if vid.strip() and vid.strip() != target_id_column_name]
+    print(f"準備處理的 Video IDs: {video_ids_list}")
+
+    if not video_ids_list:
+        print("沒有有效的 Video ID 需要處理。")
+        return {"success_video_ids": [], "failed_video_ids": []}
+
+    # 2. 一次性讀取工作表資料
+    try:
+        print(f"正在從 {sheet_url} 讀取工作表資料...")
+        sheet_data = SHEET_SERVICE.get_sheet_data_by_url(sheet_url)
+        if not sheet_data or len(sheet_data) < 1:
+            print("錯誤：工作表資料為空或缺少標頭列。")
+            return {"success_video_ids": [], "failed_video_ids": []}
+        print(f"成功讀取 {len(sheet_data)} 列資料。")
+        header_row = sheet_data[0]
+        data_rows = sheet_data[1:]
+    except Exception as e:
+        print(f"讀取工作表時發生錯誤: {e}")
+        return {"success_video_ids": [], "failed_video_ids": []}
+
+    # 3. 找到目標欄位索引並建立 video_id 到 row_number 的映射
+    try:
+        video_id_col_index = header_row.index(target_id_column_name)
+        qa_col_index = header_row.index(target_qa_column_name)
+        # Google Sheet 的欄位字母 (A=0, B=1, ...)
+        qa_col_letter = chr(ord('A') + qa_col_index)
+        print(f"'{target_id_column_name}' 欄位索引: {video_id_col_index}")
+        print(f"'{target_qa_column_name}' 欄位索引: {qa_col_index} (欄位 {qa_col_letter})")
+    except ValueError as e:
+        print(f"錯誤：在標頭列 {header_row} 中找不到必要的欄位: {e}")
+        return {"success_video_ids": [], "failed_video_ids": []}
+
+    video_id_to_row_map = {}
+    for i, row in enumerate(data_rows):
+        if len(row) > video_id_col_index and row[video_id_col_index]:
+            # 儲存 1-based 的工作表列號
+            video_id_to_row_map[row[video_id_col_index]] = i + 2 # 資料列從第 2 列開始 (1-based)
+
+    # 4. 批次檢查 GCS 並分類
+    ids_to_set_oo_phase1 = [] # (video_id, row_number)
+    ids_to_refresh = []       # video_id
+    processed_ids = set()     # 追蹤已處理的ID，避免重複
+
+    print("開始檢查 GCS 檔案狀態...")
+    for video_id in video_ids_list:
+        if video_id in processed_ids:
+            continue
+        processed_ids.add(video_id)
+
+        if video_id not in video_id_to_row_map:
+            print(f"警告：輸入的 video_id '{video_id}' 在工作表的 '{target_id_column_name}' 欄位中找不到，將跳過。")
+            continue
+
+        row_number = video_id_to_row_map[video_id]
+        file_name = f'{video_id}_transcript.json'
+        blob_name = f"{video_id}/{file_name}"
         try:
-            # 確認 GCS 中是否存在 ID_transcript.json in GCS
-            # 如果存在就 pass
-            # 如果不存在就 refresh_video_LLM_all_content_by_id
-            bucket_name = 'video_ai_assistant'
-            file_name = f'{video_id}_transcript.json'
-            blob_name = f"{video_id}/{file_name}"
             is_file_exists = GCS_SERVICE.check_file_exists(bucket_name, blob_name)
-            if not is_file_exists:
-                print(f"{video_id} 不存在逐字稿")
-                refresh_video_LLM_all_content_by_id(video_id)
+            if is_file_exists:
+                print(f"  - {video_id} (第 {row_number} 列): GCS 檔案存在，標記為 OO。")
+                ids_to_set_oo_phase1.append((video_id, row_number))
             else:
-                print(f"{video_id} 存在逐字稿")
-
-            qa_result = sheet_qa_success_tag
-            time.sleep(1)
-            # 更新呼叫，不再傳遞 sheet_video_column
-            update_sheet_data(sheet_url, qa_result, video_id)
-            success_video_ids.append(video_id) # 假設 update_sheet_data 成功就加入 success
+                print(f"  - {video_id} (第 {row_number} 列): GCS 檔案不存在，需要刷新。")
+                ids_to_refresh.append(video_id)
         except Exception as e:
-            print(f"===refresh_video_LLM_all_content_by_sheet error===")
-            print(f"video_id: {video_id}")
-            print(f"error: {str(e)}")
-            print(f"===refresh_video_LLM_all_content_by_sheet error===")
-            failed_video_ids.append(video_id)
-            qa_result = sheet_qa_failed_tag
+            print(f"檢查 GCS 檔案 {blob_name} 時發生錯誤: {e}，將嘗試刷新。")
+            ids_to_refresh.append(video_id) # 如果檢查出錯，也歸類為需要刷新
+
+    # 5. 批次更新 "OO" (Phase 1: GCS 已存在)
+    if ids_to_set_oo_phase1:
+        print(f"\n準備批次更新 {len(ids_to_set_oo_phase1)} 個 Video ID 的 QA 為 '{sheet_qa_success_tag}' (GCS 已存在)...")
+        update_data_oo1 = []
+        sheet_name = SHEET_SERVICE.get_sheet_name_by_url(sheet_url) # 需要 SHEET_SERVICE 提供此方法
+        if not sheet_name:
+             print("錯誤：無法獲取工作表名稱，無法執行批次更新。")
+             # 或者可以嘗試從 sheet_data 推斷，但不夠通用
+        else:
+            for vid, row_num in ids_to_set_oo_phase1:
+                update_data_oo1.append({
+                    'range': f"{sheet_name}!{qa_col_letter}{row_num}",
+                    'value': sheet_qa_success_tag
+                })
+            try:
+                # *** 假設 SHEET_SERVICE.batch_update_cells 存在 ***
+                SHEET_SERVICE.batch_update_cells(sheet_url, update_data_oo1)
+                print(f"成功批次更新 {len(update_data_oo1)} 個儲存格為 '{sheet_qa_success_tag}'。")
+            except Exception as e:
+                print(f"批次更新 QA 為 '{sheet_qa_success_tag}' 時發生錯誤: {e}")
+                # 這裡可以考慮是否要將這些 ID 移到失敗列表
+
+    # 6. 處理需要刷新的 ID
+    successfully_refreshed_ids = [] # (video_id, row_number)
+    failed_refresh_ids = []         # (video_id, row_number)
+
+    if ids_to_refresh:
+        print(f"\n開始處理 {len(ids_to_refresh)} 個需要刷新的 Video ID...")
+        for video_id in ids_to_refresh:
+            row_number = video_id_to_row_map[video_id] # 必定存在，前面已檢查
+            print(f"  正在刷新 {video_id} (第 {row_number} 列)...")
             try:
-                # 即使前面出錯，還是嘗試更新 QA 狀態為 XX
-                update_sheet_data(sheet_url, qa_result, video_id)
-                time.sleep(1)
-            except Exception as update_e:
-                 print(f"===更新 QA 狀態為 XX 時也發生錯誤===")
-                 print(f"video_id: {video_id}")
-                 print(f"error: {str(update_e)}")
-                 print(f"===更新 QA 狀態為 XX 時也發生錯誤===")
+                refresh_video_LLM_all_content_by_id(video_id)
+                print(f"    - {video_id} 刷新成功。")
+                successfully_refreshed_ids.append((video_id, row_number))
+                time.sleep(1) # 避免過於頻繁觸發其他 API (例如 GCS 刪除/上傳)
+            except Exception as e:
+                print(f"    - {video_id} 刷新失敗: {str(e)}")
+                failed_refresh_ids.append((video_id, row_number))
+                time.sleep(5) # 失敗時稍作停頓
+
+    # 7. 批次更新刷新結果 (OO for success, XX for failure)
+    update_data_oo2 = []
+    update_data_xx = []
+    sheet_name = SHEET_SERVICE.get_sheet_name_by_url(sheet_url) # 再次獲取或使用之前獲取的
+
+    if sheet_name:
+        for vid, row_num in successfully_refreshed_ids:
+            update_data_oo2.append({
+                'range': f"{sheet_name}!{qa_col_letter}{row_num}",
+                'value': sheet_qa_success_tag
+            })
+        for vid, row_num in failed_refresh_ids:
+             update_data_xx.append({
+                'range': f"{sheet_name}!{qa_col_letter}{row_num}",
+                'value': sheet_qa_failed_tag
+            })
+
+        if update_data_oo2:
+            print(f"\n準備批次更新 {len(update_data_oo2)} 個 Video ID 的 QA 為 '{sheet_qa_success_tag}' (刷新成功)...")
+            try:
+                SHEET_SERVICE.batch_update_cells(sheet_url, update_data_oo2)
+                print(f"成功批次更新 {len(update_data_oo2)} 個儲存格為 '{sheet_qa_success_tag}'。")
+            except Exception as e:
+                print(f"批次更新 QA 為 '{sheet_qa_success_tag}' (刷新成功) 時發生錯誤: {e}")
+
+        if update_data_xx:
+            print(f"\n準備批次更新 {len(update_data_xx)} 個 Video ID 的 QA 為 '{sheet_qa_failed_tag}' (刷新失敗)...")
+            try:
+                SHEET_SERVICE.batch_update_cells(sheet_url, update_data_xx)
+                print(f"成功批次更新 {len(update_data_xx)} 個儲存格為 '{sheet_qa_failed_tag}'。")
+            except Exception as e:
+                print(f"批次更新 QA 為 '{sheet_qa_failed_tag}' 時發生錯誤: {e}")
+    else:
+        if successfully_refreshed_ids or failed_refresh_ids:
+            print("錯誤：無法獲取工作表名稱，無法批次更新刷新結果。")
+
+
+    # 8. 整理最終結果
+    final_success_ids = [item[0] for item in ids_to_set_oo_phase1] + [item[0] for item in successfully_refreshed_ids]
+    final_failed_ids = [item[0] for item in failed_refresh_ids]
+    # 將在工作表中找不到的 ID 也視為失敗
+    initial_not_found = [vid for vid in video_ids_list if vid not in video_id_to_row_map]
+    final_failed_ids.extend(initial_not_found)
 
+    print("\n=== 批次處理完成 ===")
+    print(f"成功處理 (或 GCS 已存在): {len(final_success_ids)} 個")
+    print(f"處理失敗 (或未找到/刷新失敗): {len(final_failed_ids)} 個")
 
     result = {
-        "success_video_ids": success_video_ids,
-        "failed_video_ids": failed_video_ids
+        "success_video_ids": final_success_ids,
+        "failed_video_ids": list(set(final_failed_ids)) # 去重
     }
     return result
 
@@ -3599,81 +3731,79 @@ def create_app():
             with gr.Row():
                 with gr.Tab("學習單"):
                     with gr.Row():
-                        with gr.Column(scale=1):
-                            with gr.Row():
-                                worksheet_content_type_name = gr.Textbox(value="worksheet", visible=False)
-                                worksheet_algorithm = gr.Dropdown(label="選擇教學策略或理論", choices=["Bloom認知階層理論", "Polya數學解題法", "CRA教學法"], value="Bloom認知階層理論", visible=False)
-                                worksheet_content_btn = gr.Button("生成學習單 📄", variant="primary", visible=True)
-                            with gr.Accordion("微調", open=False):
-                                worksheet_result_fine_tune_prompt = gr.Textbox(label="根據結果，輸入你想更改的想法")
-                                worksheet_result_fine_tune_btn = gr.Button("微調結果", variant="primary")
-                                worksheet_result_retrun_original = gr.Button("返回原始結果")
-                            with gr.Accordion("prompt", open=False) as worksheet_accordion:
-                                worksheet_prompt = gr.Textbox(label="worksheet_prompt", show_copy_button=True, lines=40)
-                        with gr.Column(scale=2):
-                            # 生成對應不同模式的結果
-                            worksheet_result_prompt = gr.Textbox(visible=False)
-                            worksheet_result_original = gr.Textbox(visible=False)
-                            worksheet_result = gr.Markdown(label="初次生成結果", latex_delimiters = [{"left": "$", "right": "$", "display": False}])
-                            worksheet_download_button = gr.Button("轉成 word，完成後請點擊右下角 download 按鈕", variant="primary")
-                            worksheet_result_word_link = gr.File(label="Download Word")
-                with gr.Tab("教案"):
-                    with gr.Row():
-                        with gr.Column(scale=1):
-                            with gr.Row():
-                                lesson_plan_content_type_name = gr.Textbox(value="lesson_plan", visible=False)                    
-                                lesson_plan_time = gr.Slider(label="選擇課程時間(分鐘)", minimum=10, maximum=120, step=5, value=40)
-                                lesson_plan_btn = gr.Button("生成教案 📕", variant="primary", visible=True)
-                            with gr.Accordion("微調", open=False):
-                                lesson_plan_result_fine_tune_prompt = gr.Textbox(label="根據結果，輸入你想更改的想法")
-                                lesson_plan_result_fine_tune_btn = gr.Button("微調結果", variant="primary")
-                                lesson_plan_result_retrun_original = gr.Button("返回原始結果")
-                            with gr.Accordion("prompt", open=False) as lesson_plan_accordion:
-                                lesson_plan_prompt = gr.Textbox(label="worksheet_prompt", show_copy_button=True, lines=40)
-                        with gr.Column(scale=2):
-                            # 生成對應不同模式的結果
-                            lesson_plan_result_prompt = gr.Textbox(visible=False)
-                            lesson_plan_result_original = gr.Textbox(visible=False)
-                            lesson_plan_result = gr.Markdown(label="初次生成結果", latex_delimiters = [{"left": "$", "right": "$", "display": False}])
-                            
-                            lesson_plan_download_button = gr.Button("轉成 word，完成後請點擊右下角 download 按鈕", variant="primary")
-                            lesson_plan_result_word_link = gr.File(label="Download Word")
-                with gr.Tab("出場券"):
-                    with gr.Row():
-                        with gr.Column(scale=1):
-                            with gr.Row():
-                                exit_ticket_content_type_name = gr.Textbox(value="exit_ticket", visible=False)
-                                exit_ticket_time = gr.Slider(label="選擇出場券時間(分鐘)", minimum=5, maximum=10, step=1, value=8)
-                                exit_ticket_btn = gr.Button("生成出場券 🎟️", variant="primary", visible=True)
-                            with gr.Accordion("微調", open=False):
-                                exit_ticket_result_fine_tune_prompt = gr.Textbox(label="根據結果，輸入你想更改的想法")
-                                exit_ticket_result_fine_tune_btn = gr.Button("微調結果", variant="primary")
-                                exit_ticket_result_retrun_original = gr.Button("返回原始結果")
-                            with gr.Accordion("prompt", open=False) as exit_ticket_accordion:
-                                exit_ticket_prompt = gr.Textbox(label="worksheet_prompt", show_copy_button=True, lines=40)
-                        with gr.Column(scale=2):
-                            # 生成對應不同模式的結果
-                            exit_ticket_result_prompt = gr.Textbox(visible=False)
-                            exit_ticket_result_original = gr.Textbox(visible=False)
-                            exit_ticket_result = gr.Markdown(label="初次生成結果", latex_delimiters = [{"left": "$", "right": "$", "display": False}])
-                            
-                            exit_ticket_download_button = gr.Button("轉成 word，完成後請點擊右下角 download 按鈕", variant="primary")
-                            exit_ticket_result_word_link = gr.File(label="Download Word")
+                        worksheet_content_type_name = gr.Textbox(value="worksheet", visible=False)
+                        worksheet_algorithm = gr.Dropdown(label="選擇教學策略或理論", choices=["Bloom認知階層理論", "Polya數學解題法", "CRA教學法"], value="Bloom認知階層理論", visible=False)
+                        worksheet_content_btn = gr.Button("生成學習單 📄", variant="primary", visible=True)
+                    with gr.Accordion("微調", open=False):
+                        worksheet_result_fine_tune_prompt = gr.Textbox(label="根據結果，輸入你想更改的想法")
+                        worksheet_result_fine_tune_btn = gr.Button("微調結果", variant="primary")
+                        worksheet_result_retrun_original = gr.Button("返回原始結果")
+                    with gr.Accordion("prompt", open=False) as worksheet_accordion:
+                        worksheet_prompt = gr.Textbox(label="worksheet_prompt", show_copy_button=True, lines=40)
+                with gr.Column(scale=2):
+                    # 生成對應不同模式的結果
+                    worksheet_result_prompt = gr.Textbox(visible=False)
+                    worksheet_result_original = gr.Textbox(visible=False)
+                    worksheet_result = gr.Markdown(label="初次生成結果", latex_delimiters = [{"left": "$", "right": "$", "display": False}])
+                    worksheet_download_button = gr.Button("轉成 word，完成後請點擊右下角 download 按鈕", variant="primary")
+                    worksheet_result_word_link = gr.File(label="Download Word")
+            with gr.Tab("教案"):
+                with gr.Row():
+                    with gr.Column(scale=1):
+                        with gr.Row():
+                            lesson_plan_content_type_name = gr.Textbox(value="lesson_plan", visible=False)                    
+                            lesson_plan_time = gr.Slider(label="選擇課程時間(分鐘)", minimum=10, maximum=120, step=5, value=40)
+                            lesson_plan_btn = gr.Button("生成教案 📕", variant="primary", visible=True)
+                        with gr.Accordion("微調", open=False):
+                            lesson_plan_result_fine_tune_prompt = gr.Textbox(label="根據結果，輸入你想更改的想法")
+                            lesson_plan_result_fine_tune_btn = gr.Button("微調結果", variant="primary")
+                            lesson_plan_result_retrun_original = gr.Button("返回原始結果")
+                        with gr.Accordion("prompt", open=False) as lesson_plan_accordion:
+                            lesson_plan_prompt = gr.Textbox(label="worksheet_prompt", show_copy_button=True, lines=40)
+                    with gr.Column(scale=2):
+                        # 生成對應不同模式的結果
+                        lesson_plan_result_prompt = gr.Textbox(visible=False)
+                        lesson_plan_result_original = gr.Textbox(visible=False)
+                        lesson_plan_result = gr.Markdown(label="初次生成結果", latex_delimiters = [{"left": "$", "right": "$", "display": False}])
+                        
+                        lesson_plan_download_button = gr.Button("轉成 word，完成後請點擊右下角 download 按鈕", variant="primary")
+                        lesson_plan_result_word_link = gr.File(label="Download Word")
+            with gr.Tab("出場券"):
+                with gr.Row():
+                    with gr.Column(scale=1):
+                        with gr.Row():
+                            exit_ticket_content_type_name = gr.Textbox(value="exit_ticket", visible=False)
+                            exit_ticket_time = gr.Slider(label="選擇出場券時間(分鐘)", minimum=5, maximum=10, step=1, value=8)
+                            exit_ticket_btn = gr.Button("生成出場券 🎟️", variant="primary", visible=True)
+                        with gr.Accordion("微調", open=False):
+                            exit_ticket_result_fine_tune_prompt = gr.Textbox(label="根據結果，輸入你想更改的想法")
+                            exit_ticket_result_fine_tune_btn = gr.Button("微調結果", variant="primary")
+                            exit_ticket_result_retrun_original = gr.Button("返回原始結果")
+                        with gr.Accordion("prompt", open=False) as exit_ticket_accordion:
+                            exit_ticket_prompt = gr.Textbox(label="worksheet_prompt", show_copy_button=True, lines=40)
+                    with gr.Column(scale=2):
+                        # 生成對應不同模式的結果
+                        exit_ticket_result_prompt = gr.Textbox(visible=False)
+                        exit_ticket_result_original = gr.Textbox(visible=False)
+                        exit_ticket_result = gr.Markdown(label="初次生成結果", latex_delimiters = [{"left": "$", "right": "$", "display": False}])
+                        
+                        exit_ticket_download_button = gr.Button("轉成 word，完成後請點擊右下角 download 按鈕", variant="primary")
+                        exit_ticket_result_word_link = gr.File(label="Download Word")
     
     
-                    # with gr.Tab("素養導向閱讀題組"):
-                    #     literacy_oriented_reading_content = gr.Textbox(label="輸入閱讀材料")
-                    #     literacy_oriented_reading_content_btn = gr.Button("生成閱讀理解題")
+                # with gr.Tab("素養導向閱讀題組"):
+                #     literacy_oriented_reading_content = gr.Textbox(label="輸入閱讀材料")
+                #     literacy_oriented_reading_content_btn = gr.Button("生成閱讀理解題")
     
-                    # with gr.Tab("自我評估"):
-                    #     self_assessment_content = gr.Textbox(label="輸入自評問卷或檢查表")
-                    #     self_assessment_content_btn = gr.Button("生成自評問卷")
-                    # with gr.Tab("自我反思評量"):
-                    #     self_reflection_content = gr.Textbox(label="輸入自我反思活動")
-                    #     self_reflection_content_btn = gr.Button("生成自我反思活動")
-                    # with gr.Tab("後設認知"):
-                    #     metacognition_content = gr.Textbox(label="輸入後設認知相關問題")
-                    #     metacognition_content_btn = gr.Button("生成後設認知問題")
+                # with gr.Tab("自我評估"):
+                #     self_assessment_content = gr.Textbox(label="輸入自評問卷或檢查表")
+                #     self_assessment_content_btn = gr.Button("生成自評問卷")
+                # with gr.Tab("自我反思評量"):
+                #     self_reflection_content = gr.Textbox(label="輸入自我反思活動")
+                #     self_reflection_content_btn = gr.Button("生成自我反思活動")
+                # with gr.Tab("後設認知"):
+                #     metacognition_content = gr.Textbox(label="輸入後設認知相關問題")
+                #     metacognition_content_btn = gr.Button("生成後設認知問題")
     
         with gr.Accordion("免責聲明", open=True):
             gr.Markdown("""
@@ -3780,8 +3910,8 @@ def create_app():
                         refresh_btn = gr.Button("refresh", variant="primary")
                     with gr.Tab("by sheets"):
                         sheet_url = gr.Textbox(label="輸入 Google Sheets 的 URL")
-                        sheet_video_column = gr.Textbox(label="輸入要讀取的 youtube_id 欄位", value="D:D")
-                        sheet_QA_column = gr.Textbox(label="輸入要讀取的 QA 欄位", value="F:F")
+                        sheet_video_column = gr.Textbox(label="輸入要讀取的 youtube_id 欄位", value="D2:D")
+                        sheet_QA_column = gr.Textbox(label="輸入要讀取的 QA 欄位", value="F2:F")
                         sheet_get_value_btn = gr.Button("取得 ids", variant="primary")
                         sheet_get_value_result = gr.Textbox(label="ids", interactive=False)
                         sheet_refresh_btn = gr.Button("refresh by sheets", variant="primary")                

sheet_service.py

@@ -5,6 +5,7 @@ import json
 from urllib.parse import urlparse, parse_qs
 import logging # 建議使用 logging 而非 print
 import string # 導入 string 模組用於轉換欄位索引
+import re # 導入 re 模組
 
 # 設定基本的 logging
 logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
@@ -44,69 +45,62 @@ class SheetService:
             self.service = None
             self.sheet = None
 
+    def _extract_ids_from_url(self, sheet_url):
+        """
+        (私有方法) 從 Google Sheets URL 中提取 spreadsheetId 和 gid。
+        """
+        spreadsheet_id = None
+        gid = None
+        # 嘗試從 URL 中提取 spreadsheetId (通常在 /d/ 和 /edit 之間)
+        match_id = re.search(r'/d/([a-zA-Z0-9-_]+)', sheet_url)
+        if match_id:
+            spreadsheet_id = match_id.group(1)
+        # 嘗試從 URL 中提取 gid (通常在 gid= 後面)
+        match_gid = re.search(r'[#&]gid=(\d+)', sheet_url)
+        if match_gid:
+            gid = int(match_gid.group(1)) # gid 是數字
+        else:
+            # 如果 URL 沒有 gid，通常指向第一個工作表，gid 為 0
+            # logging.info(f"URL 中未找到 gid，假設為第一個工作表 (gid=0): {sheet_url}")
+            gid = 0
+        return spreadsheet_id, gid
+
     def get_sheet_id_by_url(self, sheet_url: str) -> str | None:
         """
         從 Google Sheets URL 中提取試算表 ID。
         """
-        parsed_url = urlparse(sheet_url)
-        path_parts = parsed_url.path.split('/')
-        try:
-            # Google Sheet URL 格式通常是 /spreadsheets/d/SPREADSHEET_ID/edit...
-            if 'd' in path_parts:
-                id_index = path_parts.index('d') + 1
-                if id_index < len(path_parts):
-                    spreadsheet_id = path_parts[id_index]
-                    # 進行一些基本檢查，確保它看起來像一個 ID
-                    if len(spreadsheet_id) > 30: # Google Sheet ID 通常很長
-                        return spreadsheet_id
-        except ValueError:
-            pass # 'd' 不在路徑中
-
-        logging.warning(f"無法從 URL 中提取有效的 Spreadsheet ID: {sheet_url}")
-        return None
+        spreadsheet_id, _ = self._extract_ids_from_url(sheet_url)
+        if spreadsheet_id:
+             # 可以添加一些基本檢查，確保它看起來像一個 ID
+             if len(spreadsheet_id) > 30: # Google Sheet ID 通常很長
+                 return spreadsheet_id
+             else:
+                 logging.warning(f"從 URL 提取的 ID '{spreadsheet_id}' 看起來太短，可能無效: {sheet_url}")
+                 return None
+        else:
+            logging.warning(f"無法從 URL 中提取有效的 Spreadsheet ID: {sheet_url}")
+            return None
 
     def get_sheet_gid_by_url(self, sheet_url: str) -> int | None:
         """
         從 Google Sheets URL 中提取 gid (工作表分頁 ID)。
-        返回整數型別的 gid 或 None。
+        返回整數型別的 gid 或 None (如果未指定則返回 0)。
         """
-        parsed_url = urlparse(sheet_url)
-        query_params = parse_qs(parsed_url.query)
-        fragment_params = parse_qs(parsed_url.fragment) # gid 也可能在 # 後面
-
-        gid_str = None
-        if 'gid' in query_params:
-            gid_str = query_params['gid'][0]
-        elif 'gid' in fragment_params:
-            gid_str = fragment_params['gid'][0]
-
-        if gid_str:
-            try:
-                return int(gid_str)
-            except ValueError:
-                logging.warning(f"URL 中的 gid 不是有效的整數: {gid_str}")
-                return None
-        else:
-            # logging.info(f"URL 中未找到 gid 參數，將嘗試使用第一個工作表: {sheet_url}")
-            # 如果 URL 沒有 gid，通常表示是第一個工作表，其 gid 通常是 0
-            # 但我們在這裡返回 None，讓後續邏輯決定如何處理
-            return None
+        _, gid = self._extract_ids_from_url(sheet_url)
+        # 即使 gid 是 0 (預設)，也將其視為有效的 gid
+        return gid
 
     def get_sheet_name_by_gid(self, spreadsheet_id: str, gid: int | None) -> str | None:
         """
         使用 spreadsheetId 和 gid 獲取工作表名稱 (title)。
-        如果 gid 為 None，則返回第一個工作表的名稱。
-
-        Args:
-            spreadsheet_id (str): Google 試算表的 ID。
-            gid (int | None): 目標工作表分頁的 ID。如果為 None，則獲取第一個工作表。
-
-        Returns:
-            str | None: 工作表的名稱 (title)，如果找不到或發生錯誤則返回 None。
+        如果 gid 為 None，則返回第一個工作表的名稱 (gid=0)。
         """
         if not self.service:
             logging.error("Sheet API 服務未成功初始化。")
             return None
+        # 如果傳入的 gid 是 None，我們將其視為 0
+        target_gid = gid if gid is not None else 0
+
         try:
             # 使用 spreadsheets.get 獲取試算表的中繼資料
             # fields 參數限制只返回我們需要的 sheets.properties (包含 title 和 sheetId)
@@ -120,39 +114,36 @@ class SheetService:
                 logging.warning(f"試算表 {spreadsheet_id} 中沒有找到任何工作表。")
                 return None
 
-            if gid is not None:
-                # 如果提供了 gid，尋找匹配的工作表
-                for sheet in sheets:
-                    properties = sheet.get('properties', {})
-                    if properties.get('sheetId') == gid:
-                        sheet_title = properties.get('title')
-                        if sheet_title:
-                            logging.info(f"找到 gid={gid} 對應的工作表名稱: '{sheet_title}'")
-                            return sheet_title
-                        else:
-                            logging.warning(f"找到 gid={gid} 但缺少 title 屬性。")
-                            return None
-                # 如果遍歷完畢沒有找到匹配的 gid
-                logging.warning(f"在試算表 {spreadsheet_id} 中未找到 gid={gid} 的工作表。")
-                return None
-            else:
-                # 如果 gid 為 None，返回第一個工作表的名稱
-                first_sheet_properties = sheets[0].get('properties', {})
-                first_sheet_title = first_sheet_properties.get('title')
-                first_sheet_gid = first_sheet_properties.get('sheetId', '未知')
-                if first_sheet_title:
-                    logging.info(f"未提供 gid，使用第一個工作表 (gid={first_sheet_gid}): '{first_sheet_title}'")
-                    return first_sheet_title
-                else:
-                    logging.warning(f"第一個工作表 (gid={first_sheet_gid}) 缺少 title 屬性。")
-                    return None
-
-        except googleapiclient.errors.HttpError as error:
-            logging.error(f"獲取工作表名稱時發生 API 錯誤: {error}")
+            for sheet in sheets:
+                properties = sheet.get('properties', {})
+                if properties.get('sheetId') == target_gid:
+                    sheet_title = properties.get('title')
+                    logging.info(f"找到 gid={target_gid} 對應的工作表名稱: '{sheet_title}'")
+                    return sheet_title
+
+            # 如果循環結束還沒找到
+            logging.warning(f"在試算表 {spreadsheet_id} 中未找到 gid={target_gid} 對應的工作表。")
+            # 如果 gid 是 0 但找不到，可能試算表是空的或有問題，返回第一個工作表的名稱作為備選
+            if target_gid == 0 and sheets:
+                 first_sheet_title = sheets[0].get('properties', {}).get('title')
+                 logging.warning(f"返回第一個工作表的名稱 '{first_sheet_title}' 作為 gid=0 的備選。")
+                 return first_sheet_title
             return None
+
         except Exception as e:
-            logging.error(f"獲取工作表名稱時發生未知錯誤: {e}")
+            logging.error(f"獲取工作表名稱時發生 API 錯誤 (ID: {spreadsheet_id}, GID: {target_gid}): {e}")
+            return None
+
+    def get_sheet_name_by_url(self, sheet_url: str) -> str | None:
+        """
+        從 Google Sheets URL 中提取 gid 並獲取對應的工作表名稱。
+        """
+        spreadsheet_id, gid = self._extract_ids_from_url(sheet_url)
+        if not spreadsheet_id:
+            logging.error(f"無法從 URL {sheet_url} 中提取 Spreadsheet ID。")
             return None
+        # 直接調用已有的 get_sheet_name_by_gid 方法
+        return self.get_sheet_name_by_gid(spreadsheet_id, gid)
 
     def get_sheet_data_by_url(self, sheet_url: str, read_range: str | None = None) -> list | None:
         """
@@ -392,4 +383,70 @@ class SheetService:
             return False
         except Exception as e:
             logging.error(f"更新儲存格時發生未知錯誤 (ID: {spreadsheet_id}, Range: {range_name}): {e}")
-            return False
+            return False
+
+    def batch_update_cells(self, sheet_url: str, update_data: list[dict]) -> dict | None:
+         """
+         批次更新 Google Sheet 中的多個儲存格。
+
+         Args:
+             sheet_url (str): Google Sheet 的 URL。
+             update_data (list[dict]): 一個字典列表，每個字典包含:
+                 'range' (str): 要更新的範圍 (例如 '工作表名!A1')
+                 'value' (str): 要寫入的值
+
+         Returns:
+             dict | None: Google API 的返回結果，如果成功。否則返回 None。
+         """
+         spreadsheet_id, _ = self._extract_ids_from_url(sheet_url)
+         if not spreadsheet_id:
+             logging.error(f"錯誤：無法從 URL {sheet_url} 中提取 Spreadsheet ID 進行批次更新。")
+             return None
+         if not self.service:
+             logging.error("Sheet API 服務未成功初始化。")
+             return None
+         if not update_data:
+             logging.warning("沒有需要批次更新的資料。")
+             return None
+
+         # 確保 update_data 中的 range 包含 sheet_name
+         # （調用此方法前應已獲取 sheet_name 並填入 range）
+         # 例如 update_data = [{'range': '測試!F2', 'value': 'OO'}, ...]
+
+         body = {
+             'valueInputOption': 'USER_ENTERED', # 或者 'RAW'
+             'data': []
+         }
+         for item in update_data:
+             # 基本的範圍和值檢查
+             if 'range' not in item or 'value' not in item:
+                 logging.warning(f"跳過格式錯誤的更新項目: {item}")
+                 continue
+             if '!' not in item['range'] or len(item['range'].split('!')[1]) < 2: # 簡單檢查範圍格式
+                 logging.warning(f"跳過範圍格式可能錯誤的更新項目: {item['range']}")
+                 continue
+
+             body['data'].append({
+                 'range': item['range'],
+                 'values': [[item['value']]] # value 需要是二維列表
+             })
+
+         if not body['data']:
+             logging.warning("沒有有效的資料可以進行批次更新。")
+             return None
+
+         try:
+             logging.info(f"準備批次更新 Spreadsheet ID: {spreadsheet_id}，共 {len(body['data'])} 個儲存格...")
+             result = self.service.spreadsheets().values().batchUpdate(
+                 spreadsheetId=spreadsheet_id,
+                 body=body
+             ).execute()
+             total_updated = result.get('totalUpdatedCells', 0)
+             logging.info(f"批次更新完成。共更新了 {total_updated} 個儲存格。")
+             return result
+         except Exception as e:
+             logging.error(f"批次更新儲存格時發生 API 錯誤: {e}")
+             # from googleapiclient.errors import HttpError
+             # if isinstance(e, HttpError):
+             #     logging.error(f"錯誤詳情: {e.content}")
+             return None