Update app.py

app.py

@@ -27,22 +27,37 @@ def process_sentence(mode, word, source, num, use_ai, model_name):
     except Exception as e:
         return f"<p style='color:red;'>❌ 發生錯誤：{str(e)}</p>", f"錯誤：{str(e)}"
 
+def project_description():
+    return """
+    # 📖 VocabLine 單字例句工具
+    支援單字例句查詢，AI 自動生成句子。適合作為 LINE 單字推播、英文學習輔助工具。
+
+    ## 🔍 核心功能
+    - 查詢單字 → 獲取例句
+    - 抽取單字 → 批量獲取例句
+    - 可選 AI 生成句子（模型：GPT2 / Pythia）
+
+    ## 🧑‍💻 技術架構
+    - Gradio Blocks + Transformers (Hugging Face)
+    - SQLite 句庫管理
+    - 支援多單字庫擴展
+
+    ## 📚 資料來源
+    - 常用 3000 單字表
+    - 英文例句資料庫 (Tatoeba)
+
+    ## 👨‍💻 開發資訊
+    - 開發者：余彦志 (大宇 ian)
+    - 信箱：[email protected]
+    - GitHub：[https://github.com/dayuian](https://github.com/dayuian)
+    """
+
 with gr.Blocks(css="""
     #card-group { padding: 15px; border-radius: 12px; background-color: rgba(255, 255, 255, 0.05); box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1); margin-bottom: 15px; }
     .gradio-container { max-width: 800px; margin: auto; }
     #generate-button.ai-active { background-color: #ff9800 !important; color: white !important; }
 """) as demo:
-    gr.Markdown(
-        """
-        # 📖 VocabLine 單字例句工具
-        支援單字例句查詢，AI 自動生成句子。適合作為 LINE 單字推播、英文學習輔助工具。
-
-        ## 👨‍💻 開發者資訊
-        - 開發者：余彦志 (大宇 ian)
-        - 信箱：[email protected]
-        - GitHub：[https://github.com/dayuian](https://github.com/dayuian)
-        """
-    )
+    gr.Markdown(project_description())
 
     with gr.Group():
         with gr.Row():
@@ -71,9 +86,9 @@ with gr.Blocks(css="""
                 label="選擇 AI 模型",
                 visible=False
             )
+            ai_warning = gr.Markdown("⚠️ 若使用 AI 生成句子，生成過程可能需要 30 秒以上，請耐心等待。", visible=False)
 
         generate_button = gr.Button("✨ 生成句子", elem_id="generate-button")
-        gr.Markdown("⚠️ 若使用 AI 生成句子，生成過程可能需要 30 秒以上，請耐心等待。")
 
         result_output = gr.HTML(label="結果")
         status_output = gr.Textbox(label="處理狀態", interactive=False)
@@ -92,6 +107,7 @@ with gr.Blocks(css="""
 
     def toggle_ai_button(use_ai):
         model_visibility = gr.update(visible=use_ai)
+        warning_visibility = gr.update(visible=use_ai)
         js_toggle_class = f"""
         function toggleButtonClass() {{
             const btn = document.getElementById('generate-button');
@@ -103,12 +119,12 @@ with gr.Blocks(css="""
         }}
         toggleButtonClass();
         """
-        return model_visibility, gr.update(_js=js_toggle_class)
+        return model_visibility, gr.update(_js=js_toggle_class), warning_visibility
 
     use_ai_checkbox.change(
         toggle_ai_button,
         inputs=[use_ai_checkbox],
-        outputs=[model_dropdown, generate_button]
+        outputs=[model_dropdown, generate_button, ai_warning]
     )
 
     generate_button.click(