app.py

import gradio as gr
import requests
import os

if 'GOOGLE_API_KEY' not in os.environ:
    print("錯誤：環境變數 'GOOGLE_API_KEY' 未設定。應用程式無法正常生成知識。")
    # 設定一個虛擬值以避免程式中斷，但功能無法正常使用
    os.environ['GOOGLE_API_KEY'] = "YOUR_API_KEY_HERE"
else:
    print("成功從環境變數讀取 GOOGLE_API_KEY。")

client = genai.Client(api_key=os.environ["GOOGLE_API_KEY"])

# --- 核心函式定義 ---

def get_celestial_body_list():
    """
    定義並回傳一個天體清單。
    為了穩定性，不實際呼叫 API，而是設計一個硬編碼的字典。

    Returns:
        list: 一個包含繁體中文天體名稱的列表。
    """
    # 這個字典可以在全域範圍被其他函式存取
    global celestial_bodies_data
    celestial_bodies_data = {
        # --- 行星 (Planets) ---
        "水星": "Mercury",
        "金星": "Venus",
        "地球": "Earth",
        "火星": "Mars",
        "木星": "Jupiter",
        "土星": "Saturn",
        "天王星": "Uranus",
        "海王星": "Neptune",
        # --- 恆星與其他 (Stars & Others) ---
        "太陽": "Sun",
        "月球": "Moon",
        "冥王星": "Pluto",
        "黑洞": "Black Hole",
        # --- 星雲 (Nebulae) ---
        "獵戶座星雲": "Orion Nebula",
        "蟹狀星雲": "Crab Nebula",
        "鷹狀星雲": "Eagle Nebula",
        "馬頭星雲": "Horsehead Nebula",
        # --- 星系 (Galaxies) ---
        "仙女座星系": "Andromeda Galaxy",
        "草帽星系": "Sombrero Galaxy",
        "三角座星系": "Triangulum Galaxy",
        # --- 星團 (Clusters) ---
        "昴宿星團": "Pleiades",
        "畢宿星團": "Hyades",
        "半人馬座ω星團": "Omega Centauri",
        # --- 系外行星 (Exoplanet) ---
        "克卜勒-186f": "Kepler-186f"
    }
    return list(celestial_bodies_data.keys())

def get_nasa_image(celestial_body_name_chinese):
    """
    根據選擇的中文天體名稱，從 NASA API 獲取圖片 URL。

    Args:
        celestial_body_name_chinese (str): 使用者從下拉選單選擇的中文天體名稱。

    Returns:
        str: 找到的圖片 URL，如果找不到則回傳 None。
    """
    # 從全域字典中查找對應的英文名稱
    english_name = celestial_bodies_data.get(celestial_body_name_chinese)
    if not english_name:
        return None

    # NASA API 端點
    api_url = f"https://images-api.nasa.gov/search?q={english_name}&media_type=image"

    try:
        response = requests.get(api_url)
        response.raise_for_status()  # 如果請求失敗則發起異常
        data = response.json()

        # 檢查是否有回傳項目
        if data['collection']['items']:
            # 獲取第一張圖片的 URL
            image_url = data['collection']['items'][0]['links'][0]['href']
            return image_url
        else:
            return None
    except requests.exceptions.RequestException as e:
        print(f"呼叫 NASA API 時發生錯誤: {e}")
        return None

def get_space_trivia(celestial_body_name_chinese):
    """
    使用 Gemini API 生成關於指定天體的冷知識。

    Args:
        celestial_body_name_chinese (str): 使用者選擇的中文天體名稱。

    Returns:
        str: 由 Gemini API 生成的繁體中文冷知識文字。
    """
    if os.environ.get("GOOGLE_API_KEY") == "YOUR_API_KEY_HERE":
        return "錯誤：Google API 金鑰未設定。"

    try:
        # 選擇 Gemini 模型
        models = [
            "gemini-2.0-flash",
            "gemini-2.0-flash-lite",
            "gemini-2.5-flash",
            "gemini-2.5-flash-lite-preview-06-17"
        ]

        # 設計精確的提示 (Prompt)
        prompt = f"你是一位頂尖的科普作家與天文學家，擅長用生動的比喻和一點點的幽默感，把複雜的宇宙知識變得像聽故事一樣有趣。請針對『{celestial_body_name_chinese}』這個天體，提供一個令人驚訝、課本上學不到的冷知識，並用繁體中文回答。"

        # 生成內容
        response = client.models.generate_content(
            model=models[3],
            contents=prompt
        )

        return response.text
        
    except Exception as e:
        print(f"呼叫 Gemini API 時發生錯誤: {e}")
        return f"無法生成關於「{celestial_body_name_chinese}」的冷知識，請檢查您的 API 金鑰設定或稍後再試。"

def explore_celestial_body(celestial_body_name_chinese):
    """
    Gradio 的主要處理函式，整合圖片獲取和知識生成。

    Args:
        celestial_body_name_chinese (str): 從 Gradio 下拉選單傳來的使用者選擇。

    Returns:
        tuple: 包含圖片 URL 和冷知識文字的元組。
    """
    print(f"開始探索：{celestial_body_name_chinese}")
    # 依序執行兩個任務
    image_url = get_nasa_image(celestial_body_name_chinese)
    trivia_text = get_space_trivia(celestial_body_name_chinese)
    print("探索完成！")
    return image_url, trivia_text

# --- 5. 建立並啟動 Gradio 介面 ---

# 預先載入天體列表
celestial_body_choices = get_celestial_body_list()

# Gradio 介面描述文字
APP_DESCRIPTION = """
# AI 宇宙冷知識探索家 🚀

歡迎來到 AI 宇宙冷知識探索家！這是一個結合 NASA 與 Google Gemini AI 技術的互動應用。

**如何使用：**
1.  從下拉式選單中選擇一個您感興趣的行星、星雲或星系。
2.  點擊「探索！」按鈕。
3.  應用程式將會為您呈現一張來自 NASA 的震撼照片，並由 AI 生成一則關於它的驚人冷知識！
"""

# 使用 gr.Blocks() 來自訂更靈活的版面
with gr.Blocks(theme=gr.themes.Ocean()) as app:
    gr.Markdown(APP_DESCRIPTION)

    with gr.Row():
        # 輸入元件
        celestial_dropdown = gr.Dropdown(
            choices=celestial_body_choices,
            label="請選擇一個天體 (Select a Celestial Body)",
            value="金星" # 預設值
        )
        # 觸發按鈕
        explore_button = gr.Button("探索！ (Explore!)", variant="primary")

    with gr.Row():
        # 輸出元件
        output_image = gr.Image(label="NASA 實拍照片 (NASA Image)", type="filepath", height=400)
        output_trivia = gr.Textbox(label="🚀 宇宙冷知識 (Universe Trivia)", lines=15, interactive=False)

    # 設定按鈕的點擊事件
    explore_button.click(
        fn=explore_celestial_body,
        inputs=celestial_dropdown,
        outputs=[output_image, output_trivia]
    )

    # 提供一些範例，讓使用者可以快速體驗
    gr.Examples(
        examples=["木星", "仙女座星系", "蟹狀星雲"],
        inputs=celestial_dropdown,
        outputs=[output_image, output_trivia],
        fn=explore_celestial_body,
        cache_examples=True
    )

# 啟動應用程式
app.launch(debug=False, share=False, show_error=True, show_api=False)