Update README.md

README.md

@@ -1,10 +1,51 @@
+---
+license: apache-2.0
 title: Interactive_AI_Debate_Bot
-emoji: 🏃
+sdk: gradio
+emoji: 📚
 colorFrom: gray
 colorTo: indigo
-sdk: gradio
-sdk_version: 5.25.2
-app_file: app.py
 pinned: false
-license: apache-2.0
+---
+# 時事觀點對對碰 (Current Events Debate Bot)
+
+[![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/yiming-0120/Interactive_AI_Debate_Bot)
+
+**AI 陪你練思辨！選擇或自訂時事議題與立場，透過文字或語音和 AI 展開正反交鋒。**
+
+這是一個使用 Gradio 和 OpenAI API建立的互動式 AI 辯論機器人應用程式。使用者可以針對選定的台灣時事議題或自訂主題，選擇正方或反方立場，然後透過文字或語音輸入自己的論點。AI 會自動扮演對立的立場，生成反駁論點，並以文字和語音回覆，模擬一場簡單的辯論體驗[1][4]。
+
+## 核心概念與目標
+
+在資訊爆炸的時代，理解複雜議題的不同面向至關重要。本應用旨在：
+
+*   **促進思辨：** 提供一個安全的環境，讓使用者練習從不同角度思考同一事件。
+*   **鍛鍊表達：** 鼓勵使用者組織論點並清晰表達。
+*   **探索觀點：** 透過 AI 扮演的反方，了解議題可能的爭議點與不同論證方式[1]。
+*   **多模態互動：** 支援文字與語音輸入/輸出，增加使用的便利性與沉浸感。
+
+## 主要功能
+
+*   **多元議題選擇：**
+    *   提供一系列預設的台灣近期時事議題選項。
+    *   允許使用者輸入**自訂辯論主題**。
+*   **立場扮演：** 使用者選擇「正方」或「反方」，AI 自動扮演對立角色。
+*   **多模態輸入：**
+    *   支援**文字**輸入論點。
+    *   支援**麥克風錄音**輸入論點。
+*   **多模態輸出：**
+    *   AI 以**文字**形式回覆反駁論點。
+    *   AI 同步提供**語音**回覆 (透過 OpenAI TTS)。
+*   **對話歷史：** 在介面上顯示辯論過程。
+
+## 如何使用
+
+1.  **選擇或輸入主題：** 從下拉選單選擇一個預設的台灣時事議題，**或者**在旁邊的文字框中輸入你想辯論的任何主題。若輸入自訂主題，將優先使用該主題。
+2.  **選擇立場：** 點選「正方」或「反方」。AI 將自動站在你的對立面。
+3.  **提出論點：**
+    *   在「輸入你的論點 (文字)」框中輸入你的看法。
+    *   **或者**點擊「或錄製你的論點 (語音)」下方的麥克風圖示開始錄音，錄製完畢後再次點擊結束。
+4.  **送出論點：** 點擊「送出論點」按鈕。
+5.  **接收回應：** AI 會在聊天框中顯示文字回應，並自動播放語音回覆。
+6.  **繼續辯論：** 針對 AI 的回應，重複步驟 3 和 4。
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference