# 导入FastAPI核心类
from fastapi import FastAPI
# 导入流式响应类：用于实现实时逐字返回数据（打字机效果）
from fastapi.responses import StreamingResponse
# 异步HTTP客户端、系统环境变量、JSON解析库
import httpx
import os
import json

# 导入Pydantic数据模型（补全你缺失的依赖，用于校验请求体）
from pydantic import BaseModel

# 创建FastAPI应用实例
app = FastAPI()

# 定义请求体数据模型：校验前端传入的问题内容
class Question(BaseModel):
    content: str  # 用户的问题文本

# 定义POST接口：实现AI流式问答（/ask/stream 路径）
@app.post("/ask/stream")
async def ask_stream(q: Question):
    """
    异步流式AI问答接口
    功能：实时逐字返回AI回答内容（前端可实现打字机效果）
    """

    # ------------------- 核心：异步生成器函数 -------------------
    # 作用：实时生成AI返回的文本片段，逐段推送给前端
    async def generate():
        # 创建异步HTTP客户端
        async with httpx.AsyncClient() as client:
            # 发送【流式请求】到DeepSeek AI接口
            # stream=True：开启AI流式输出，服务器会逐字返回数据
            async with client.stream(
                method="POST",
                url="https://api.deepseek.com/chat/completions",
                headers={
                    # 从环境变量读取API密钥，安全不泄露
                    "Authorization": f"Bearer {os.getenv('KEY')}"
                },
                json={
                    "model": "deepseek-chat",  # 指定AI模型
                    "stream": True,            # 关键：开启流式响应
                    "messages": [{"role": "user", "content": q.content}]  # 用户问题
                },
            ) as resp:
                # 异步迭代读取AI返回的每一行数据流（SSE格式）
                async for line in resp.aiter_lines():
                    # AI流式数据固定以 "data: " 开头，过滤无效行
                    if line.startswith("data: "):
                        # 截取掉前缀 "data: "，获取真实数据
                        data = line[6:]
                        
                        # 数据为 [DONE] 表示流式传输结束，退出循环
                        if data == "[DONE]":
                            break
                        
                        # 解析JSON格式的文本片段
                        chunk = json.loads(data)
                        # 提取AI返回的单个字符/单词（token）
                        token = chunk["choices"][0]["delta"].get("content", "")
                        
                        # 如果有有效内容，通过 yield 实时推送给前端
                        if token:
                            yield token

    # ------------------- 返回流式响应 -------------------
    # StreamingResponse：FastAPI内置类，将生成器数据实时推送给前端
    # media_type="text/plain"：指定返回纯文本数据流
    return StreamingResponse(generate(), media_type="text/plain")