def rag_query(query: str, top_k: int = 3) -> dict:
    """完整 RAG 管道:R → A → G"""
    # R：检索
    contexts = retrieve(query, top_k)
    if not contexts:
        return {"answer": "知识库中没有相关内容", "contexts": []}

    # A：增强
    system, user = build_prompt(contexts, query)

    # G：生成
    answer = generate(system, user)

    return {
        "answer": answer,
        "contexts": contexts,  # 返回来源，方便前端展示「依据」
    }

# 测试
result = rag_query("间歇跑应该怎么安排训练频率？")
print(result["answer"])
print("--- 依据来源 ---")
for c in result["contexts"]:
    print(f"· {c[:50]}")