1

.env

@@ -0,0 +1,9 @@
+OPENAI_API_KEY = ""
+wenxin_api_key = ""
+wenxin_secret_key = ""
+spark_appid = "e066d42a"
+spark_api_secret = "YTJmMzBmMmM4YmFkZTQ4ODQ5ODBiYzhj"
+spark_api_key = "d2586b82c18d2e5eab65e34a87a14362"
+ZHIPUAI_API_KEY = "09250b288894428890562600b2035ecb.R1fCWi6aQIsTshNH"
+TOKEN=""
+ali_api_key="sk-ccfcd3767a9646828c4943e88c07dbf4"

qa_chain/Chat_QA_chain_self.py

@@ -0,0 +1,162 @@
+from langchain.prompts import PromptTemplate
+from langchain.chains import RetrievalQA
+from langchain.vectorstores import Chroma
+from langchain.chains import ConversationalRetrievalChain
+from langchain.memory import ConversationBufferMemory
+from langchain.chat_models import ChatOpenAI
+import sys
+import os
+
+# 添加当前目录到 Python 路径
+current_dir = os.path.dirname(os.path.abspath(__file__))
+if current_dir not in sys.path:
+    sys.path.append(current_dir)
+
+from model_to_llm import model_to_llm
+from get_vectordb import get_vectordb
+import re
+
+class Chat_QA_chain_self:
+    """"
+    带历史记录的问答链  
+    - model：调用的模型名称
+    - temperature：温度系数，控制生成的随机性
+    - top_k：返回检索的前k个相似文档
+    - chat_history：历史记录，输入一个列表，默认是一个空列表
+    - history_len：控制保留的最近 history_len 次对话
+    - file_path：建库文件所在路径
+    - persist_path：向量数据库持久化路径
+    - appid：星火
+    - api_key：星火、百度文心、OpenAI、智谱都需要传递的参数
+    - Spark_api_secret：星火秘钥
+    - Wenxin_secret_key：文心秘钥
+    - embeddings：使用的embedding模型
+    - embedding_key：使用的embedding模型的秘钥（智谱或者OpenAI）  
+    """
+    def __init__(self,model:str, temperature:float=0.0, top_k:int=4, chat_history:list=[], file_path:str=None, persist_path:str=None, appid:str=None, api_key:str=None, Spark_api_secret:str=None,Wenxin_secret_key:str=None, embedding = "openai",embedding_key:str=None):
+        print("开始初始化 Chat_QA_chain_self...")
+        self.model = model
+        self.temperature = temperature
+        self.top_k = top_k
+        self.chat_history = chat_history
+        self.file_path = file_path
+        self.persist_path = persist_path
+        self.appid = appid
+        self.api_key = api_key
+        self.Spark_api_secret = Spark_api_secret
+        self.Wenxin_secret_key = Wenxin_secret_key
+        self.embedding = embedding
+        self.embedding_key = embedding_key
+
+        print("正在初始化向量数据库...")
+        try:
+            self.vectordb = get_vectordb(self.file_path, self.persist_path, self.embedding,self.embedding_key)
+            print("向量数据库初始化完成")
+        except Exception as e:
+            print(f"向量数据库初始化失败: {str(e)}")
+            raise
+        print("Chat_QA_chain_self 初始化完成")
+    
+    def clear_history(self):
+        "清空历史记录"
+        return self.chat_history.clear()
+
+    
+    def change_history_length(self, history_len:int=None):
+        """
+        返回指定数量的历史记录，不传参数则返回全部
+        """
+        if history_len is None:
+            return self.chat_history
+        n = len(self.chat_history)
+        return self.chat_history[n-history_len:]
+
+ 
+    def answer(self, question:str=None, temperature=None, top_k=4, chat_history=None):
+        """"
+        核心方法，调用问答链
+        arguments: 
+        - question：用户提问
+        - chat_history：对话历史记录
+        """
+        print("Chat_QA_chain_self.answer 开始执行...")
+        
+        if len(question) == 0:
+            return "", chat_history or self.chat_history
+        
+        if temperature is None:
+            temperature = self.temperature
+        
+        if chat_history is None:
+            chat_history = self.chat_history
+            
+        print("正在初始化 LLM...")
+        llm = model_to_llm(self.model, temperature, self.appid, self.api_key, self.Spark_api_secret,self.Wenxin_secret_key)
+        print("LLM 初始化完成")
+
+        print("正在初始化检索器...")
+        retriever = self.vectordb.as_retriever(
+            search_type="mmr",  # 改为MMR算法
+            search_kwargs={
+                'k': top_k,
+                'lambda_mult': 0.5  # 控制多样性
+            }
+        )
+        print("检索器初始化完成")
+
+        print("正在创建问答链...")
+        # 新增：显式配置提示词模板
+        from langchain.prompts import PromptTemplate
+        
+        template = """基于以下历史对话和相关文档回答用户问题。如果历史对话中已包含相关信息，优先参考历史对话内容：
+        
+        历史对话：
+        {chat_history}
+        
+        相关文档：
+        {context}
+        
+        问题：{question}
+        """
+        QA_PROMPT = PromptTemplate(
+            template=template,
+            input_variables=["chat_history", "context", "question"]
+        )
+        
+        qa = ConversationalRetrievalChain.from_llm(
+            llm=llm,
+            retriever=retriever,
+            combine_docs_chain_kwargs={"prompt": QA_PROMPT}  # 应用自定义模板
+        )
+        print("问答链创建完成")
+
+        print("正在发送问题到模型...")
+        print("当前传递的chat_history内容：", chat_history)
+        # 新增：打印检索结果调试信息
+        docs = retriever.get_relevant_documents(question)
+        print(f"检索到的文档内容：{[doc.page_content[:50]+'...' for doc in docs]}")  # 显示文档前50字符
+        result = qa({"question": question, "chat_history": chat_history})
+        print("收到模型回复")
+        answer = result['answer']
+        answer = re.sub(r"\\n", '<br/>', answer)
+        chat_history.append((question, answer))
+
+        print("Chat_QA_chain_self.answer 执行完成")
+        return chat_history  #返回本次回答和更新后的历史记录
+        
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

qa_chain/QA_chain_self.py

@@ -0,0 +1,176 @@
+from langchain.prompts import PromptTemplate
+from langchain.chains import RetrievalQA
+from langchain.vectorstores import Chroma
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+from model_to_llm import model_to_llm 
+from get_vectordb import get_vectordb
+import sys
+import re
+
+class QA_chain_self():
+    """"
+    不带历史记录的问答链
+    - model：调用的模型名称
+    - temperature：温度系数，控制生成的随机性
+    - top_k：返回检索的前k个相似文档
+    - file_path：建库文件所在路径
+    - persist_path：向量数据库持久化路径
+    - appid：星火需要输入
+    - api_key：所有模型都需要
+    - Spark_api_secret：星火秘钥
+    - Wenxin_secret_key：文心秘钥
+    - embeddings：使用的embedding模型  
+    - embedding_key：使用的embedding模型的秘钥（智谱或者OpenAI）
+    - template：可以自定义提示模板，没有输入则使用默认的提示模板default_template_rq    
+    """
+
+    #基于召回结果和 query 结合起来构建的 prompt使用的默认提示模版
+    default_template_rq = """你是一个三国大乱斗系统的AI助手。请根据以下角色信息回答问题。
+    
+    角色信息：
+    {context}
+    
+    问题: {question}
+    
+    请按照以下规则回答：
+    1. 如果问题是抽取角色或角色信息相关，请不要只回答角色名，而是回答以下信息：
+       - 抽取结果：[角色名]
+       - 角色特点：[简要描述]
+       - 属性值：[列出关键属性]
+       - 技能说明：[列出技能效果]
+    
+    
+    2. 如果问题是战斗规则说明相关：
+       请直接引用下面"回合制对战规则"部分的内容，包括：
+       - 回合顺序：每回合速度快的一方先出手
+       - 行动选择：每回合可选择普通攻击、使用技能、休息（回复1%体力和10灵力）
+       - 技能使用：需要支付相应消耗，无法支付则无法发动
+       - 伤害计算的逻辑：- 普通攻击伤害 = (攻击方攻击-防御方防御)/防御方耐力*2  
+            - 技能附加效果（如增伤、减防、附加状态）独立计算。
+       - 胜负判定：体力降为0或以下即判负
+
+    3. 如果问题是对战、模拟战、战斗相关：
+       - 对战双方：[双方角色名]
+       - 行动类型：[普通攻击/技能/休息]
+       - 行动结果：[详细描述]
+       - 伤害计算：[如果有伤害，显示计算过程]
+       - 状态变化：[双方状态变化]
+    
+    4. 如果问题是状态查询相关：
+       - 当前状态：[详细描述]
+       - 可用行动：[可选操作]
+       - 建议策略：[战术建议]
+    
+    回答要严谨简约，并保持专业性和准确性。如果不知道答案，请直接说明，不要编造信息。"""
+
+    def __init__(self, model:str, temperature:float=0.0, top_k:int=4,  file_path:str=None, persist_path:str=None, appid:str=None, api_key:str=None, Spark_api_secret:str=None,Wenxin_secret_key:str=None, embedding = "openai",  embedding_key = None, template=default_template_rq):
+        self.model = model
+        self.temperature = temperature
+        self.top_k = top_k
+        self.file_path = file_path
+        self.persist_path = persist_path
+        self.appid = appid
+        self.api_key = api_key
+        self.Spark_api_secret = Spark_api_secret
+        self.Wenxin_secret_key = Wenxin_secret_key
+        self.embedding = embedding
+        self.embedding_key = embedding_key
+        self.template = template
+        self.vectordb = get_vectordb(self.file_path, self.persist_path, self.embedding,self.embedding_key)
+        self.llm = model_to_llm(self.model, self.temperature, self.appid, self.api_key, self.Spark_api_secret,self.Wenxin_secret_key)
+
+        self.QA_CHAIN_PROMPT = PromptTemplate(input_variables=["context","question"],
+                                    template=self.template)
+        self.retriever = self.vectordb.as_retriever(
+            search_type="similarity_score_threshold",
+            search_kwargs={
+                'k': self.top_k,
+                'score_threshold': 0.3  # 降低阈值获取更多结果
+            }
+        )
+        # 自定义 QA 链
+        self.qa_chain = RetrievalQA.from_chain_type(llm=self.llm,
+                                        retriever=self.retriever,
+                                        return_source_documents=True,
+                                        chain_type_kwargs={"prompt":self.QA_CHAIN_PROMPT})
+
+    #基于大模型的问答 prompt 使用的默认提示模版
+    #default_template_llm = """请回答下列问题:{question}"""
+           
+    def answer(self, question:str=None, temperature = None, top_k = 4):
+        """"
+        核心方法，调用问答链
+        arguments: 
+        - question：用户提问
+        """
+
+        if len(question) == 0:
+            return ""
+        
+        if temperature == None:
+            temperature = self.temperature
+            
+        if top_k == None:
+            top_k = self.top_k
+
+        result = self.qa_chain({"query": question, "temperature": temperature, "top_k": top_k})
+        answer = result["result"]
+        answer = re.sub(r"\\n", '<br/>', answer)
+        return answer   
+
+    def battle_analysis(self, character1: str, character2: str):
+        """
+        分析两个角色之间的战斗
+        """
+        question = f"请分析{character1}和{character2}之间的战斗，谁会获胜？请详细分析双方的属性、技能和战斗策略。"
+        return self.answer(question, temperature=0.7, top_k=6)
+
+    def skill_analysis(self, character: str, skill: str):
+        """
+        分析特定角色的特定技能
+        """
+        question = f"请详细分析{character}的{skill}技能，包括技能效果、消耗和最佳使用时机。"
+        return self.answer(question, temperature=0.5, top_k=4)
+
+    def character_comparison(self, character1: str, character2: str):
+        """
+        比较两个角色的属性
+        """
+        question = f"请详细比较{character1}和{character2}的属性，包括攻击力、防御力、体力、耐力、法力、闪避和速度，并分析各自的优势和劣势。"
+        return self.answer(question, temperature=0.5, top_k=6)
+
+    def battle_strategy(self, character: str, opponent: str):
+        """
+        为特定角色提供战斗策略
+        """
+        question = f"如果{character}要对抗{opponent}，应该采用什么战斗策略？请根据双方的属性和技能给出具体的建议。"
+        return self.answer(question, temperature=0.7, top_k=6)   
+
+    def draw_character(self, specific_character: str = None):
+        """
+        抽取角色卡
+        specific_character: 如果指定了具体角色，则抽取该角色；否则随机抽取
+        """
+        if specific_character:
+            question = f"请抽取{specific_character}的角色卡，并详细介绍其属性和技能特点。"
+        else:
+            question = "请随机抽取一张三国人物卡，并详细介绍该角色的属性和技能特点。"
+        return self.answer(question, temperature=0.7, top_k=4)
+
+    def battle_simulation(self, player_character: str, action: str):
+        """
+        模拟战斗
+        player_character: 玩家角色
+        action: 玩家选择的行动（普通攻击/使用技能/休息）
+        """
+        question = f"玩家使用{player_character}选择了{action}，请模拟一场战斗，详细描述战斗过程和结果。"
+        return self.answer(question, temperature=0.8, top_k=6)
+
+    def character_status(self, character: str):
+        """
+        查询角色状态
+        """
+        question = f"请查询{character}的当前状态，包括体力、灵力、技能冷却等信息。"
+        return self.answer(question, temperature=0.5, top_k=4)

qa_chain/get_vectordb.py

@@ -0,0 +1,39 @@
+import sys 
+# sys.path.append("../embedding") 
+# sys.path.append("../database") 
+
+from langchain.embeddings.openai import OpenAIEmbeddings    # 调用 OpenAI 的 Embeddings 模型
+import os
+from embedding.zhipuai_embedding import ZhipuAIEmbeddings
+from database.create_db import create_db,load_knowledge_db
+from embedding.call_embedding import get_embedding
+
+def get_vectordb(file_path:str=None, persist_path:str=None, embedding = "openai",embedding_key:str=None):
+    """
+    返回向量数据库对象
+    输入参数：
+    question：
+    llm:
+    vectordb:向量数据库(必要参数),一个对象
+    template：提示模版（可选参数）可以自己设计一个提示模版，也有默认使用的
+    embedding：可以使用zhipuai等embedding，不输入该参数则默认使用 openai embedding，注意此时api_key不要输错
+    """
+    
+    embedding = get_embedding(embedding=embedding, embedding_key=embedding_key)
+    
+    if os.path.exists(persist_path):  #持久化目录存在
+        contents = os.listdir(persist_path)
+        if len(contents) == 0:  #但是下面为空
+            print("创建新的向量数据库...")
+            vectordb = create_db(file_path, persist_path, embedding)
+            vectordb = load_knowledge_db(persist_path, embedding)
+        else:
+            print(f"加载已有向量数据库...")
+            vectordb = load_knowledge_db(persist_path, embedding)
+    else: #目录不存在，从头开始创建向量数据库
+        print("创建新的向量数据库...")
+        vectordb = create_db(file_path, persist_path, embedding)
+        vectordb = load_knowledge_db(persist_path, embedding)
+
+    print("向量数据库初始化完成")
+    return vectordb

qa_chain/model_to_llm.py

@@ -0,0 +1,48 @@
+import sys 
+import os
+
+# 添加项目根目录到 Python 路径
+current_dir = os.path.dirname(os.path.abspath(__file__))
+project_root = os.path.dirname(current_dir)
+if project_root not in sys.path:
+    sys.path.append(project_root)
+
+from llm.wenxin_llm import Wenxin_LLM
+from llm.spark_llm import Spark_LLM
+from llm.zhipuai_llm import ZhipuAILLM
+from langchain.chat_models import ChatOpenAI
+from llm.call_llm import parse_llm_api_key
+
+
+def model_to_llm(model:str=None, temperature:float=0.0, appid:str=None, api_key:str=None,Spark_api_secret:str=None,Wenxin_secret_key:str=None):
+        """
+        星火：model,temperature,appid,api_key,api_secret
+        百度问心：model,temperature,api_key,api_secret
+        智谱：model,temperature,api_key
+        OpenAI：model,temperature,api_key
+        """
+        if model in ["gpt-3.5-turbo", "gpt-3.5-turbo-16k-0613", "gpt-3.5-turbo-0613", "gpt-4", "gpt-4-32k"]:
+            if api_key == None:
+                api_key = parse_llm_api_key("openai")
+            llm = ChatOpenAI(model_name = model, temperature = temperature , openai_api_key = api_key)
+        elif model in ["ERNIE-Bot", "ERNIE-Bot-4", "ERNIE-Bot-turbo"]:
+            if api_key == None or Wenxin_secret_key == None:
+                api_key, Wenxin_secret_key = parse_llm_api_key("wenxin")
+            llm = Wenxin_LLM(model=model, temperature = temperature, api_key=api_key, secret_key=Wenxin_secret_key)
+        elif model == "Spark-X1":
+            if api_key == None or appid == None and Spark_api_secret == None:
+                api_key, appid, Spark_api_secret = parse_llm_api_key("spark")
+            llm = Spark_LLM(model=model, temperature = temperature, appid=appid, api_secret=Spark_api_secret, api_key=api_key)
+        elif model in ["chatglm_pro", "chatglm_std", "chatglm_lite"]:
+            if api_key == None:
+                api_key = parse_llm_api_key("zhipuai")
+            llm = ZhipuAILLM(model=model, zhipuai_api_key=api_key, temperature = temperature)
+        elif model in ["qwen-turbo", "qwen-plus", "qwen-max"]:
+            if api_key == None:
+                api_key = parse_llm_api_key("ali")
+            from llm.ali_llm import Ali_LLM
+            llm = Ali_LLM(model=model, temperature=temperature, api_key=api_key)
+            
+        else:
+            raise ValueError(f"model{model} not support!!!")
+        return llm

qa_chain/test.ipynb

@@ -0,0 +1,306 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from Chat_QA_chain_self import Chat_QA_chain_self #带历史记录的问答链\n",
+    "from QA_chain_self import QA_chain_self       #不带历史记录的问答链"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "# os.environ"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 带历史记录的问答链  "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# 定义参数\n",
+    "# model可选值：[\"gpt-3.5-turbo\", \"gpt-3.5-turbo-16k-0613\", \"gpt-3.5-turbo-0613\", \"gpt-4\", \"gpt-4-32k\"]，[\"ERNIE-Bot\", \"ERNIE-Bot-4\", \"ERNIE-Bot-turbo\"]，\n",
+    "# [\"Spark-1.5\", \"Spark-2.0\"]，[\"chatglm_pro\", \"chatglm_std\", \"chatglm_lite\"]\n",
+    "model:str = \"chatglm_std\"\n",
+    "temperature:float=0.0\n",
+    "top_k:int=4 \n",
+    "chat_history:list=[] \n",
+    "file_path:str = \"/Users/lta/Desktop/llm-universe/data_base/knowledge_db\"\n",
+    "persist_path:str = \"/Users/lta/Desktop/llm-universe/data_base/vector_db/chroma\"\n",
+    "appid:str=None \n",
+    "api_key:str = \"\"   #or 从本地环境读取\n",
+    "api_secret:str=None \n",
+    "embedding = \"m3e\"     # [\"openai\",\"zhipuai\", \"m3e\"]  默认m3e\n",
+    "embedding_key = \"\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "<Chat_QA_chain_self.Chat_QA_chain_self object at 0x2a0310b80>\n"
+     ]
+    }
+   ],
+   "source": [
+    "qa_chain = Chat_QA_chain_self(model=model, temperature=temperature, top_k=top_k, chat_history=chat_history, file_path=file_path, persist_path=persist_path, api_key=api_key, embedding = embedding, embedding_key=embedding_key)\n",
+    "print(qa_chain)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### 第一轮"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "question = \"我可以学习到关于强化学习的知识吗？\"\n",
+    "#answer,chat_history = qa_chain.answer(question)\n",
+    "answer = qa_chain.answer(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[('我可以学习到关于强化学习的知识吗？', '根据您提供的信息，强化学习是一种机器学习的子领域，主要研究在不确定的情况下如何做出好的决策。强化学习应用广泛，如玩游戏、控制机器人、自动驾驶等。您提到的《Easy RL：强化学习教程》是一本关于强化学习的教材，该书通过一些简单生动的例子来解释强化学习概念，配有对应的概念词、习题和面试题，以及代码实战。这本书得到了一些专业人士的好评，并被推荐用于学习强化学习。\\\\n\\\\n另外，您还提到了一个名为rl-papers的仓库，该仓库收集了强化学习及其应用领域的论文，涵盖了基础强化学习、多智体强化学习、推荐系统、游戏理论、交通系统等多个方面。通过阅读这些论文，您也可以了解到关于强化学习的知识。\\\\n\\\\n综上所述，您可以学习到关于强化学习的知识，可以通过阅读《Easy RL：强化学习教程》和参考rl-papers仓库中的论文来进一步了解强化学习。')]\n",
+      "[('我可以学习到关于强化学习的知识吗？', '根据您提供的信息，强化学习是一种机器学习的子领域，主要研究在不确定的情况下如何做出好的决策。强化学习应用广泛，如玩游戏、控制机器人、自动驾驶等。您提到的《Easy RL：强化学习教程》是一本关于强化学习的教材，该书通过一些简单生动的例子来解释强化学习概念，配有对应的概念词、习题和面试题，以及代码实战。这本书得到了一些专业人士的好评，并被推荐用于学习强化学习。\\\\n\\\\n另外，您还提到了一个名为rl-papers的仓库，该仓库收集了强化学习及其应用领域的论文，涵盖了基础强化学习、多智体强化学习、推荐系统、游戏理论、交通系统等多个方面。通过阅读这些论文，您也可以了解到关于强化学习的知识。\\\\n\\\\n综上所述，您可以学习到关于强化学习的知识，可以通过阅读《Easy RL：强化学习教程》和参考rl-papers仓库中的论文来进一步了解强化学习。')]\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(answer)\n",
+    "print(chat_history)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### 第二��"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "question = \"为什么这门课需要教这方面的知识？\"\n",
+    "answer,chat_history = qa_chain.answer(question)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "('我可以学习到关于强化学习的知识吗？', '根据您提供的信息，强化学习是一种机器学习的子领域，主要研究在不确定的情况下如何做出好的决策。强化学习应用广泛，如玩游戏、控制机器人、自动驾驶等。您提到的《Easy RL：强化学习教程》是一本关于强化学习的教材，该书通过一些简单生动的例子来解释强化学习概念，配有对应的概念词、习题和面试题，以及代码实战。这本书得到了一些专业人士的好评，并被推荐用于学习强化学习。\\\\n\\\\n另外，您还提到了一个名为rl-papers的仓库，该仓库收集了强化学习及其应用领域的论文，涵盖了基础强化学习、多智体强化学习、推荐系统、游戏理论、交通系统等多个方面。通过阅读这些论文，您也可以了解到关于强化学习的知识。\\\\n\\\\n综上所述，您可以学习到关于强化学习的知识，可以通过阅读《Easy RL：强化学习教程》和参考rl-papers仓库中的论文来进一步了解强化学习。')\n",
+      "('为什么这门课需要教这方面的知识？', '强化学习作为人工智能的一个重要分支，主要研究在不确定的情况下如何做出好的决策。现实生活中许多问题都具有不确定性和动态性，因此强化学习在很多领域都有广泛的应用，如自动驾驶、机器人控制、智能交通、游戏AI等。学习强化学习可以帮助学生更好地理解和解决这些问题，为我国人工智能领域的发展贡献力量。此外，强化学习也是目前学术界和工业界的研究热点，掌握这门课程的知识可以帮助学生在未来的工作和研究中更好地适应和引领这个领域的发展。')\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(answer)\n",
+    "print(chat_history)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### 改变历史记录的长度"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[('为什么这门课需要教这方面的知识？', '强化学习作为人工智能的一个重要分支，主要研究在不确定的情况下如何做出好的决策。现实生活中许多问题都具有不确定性和动态性，因此强化学习在很多领域都有广泛的应用，如自动驾驶、机器人控制、智能交通、游戏AI等。学习强化学习可以帮助学生更好地理解和解决这些问题，为我国人工智能领域的发展贡献力量。此外，强化学习也是目前学术界和工业界的研究热点，掌握这门课程的知识可以帮助学生在未来的工作和研究中更好地适应和引领这个领域的发展。')]\n"
+     ]
+    }
+   ],
+   "source": [
+    "history_len = 1 \n",
+    "\n",
+    "### 改变历史记录的长度,使用的是history_len参数来改变保留历史记录的长度\n",
+    "chat_history = qa_chain.change_history_length(history_len)\n",
+    "print(chat_history)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### 清除历史记录"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "None\n"
+     ]
+    }
+   ],
+   "source": [
+    "chat_history = qa_chain.clear_history()\n",
+    "print(chat_history)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 不带历史记录的问答链"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# 定义参数\n",
+    "# model可选值：[\"gpt-3.5-turbo\", \"gpt-3.5-turbo-16k-0613\", \"gpt-3.5-turbo-0613\", \"gpt-4\", \"gpt-4-32k\"]，[\"ERNIE-Bot\", \"ERNIE-Bot-4\", \"ERNIE-Bot-turbo\"]，\n",
+    "# [\"Spark-1.5\", \"Spark-2.0\"]，[\"chatglm_pro\", \"chatglm_std\", \"chatglm_lite\"]\n",
+    "model:str = \"chatglm_std\"\n",
+    "temperature:float=0.0\n",
+    "top_k:int=4 \n",
+    "file_path:str = \"/Users/lta/Desktop/llm-universe/data_base/knowledge_db\"\n",
+    "persist_path:str = \"/Users/lta/Desktop/llm-universe/data_base/vector_db/chroma\"\n",
+    "appid:str=None \n",
+    "api_key:str = \"\"   #or从本地环境读取\n",
+    "api_secret:str=None \n",
+    "embedding = \"m3e\"\n",
+    "embedding_key = \"\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "<QA_chain_self.QA_chain_self object at 0x2f5afdf10>\n"
+     ]
+    }
+   ],
+   "source": [
+    "#星火输入参数用法\n",
+    "#qa_chain = QA_chain_self(model=model, temperature=temperature, top_k=top_k, file_path=file_path, persist_path=persist_path, appid=appid,api_key=api_key,Spark_api_secret=Spark_api_secret, embedding = embedding,embedding_key=embedding_key)\n",
+    "\n",
+    "##百度文心输入参数用法\n",
+    "#qa_chain = QA_chain_self(model=model, temperature=temperature, top_k=top_k, file_path=file_path, persist_path=persist_path, appid=appid,api_key=api_key,Wenxin_api_secret=Wenxin_api_secret, embedding = embedding,embedding_key=embedding_key)\n",
+    "\n",
+    "#智谱(或OpenAI)输入参数用法\n",
+    "qa_chain = QA_chain_self(model=model, temperature=temperature, top_k=top_k, file_path=file_path, persist_path=persist_path, appid=appid,api_key=api_key, embedding = embedding,embedding_key=embedding_key)\n",
+    "print(qa_chain)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "question = \"什么是蘑菇书（easyrl）？\"\n",
+    "answer = qa_chain.answer(question)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "蘑菇书（easy-rl）是一本关于强化学习的教程，主要包含李宏毅老师的强化学习视频内容、经典资料整理、章节习题和算法实战等，旨在帮助读者学习强化学习并探索人工智能领域。谢谢你的提问！\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(answer)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "------------------\n",
+    "> 其他模型可参考上面的实例进行使用，embedding 目前支持 openAI 和智谱以及m3e的模型，其他类型敬请期待！"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "xuhu",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.9.18"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

qa_chain/test_chat.py

@@ -0,0 +1,49 @@
+import sys
+import os
+
+# 添加项目根目录到 Python 路径
+current_dir = os.path.dirname(os.path.abspath(__file__))
+project_root = os.path.dirname(current_dir)
+if project_root not in sys.path:
+    sys.path.append(project_root)
+
+from qa_chain.Chat_QA_chain_self import Chat_QA_chain_self
+from dotenv import load_dotenv
+
+# 加载环境变量
+load_dotenv()
+
+chat_history:list=[]  # 初始化聊天历史记录
+
+
+def chat_with_ai():
+    print("正在初始化AI助手...")
+    chat_qa = Chat_QA_chain_self(
+        model="qwen-max",  # 改为阿里通义千问模型
+        temperature=0.7,
+        top_k=4,
+        chat_history=chat_history,
+        persist_path="./vector_db/chroma_sanguo",
+        file_path="./knowledge_db/sanguo_characters",
+        api_key=os.getenv("ali_api_key"),  # 使用阿里API Key
+        embedding="m3e",
+        embedding_key=None
+    )
+    print("AI助手初始化完成，可以开始对话了！(输入'退出'结束对话)")
+
+    while True:
+        user_input = input("\n您: ")
+        if user_input.lower() in ["退出", "exit", "quit"]:
+            break
+            
+        history = chat_qa.answer(user_input, chat_history=chat_history)
+        chat_history[:] = history  # 关键修改：将更新后的历史记录同步到全局变量
+        print("\n完整对话历史:")
+        for i, (q, a) in enumerate(history, 1):
+            print(f"{i}. 您: {q}")
+            print(f"   AI: {a}\n")
+        print("\nAI助手最新回复:", history[-1][1])
+
+if __name__ == "__main__":
+    chat_with_ai()
+    

serve/api.py

@@ -0,0 +1,88 @@
+#!/usr/bin/env python
+# -*- encoding: utf-8 -*-
+'''
+@File    :   spark_api.py
+@Time    :   2023/09/24 11:00:46
+@Author  :   Logan Zou 
+@Version :   1.0
+@Contact :   loganzou0421@163.com
+@License :   (C)Copyright 2017-2018, Liugroup-NLPR-CASIA
+@Desc    :   启动服务为本地 API
+'''
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+import os
+import sys
+from pathlib import Path
+
+# 添加项目根目录到 Python 路径
+current_dir = Path(__file__).resolve().parent
+project_root = current_dir.parent
+sys.path.append(str(project_root))
+
+from qa_chain.QA_chain_self import QA_chain_self
+
+# os.environ["HTTP_PROXY"] = "http://127.0.0.1:7890"
+# os.environ["HTTPS_PROXY"] = "http://127.0.0.1:7890"
+
+app = FastAPI() # 创建 api 对象
+
+template = """使用以下上下文来回答最后的问题。如果你不知道答案，就说你不知道，不要试图编造答
+案。最多使用三句话。尽量使答案简明扼要。总是在回答的最后说"谢谢你的提问！"。
+{context}
+问题: {question}
+有用的回答:"""
+
+# 定义一个数据模型，用于接收POST请求中的数据
+class Item(BaseModel):
+    prompt : str # 用户 prompt
+    model : str = "gpt-3.5-turbo"# 使用的模型
+    temperature : float = 0.1# 温度系数
+    if_history : bool = False # 是否使用历史对话功能
+    # API_Key
+    api_key: str = None
+    # Secret_Key
+    secret_key : str = None
+    # access_token
+    access_token: str = None
+    # APPID
+    appid : str = None
+    # APISecret
+    Spark_api_secret : str = None
+    # Secret_key
+    Wenxin_secret_key : str = None
+    # 数据库路径
+    db_path : str = "/Users/lta/Desktop/llm-universe/data_base/vector_db/chroma"
+    # 源文件路径
+    file_path : str = "/Users/lta/Desktop/llm-universe/data_base/knowledge_db"
+    # prompt template
+    prompt_template : str = template
+    # Template 变量
+    input_variables : list = ["context","question"]
+    # Embdding
+    embedding : str = "m3e"
+    # Top K
+    top_k : int = 5
+    # embedding_key
+    embedding_key : str = None
+
+@app.post("/")
+async def get_response(item: Item):
+
+    # 首先确定需要调用的链
+    if not item.if_history:
+        # 调用 Chat 链
+        # return item.embedding_key
+        if item.embedding_key == None:
+            item.embedding_key = item.api_key
+        chain = QA_chain_self(model=item.model, temperature=item.temperature, top_k=item.top_k, file_path=item.file_path, persist_path=item.db_path, 
+                                appid=item.appid, api_key=item.api_key, embedding=item.embedding, template=template, Spark_api_secret=item.Spark_api_secret, Wenxin_secret_key=item.Wenxin_secret_key, embedding_key=item.embedding_key)
+
+        response = chain.answer(question = item.prompt)
+    
+        return response
+    
+    # 由于 API 存在即时性问题，不能支持历史链
+    else:
+        return "API 不支持历史链"

serve/run_api.sh

@@ -0,0 +1,2 @@
+! cd project/serve
+! uvicorn api:app --reload

serve/run_gradio.py

@@ -0,0 +1,251 @@
+# 导入必要的库
+
+import sys
+import os                # 用于操作系统相关的操作，例如读取环境变量
+
+sys.path.append(os.path.dirname(os.path.dirname(__file__)))
+
+import IPython.display   # 用于在 IPython 环境中显示数据，例如图片
+import io                # 用于处理流式数据（例如文件流）
+import gradio as gr
+from dotenv import load_dotenv, find_dotenv
+from llm.call_llm import get_completion
+from database.create_db import create_db_info
+from qa_chain.Chat_QA_chain_self import Chat_QA_chain_self
+from qa_chain.QA_chain_self import QA_chain_self
+import re
+# 导入 dotenv 库的函数
+# dotenv 允许您从 .env 文件中读取环境变量
+# 这在开发时特别有用，可以避免将敏感信息（如API密钥）硬编码到代码中
+
+# 寻找 .env 文件并加载它的内容
+# 这允许您使用 os.environ 来读取在 .env 文件中设置的环境变量
+_ = load_dotenv(find_dotenv())
+LLM_MODEL_DICT = {
+    "openai": ["gpt-3.5-turbo", "gpt-3.5-turbo-16k-0613", "gpt-3.5-turbo-0613", "gpt-4", "gpt-4-32k"],
+    "wenxin": ["ERNIE-Bot", "ERNIE-Bot-4", "ERNIE-Bot-turbo"],
+    "xinhuo": ["Spark-X1"],
+    "zhipuai": ["chatglm_pro", "chatglm_std", "chatglm_lite"]
+}
+
+
+LLM_MODEL_LIST = sum(list(LLM_MODEL_DICT.values()),[])
+INIT_LLM = "chatglm_std"
+EMBEDDING_MODEL_LIST = ['zhipuai', 'openai', 'm3e']
+INIT_EMBEDDING_MODEL = "m3e"
+DEFAULT_DB_PATH = "./knowledge_db"
+DEFAULT_PERSIST_PATH = "./vector_db/chroma"
+AIGC_AVATAR_PATH = "./figures/aigc_avatar.png"
+DATAWHALE_AVATAR_PATH = "./figures/datawhale_avatar.png"
+AIGC_LOGO_PATH = "./figures/aigc_logo.png"
+DATAWHALE_LOGO_PATH = "./figures/datawhale_logo.png"
+
+def get_model_by_platform(platform):
+    return LLM_MODEL_DICT.get(platform, "")
+class Model_center():
+    """
+    存储问答 Chain 的对象 
+
+    - chat_qa_chain_self: 以 (model, embedding) 为键存储的带历史记录的问答链。
+    - qa_chain_self: 以 (model, embedding) 为键存储的不带历史记录的问答链。
+    """
+    def __init__(self):
+        self.chat_qa_chain_self = {}
+        self.qa_chain_self = {}
+
+    def chat_qa_chain_self_answer(self, question: str, chat_history: list = [], model: str = "openai", embedding: str = "openai", temperature: float = 0.0, top_k: int = 4, history_len: int = 3, file_path: str = DEFAULT_DB_PATH, persist_path: str = DEFAULT_PERSIST_PATH):
+        """
+        调用带历史记录的问答链进行回答
+        """
+        if question == None or len(question) < 1:
+            return "", chat_history
+        try:
+            if (model, embedding) not in self.chat_qa_chain_self:
+                self.chat_qa_chain_self[(model, embedding)] = Chat_QA_chain_self(model=model, temperature=temperature,
+                                                                                    top_k=top_k, chat_history=chat_history, file_path=file_path, persist_path=persist_path, embedding=embedding)
+            chain = self.chat_qa_chain_self[(model, embedding)]
+            return "", chain.answer(question=question, temperature=temperature, top_k=top_k)
+        except Exception as e:
+            return e, chat_history
+
+    def qa_chain_self_answer(self, question: str, chat_history: list = [], model: str = "openai", embedding="openai", temperature: float = 0.0, top_k: int = 4, file_path: str = DEFAULT_DB_PATH, persist_path: str = DEFAULT_PERSIST_PATH):
+        """
+        调用不带历史记录的问答链进行回答
+        """
+        if question == None or len(question) < 1:
+            return "", chat_history
+        try:
+            if (model, embedding) not in self.qa_chain_self:
+                self.qa_chain_self[(model, embedding)] = QA_chain_self(model=model, temperature=temperature,
+                                                                       top_k=top_k, file_path=file_path, persist_path=persist_path, embedding=embedding)
+            chain = self.qa_chain_self[(model, embedding)]
+            chat_history.append(
+                (question, chain.answer(question, temperature, top_k)))
+            return "", chat_history
+        except Exception as e:
+            return e, chat_history
+
+    def clear_history(self):
+        if len(self.chat_qa_chain_self) > 0:
+            for chain in self.chat_qa_chain_self.values():
+                chain.clear_history()
+
+
+def format_chat_prompt(message, chat_history):
+    """
+    该函数用于格式化聊天 prompt。
+
+    参数:
+    message: 当前的用户消息。
+    chat_history: 聊天历史记录。
+
+    返回:
+    prompt: 格式化后的 prompt。
+    """
+    # 初始化一个空字符串，用于存放格式化后的聊天 prompt。
+    prompt = ""
+    # 遍历聊天历史记录。
+    for turn in chat_history:
+        # 从聊天记录中提取用户和机器人的消息。
+        user_message, bot_message = turn
+        # 更新 prompt，加入用户和机器人的消息。
+        prompt = f"{prompt}\nUser: {user_message}\nAssistant: {bot_message}"
+    # 将当前的用户消息也加入到 prompt中，并预留一个位置给机器人的回复。
+    prompt = f"{prompt}\nUser: {message}\nAssistant:"
+    # 返回格式化后的 prompt。
+    return prompt
+
+
+
+def respond(message, chat_history, llm, history_len=3, temperature=0.1, max_tokens=2048):
+    """
+    该函数用于生成机器人的回复。
+
+    参数:
+    message: 当前的用户消息。
+    chat_history: 聊天历史记录。
+
+    返回:
+    "": 空字符串表示没有内容需要显示在界面上，可以替换为真正的机器人回复。
+    chat_history: 更新后的聊天历史记录
+    """
+    if message == None or len(message) < 1:
+            return "", chat_history
+    try:
+        # 限制 history 的记忆长度
+        chat_history = chat_history[-history_len:] if history_len > 0 else []
+        # 调用上面的函数，将用户的消息和聊天历史记录格式化为一个 prompt。
+        formatted_prompt = format_chat_prompt(message, chat_history)
+        # 使用llm对象的predict方法生成机器人的回复（注意：llm对象在此代码中并未定义）。
+        bot_message = get_completion(
+            formatted_prompt, llm, temperature=temperature, max_tokens=max_tokens)
+        # 将bot_message中\n换为<br/>
+        bot_message = re.sub(r"\\n", '<br/>', bot_message)
+        # 将用户的消息和机器人的回复加入到聊天历史记录中。
+        chat_history.append((message, bot_message))
+        # 返回一个空字符串和更新后的聊天历史记录（这里的空字符串可以替换为真正的机器人回复，如果需要显示在界面上）。
+        return "", chat_history
+    except Exception as e:
+        return e, chat_history
+
+
+model_center = Model_center()
+
+block = gr.Blocks()
+with block as demo:
+    with gr.Row(equal_height=True):           
+        gr.Image(value=AIGC_LOGO_PATH, scale=1, min_width=10, show_label=False, show_download_button=False, container=False)
+   
+        with gr.Column(scale=2):
+            gr.Markdown("""<h1><center>动手学大模型应用开发</center></h1>
+                <center>LLM-UNIVERSE</center>
+                """)
+        gr.Image(value=DATAWHALE_LOGO_PATH, scale=1, min_width=10, show_label=False, show_download_button=False, container=False)
+
+    with gr.Row():
+        with gr.Column(scale=4):
+            chatbot = gr.Chatbot(height=400, show_copy_button=True, show_share_button=True, avatar_images=(AIGC_AVATAR_PATH, DATAWHALE_AVATAR_PATH))
+            # 创建一个文本框组件，用于输入 prompt。
+            msg = gr.Textbox(label="Prompt/问题")
+
+            with gr.Row():
+                # 创建提交按钮。
+                db_with_his_btn = gr.Button("Chat db with history")
+                db_wo_his_btn = gr.Button("Chat db without history")
+                llm_btn = gr.Button("Chat with llm")
+            with gr.Row():
+                # 创建一个清除按钮，用于清除聊天机器人组件的内容。
+                clear = gr.ClearButton(
+                    components=[chatbot], value="Clear console")
+
+        with gr.Column(scale=1):
+            file = gr.File(label='请选择知识库目录', file_count='directory',
+                           file_types=['.txt', '.md', '.docx', '.pdf'])
+            with gr.Row():
+                init_db = gr.Button("知识库文件向量化")
+            model_argument = gr.Accordion("参数配置", open=False)
+            with model_argument:
+                temperature = gr.Slider(0,
+                                        1,
+                                        value=0.01,
+                                        step=0.01,
+                                        label="llm temperature",
+                                        interactive=True)
+
+                top_k = gr.Slider(1,
+                                  10,
+                                  value=3,
+                                  step=1,
+                                  label="vector db search top k",
+                                  interactive=True)
+
+                history_len = gr.Slider(0,
+                                        5,
+                                        value=3,
+                                        step=1,
+                                        label="history length",
+                                        interactive=True)
+
+            model_select = gr.Accordion("模型选择")
+            with model_select:
+                llm = gr.Dropdown(
+                    LLM_MODEL_LIST,
+                    label="large language model",
+                    value=INIT_LLM,
+                    interactive=True)
+
+                embeddings = gr.Dropdown(EMBEDDING_MODEL_LIST,
+                                         label="Embedding model",
+                                         value=INIT_EMBEDDING_MODEL)
+
+        # 设置初始化向量数据库按钮的点击事件。当点击时，调用 create_db_info 函数，并传入用户的文件和希��使用的 Embedding 模型。
+        init_db.click(create_db_info,
+                      inputs=[file, embeddings], outputs=[msg])
+
+        # 设置按钮的点击事件。当点击时，调用上面定义的 chat_qa_chain_self_answer 函数，并传入用户的消息和聊天历史记录，然后更新文本框和聊天机器人组件。
+        db_with_his_btn.click(model_center.chat_qa_chain_self_answer, inputs=[
+                              msg, chatbot,  llm, embeddings, temperature, top_k, history_len],
+                              outputs=[msg, chatbot])
+        # 设置按钮的点击事件。当点击时，调用上面定义的 qa_chain_self_answer 函数，并传入用户的消息和聊天历史记录，然后更新文本框和聊天机器人组件。
+        db_wo_his_btn.click(model_center.qa_chain_self_answer, inputs=[
+                            msg, chatbot, llm, embeddings, temperature, top_k], outputs=[msg, chatbot])
+        # 设置按钮的点击事件。当点击时，调用上面定义的 respond 函数，并传入用户的消息和聊天历史记录，然后更新文本框和聊天机器人组件。
+        llm_btn.click(respond, inputs=[
+                      msg, chatbot, llm, history_len, temperature], outputs=[msg, chatbot], show_progress="minimal")
+
+        # 设置文本框的提交事件（即按下Enter键时）。功能与上面的 llm_btn 按钮点击事件相同。
+        msg.submit(respond, inputs=[
+                   msg, chatbot,  llm, history_len, temperature], outputs=[msg, chatbot], show_progress="hidden")
+        # 点击后清空后端存储的聊天记录
+        clear.click(model_center.clear_history)
+    gr.Markdown("""提醒：<br>
+    1. 使用时请先上传自己的知识文件，不然将会解析项目自带的知识库。
+    2. 初始化数据库时间可能较长，请耐心等待。
+    3. 使用中如果出现异常，将会在文本输入框进行展示，请不要惊慌。 <br>
+    """)
+# threads to consume the request
+gr.close_all()
+# 启动新的 Gradio 应用，设置分享功能为 True，并使用环境变量 PORT1 指定服务器端口。
+# demo.launch(share=True, server_port=int(os.environ['PORT1']))
+# 直接启动
+demo.launch()

serve/sanguo_duel.py

@@ -0,0 +1,85 @@
+import gradio as gr
+from dotenv import load_dotenv
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))  # 添加项目根目录
+from qa_chain.Chat_QA_chain_self import Chat_QA_chain_self
+
+# 加载环境变量
+load_dotenv()
+
+chat_history:list=[]  # 初始化聊天历史记录
+
+class ChatSystem:
+    def __init__(self):
+        self.chat_chain = Chat_QA_chain_self(
+        model="qwen-max",  # 改为阿里通义千问模型
+        temperature=0.7,
+        top_k=4,
+        chat_history=chat_history,
+        persist_path="./vector_db/chroma_sanguo",
+        file_path="./knowledge_db/sanguo_characters",
+        api_key=os.getenv("ali_api_key"),  # 使用阿里API Key
+        embedding="m3e",
+        embedding_key=None
+    )
+
+chat_system = ChatSystem()
+
+def handle_message(message, chat_history):
+    if not message:
+        return "", chat_history
+    
+    # 处理None值：将用户消息中的None转换为空字符串
+    formatted_chat_history = []
+    for item in chat_history:
+        user_msg, ai_msg = item
+        formatted_user_msg = user_msg if user_msg is not None else ""  # 关键修改
+        formatted_chat_history.append((formatted_user_msg, ai_msg))
+    
+    # 调用问答链获取回复
+    updated_history = chat_system.chat_chain.answer(
+        question=message, 
+        chat_history=formatted_chat_history
+    )
+    
+    # 转换回列表的列表供Gradio显示
+    return "", [list(item) for item in updated_history]
+
+with gr.Blocks() as simple_demo:
+    # 使用Row布局水平排列图标和标题（可改为Column垂直排列）
+    with gr.Row(equal_height=True,justify="center"):  # equal_height=True保证行内组件高度一致
+        # 加载图标（调整参数保持1:1比例）
+        gr.Image(
+            value="./figures/sanguo.png",  # 图标路径
+            scale=0.2,  # 控制组件在布局中的占比（1表示与相邻组件等宽）
+            # min_width=60,  # 设置最小宽度（根据图标原始尺寸调整）
+            # min_height=60,  # 设置最小高度（与min_width相同，保持1:1）
+            width=80,  # 固定宽度
+            height=80,  # 固定高度
+            show_label=False,  # 隐藏标签
+            show_download_button=False,  # 隐藏下载按钮
+            container=False  # 去除图标外边框
+        )
+        gr.Markdown("## 三国大乱斗系统")  # 原标题
+    
+    # 初始化带系统介绍的聊天框
+    chatbot = gr.Chatbot(
+        height=600,
+        value=[[None, "欢迎使用三国大乱斗系统！我可以为您提供以下功能：\n1. 角色抽取：随机抽取三国人物卡并展示完整信息\n2. 对战规程介绍：包括回合制规则、技能使用说明等\n3. 实时对战：支持玩家与AI的回合制对战模拟\n请输入您的问题开始交互~"]]
+    )
+    msg = gr.Textbox(label="请输入您的问题")
+    
+    with gr.Row():
+        submit_btn = gr.Button("发送")
+        clear_btn = gr.Button("清空对话")
+
+    submit_btn.click(
+        handle_message,
+        inputs=[msg, chatbot],
+        outputs=[msg, chatbot]
+    )
+    clear_btn.click(lambda: [], None, chatbot)
+
+if __name__ == "__main__":
+    simple_demo.launch()

serve/test.ipynb

@@ -0,0 +1,63 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 41,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import requests\n",
+    "\n",
+    "url = \"http://127.0.0.1:8000\"\n",
+    "\n",
+    "data = {\n",
+    "    \"prompt\":\"什么是蘑菇书(easyrl)？\",\n",
+    "    \"api_key\":\"\"\n",
+    "}\n",
+    "\n",
+    "r = requests.post(url, json=data)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 42,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'\"蘑菇书(easyrl)是一个仓库，内容主要包括李宏毅老师强化学习视频内容、经典资料整理、章节习题、算法实战等，旨在帮助读者学习强化学习并探索人工智能领域。谢谢你的提问！\"'"
+      ]
+     },
+     "execution_count": 42,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.text"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "gpt",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.0"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

split_docs/split_documents.txt

@@ -0,0 +1,2006 @@
+
+文档 1:
+--------------------------------------------------
+角色：刘备
+攻击力：150
+防御力：80
+体力：100
+耐力：60
+法力：70
+闪避：20
+速度：50
+技能：
+- 仁德护体：防御力提升30%，持续2回合，并恢复自身10%体力
+  耐力消耗：5，法力消耗：20
+- 激将：攻击力提升50%（1回合），且必定命中，但自身防御下降20%
+  耐力消耗：10，法力消耗：25
+- 遁走：消耗50%耐力强制撤退，本回合闪避率提升至100%（仅生效一次）
+  耐力消耗：8，法力消耗：15
+
+--------------------------------------------------
+
+文档 2:
+--------------------------------------------------
+角色：诸葛亮
+攻击力：580
+防御力：120
+体力：100
+耐力：80
+法力：90
+闪避：30
+速度：85
+技能：
+- 七星灯：恢复自身30%体力，并提升30%攻击增强，持续2回合
+  耐力消耗：5，法力消耗：30
+- 火攻计：对单体目标造成150%攻击伤害，并附加灼烧状态（每回合损失1%体力，持续3回合）
+  耐力消耗：3，法力消耗：20
+- 八卦阵：提升50%防御和20%闪避，持续3回合，必定命中
+  耐力消耗：7，法力消耗：15
+
+--------------------------------------------------
+
+文档 3:
+--------------------------------------------------
+角色：关羽
+攻击力：720
+防御力：160
+体力：100
+耐力：85
+法力：75
+闪避：35
+速度：70
+技能：
+- 青龙斩：攻击力提升30%，必定命中，攻击附加灼烧状态（每回合降低1%体力）
+  耐力消耗：10，法力消耗：25
+- 铁壁防御：防御力提升50%，闪避率增加15%（持续2回合）
+  耐力消耗：8，法力消耗：20
+- 义薄云天：恢复自身20%体力，下一击暴击率提升50%
+  耐力消耗：7，法力消耗：30
+
+--------------------------------------------------
+
+文档 4:
+--------------------------------------------------
+角色：张飞
+攻击力：620
+防御力：160
+体力：100
+耐力：80
+法力：35
+闪避：15
+速度：85
+技能：
+- 怒吼冲锋：攻击增强30%，持续2回合，并附带必定命中效果
+  耐力消耗：7，法力消耗：20
+- 铁壁防御：防御力提升50%，并回复自身15%体力，持续1回合
+  耐力消耗：9，法力消耗：15
+- 烈焰斩：造成150%攻击力的伤害，并使目标进入灼烧状态（每回合损失3%体力，持续3回合）
+  耐力消耗：5，法力消耗：25
+
+--------------------------------------------------
+
+文档 5:
+--------------------------------------------------
+角色：赵云
+攻击力：600
+防御力：150
+体力：100
+耐力：80
+法力：30
+闪避：25
+速度：90
+技能：
+- 七探盘龙：攻击力提升30%，持续3回合，且必定命中
+  耐力消耗：5，法力消耗：15
+- 银甲护体：防御力提升40%，持续2回合，并附加30%概率闪避普攻
+  耐力消耗：8，法力消耗：20
+- 龙胆恢复：恢复自身30%体力，若体力低于50%则额外解除负面状态
+  耐力消耗：10，法力消耗：25
+
+--------------------------------------------------
+
+文档 6:
+--------------------------------------------------
+角色：黄忠
+攻击力：620
+防御力：110
+体力：100
+耐力：60
+法力：40
+闪避：35
+速度：85
+技能：
+- 百步穿杨：攻击力提升30%，持续3回合（必中）
+  耐力消耗：5，法力消耗：15
+- 烈弓术：射出火焰箭，造成1.5倍伤害并附加灼烧状态（每回合损失1%体力，持续3回合）
+  耐力消耗：8，法力消耗：25
+- 鹰眼洞察：闪避率提升20%并解除自身负面状态，持续2回合
+  耐力消耗：3，法力消耗：10
+
+--------------------------------------------------
+
+文档 7:
+--------------------------------------------------
+角色：马超
+攻击力：620
+防御力：110
+体力：100
+耐力：85
+法力：45
+闪避：38
+速度：95
+技能：
+- 铁骑突袭：对单体目标造成1.5倍伤害，并有30%几率使目标进入灼烧状态（每回合损失1%体力，持续3回合）
+  耐力消耗：7，法力消耗：20
+- 狼啸破阵：消耗自身10%体力发动强力攻击，本次攻击必定命中且暴击率提升50%，若击杀目标则恢复15%体力
+  耐力消耗：3，法力消耗：25
+- 西凉战吼：提升自身30%攻击力和20%防御力，持续2回合，并驱散所有负面状态
+  耐力消耗：9，法力消耗：30
+
+--------------------------------------------------
+
+文档 8:
+--------------------------------------------------
+角色：魏延
+攻击力：780
+防御力：160
+体力：100
+耐力：85
+法力：75
+闪避：30
+速度：90
+技能：
+- 狂骨突进：攻击力提升30%持续2回合，并附带20%暴击率
+- 铁壁防守：防御力提升50%持续1回合，但自身速度降低20%
+- 火计连环：消耗灵力释放火焰攻击，造成攻击力120%伤害，目标陷入灼烧状态（每回合损失1%体力，持续3回合）
+
+--------------------------------------------------
+
+文档 9:
+--------------------------------------------------
+角色：姜维
+攻击力：450
+防御力：120
+体力：100
+耐力：70
+法力：60
+闪避：30
+速度：80
+技能：
+- 麒麟撼地击：攻击增强30%，命中后附带震荡效果（降低目标10%防御力，持续2回合）
+  耐力消耗：5，法力消耗：20
+- 八卦阵·守：防御增强40%并恢复自身15%体力，持续3回合
+  耐力消耗：8，法力消耗：25
+- 九伐连矢：释放三波箭雨攻击目标，每波造成60%攻击力伤害，最后一波附带灼烧状态（每回合损失1%体力）
+  耐力消耗：7，法力消耗：30
+
+--------------------------------------------------
+
+文档 10:
+--------------------------------------------------
+角色：徐庶
+攻击力：320
+防御力：85
+体力：100
+耐力：68
+法力：75
+闪避：15
+速度：82
+技能：
+- 石破天惊：攻击增强30%，持续2回合，并附加灼烧状态（每回合降低目标1%体力）
+- 观星遁甲：自身防御增强40%，闪避率提升20%，持续3回合
+- 风卷残云：消耗灵力恢复己方全体15%体力，并附带速度增强15%，持续1回合
+
+--------------------------------------------------
+
+文档 11:
+--------------------------------------------------
+角色：马良
+攻击力：600
+防御力：80
+体力：100
+耐力：70
+法力：65
+闪避：20
+速度：85
+技能：
+- 神笔天威：攻击力提升50%，持续3回合，必定命中
+  耐力消耗：5，法力消耗：20
+- 墨守成规：防御力提升50%并附加50%概率闪避，持续2回合
+  耐力消耗：10，法力消耗：25
+- 画龙点睛：恢复自身30%体力，并使下一击附带灼烧效果（每回合损失1%体力）
+  耐力消耗：8，法力消耗：15
+
+--------------------------------------------------
+
+文档 12:
+--------------------------------------------------
+角色：费祎
+攻击力：280
+防御力：90
+体力：100
+耐力：75
+法力：85
+闪避：22
+速度：88
+技能：
+- 奇谋妙计：提升自身攻击力30%，持续2回合（必定命中）
+  耐力消耗：7，法力消耗：22
+- 御敌屏障：生成护盾吸收相当于自身防御力150%的伤害，持续3回合（闪避增强20%）
+  耐力消耗：5，法力消耗：18
+- 匡世之才：回复全体队友15%体力，移除所有灼烧/中毒状态，自身速度提升20%持续1回合
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 13:
+--------------------------------------------------
+角色：邓芝
+攻击力：480
+防御力：135
+体力：100
+耐力：75
+法力：65
+闪避：25
+速度：85
+技能：
+- 无双斩：攻击增强30%，必定命中，持续2回合
+  耐力消耗：8，法力消耗：20
+- 铁壁防御：防御增强50%，并恢复10%体力，持续3回合
+  耐力消耗：12，法力消耗：25
+- 毒龙破：攻击附加中毒状态（目标攻击降低3%），暴击率提升20%
+  耐力消耗：6，法力消耗：18
+
+--------------------------------------------------
+
+文档 14:
+--------------------------------------------------
+角色：王平
+攻击力：580
+防御力：95
+体力：100
+耐力：68
+法力：75
+闪避：25
+速度：82
+技能：
+- 破军击：消耗耐力提升50%攻击力，附带30%暴击率，持续1回合
+  耐力消耗：8，法力消耗：25
+- 铁壁术：吸收30%伤害并反弹10%所受伤害，持续2回合
+  耐力消耗：5，法力消耗：18
+- 回春术：立即回复15%体力并清除负面状态，获得1回合伤害减免20%
+  耐力消耗：7，法力消耗：22
+
+--------------------------------------------------
+
+文档 15:
+--------------------------------------------------
+角色：张翼
+攻击力：420
+防御力：160
+体力：100
+耐力：75
+法力：60
+闪避：25
+速度：90
+技能：
+- 破军斩：攻击力提升30%（持续2回合），必定命中，并附加10%概率使目标进入【流血】状态（每回合损失3%体力）
+  耐力消耗：8，法力消耗：25
+- 玄冥护体：防御力提升50%（持续3回合），30%概率闪避物理攻击
+  耐力消耗：6，法力消耗：18
+- 九转回天：恢复自身35%体力，清除所有负面状态，并获得【绝对防御】（下回合免疫所有伤害）
+  耐力消耗：10，法力消耗：32
+
+--------------------------------------------------
+
+文档 16:
+--------------------------------------------------
+角色：马岱
+攻击力：250
+防御力：120
+体力：100
+耐力：100
+法力：65
+闪避：30
+速度：75
+技能：
+- 逆风斩：攻击力提升30%，持续3回合，必定命中
+  耐力消耗：5，法力消耗：15
+- 铁壁守护：防御力提升50%，持续2回合，并回复自身15%体力
+  耐力消耗：8，法力消耗：25
+- 毒龙箭：对单体目标造成120%伤害，附加中毒状态（目标攻击力降低3%，持续3回合）
+  耐力消耗：6，法力消耗：20
+
+--------------------------------------------------
+
+文档 17:
+--------------------------------------------------
+角色：关兴
+攻击力：420
+防御力：120
+体力：100
+耐力：70
+法力：50
+闪避：15
+速度：80
+技能：
+- 青龙斩：攻击力提升30%，持续2回合，必定命中
+  耐力消耗：5，法力消耗：15
+- 铁壁防御：防御力提升50%，并附带30%概率反弹伤害，持续1回合
+  耐力消耗：8，法力消耗：25
+- 战意复苏：恢复30%体力并解除所有异常状态，同时获得1次无视防御的攻击机会
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 18:
+--------------------------------------------------
+角色：张苞
+攻击力：620
+防御力：140
+体力：100
+耐力：70
+法力：60
+闪避：30
+速度：85
+技能：
+- 猛袭冲锋：攻击力提升30%，持续3回合，必定命中
+  耐力消耗：8，法力消耗：20
+- 铁壁防御：防御力提升50%，并附带30%概率反弹伤害，持续2回合
+  耐力消耗：6，法力消耗：25
+- 烈焰裂地：造成150%攻击力的范围伤害，目标附带灼烧状态（每回合损失2%体力）
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 19:
+--------------------------------------------------
+角色：周仓
+攻击力：720
+防御力：160
+体力：100
+耐力：85
+法力：60
+闪避：35
+速度：90
+技能：
+- 猛斧裂地：对单体目标造成150%攻击力的伤害，并有30%概率附加【灼烧】状态（每回合降低1%体力），持续2回合
+  耐力消耗：10，法力消耗：20
+- 铁壁守护：提升30%防御力，持续3回合，且本技能必定命中
+  耐力消耗：5，法力消耗：15
+- 战意复苏：恢复自身20%体力，并提升15%闪避率，持续1回合
+  耐力消耗：8，法力消耗：25
+
+--------------------------------------------------
+
+文档 20:
+--------------------------------------------------
+角色：严颜
+攻击力：450
+防御力：120
+体力：100
+耐力：75
+法力：65
+闪避：15
+速度：85
+技能：
+- 狂战怒吼：攻击力提升40%且必定命中，持续2回合
+  耐力消耗：8，法力消耗：25
+- 荆棘护体：防御力提升30%并反弹30%伤害，持续3回合
+  耐力消耗：7，法力消耗：18
+- 蚀骨毒箭：普通攻击附加中毒状态（目标攻击力每回合降低3%），持续5回合
+  耐力消耗：5，法力消耗：12
+
+--------------------------------------------------
+
+文档 21:
+--------------------------------------------------
+角色：李严
+攻击力：415
+防御力：120
+体力：100
+耐力：70
+法力：60
+闪避：30
+速度：80
+技能：
+- 破军击：攻击力提升30%（持续2回合），必定命中
+  耐力消耗：5，法力消耗：20
+- 铁壁术：防御力提升50%（持续3回合），并附加30%闪避率
+  耐力消耗：8，法力消耗：15
+- 焚天诀：消耗当前30%灵力造成双倍伤害，目标陷入灼烧状态（每回合损失1%体力）
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 22:
+--------------------------------------------------
+角色：曹操
+攻击力：680
+防御力：160
+体力：100
+耐力：75
+法力：55
+闪避：25
+速度：85
+技能：
+- 霸业斩：攻击力提升30%，持续3回合，必定命中
+  耐力消耗：7，法力消耗：20
+- 铁壁阵：防御力提升50%，并附加30%概率闪避普攻，持续2回合
+  耐力消耗：8，法力消耗：25
+- 天命复苏：恢复自身30%体力，并净化负面状态
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 23:
+--------------------------------------------------
+角色：司马懿
+攻击力：240
+防御力：160
+体力：100
+耐力：75
+法力：65
+闪避：25
+速度：60
+技能：
+- 虎豹骑阵：提升自身30%攻击力并附带必定命中，持续2回合
+  耐力消耗：8，法力消耗：20
+- 奇谋妙计：恢复自身15%体力并提升20%闪避，持续3回合
+  耐力消耗：10，法力消耗：25
+- 暗影毒计：普通攻击附加中毒状态（目标每回合降低3%攻击力），命中率+15%
+  耐力消耗：5，法力消耗：18
+
+--------------------------------------------------
+
+文档 24:
+--------------------------------------------------
+角色：夏侯惇
+攻击力：600
+防御力：150
+体力：100
+耐力：80
+法力：60
+闪避：10
+速度：75
+技能：
+- 刚烈：攻击增强30%，持续2回合，且本次攻击必定命中
+  耐力消耗：5，法力消耗：20
+- 铁壁：防御增强50%，持续1回合，并免疫下一次受到的暴击
+  耐力消耗：8，法力消耗：15
+- 火攻之计：对单体目标造成攻击力120%的伤害，并附加灼烧状态（每回合损失1%体力，持续3回合）
+  耐力消耗：7，法力消耗：25
+
+--------------------------------------------------
+
+文档 25:
+--------------------------------------------------
+角色：夏侯渊
+攻击力：720
+防御力：150
+体���：100
+耐力：85
+法力：30
+闪避：15
+速度：90
+技能：
+- 疾风突刺：提升50%攻击力，持续2回合，必定命中
+  耐力消耗：5，法力消耗：15
+- 铁壁防御：防御力提升100%，并恢复10%体力，持续1回合
+  耐力消耗：10，法力消耗：25
+- 烈焰斩：造成150%伤害，附加灼烧状态（每回合损失1%体力），暴击率提升20%
+  耐力消耗：8，法力消耗：20
+
+--------------------------------------------------
+
+文档 26:
+--------------------------------------------------
+角色：张辽
+攻击力：750
+防御力：150
+体力：100
+耐力：80
+法力：60
+闪避：15
+速度：85
+技能：
+- 霸王击：攻击力提升30%，持续2回合，必定命中
+- 突袭：50%概率触发暴击，若暴击则额外附加目标当前体力5%的真实伤害
+- 毒龙戟：普通攻击附加中毒状态，使目标攻击力降低3%（可叠加），持续3回合
+
+--------------------------------------------------
+
+文档 27:
+--------------------------------------------------
+角色：徐晃
+攻击力：180
+防御力：120
+体力：100
+耐力：100
+法力：40
+闪避：30
+速度：60
+技能：
+- 破军之斧：攻击力提升50%，持续2回合，必定命中
+  耐力消耗：5，法力消耗：15
+- 铁壁防守：防御力提升40%，并附加30%闪避增益，持续3回合
+  耐力消耗：5，法力消耗：20
+- 焚天怒火：消耗当前50%耐力发动强力攻击（攻击力×200%），目标陷入灼烧状态（每回合损失1%体力），持续2回合
+  耐力消耗：10，法力消耗：25
+
+--------------------------------------------------
+
+文档 28:
+--------------------------------------------------
+角色：张郃
+攻击力：420
+防御力：160
+体力：100
+耐力：70
+法力：65
+闪避：25
+速度：75
+技能：
+- 磐石守御：防御力提升30%，持续3回合，且必定命中
+  耐力消耗：5，法力消耗：20
+- 毒牙箭雨：对敌方单体造成120%攻击伤害，并附加中毒状态（目标攻击力每回合降低3%，持续5回合）
+  耐力消耗：8，法力消耗：25
+- 固本培元：恢复自身30%体力，并提升20%闪避率，持续2回合
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 29:
+--------------------------------------------------
+角色：许褚
+攻击力：720
+防御力：180
+体力：100
+耐力：80
+法力：30
+闪避：10
+速度：75
+技能：
+- 虎痴怒击：攻击力提升30%，持续3回合，必定命中
+  耐力消耗：5，法力消耗：15
+- 不动如山：防御力提升50%，并附加30%闪避率，持续2回合
+  耐力消耗：8，法力消耗：25
+- 嗜血回复：攻击时30%概率恢复自身5%体力，并附加灼烧效果（每回合损失1%体力）
+  耐力消耗：6，法力消耗：20
+
+--------------------------------------------------
+
+文档 30:
+--------------------------------------------------
+角色：典韦
+攻击力：720
+防御力：180
+体力：100
+耐力：85
+法力：40
+闪避：10
+速度：65
+技能：
+- 无双猛击：攻击力提升30%（持续2回合），必定命中
+  耐力消耗：5，法力消耗：15
+- 铁壁防御：防御力提升50%（持续3回合），并附加30%闪避率
+  耐力消耗：8，法力消耗：25
+- 嗜血狂暴：暴击率提升至100%（1回合），攻击附加灼烧状态（每回合损失1%体力）
+  耐力消耗：3，法力消耗：10
+
+--------------------------------------------------
+
+文档 31:
+--------------------------------------------------
+角色：曹仁
+攻击力：350
+防御力：190
+体力：100
+耐力：90
+法力：65
+闪避：25
+速度：60
+技能：
+- 铁壁防御：防御力提升30%，持续3回合
+  耐力消耗：5，法力消耗：15
+- 反击阵：30%概率对攻击者造成50%攻击力的反击伤害
+  耐力消耗：10，法力消耗：20
+- 火攻之计：普通攻击附加灼烧状态，目标每回合损失1%体力，持续3回合
+  耐力消耗：5，法力消耗：25
+
+--------------------------------------------------
+
+文档 32:
+--------------------------------------------------
+角色：曹洪
+攻击力：420
+防御力：130
+体力：100
+耐力：65
+法力：50
+闪避：25
+速度：75
+技能：
+- 狂战怒吼：攻击力提升30%，持续3回合，且本次攻击必定命中
+  耐力消耗：5，法力消耗：15
+- 铁壁防御：防御力提升50%，持续2回合，并回复10%体力
+  耐力消耗：8，法力消耗：20
+- 毒牙击：造成120%攻击力的伤害，附带目标中毒（攻击降低3%），持续3回合
+  耐力消耗：6，法力消耗：25
+
+--------------------------------------------------
+
+文档 33:
+--------------------------------------------------
+角色：曹真
+攻击力：650
+防御力：150
+体力：100
+耐力：75
+法力：60
+闪避：30
+速度：80
+技能：
+- 雷霆破：攻击力提升30%，持续2回合，必定命中
+  耐力消耗：8，法力消耗：25
+- 铁壁术：防御��提升50%，并恢复自身15%体力
+  耐力消耗：6，法力消耗：20
+- 燎原火：对单体造成1.5倍伤害，50%概率使目标进入灼烧状态（每回合损失2%体力）
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 34:
+--------------------------------------------------
+角色：曹爽
+攻击力：420
+防御力：110
+体力：100
+耐力：65
+法力：75
+闪避：25
+速度：85
+技能：
+- 狂澜斩：攻击力提升30%，持续3回合，必定命中
+- 毒牙箭：普通攻击附加中毒状态（目标攻击力降低3%），暴击率+15%
+- 治愈之光：恢复自身35%体力，并提升20%闪避，持续2回合
+
+--------------------------------------------------
+
+文档 35:
+--------------------------------------------------
+角色：荀彧
+攻击力：150
+防御力：80
+体力：100
+耐力：70
+法力：90
+闪避：25
+速度：60
+技能：
+- 王佐之才：提升自身30%攻击和20%防御，攻击附加中毒状态（降低目标3%攻击）
+  耐力消耗：5，法力消耗：20
+- 谋定天下：自身闪避率提升50%并加速30%，持续2回合（必中）
+  耐力消耗：6，法力消耗：15
+- 天命归心：恢复全体队友15%体力并净化负面状态，自身获得1次无敌效果
+  耐力消耗：8，法力消耗：25
+
+--------------------------------------------------
+
+文档 36:
+--------------------------------------------------
+角色：荀攸
+攻击力：450
+防御力：160
+体力：100
+耐力：75
+法力：80
+闪避：35
+速度：65
+技能：
+- 坚壁：防御力提升30%，持续2回合
+  耐力消耗：5，法力消耗：15
+- 养精蓄锐：恢复自身30%体力，并解除灼烧/中毒状态
+  耐力消耗：8，法力消耗：20
+- 火攻之计：对单体造成150%攻击伤害，附加灼烧状态（每回合损失1%体力，持续3回合），必定命中
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 37:
+--------------------------------------------------
+角色：贾诩
+攻击力：200
+防御力：80
+体力：100
+耐力：75
+法力：90
+闪避：20
+速度：60
+技能：
+- 毒雾术：对敌方全体施加中毒状态，目标攻击力降低3%，持续3回合，必定命中
+  耐力消耗：5，法力消耗：25
+- 火攻之计：对单体造成150%攻击力的伤害，并附加灼烧状态（每回合损失1%体力），暴击率提升20%
+  耐力消耗：8，法力消耗：30
+- 奇谋护盾：为自身施加护盾，防御力提升50%持续2回合，同时恢复10%体力
+  耐力消耗：7，法力消耗：20
+
+--------------------------------------------------
+
+文档 38:
+--------------------------------------------------
+角色：程昱
+攻击力：320
+防御力：160
+体力：100
+耐力：50
+法力：80
+闪避：20
+速度：60
+技能：
+- 谋定乾坤：提升30%攻击力并附加中毒状态（目标攻击力降低3%），持续3回合
+  耐力消耗：7，法力消耗：25
+- 固本培元：防御力提升50%，闪避率增加15%，持续2回合
+  耐力消耗：8，法力消耗：20
+- 韬光养晦：恢复自身30%体力并解除所有负面状态，本回合免疫控制
+  耐力消耗：10，法力消耗：35
+
+--------------------------------------------------
+
+文档 39:
+--------------------------------------------------
+角色：司马师
+攻击力：320
+防御力：110
+体力：100
+耐力：75
+法力：85
+闪避：18
+速度：65
+技能：
+- 谋略之士：提升自身攻击力30%，持续2回合，并有30%概率使目标灼烧（每回合降低1%体力）
+  耐力消耗：8，法力消耗：25
+- 明镜止水：提升防御力50%，持续3回合，并恢复10%体力
+  耐力消耗：5，法力消耗：20
+- 幽冥符咒：攻击附加中毒状态（降低目标3%攻击力），持续3回合，必定命中
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 40:
+--------------------------------------------------
+角色：司马昭
+攻击力：350
+防御力：180
+体力：100
+耐力：80
+法力：75
+闪避：30
+速度：90
+技能：
+- 权谋之刃：攻击力提升30%，持续2回合，并使目标中毒（攻击降低3%）
+  耐力消耗：5，法力消耗：20
+- 铁壁防线：防御力提升50%，持续3回合，并恢复自身5%体力
+  耐力消耗：8，法力消耗：25
+- 先机掌握：速度提升40%，持续1回合，下一次攻击必定暴击
+  耐力消耗：7，法力消耗：15
+
+--------------------------------------------------
+
+文档 41:
+--------------------------------------------------
+角色：乐进
+攻击力：650
+防御力：150
+体力：100
+耐力：70
+法力：60
+闪避：15
+速度：80
+技能：
+- 猛虎击：攻击增强30%，持续3回合，必定命中
+  耐力消耗：5，法力消耗：20
+- 铁壁术：防御力提升50%，持续2回合
+  耐力消耗：8，法力消耗：15
+- 烈焰斩：攻击附加灼烧状态（每回合降低1%体力���持续3回合），暴击率提升20%
+  耐力消耗：7，法力消耗：25
+
+--------------------------------------------------
+
+文档 42:
+--------------------------------------------------
+角色：李典
+攻击力：720
+防御力：160
+体力：100
+耐力：80
+法力：60
+闪避：35
+速度：75
+技能：
+- 崩山裂地：对单体目标造成150%攻击力的伤害，并使自身攻击提升30%（持续2回合），必定命中
+  耐力消耗：10，法力消耗：30
+- 铁壁护体：提升自身防御力50%（持续3回合），并有30%概率反弹受到的物理伤害
+  耐力消耗：8，法力消耗：25
+- 战吼：消耗全部灵力，为周围友军恢复15%体力，并提升全体队友15%攻击和速度（持续2回合）
+  耐力消耗：5，法力消耗：35
+
+--------------------------------------------------
+
+文档 43:
+--------------------------------------------------
+角色：于禁
+攻击力：520
+防御力：160
+体力：100
+耐力：80
+法力：70
+闪避：20
+速度：60
+技能：
+- 坚守防线：防御力提升30%，持续3回合，且必定命中敌人
+  耐力消耗：5，法力消耗：20
+- 毒刃：普通攻击附带20%概率使目标中毒（每回合降低3%攻击力），持续3回合
+  耐力消耗：3，法力消耗：15
+- 固本培元：恢复自身30%体力，并提升20%闪避率，持续2回合
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 44:
+--------------------------------------------------
+角色：文聘
+攻击力：380
+防御力：160
+体力：100
+耐力：75
+法力：40
+闪避：22
+速度：65
+技能：
+- 破军之刺：攻击提升30%，且必定命中，持续1回合
+  耐力消耗：8，法力消耗：15
+- 固垒坚守：防御提升50%，并附带30%闪避率，持续2回合
+  耐力消耗：6，法力消耗：25
+- 毒龙穿刺：普通攻击附加目标中毒状态（每秒减少3%攻击力），命中率+20%
+  耐力消耗：5，法力消耗：18
+
+--------------------------------------------------
+
+文档 45:
+--------------------------------------------------
+角色：郭淮
+攻击力：180
+防御力：160
+体力：100
+耐力：75
+法力：50
+闪避：22
+速度：65
+技能：
+- 壁垒坚守：防御力提升30%，持续2回合，且必定命中攻击者
+  耐力消耗：8，法力消耗：15
+- 缓兵之计：使自身速度提升20%，并有30%概率闪避物理攻击，持续3回合
+  耐力消耗：6，法力消耗：25
+- 枯木逢春：恢复自身15%体力，并附加灼烧状态（每回合损失3%体力）给随机敌方单位，持续2回合
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 46:
+--------------------------------------------------
+角色：孙权
+攻击力：380
+防御力：160
+体力：100
+耐力：85
+法力：75
+闪避：12
+速度：78
+技能：
+- 江东制霸：攻击力提升30%，持续3回合，必定命中
+  耐力消耗：8，法力消耗：25
+- 铁壁长江：防御力提升50%，并附加闪避增强20%，持续2回合
+  耐力消耗：6，法力消耗：20
+- 火攻连环：攻击附加灼烧状态（每回合损失1%体力），若暴击则额外降低目标10%防御，持续3回合
+  耐力消耗：9，法力消耗：30
+
+--------------------------------------------------
+
+文档 47:
+--------------------------------------------------
+角色：周瑜
+攻击力：320
+防御力：95
+体力：100
+耐力：50
+法力：75
+闪避：25
+速度：70
+技能：
+- 烈焰焚天：攻击附加灼烧状态（每回合降低1%体力），暴击率提升20%
+  耐力消耗：8，法力消耗：25
+- 铁壁连营：防御增强50%并提升闪避率15%，持续2回合
+  耐力消耗：6，法力消耗：18
+- 东风复苏：恢复自身30%体力并净化负面状态，下回合速度提升30%
+  耐力消耗：7，法力消耗：22
+
+--------------------------------------------------
+
+文档 48:
+--------------------------------------------------
+角色：鲁肃
+攻击力：320
+防御力：180
+体力：100
+耐力：50
+法力：80
+闪避：20
+速度：60
+技能：
+- 铁壁防御：提升30%防御力，持续3回合
+  耐力消耗：5，法力消耗：20
+- 治愈之光：恢复自身20%体力（仅限濒危时触发）
+  耐力消耗：3，法力消耗：15
+- 毒雾术：攻击附加中毒状态（目标攻击力降低3%，持续3回合）
+  耐力消耗：7，法力消耗：25
+
+--------------------------------------------------
+
+文档 49:
+--------------------------------------------------
+角色：吕蒙
+攻击力：650
+防御力：120
+体力：100
+耐力：75
+法力：50
+闪避：15
+速度：85
+技能：
+- 白衣渡江：攻击增强30%，并附加中毒状态（目标攻击力降低3%），持续3回合
+  耐力消耗：5，法力消耗：20
+- 江陵固守：防御增强40%，并恢复自身15%体力
+  耐力消耗：10，法力消耗：25
+- 烽火连营：速度增强50%，下一击必定暴击
+  耐力��耗：8，法力消耗：30
+
+--------------------------------------------------
+
+文档 50:
+--------------------------------------------------
+角色：陆逊
+攻击力：580
+防御力：120
+体力：100
+耐力：75
+法力：85
+闪避：25
+速度：85
+技能：
+- 火攻之计：造成攻击力120%的伤害，并使目标陷入灼烧状态（每回合降低1%体力，持续3回合）
+  耐力消耗：5，法力消耗：25
+- 锦囊护体：提升自身防御力50%，持续2回合，并有30%概率闪避下一次攻击
+  耐力消耗：3，法力消耗：15
+- 调息养神：恢复自身30%体力，并解除灼烧/中毒状态，本回合速度提升20%
+  耐力消耗：8，法力消耗：20
+
+--------------------------------------------------
+
+文档 51:
+--------------------------------------------------
+角色：太史慈
+攻击力：720
+防御力：140
+体力：100
+耐力：80
+法力：60
+闪避：35
+速度：85
+技能：
+- 箭雨风暴：对单体目标造成200%攻击力的物理伤害，并附加灼烧状态（每回合降低1%体力），持续3回合
+  耐力消耗：8，法力消耗：25
+- 铁壁之御：提升自身30%防御力，持续2回合，且必定命中
+  耐力消耗：5，法力消耗：15
+- 野性复苏：恢复自身30%体力，并提升20%闪避率，持续1回合
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 52:
+--------------------------------------------------
+角色：甘宁
+攻击力：620
+防御力：140
+体力：100
+耐力：80
+法力：60
+闪避：35
+速度：75
+技能：
+- 锦帆突袭：提升30%攻击力并附带暴击效果，持续2回合
+  耐力消耗：7，法力消耗：20
+- 毒龙破：造成150%伤害并使目标中毒（每回合降低3%攻击力，持续3回合）
+  耐力消耗：8，法力消耗：25
+- 激浪回旋：恢复自身20%体力并提升50%闪避率，持续1回合
+  耐力消耗：7，法力消耗：30
+
+--------------------------------------------------
+
+文档 53:
+--------------------------------------------------
+角色：韩当
+攻击力：350
+防御力：150
+体力：100
+耐力：75
+法力：50
+闪避：15
+速度：60
+技能：
+- 猛击：攻击力提升30%，持续3回合，必定命中
+  耐力消耗：5，法力消耗：15
+- 铁壁防御：防御力提升50%，并附加50%概率反弹伤害，持续2回合
+  耐力消耗：10，法力消耗：25
+- 战吼：全队攻击附带灼烧效果（每回合损失1%体力），自身速度提升20%，持续3回合
+  耐力消耗：8，法力消耗：20
+
+--------------------------------------------------
+
+文档 54:
+--------------------------------------------------
+角色：周泰
+攻击力：680
+防御力：170
+体力：100
+耐力：75
+法力：55
+闪避：35
+速度：85
+技能：
+- 不屈战意：攻击力提升30%，持续2回合，并附带20%暴击率加成
+  耐力消耗：8，法力消耗：20
+- 铁壁守护：防御力提升50%，同时闪避率增加15%，持续3回合
+  耐力消耗：5，法力消耗：15
+- 浴血重生：消耗当前30%体力值，瞬间恢复等量体力并清除所有负面状态
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 55:
+--------------------------------------------------
+角色：潘璋
+攻击力：320
+防御力：160
+体力：100
+耐力：85
+法力：70
+闪避：35
+速度：65
+技能：
+- 钢骨：防御力提升30%，持续3回合
+  耐力消耗：5，法力消耗：15
+- 毒影箭：射程攻击造成120%伤害，附带目标中毒（攻击降低3%），持续2回合
+  耐力消耗：3，法力消耗：20
+- 铁壁守护：防御力提升50%且闪避率+20%，持续2回合，但期间无法主动攻击
+  耐力消耗：10，法力消耗：25
+
+--------------------------------------------------
+
+文档 56:
+--------------------------------------------------
+角色：朱然
+攻击力：415
+防御力：150
+体力：100
+耐力：75
+法力：60
+闪避：25.0
+速度：85
+技能：
+- 火龙怒击：攻击力提升50%，暴击率+20%，持续2回合；攻击附带灼烧状态（每回合造成目标当前体力1%的伤害）
+  耐力消耗：8，法力消耗：25
+- 玄甲护体：防御力提升100%，并恢复自身10%体力；若受到攻击，有30%概率反射50%伤害给攻击者
+  耐力消耗：6，法力消耗：30
+- 疾风步：速度提升100%，闪避率+50%，持续1回合；本回合结束时清除所有负面状态
+  耐力消耗：3，法力消耗：15
+
+--------------------------------------------------
+
+文档 57:
+--------------------------------------------------
+角色：张昭
+攻击力：520
+防御力：140
+体力：100
+耐力：75
+法力：60
+闪避：25
+速度：85
+技能：
+- 破军击：攻击力提升30%并附带暴击（2回合）
+  耐力消耗：5，法力消耗：20
+- 铁壁术：防御力提升50%并附带30%概率闪避（3回合）
+  耐力消耗：8，法力消耗：25
+- 涅槃之火：恢复自身20%���力，并使下次攻击附加灼烧状态（每回合降低1%体力）
+  耐力消耗：7，法力消耗：30
+
+--------------------------------------------------
+
+文档 58:
+--------------------------------------------------
+角色：步骘
+攻击力：450
+防御力：120
+体力：100
+耐力：75
+法力：85
+闪避：30
+速度：80
+技能：
+- 火攻计：对单体目标造成120%攻击力的伤害，并附加灼烧状态（每回合降低1%体力），持续3回合
+  耐力消耗：5，法力消耗：25
+- 镇静仙术：提升自身30%防御力，并增加20%闪避率，持续2回合
+  耐力消耗：7，法力消耗：20
+- 安魂咒：恢复自身25%体力，并解除灼烧/中毒状态
+  耐力消耗：6，法力消耗：30
+
+--------------------------------------------------
+
+文档 59:
+--------------------------------------------------
+角色：陆抗
+攻击力：750
+防御力：150
+体力：100
+耐力：80
+法力：65
+闪避：30
+速度：85
+技能：
+- 破军斩：攻击力提升30%，持续3回合，必定命中
+  耐力消耗：5，法力消耗：20
+- 铁壁术：防御力提升50%，并附带30%概率反弹伤害，持续2回合
+  耐力消耗：8，法力消耗：25
+- 毒龙箭：发射毒箭造成120%伤害，目标中毒（每回合降低3%攻击力）持续3回合
+  耐力消耗：6，法力消耗：15
+
+--------------------------------------------------
+
+文档 60:
+--------------------------------------------------
+角色：孙策
+攻击力：600
+防御力：150
+体力：100
+耐力：80
+法力：60
+闪避：15
+速度：75
+技能：
+- 霸王咆哮：攻击力提升30%，持续3回合，且必定命中
+  耐力消耗：5，法力消耗：20
+- 铁壁守护：防御力提升50%，持续2回合，并附带30%闪避增强
+  耐力消耗：8，法力消耗：25
+- 烈焰斩：造成150%攻击力的单体伤害，附加灼烧状态（每回合损失1%体力，持续3回合），30%概率触发暴击
+  耐力消耗：7，法力消耗：15
+
+--------------------------------------------------
+
+文档 61:
+--------------------------------------------------
+角色：孙尚香
+攻击力：350
+防御力：80
+体力：100
+耐力：70
+法力：30
+闪避：30
+速度：90
+技能：
+- 烈焰箭：攻击增强30%并附加灼烧状态（每回合降低1%体力）
+- 凤舞九天：提升自身闪避率20%且速度增加20%，持续2回合
+- 治愈之光：恢复自身30%体力并解除灼烧状态
+
+--------------------------------------------------
+
+文档 62:
+--------------------------------------------------
+角色：大乔
+攻击力：320
+防御力：90
+体力：100
+耐力：50
+法力：65
+闪避：0.15
+速度：75
+技能：
+- 守护之盾：提升30%防御力，持续2回合，必定命中
+- 治愈之风：恢复自身25%体力，并附加闪避增强15%持续1回合
+- 烈焰之触：攻击附加灼烧状态（每回合损失1%体力），暴击率提升20%持续3回合
+
+--------------------------------------------------
+
+文档 63:
+--------------------------------------------------
+角色：小乔
+攻击力：350
+防御力：80
+体力：100
+耐力：65
+法力：90
+闪避：35
+速度：75
+技能：
+- 凤求凰：单体攻击附加中毒状态（降低3%攻击），暴击率提升20%
+  耐力消耗：8，法力消耗：25
+- 灵雀屏障：防御力提升30%，闪避率额外增加15%，持续2回合
+  耐力消耗：5，法力消耗：15
+- 治愈之风：恢复自身15%体力并清除负面状态，速度提升20%持续1回合
+  耐力消耗：10，法力消耗：20
+
+--------------------------------------------------
+
+文档 64:
+--------------------------------------------------
+角色：诸葛恪
+攻击力：320
+防御力：160
+体力：100
+耐力：65
+法力：75
+闪避：25
+速度：85
+技能：
+- 石兵八阵：召唤石阵提升自身防御50%，持续2回合（必定命中）
+  耐力消耗：8，法力消耗：25
+- 空城抚琴：回复自身15%体力并提升闪避率30%，持续1回合（暴击抗性+30%）
+  耐力消耗：6，法力消耗：30
+- 东风劫火：消耗自身20%当前体力，对单体目标造成1.5倍攻击伤害并附加灼烧状态（每回合损失1.2%体力）
+  耐力消耗：10，法力消耗：35
+
+--------------------------------------------------
+
+文档 65:
+--------------------------------------------------
+角色：董卓
+攻击力：650
+防御力：180
+体力：100
+耐力：75
+法力：50
+闪避：20
+速度：60
+技能：
+- 霸者重击：攻击力提升30%，持续3回合（必定命中）
+  耐力消耗：5，法力消耗：15
+- 修罗护体：防御力提升50%，并附加50%概率反弹伤害，持续2回合
+  耐力消耗：8，法力消耗：25
+- 魔血复苏：消耗当前30%体力值，瞬间恢复等量体力（最低保留10%体力）
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 66:
+--------------------------------------------------
+角色：吕布
+攻击力：780
+防御力：160
+体力：100
+耐力：85
+法力：30
+闪避：15
+速度：90
+技能：
+- 无双乱舞：对单体目标造成300%攻击的物理伤害，附加灼烧状态（每回合降低1%体力），必定命中
+  耐力消耗：8，法力消耗：25
+- 魔神降世：防御力提升50%，持续3回合，并反击所有攻击者（100%触发）
+  耐力消耗：6，法力消耗：18
+- 赤兔冲锋：速度提升100%持续1回合，本回合攻击附带中毒状态（目标攻击力降低3%）
+  耐力消耗：10，法力消耗：12
+
+--------------------------------------------------
+
+文档 67:
+--------------------------------------------------
+角色：貂蝉
+攻击力：600
+防御力：120
+体力：100
+耐力：100
+法力：80
+闪避：35
+速度：85
+技能：
+- 闭月之舞：提升30%闪避率，持续3回合（每回合衰减10%）
+  耐力消耗：5，法力消耗：20
+- 倾城之魅：对单体造成250%攻击力的伤害，并附加【中毒】状态（目标攻击降低3%）持续5回合
+  耐力消耗：8，法力消耗：25
+- 疗伤抚心：恢复自身30%体力，并解除所有负面状态
+  耐力消耗：6，法力消耗：30
+
+--------------------------------------------------
+
+文档 68:
+--------------------------------------------------
+角色：袁绍
+攻击力：215
+防御力：120
+体力：100
+耐力：70
+法力：50
+闪避：15
+速度：65
+技能：
+- 霸业雄心：消耗灵力释放王霸之气，2回合内攻击力提升50%且必定命中，自身速度临时+20%
+  耐力消耗：7，法力消耗：25
+- 坚壁清野：凝聚防线形成护盾，3回合内防御力提升80%，并将所受30%伤害转化为耐力消耗
+  耐力消耗：10，法力消耗：30
+- 河北复兴：召唤河北精锐加入战场，全体友军恢复15%体力，自身获得『每回合自动恢复5%耐力』状态持续3回合
+  耐力消耗：5，法力消耗：20
+
+--------------------------------------------------
+
+文档 69:
+--------------------------------------------------
+角色：公孙瓒
+攻击力：620
+防御力：120
+体力：100
+耐力：80
+法力：70
+闪避：35
+速度：90
+技能：
+- 白马突袭：攻击增强50%，必定命中，并附加中毒状态（降低目标3%攻击）
+  耐力消耗：5，法力消耗：20
+- 坚壁清野：防御增强50%，持续2回合，并恢复自身10%体力
+  耐力消耗：8，法力消耗：25
+- 烈焰焚营：对前方扇形区域造成120%伤害，附加灼烧状态（每回合降低1%体力）
+  耐力消耗：7，法力消耗：15
+
+--------------------------------------------------
+
+文档 70:
+--------------------------------------------------
+角色：刘表
+攻击力：550
+防御力：160
+体力：100
+耐力：70
+法力：80
+闪避：10
+速度：65
+技能：
+- 荆襄固守：防御力提升30%，持续2回合（可叠加）
+- 仁政疗伤：恢复自身15%体力并附加【每回合回复5%体力】，持续3回合
+- 火攻计略：消耗30%灵力释放火焰箭雨，对敌方全体造成攻击力80%的伤害，并附加【灼烧】状态（每回合损失1%体力）
+
+--------------------------------------------------
+
+文档 71:
+--------------------------------------------------
+角色：华雄
+攻击力：620
+防御力：150
+体力：100
+耐力：70
+法力：60
+闪避：20
+速度：85
+技能：
+- 狂斧裂地：攻击力提升30%（持续2回合），必定命中
+  耐力消耗：8，法力消耗：25
+- 血怒狂暴：防御力降低40%换取攻击力翻倍（持续3回合），每回合结束时损失当前体力5%
+  耐力消耗：10，法力消耗：30
+- 震雷斩：消耗自身当前30%体力发动强力单体攻击，附带30%概率触发灼烧状态（每回合损失1%体力）
+  耐力消耗：5，法力消耗：18
+
+--------------------------------------------------
+
+文档 72:
+--------------------------------------------------
+角色：颜良
+攻击力：620
+防御力：150
+体力：100
+耐力：80
+法力：30
+闪避：10
+速度：60
+技能：
+- 狂暴突袭：攻击力提升50%，持续3回合（必定命中）
+- 铁壁防御：防御力提升30%，持续2回合并附带30%概率反弹伤害
+- 毒牙裂斩：造成150%攻击力的物理伤害，并使目标中毒（每回合降低3%攻击力，持续3回合）
+
+--------------------------------------------------
+
+文档 73:
+--------------------------------------------------
+角色：文丑
+攻击力：620
+防御力：150
+体力：100
+耐力：70
+法力：40
+闪避：30
+速度：85
+技能：
+- 霸烈斩：攻击强度提升50%，持续3回合，必定命中
+  耐力消耗：8，法力消耗：25
+- 固守：防御力提升100%，并恢复10%体力，持续2回合
+  耐力消耗：5，法力消耗：15
+- 毒刃：普通攻击附加中毒状态，目标每回合攻击降低3%，持续5回合
+  耐力消耗：3，法力消耗：10
+
+--------------------------------------------------
+
+文档 74:
+--------------------------------------------------
+角色：高顺
+攻击力：520
+防御力：180
+体力：100
+耐力：80
+法力：30
+闪避：10
+速度：60
+技能：
+- 坚壁清野：提升30%防御力，持续3回合
+  耐力消耗：5，法力消耗：20
+- 陷阵之志：普通攻击附加中毒状态（目标攻击力降低3%，每回合叠加）
+  耐力消耗：7，法力消耗：25
+- 重整旗鼓：消耗自身30%当前体力，为全队恢复等同数值的体力
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 75:
+--------------------------------------------------
+角色：审配
+攻击力：200
+防御力：150
+体力：100
+耐力：80
+法力：75
+闪避：20
+速度：60
+技能：
+- 坚壁清野：防御增强30%，持续2回合
+  耐力消耗：5，法力消耗：15
+- 粮草调度：恢复自身15%体力，并提升闪避10%
+  耐力消耗：3，法力消耗：20
+- 毒计攻心：攻击附加中毒状态（目标攻击降低3%，持续3回合）
+  耐力消耗：7，法力消耗：25
+
+--------------------------------------------------
+
+文档 76:
+--------------------------------------------------
+角色：逢纪
+攻击力：320
+防御力：90
+体力：100
+耐力：75
+法力：85
+闪避：25
+速度：55
+技能：
+- 毒雾术：释放毒雾攻击目标，造成110%攻击力的伤害，并使目标中毒（降低3%攻击力，持续3回合）
+  耐力消耗：7，法力消耗：25
+- 天机策：短暂预判战场局势，提升自身30%闪避率和20%速度，持续2回合
+  耐力消耗：5，法力消耗：20
+- 缚魂咒：锁定目标灵魂，接下来3次攻击必定命中且附带灼烧效果（每回合损失2%体力），技能结束后目标陷入眩晕1回合
+  耐力消耗：10，法力消耗：35
+
+--------------------------------------------------
+
+文档 77:
+--------------------------------------------------
+角色：郭图
+攻击力：480
+防御力：120
+体力：100
+耐力：65
+法力：75
+闪避：25
+速度：85
+技能：
+- 烈焰击：攻击附加灼烧状态（每回合降低1%体力），必定命中，持续3回合
+  耐力消耗：7，法力消耗：25
+- 八卦阵：防御增强50%，闪避提升20%，持续2回合
+- 天机策：速度增强30%，暴击率提升20%，持续5回合
+  耐力消耗：5，法力消耗：35
+
+--------------------------------------------------
+
+文档 78:
+--------------------------------------------------
+角色：许攸
+攻击力：150
+防御力：50
+体力：100
+耐力：70
+法力：85
+闪避：20
+速度：60
+技能：
+- 策谋攻势：提升30%攻击力，持续2回合，必定命中
+  耐力消耗：5，法力消耗：20
+- 固守之策：防御力提升50%，并附带30%闪避增强，持续3回合
+  耐力消耗：10，法力消耗：25
+- 火攻之计：造成120%攻击力的伤害，并附加灼烧状态（每回合损失1%体力，持续3回合）
+  耐力消耗：8，法力消耗：30
+
+--------------------------------------------------
+
+文档 79:
+--------------------------------------------------
+角色：纪灵
+攻击力：600
+防御力：120
+体力：100
+耐力：70
+法力：65
+闪避：25
+速度：80
+技能：
+- 破军斩：单体攻击造成250%武器伤害，暴击率提升50%
+  耐力消耗：5，法力消耗：20
+- 灵甲护体：防御力提升30%，持续2回合
+  耐力消耗：8，法力消耗：15
+- 焚天怒：对前方扇形区域造成180%武器伤害，并附加灼烧状态（每回合损失1%体力）
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 80:
+--------------------------------------------------
+角色：蔡瑁
+攻击力：425
+防御力：155
+体力：100
+耐力：80
+法力：30
+闪避：20
+速度：60
+技能：
+- 铁壁防御：防御力提升30%，持续2回合
+  耐力消耗：5，法力消耗：15
+- 水军整备：恢复自身10%体力，并提升闪避率15%
+  耐力消耗：10，法力消耗：20
+- 毒箭齐射：发射毒箭攻击敌方单体，造成1.2倍伤害并附加中毒状态（目标攻击力每回合降低3%）
+  耐力消耗：8，法力消耗：25
+
+--------------------------------------------------
+
+文档 81:
+--------------------------------------------------
+角色：张允
+攻击力：542
+防御力：115
+体力：100
+耐力：65
+法力：83
+闪避：18.5
+速度：89
+技能：
+- 破军斩：攻击力提升50%，持续3回合（必定命中）
+  耐力消耗：8，法力消耗：25
+- 玄冥护体：防御力提升100%，并附加30%闪避率，持续2回合
+  耐力消耗：6，法力消耗：18
+- 燎原火：攻击附带灼烧状态（每回合损失5%体力），自身速度提升20%
+  耐力消耗：4，法力消耗：30
+
+--------------------------------------------------
+
+文档 82:
+--------------------------------------------------
+角色：陶谦
+攻击力：320
+防御力：150
+体力：100
+耐力：70
+法力：60
+闪避：30
+速度：60
+技能：
+- 坚守防线：提升30%防御力，持续3回合
+  耐力消耗：5，法力消耗：20
+- 疗伤术：恢复自身20%体力，并解除负面状态
+  耐力消耗：3，法力消耗：15
+- 毒雾侵袭：普通攻击附加中毒状态，目标攻击力每回合降低3%
+  耐力消耗：8，法力消耗：25
+
+--------------------------------------------------
+
+文档 83:
+--------------------------------------------------
+角色：刘繇
+攻击力：350
+防御力：120
+体力：100
+耐力：60
+法力：80
+闪避：20
+速度：70
+技能：
+- 破军之击：攻击力提升30%，持续3回合，必中
+  耐力消耗：5，法力消耗：20
+- 固守之阵：防御力提升50%并恢复10%体力，持续2回合
+  耐力消耗：8，法力消耗：25
+- 毒雾侵袭：攻击附加中毒状态（目标攻击力降低3%），持续5回合，命中率+20%
+  耐力消耗：3，法力消耗：15
+
+--------------------------------------------------
+
+文档 84:
+--------------------------------------------------
+角色：祝融夫人
+攻击力：680
+防御力：140
+体力：100
+耐力：70
+法力：60
+闪避：25
+速度：85
+技能：
+- 炎龙怒击：对单体目标造成150%攻击力的火焰伤害，并附加灼烧状态（每回合降低1%体力，持续3回合），必定命中
+  耐力消耗：8，法力消耗：25
+- 火神庇护：提升自身30%防御力，持续2回合，并解除负面状态
+  耐力消耗：5，法力消耗：15
+- 凤凰涅槃：恢复自身30%体力，获得闪避增强效果（提升20%闪避率）持续2回合，速度提升20%
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 85:
+--------------------------------------------------
+角色：兀突骨
+攻击力：200
+防御力：190
+体力：100
+耐力：60
+法力：70
+闪避：10
+速度：40
+技能：
+- 藤甲防御：防御力提升30%，持续3回合，且受到攻击时30%概率反弹10%伤害
+  耐力消耗：5，法力消耗：20
+- 毒矛反噬：攻击附加中毒状态（目标攻击力降低3%），并使自身闪避率提升20%持续2回合
+  耐力消耗：8，法力消耗：15
+- 血藤恢复：消耗当前30%耐力值转换为体力，并清除负面状态
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 86:
+--------------------------------------------------
+角色：木鹿大王
+攻击力：520
+防御力：160
+体力：100
+耐力：80
+法力：70
+闪避：35
+速度：65
+技能：
+- 藤鞭狂舞：攻击力提升30%，持续3回合，必定命中
+- 木甲护体：防御力提升50%，并附加30%反弹伤害，持续2回合
+- 自然复苏：回复自身20%体力，并清除所有负面状态
+
+--------------------------------------------------
+
+文档 87:
+--------------------------------------------------
+角色：沙摩柯
+攻击力：620
+防御力：140
+体力：100
+耐力：75
+法力：55
+闪避：35
+速度：65
+技能：
+- 狂斧裂地：攻击力提升30%，持续2回合，且必定命中
+  耐力消耗：8，法力消耗：20
+- 荆棘护体：防御力提升40%并反弹30%所受伤害，持续3回合
+  耐力消耗：10，法力消耗：25
+- 血怒狂暴：消耗当前50%体力值，获得『暴击率+25%』且『攻击附加灼烧状态』，持续到战斗结束
+  耐力消耗：7，法力消耗：30
+
+--------------------------------------------------
+
+文档 88:
+--------------------------------------------------
+角色：轲比能
+攻击力：680
+防御力：140
+体力：100
+耐力：75
+法力：40
+闪避：15
+速度：85
+技能：
+- 狼袭猛击：攻击力提升30%，持续3回合，且必定命中
+  耐力消耗：5，法力消耗：20
+- 铁骑防御：防御力提升50%，并附加30%闪避率，持续2回合
+  耐力消耗：8，法力消耗：25
+- 草原之怒：攻击附加灼烧状态（每回合损失1%体力），自身暴击率提升20%，持续3回合
+  耐力消耗：7，法力消耗：15
+
+--------------------------------------------------
+
+文档 89:
+--------------------------------------------------
+角色：左慈
+攻击力：580
+防御力：120
+体力：100
+耐力：75
+法力：85
+闪避：25
+速度：90
+技能：
+- 幻光毒雾：对单体目标造成120%攻击力的伤害，并附加中毒状态（每回合降低目标3%攻击力，持续3回合）
+  耐力消耗：8，法力消耗：25
+- 八卦仙衣：提升自身30%防御力，并有50%概率闪避物理攻击，持续2回合
+  耐力消耗：5，法力消耗：15
+- 天地回元：恢复自身30%体力，同时清除所有负面状态，并提升20%灵力伤害，持续1回合
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 90:
+--------------------------------------------------
+角色：华佗
+攻击力：100
+防御力：80
+体力：100
+耐力：70
+法力：90
+闪避：40
+速度：60
+技能：
+- 青囊书：恢复自身30%体力，并附带持续2回合的『必定命中』效果
+  耐力消耗：5，法力消耗：20
+- 金针护体：��升己方全体20%防御力，持续3回合，并附加『闪避增强』10%
+  耐力消耗：5，法力消耗：15
+- 麻沸散：驱散自身所有负面状态，并使下次攻击必定触发『暴击』，消耗自身15%体力
+  耐力消耗：8，法力消耗：25
+
+--------------------------------------------------
+
+文档 91:
+--------------------------------------------------
+角色：司马徽
+攻击力：200
+防御力：120
+体力：100
+耐力：80
+法力：90
+闪避：35
+速度：75
+技能：
+- 水镜术：提升自身30%攻击力并附加中毒状态（降低目标3%攻击），持续2回合
+- 观星诀：防御提升50%，闪避率增加20%，持续3回合
+- 天命归元：恢复自身30%体力并净化负面状态，必定命中
+
+--------------------------------------------------
+
+文档 92:
+--------------------------------------------------
+角色：蔡邕
+攻击力：300
+防御力：80
+体力：100
+耐力：75
+法力：60
+闪避：20
+速度：60
+技能：
+- 文气贯虹：攻击力提升30%，持续3回合，并附带必定命中效果
+  耐力消耗：8，法力消耗：15
+- 护心鉴：防御力提升50%，持续2回合，并附加闪避增强10%
+  耐力消耗：5，法力消耗：25
+- 清音疗愈：恢复自身25%体力，并解除负面状态
+  耐力消耗：7，法力消耗：20
+
+--------------------------------------------------
+
+文档 93:
+--------------------------------------------------
+角色：蔡文姬
+攻击力：320
+防御力：150
+体力：100
+耐力：75
+法力：90
+闪避：25
+速度：85
+技能：
+- 胡笳安魂曲：恢复全体队友15%体力，并附加持续2回合的【护盾】（吸收15%伤害）
+  耐力消耗：8，法力消耗：25
+- 悲歌护体：提升自身30%防御力，并使下一次受到的攻击必定触发【闪避】
+  耐力消耗：5，法力消耗：18
+- 断肠焚心：对单体造成180%攻击力的伤害，并附加【灼烧】状态（每回合损失2%体力，持续3回合）
+  耐力消耗：10，法力消耗：32
+
+--------------------------------------------------
+
+文档 94:
+--------------------------------------------------
+角色：甄宓
+攻击力：320
+防御力：80
+体力：100
+耐力：40
+法力：80
+闪避：20
+速度：60
+技能：
+- 洛水仙咒：攻击附加中毒状态，目标攻击力降低3%（每回合叠加）
+  耐力消耗：5，法力消耗：20
+- 惊鸿之舞：恢复自身20%体力，并提升30%闪避率，持续2回合
+  耐力消耗：8，法力消耗：25
+- 凌波剑诀：必定命中，造成1.5倍攻击伤害，并使自身防御提升20%，持续1回合
+  耐力消耗：7，法力消耗：30
+
+--------------------------------------------------
+
+文档 95:
+--------------------------------------------------
+角色：邹氏
+攻击力：450
+防御力：90
+体力：100
+耐力：65
+法力：75
+闪避：25
+速度：70
+技能：
+- 玄冥冰魄：攻击附加冻结状态（目标速度降低50%，持续2回合），并提升自身暴击率20%
+  耐力消耗：7，法力消耗：28
+- 九转回春术：消耗灵力恢复自身35%体力，并附加持续3回合的毒伤（每回合造成目标最大体力5%的伤害）
+  耐力消耗：4，法力消耗：32
+- 天罡战意：消耗耐力清除自身所有负面状态，提升防御力150%并免疫控制效果，持续3回合
+  耐力消耗：10，法力消耗：15
+
+--------------------------------------------------
+
+文档 96:
+--------------------------------------------------
+角色：杜氏
+攻击力：450
+防御力：120
+体力：100
+耐力：75
+法力：60
+闪避：25
+速度：85
+技能：
+- 狂澜斩：攻击力提升30%，持续2回合，必定命中
+  耐力消耗：5，法力消耗：15
+- 铁壁术：防御力提升50%，并附加30%概率闪避普攻，持续3回合
+  耐力消耗：8，法力消耗：25
+- 蚀骨毒：攻击附加中毒状态（目标攻击力每回合降低3%），持续3回合，必中且无视闪避
+  耐力消耗：3，法力消耗：20
+
+--------------------------------------------------
+
+文档 97:
+--------------------------------------------------
+角色：王允
+攻击力：285
+防御力：110
+体力：100
+耐力：75
+法力：68
+闪避：25
+速度：55
+技能：
+- 毒计连环：攻击附加中毒状态（目标攻击降低3%，持续3回合）
+  耐力消耗：8，法力消耗：22
+- 智障护体：提升30%防御并强制闪避下一次物理攻击
+  耐力消耗：6，法力消耗：18
+- 连环策攻：必定命中的三段连击（每段伤害为攻击力60%），暴击率提升20%
+  耐力消耗：10，法力消耗：35
+
+--------------------------------------------------
+
+文档 98:
+--------------------------------------------------
+角色：李儒
+攻击力：580
+防御力：140
+体力：100
+耐力：75
+法力：85
+闪避：25
+速度：65
+技能：
+- 毒计蚀骨：攻击附加中毒状态，目标每回合降低3%攻击力，持续3回合，必定命中
+  耐力消耗：7，法力消耗：22
+- 固防之策：提升自身30%防御力，持续2回合，并有50%概率闪避下次攻击
+  耐力消耗：5，法力消耗：18
+- 燃血焚心：消耗自身10%体力，对目标造成1.5倍伤害并附加灼烧（每回合损失2%体力），暴击率提升20%
+  耐力消耗：10，法力消耗：30
+
+--------------------------------------------------
+
+文档 99:
+--------------------------------------------------
+角色：王朗
+攻击力：500
+防御力：120
+体力：100
+耐力：80
+法力：60
+闪避：25
+速度：70
+技能：
+- 雷霆一击：攻击增强50%，持续3回合，必定命中
+  耐力消耗：5，法力消耗：20
+- 铁壁防御：防御增强80%，持续2回合，并提升30%闪避
+  耐力消耗：8，法力消耗：15
+- 毒雾术：攻击附加中毒状态（目标攻击降低3%），持续5回合，50%概率触发暴击
+  耐力消耗：3，法力消耗：25
+
+--------------------------------------------------
+
+文档 100:
+--------------------------------------------------
+角色：钟繇
+攻击力：320
+防御力：120
+体力：100
+耐力：75
+法力：65
+闪避：25
+速度：70
+技能：
+- 墨守千钧：提升自身防御力50%，持续2回合，且有30%概率反弹受到的物理攻击
+  耐力消耗：8，法力消耗：20
+- 浩然笔意：消耗自身30%当前体力值，对单体目标造成1.5倍攻击力的斩杀伤害（若目标体力低于50%则必中）
+  耐力消耗：5，法力消耗：25
+- 文魂护体：回复自身20%体力并清除负面状态，同时获得等同于已损失体力值50%的临时护盾（持续1回合）
+  耐力消耗：7，法力消耗：18
+
+--------------------------------------------------
+
+文档 101:
+--------------------------------------------------
+角色：陈群
+攻击力：420
+防御力：150
+体力：100
+耐力：75
+法力：60
+闪避：25
+速度：85
+技能：
+- 烈焰斩：攻击附带灼烧状态（每回合降低目标1%体力），自身暴击率提升20%（持续2回合）
+  耐力消耗：7，法力消耗：20
+- 玄龟护体：防御力提升30%（持续3回合），并必定闪避下一次攻击
+  耐力消耗：9，法力消耗：25
+- 回春术：恢复自身20%体力，并清除所有负面状态
+  耐力消耗：5，法力消耗：30
+
+--------------------------------------------------
+
+文档 102:
+--------------------------------------------------
+角色：司马炎
+攻击力：320
+防御力：160
+体力：100
+耐力：80
+法力：65
+闪避：35
+速度：75
+技能：
+- 帝王威仪：提升30%防御力，持续3回合，并强制敌方目标攻击自己（必定命中）
+- 晋朝余荫：恢复自身30%最大体力，同时提升20%闪避率，持续2回合
+- 山河烬燃：消耗灵力释放范围攻击，对前方敌人造成150%攻击力的灼烧伤害，并附加每回合1%体力流失的灼烧状态，持续3回合
+
+--------------------------------------------------

vector_db/chroma/chroma-collections.parquet

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:eb061c8370cbf94fce6e906cab847da748b357c97be495237a5adff38857d12d
+size 559

vector_db/chroma/chroma-embeddings.parquet

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9730b9b9ef2ed6b2b69654c18420e06152c46c63e8139f6c0448965dd4b5b96f
+size 6635173

vector_db/chroma/index/id_to_uuid_cdd98bbd-b458-4fcc-b571-cbc2f817d69f.pkl

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:93745a94adcf6879d92888621614565c51abb10dc5871744f92d1aadcb5e0dac
+size 42548

vector_db/chroma/index/index_cdd98bbd-b458-4fcc-b571-cbc2f817d69f.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b80cccbe66c34e63d56482f1fb2aa1129b642f1f1edca0ad76ae3574b782053f
+size 4238200

vector_db/chroma/index/index_metadata_cdd98bbd-b458-4fcc-b571-cbc2f817d69f.pkl

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5807817e6627647688439e8f39426c0c1d48c4d4c8597c2a2e8bd023de118d93
+size 105

vector_db/chroma/index/uuid_to_id_cdd98bbd-b458-4fcc-b571-cbc2f817d69f.pkl

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d93af44169ded96268b33b62133634091fa183ca7a46264f60f3fefe1c90a7aa
+size 49771

vector_db/chroma_sanguo/chroma-collections.parquet

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0ebb1f3c65a22a3b5dd6b2b198e0cd16fbd7f241b28006c2d865327508aeac73
+size 559

vector_db/chroma_sanguo/chroma-embeddings.parquet

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4f3e90f94d52bf024fc936115261be9ff076dc11b298108895f1d293bc57d1f2
+size 1948642

vector_db/chroma_sanguo/index/id_to_uuid_ad3fef11-d2a5-4d10-bf66-f3c882511c7d.pkl

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6523fb2bcfe57f3eaa95036ffc65260a4d2266269747254dad646c8c582d51b7
+size 12941

vector_db/chroma_sanguo/index/index_ad3fef11-d2a5-4d10-bf66-f3c882511c7d.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e132b028da03e62e2fe138e78ed0543ac1c8fc54e38343cea387a391fe0e5570
+size 1304548

vector_db/chroma_sanguo/index/index_metadata_ad3fef11-d2a5-4d10-bf66-f3c882511c7d.pkl

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:641110764d8a60702cbc4b82af63410f5df6e51ea721153d1b70c8188e4a25d9
+size 105

vector_db/chroma_sanguo/index/uuid_to_id_ad3fef11-d2a5-4d10-bf66-f3c882511c7d.pkl

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c3382491670eb3ea6742a578dfddc1247678337f2d0b3e71655c550f45096c33
+size 15151