Update app.py

app.py

@@ -2,9 +2,9 @@ import gradio as gr
 from openai import OpenAI
 import os
 
-# ============================ 用户信息结构 ============================
+# ============================ User Information Structure ============================
 user_profile = {
-    "mode": None,  # 只在回答第一个问题时设置（是/否）
+    "mode": None,  # Only set when answering the first question (yes/no)
     "specific_career": None,
     "bg_info": None,
     "work_value": None,
@@ -12,33 +12,33 @@ user_profile = {
     "dream_day": None,
     "forward_direction_choice": None,
 
-    # Forward模式下更多状态
-    "recommended_directions": [],  # 3个大方向
-    "selected_direction": None,    # 学生最终选定的大方向
-    "recommended_jobs": [],        # 3个具体职业
-    "final_choice": None           # 学生最终选定的具体职业
+    # Additional state for Forward mode
+    "recommended_directions": [],  # 3 general career directions
+    "selected_direction": None,    # The final general direction selected by the user
+    "recommended_jobs": [],        # 3 specific job recommendations
+    "final_choice": None           # The final specific job selected by the user
 }
 
-# ============================ 基础问题 ============================
+# ============================ Base Question ============================
 base_questions = [
-    ("mode", "你是否有心仪的职业方向？\n- 如果有，请回复'是'（Backward模式）\n- 如果没有，请回复'否'（Forward模式）")
+    ("mode", "Do you already have a preferred career path?\n- If yes, please reply 'Yes' (Backward mode)\n- If no, please reply 'No' (Forward mode)")
 ]
 
-# ============================ Forward 模式问题 ============================
+# ============================ Forward Mode Questions ============================
 forward_additional_questions = [
-    ("bg_info", """那么接下来我会需要你提供一些你的资料，并分享一些你的性格和喜好。请先告诉我，你的学校、年级、专业，和主修课程是什么？如果能提供你的选课表或resume就更好啦。"""),
-    ("work_value", """非常好！那你认为"工作"的意义是什么？你觉得一份理想的工作，应该带来哪些价值或满足感？（例如：帮助他人、赚大钱、自由时间、个人成长、创意空间等）"""),
-    ("personality_summary", "用几句话总结你的性格：比如外向/内向？喜欢挑战？注重细节？讨厌重复吗？"),
-    ("dream_day", "再描述一下你理想工作的一天是什么样：在哪工作？做什么？和谁合作？忙还是闲？更自由还是更有秩序？")
+    ("bg_info", """To get started, please tell me a bit about your academic background and interests. What's your school, year, major, and core courses? If you have a transcript or resume, that would be even better!"""),
+    ("work_value", """Great! What do you think is the meaning or value of 'work'? What should an ideal job provide for you? (e.g., helping others, high income, free time, personal growth, creative space, etc.)"""),
+    ("personality_summary", "Briefly describe your personality: Are you introverted or extroverted? Do you enjoy challenges? Detail-oriented? Do you dislike repetitive work?"),
+    ("dream_day", "Now describe what your ideal workday looks like: Where are you working? What are you doing? Who are you collaborating with? Is it busy or relaxed? More freedom or more structure?")
 ]
 
-# ============================ Backward 模式问题 ============================
+# ============================ Backward Mode Questions ============================
 backward_additional_questions = [
-    ("specific_career", "请具体描述你想要从事的职业方向。"),
-    ("bg_info", "请提供你的学校、年级、专业以及已有的实习或项目经历，以便更好地帮你规划如何达成目标。")
+    ("specific_career", "Please describe the specific career path you want to pursue."),
+    ("bg_info", "Please provide your school, year, major, and any internship or project experience you already have, so I can help you build a clearer path to your goal.")
 ]
 
-# ============================ 状态控制变量 ============================
+# ============================ State Control Variables ============================
 current_q_index = 0
 questions = base_questions[:]
 in_forward_flow = False
@@ -53,15 +53,15 @@ forward_deep_dive_done = False
 roadmap_offered = False
 roadmap_done = False
 
-direction_chosen = False    # 是否已经选定大方向
-jobs_recommended = False    # 是否已给出3个具体职业
-job_chosen = False          # 是否选定了具体职业
+direction_chosen = False    # Whether a general direction has been selected
+jobs_recommended = False    # Whether 3 specific job options have been recommended
+job_chosen = False          # Whether the final job has been selected
 
-# ========== 用于 A/B/C 专项问题的标记 ==========
-post_career_detail_asked = False  # 是否已询问用户要看A/B/C
-post_career_detail_done = False   # 是否已回答完A/B/C
+# ========== Flags for A/B/C Deep Dive Questions ==========
+post_career_detail_asked = False  # Whether the user has been asked about A/B/C sections
+post_career_detail_done = False   # Whether A/B/C responses are complete
 
-# ============================ 模型设置 ============================
+# ============================ Model Configuration ============================
 model_default = "gpt-4o"
 token_default = 2000
 temp_default = 0.7
@@ -69,30 +69,30 @@ top_p_default = 0.95
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-#  动态函数：根据用户选择的 A/B/C，让 OpenAI 生成相应分析
+#  Dynamic Function: Generate a personalized career roadmap based on A/B/C analysis
 def backward_strategy_plan(specific_career, bg_info):
     prompt = f"""
-你是一位专业的职业规划顾问。
-现在有一位学生，他的目标职业是：{specific_career}
-他的当前背景是：{bg_info}
-
-请根据这个学生的背景和目标，帮他做一个清晰的达成路径规划，内容要包括：
-1. 是否需要考虑转专业或辅修？
-2. 是否需要补哪些课？课程关键词有哪些？
-3. 推荐的证书/考试（如CFA等）和学习建议
-4. 推荐的实习方向（基于他的背景）
-5. 如何利用本校资源（career center、club、networking等）
-6. 如果他背景不匹配（比如机械去金融），如何填补Gap？
-
-请使用 Markdown 分段格式，不少于300字，内容务必紧扣他目前的背景和目标。
+You are a professional career planning advisor.
+A student has the target career: {specific_career}
+Their current background is: {bg_info}
+
+Please help the student build a clear plan to reach their goal, including:
+1. Should they consider changing majors or taking a minor?
+2. Are there any courses they should take? What are the key course topics?
+3. Recommended certificates/exams (e.g., CFA) and study tips
+4. Suggested internship directions (based on their background)
+5. How to make use of university resources (career center, clubs, networking, etc.)
+6. If their background is mismatched (e.g., mechanical engineering to finance), how to bridge the gap?
+
+Use Markdown formatting in sections, with a minimum of 300 words. The content must align closely with the student's current background and goals.
 """
     try:
         api_key = os.environ.get("API_TOKEN")
         if not api_key:
-            return "错误：API_TOKEN 未设置"
+            return "Error: API_TOKEN is not set"
         client = OpenAI(api_key=api_key)
         msgs = [
-            {"role": "system", "content": "你是一位经验丰富的职业顾问，擅长根据用户背景制定路径规划"},
+            {"role": "system", "content": "You are an experienced career advisor, good at creating roadmaps based on user background."},
             {"role": "user", "content": prompt}
         ]
         resp = client.chat.completions.create(
@@ -105,9 +105,11 @@ def backward_strategy_plan(specific_career, bg_info):
         )
         return resp.choices[0].message.content
     except Exception as e:
-        return f"生成职业路径建议时出错: {str(e)}"
+        return f"Error generating career roadmap: {str(e)}"
+
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# Dynamic function: Generate detailed analysis based on selected A/B/C modules
 def answer_abc_questions(selected, bg_info, wv, ps, dd):
     desired_parts = []
     if "a" in selected.lower():
@@ -118,31 +120,46 @@ def answer_abc_questions(selected, bg_info, wv, ps, dd):
         desired_parts.append("C")
 
     if not desired_parts:
-        return "好的，你暂时不需要查看A/B/C的专项信息。"
+        return "Alright, you chose not to view the A/B/C modules for now."
 
     prompt_text = f"""
-你是一位专业的职业规划顾问。以下是学生背景信息，请根据他选择的模块(A/B/C)给出详细分析和建议。
-学生背景：
-- 学术背景: {bg_info}
-- 工作意义: {wv}
-- 性格: {ps}
-- 理想工作: {dd}
-
-学生目前想要的额外信息模块：{', '.join(desired_parts)}
-请分别按顺序为每个模块写一段分析和建议，可以使用Markdown分段形式。
-（A: 专业/选课方向 & 求职入门建议部分的回答请根据学生的学术背景信息分析学生已经有的能力，然后根据其选择的职业方向分析该学生未来的选课应该注重什么课程方向，提示学生课程名称和关键词）
-（'B: 本校资源利用建议'部分的回答请你从3个方面回答学生，包括1.如何利用学校的career service；2.如何关注学校与职业准备和证书考试相关的club、组织和平台；3.学生如何与学校的及其所在专业的校友取得联系和networking技巧）
-（'C: 实习 & Experience积累'部分的回答请你从申请internship的平台、达成目前职业目标需要的internship方向，申请需要的资料和准备技巧、通过networking获得实习或者学生工作经历的策略）
-
-��只回答用户所选模块，不要回答未选的模块。
+You are a professional career planning advisor. Below is the student's background information. Please provide detailed analysis and suggestions based on the selected module(s): A, B, or C.
+
+Student Profile:
+- Academic Background: {bg_info}
+- Work Value: {wv}
+- Personality: {ps}
+- Ideal Workday: {dd}
+
+The student wants insights on the following module(s): {', '.join(desired_parts)}
+Please write a separate section for each selected module in order, using Markdown formatting.
+
+(A: Course Selection & Career Entry)
+- Analyze the student’s current academic background and what capabilities they already have.
+- Based on their intended career, recommend what types of courses they should focus on.
+- Suggest course names and keywords to guide their course planning.
+
+(B: School Resource Utilization)
+- Provide 3 types of suggestions:
+  1. How to utilize the university's career services.
+  2. How to get involved with career-related clubs, organizations, and platforms.
+  3. How to network with alumni in their field and improve networking skills.
+
+(C: Internships & Experience Building)
+- Suggest platforms to find internships.
+- Recommend internship directions aligned with the student’s career goal.
+- Provide tips for preparing materials and applying.
+- Strategies for gaining experience through networking, internships, or campus jobs.
+
+Only include the modules selected by the student. Do not generate content for unselected modules.
 """
     try:
         api_key = os.environ.get("API_TOKEN")
         if not api_key:
-            return "错误：API_TOKEN 未设置"
+            return "Error: API_TOKEN is not set."
         client = OpenAI(api_key=api_key)
         msgs = [
-            {"role": "system", "content": "你是一位专业职业顾问，会针对A/B/C进行分析。"},
+            {"role": "system", "content": "You are a professional career advisor who provides module-specific (A/B/C) analysis and suggestions."},
             {"role": "user", "content": prompt_text}
         ]
         resp = client.chat.completions.create(
@@ -155,35 +172,39 @@ def answer_abc_questions(selected, bg_info, wv, ps, dd):
         )
         return resp.choices[0].message.content
     except Exception as e:
-        return f"生成A/B/C专项信息时出错: {str(e)}"
+        return f"Error generating A/B/C insights: {str(e)}"
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 职业详细介绍 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Career Detail Generation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 def do_selected_career_detail(selected_career, bg_info, wv, ps, dd):
     prompt = f"""
-你是一位专业的职业规划顾问。
-学生最终选择的具体职业: {selected_career}
-学生背景: {bg_info}
-工作意义: {wv}
-性格: {ps}
-理想工作: {dd}
-请写一份更详细的职业说明，至少包含：
-1. 行业平均薪资（初级/中级/高级）
-2. 工作环境（远程/混合/办公室，团队规模等）
-3. 晋升难度（需要什么资历或条件）
-4. 关键技能和考证
-5. 日常工作节奏
-6. 行业前景
-用分段Markdown格式，字数不少于300字。
+You are a professional career planning advisor.
+
+The student has selected the following specific career: {selected_career}
+Student Profile:
+- Academic Background: {bg_info}
+- Work Value: {wv}
+- Personality: {ps}
+- Ideal Workday: {dd}
+
+Please write a detailed description of this career including at least the following:
+1. Average salary (entry-level / mid-level / senior)
+2. Work environment (remote/hybrid/in-office, team size, etc.)
+3. Promotion difficulty (what qualifications or milestones are needed)
+4. Key skills and certifications required
+5. Typical work rhythm (fast-paced or routine?)
+6. Industry outlook
+
+Please use Markdown formatting in separate sections, with a minimum of 300 words.
 """
     try:
         api_key = os.environ.get("API_TOKEN")
         if not api_key:
-            return "错误：API_TOKEN 未设置"
+            return "Error: API_TOKEN is not set."
         client = OpenAI(api_key=api_key)
 
         msgs = [
-            {"role": "system", "content": "你是一位专业职业顾问，会为用户选定的具体职业提供详细的分析。"},
+            {"role": "system", "content": "You are a professional career advisor who provides in-depth career descriptions."},
             {"role": "user", "content": prompt}
         ]
         resp = client.chat.completions.create(
@@ -196,42 +217,46 @@ def do_selected_career_detail(selected_career, bg_info, wv, ps, dd):
         )
         return resp.choices[0].message.content
     except Exception as e:
-        return f"生成职业详细信息时出错: {str(e)}"
+        return f"Error generating detailed career info: {str(e)}"
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 时间轴式规划 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Timeline-Based Career Roadmap ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 def do_time_roadmap():
     direction = user_profile.get("final_choice") or user_profile.get("selected_direction") or \
                 user_profile.get("forward_direction_choice") or user_profile.get("specific_career")
-    bg_info = user_profile["bg_info"] or "未知专业"
-    wv = user_profile["work_value"] or "暂无"
-    ps = user_profile["personality_summary"] or "暂无"
-    dd = user_profile["dream_day"] or "暂无"
+    bg_info = user_profile["bg_info"] or "Unknown Major"
+    wv = user_profile["work_value"] or "Not provided"
+    ps = user_profile["personality_summary"] or "Not provided"
+    dd = user_profile["dream_day"] or "Not provided"
 
     prompt_roadmap = f"""
-学生信息：
-- 学术背景：{bg_info}
-- 职业方向/具体职业：{direction}
-- 工作价值：{wv}
-- 性格：{ps}
-- 理想工作：{dd}
-请你使用时间轴方式，给出一个职业路线图，如：
-📍 大二暑假: [申请什么实习，参加什么活动，考什么证书]
-🎓 Year 3: [需要选的课/要做的项目]
-💼 大三暑假: [申请什么实习、参加什么活动，考什么证书]
-📄 毕业前1年到6个月: [考什么证书、准备什么申请工作或者申请研究生的材料]
-🚀 毕业后: [目标岗位、如何申请]
-请用Markdown分段写作，结合学生当前背景合理推断要点，写得具体些。
+Student Profile:
+- Academic Background: {bg_info}
+- Career Direction / Specific Role: {direction}
+- Work Values: {wv}
+- Personality: {ps}
+- Ideal Workday: {dd}
+
+Please create a timeline-style career roadmap based on the student's background and goal.
+Use the following structure as a reference:
+
+📍 Summer after Year 2: [What internship to apply for, what activities to participate in, what certifications to pursue]
+🎓 Year 3: [Recommended courses, key projects or academic goals]
+💼 Summer after Year 3: [Target internships, certifications, personal/professional development plans]
+📄 6–12 Months Before Graduation: [Certifications to complete, job/grad school application materials to prepare]
+🚀 Post-Graduation: [Target roles, how to apply, next steps]
+
+Please write the roadmap using Markdown formatting and tailor your suggestions specifically to the student's profile.
 """
     try:
         api_key = os.environ.get("API_TOKEN")
         if not api_key:
-            return "错误：API_TOKEN 未设置"
+            return "Error: API_TOKEN is not set."
         client = OpenAI(api_key=api_key)
 
         msgs = [
-            {"role":"system","content":"你是一位专业的职业规划顾问，会生成时间轴式路线图"},
-            {"role":"user","content": prompt_roadmap}
+            {"role": "system", "content": "You are a professional career advisor who generates timeline-based career roadmaps."},
+            {"role": "user", "content": prompt_roadmap}
         ]
         resp = client.chat.completions.create(
             model=model_default,
@@ -243,39 +268,41 @@ def do_time_roadmap():
         )
         return resp.choices[0].message.content
     except Exception as e:
-        return f"生成路线图时出错: {str(e)}"
+        return f"Error generating career roadmap: {str(e)}"
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 推荐具体职业 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Recommend Specific Careers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 def recommend_3jobs_for_direction(direction, bg_info, wv, ps, dd):
     prompt = f"""
-你是一位专业的职业规划顾问。
-学生选定的大方向：{direction}
-学生背景：{bg_info}
-工作意义：{wv}
-性格：{ps}
-理想工作：{dd}
-请为该方向推荐3个更具体的职业岗位，并分点说明：
-1) 为什么适合这个大方向
-2) 典型工作职责
-3) 技能/证书要求
-4) 未来发展前景
-最后以这样的格式结束（不要在前面重复这些选项）：
-
-请选择你的理想职业：
-1. [职业名称1]
-2. [职业名称2]
-3. [职业名称3]
-如都不满意，可输入'换'。
+You are a professional career advisor.
+The student has selected the following general career direction: {direction}
+Student background: {bg_info}
+Work values: {wv}
+Personality: {ps}
+Ideal workday: {dd}
+
+Please recommend 3 specific job roles related to this direction, and provide details for each:
+1) Why this job fits the chosen direction
+2) Typical responsibilities
+3) Required skills and certifications
+4) Future career prospects
+
+End your response with this format (do not repeat this format earlier in the message):
+
+Please select your ideal job:
+1. [Job Title 1]
+2. [Job Title 2]
+3. [Job Title 3]
+If none of these suit you, enter 'change'.
 """
     try:
         api_key = os.environ.get("API_TOKEN")
         if not api_key:
-            return "错误：API_TOKEN 未设置"
+            return "Error: API_TOKEN not set"
         client = OpenAI(api_key=api_key)
 
         msgs = [
-            {"role": "system", "content": "你是一位专业职业顾问，会根据用户选定的大方向再推荐3个具体职业。"},
+            {"role": "system", "content": "You are a professional career advisor, recommending 3 specific jobs based on the student's chosen direction."},
             {"role": "user", "content": prompt}
         ]
         resp = client.chat.completions.create(
@@ -288,65 +315,69 @@ def recommend_3jobs_for_direction(direction, bg_info, wv, ps, dd):
         )
         output_text = resp.choices[0].message.content
 
-        # 从回复中尝试解析职业名称 - 简单示例实现
+        # Try to extract job titles from the response
         import re
         job_pattern = r'(\d+)\.\s+\[?(.*?)\]?(?:\n|$)'
         job_matches = re.findall(job_pattern, output_text)
         job_list = [match[1].strip() for match in job_matches]
-        
-        # 如果没有找到合适的匹配，创建默认值
+
+        # If parsing fails, provide fallback options
         if len(job_list) < 3:
             job_list = [
-                f"{direction} - 职业A",
-                f"{direction} - 职业B",
-                f"{direction} - 职业C"
+                f"{direction} - Job A",
+                f"{direction} - Job B",
+                f"{direction} - Job C"
             ]
-        
-        user_profile["recommended_jobs"] = job_list[:3]  # 确保只取前3个
-        
-        # 设置为已经推荐过职业
+
+        user_profile["recommended_jobs"] = job_list[:3]  # Ensure only the first 3 are used
+
+        # Mark that jobs have been recommended
         global jobs_recommended
         jobs_recommended = True
-        
+
         return output_text
     except Exception as e:
-        return f"推荐具体职业时出错: {str(e)}"
+        return f"Error recommending specific jobs: {str(e)}"
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 推荐大方向 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Recommend General Directions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 def recommend_3directions():
-    bg_info = user_profile["bg_info"] or "未知"
-    wv = user_profile["work_value"] or "无"
-    ps = user_profile["personality_summary"] or "不详"
-    dd = user_profile["dream_day"] or "无"
+    bg_info = user_profile["bg_info"] or "Unknown"
+    wv = user_profile["work_value"] or "Not provided"
+    ps = user_profile["personality_summary"] or "Not provided"
+    dd = user_profile["dream_day"] or "Not provided"
 
     rec_prompt = f"""
-请根据以下信息，写一份条理清晰的人物画像+3个大方向，其中称呼对面用"你"不要用"他/她"：
-- 学术背景: {bg_info}
-- 工作意义: {wv}
-- 性格: {ps}
-- 理想工作: {dd}
-分两部分：
-[一、人物画像]：1) 学术背景 2) 价值观 3) 性格 4) 理想工作
-
-[二、推荐3个大方向]：每个方向写1~2段文字分析，并说明为什么适合学生。
-
-最后结束时只有这样的选项（不要在前面重复这些选项）：
-
-请选择你的职业方向：
-1. [方向名称1]
-2. [方向名称2]
-3. [方向名称3]
-如都不满意，可输入'换'。
+Based on the following information, write a structured student profile and recommend 3 general career directions.
+Address the student as "you" (not he/she).
+
+- Academic Background: {bg_info}
+- Work Values: {wv}
+- Personality: {ps}
+- Ideal Workday: {dd}
+
+Two parts required:
+
+[1. Student Profile]: Briefly summarize their academic background, core values, personality, and career expectations.
+
+[2. Recommend 3 General Directions]: For each direction, write 1–2 paragraphs explaining why it's a good fit for the student.
+
+End with only the following format (do not repeat it earlier):
+
+Please choose your career direction:
+1. [Direction Name 1]
+2. [Direction Name 2]
+3. [Direction Name 3]
+If none are suitable, type 'change'.
 """
     try:
         api_key = os.environ.get("API_TOKEN")
         if not api_key:
-            return "错误：API_TOKEN 未设置"
+            return "Error: API_TOKEN not set"
         client = OpenAI(api_key=api_key)
         msgs = [
-            {"role":"system","content":"你是一位职业顾问，擅长根据用户资料推荐3大方向"},
-            {"role":"user","content": rec_prompt}
+            {"role": "system", "content": "You are a career advisor who recommends 3 general directions based on the user's profile."},
+            {"role": "user", "content": rec_prompt}
         ]
         resp = client.chat.completions.create(
             model=model_default,
@@ -358,27 +389,24 @@ def recommend_3directions():
         )
         output_text = resp.choices[0].message.content
 
-        # 从回复中尝试解析方向名称 - 简单示例实现
+        # Try to extract direction names from the response
         import re
         dir_pattern = r'(\d+)\.\s+\[?(.*?)\]?(?:\n|$)'
         dir_matches = re.findall(dir_pattern, output_text)
         dir_list = [match[1].strip() for match in dir_matches]
-        
-        # 如果没有找到合适的匹配，创建默认值
+
+        # Fallback if parsing fails
         if len(dir_list) < 3:
-            dir_list = [
-                "方向1", 
-                "方向2", 
-                "方向3"
-            ]
-            
-        user_profile["recommended_directions"] = dir_list[:3]  # 确保只取前3个
+            dir_list = ["Direction 1", "Direction 2", "Direction 3"]
+
+        user_profile["recommended_directions"] = dir_list[:3]
         return output_text
     except Exception as e:
-        return f"多方向推荐出错: {str(e)}"
+        return f"Error recommending general directions: {str(e)}"
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 生成系统提示 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Generate System Prompt ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 def generate_system_prompt():
     mode = user_profile["mode"]
     sc = user_profile["specific_career"]
@@ -388,39 +416,40 @@ def generate_system_prompt():
     dd = user_profile["dream_day"]
     fwd = user_profile["forward_direction_choice"]
 
-    if mode == "是":
+    if mode == "是":  # Backward Mode
         return f"""
-你是一位专业的职业规划顾问，使用Backward Design方法帮助学生达成他们的职业目标。
-目标职业: {sc}
-背景信息: {bg}
-请提供：
-1. 该职业的简要分析
-2. 排名前列的组织或公司
-3. 所需技能和能力
-4. 职业发展路径
-5. 学术/课程建议、技能培养、资源使用、实习规划、简历优化等
-最后请用Markdown格式输出职业路线图：
-📍 现在 → 🎓 学习建议 → 💼 实践建议 → 📄 认证建议 → 🚀 求职建议
+You are a professional career advisor using the Backward Design method to help students achieve their career goals.
+Target career: {sc}
+Background information: {bg}
+Please provide:
+1. A brief analysis of the target career
+2. Top companies or organizations in this field
+3. Required skills and qualifications
+4. Career development path
+5. Academic/course suggestions, skill development, use of resources, internship planning, resume tips, etc.
+
+Finally, output a career roadmap in Markdown format like this:
+📍 Now → 🎓 Learning Suggestions → 💼 Practice Suggestions → 📄 Certification Advice → 🚀 Job Search Suggestions
 """
-    else:
+    else:  # Forward Mode
         return f"""
-你是一位专业的职业规划顾问，使用Forward Design方法帮助学生探索合适的职业路径。
-学生背景: {bg}
-工作意义: {wv}
-性格总结: {ps}
-理想工作: {dd}
-学生选择方向: {fwd}
-请输出：
-1. 学生的优势、性格、价值观分析
-2. 推荐3个具体职业，并说明日常工作内容、适配性、要求、准备路径
-3. 最后输出职业路线图：
-📍 现在 → 🎓 学习建议 → 💼 实践建议 → 📄 认证建议 → 🚀 求职建议
+You are a professional career advisor using the Forward Design method to help students explore suitable career paths.
+Student background: {bg}
+Work values: {wv}
+Personality summary: {ps}
+Ideal workday: {dd}
+Student's selected direction: {fwd}
+Please provide:
+1. An analysis of the student’s strengths, personality traits, and values
+2. 3 recommended specific jobs, including daily work content, fit, requirements, and preparation pathway
+3. A final career roadmap:
+📍 Now → 🎓 Learning Suggestions → 💼 Practice Suggestions → 📄 Certification Advice → 🚀 Job Search Suggestions
 """
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 主对话逻辑函数 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Main Dialogue Logic Function ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 def predict(message, history):
-    # ========= 在函数开头，提前声明所有 global =========
+    # ========= Declare all global variables at the beginning =========
     global current_q_index, questions
     global in_forward_flow, in_backward_flow
     global forward_index, backward_index
@@ -432,7 +461,7 @@ def predict(message, history):
     global direction_chosen, jobs_recommended, job_chosen
     global post_career_detail_asked, post_career_detail_done
 
-    # ======================== 初始化 =========================
+    # ======================== Initialization =========================
     if not history:
         current_q_index = 0
         questions[:] = base_questions
@@ -457,35 +486,32 @@ def predict(message, history):
         post_career_detail_asked = False
         post_career_detail_done = False
 
-    # ======================== 先处理基础问题 =========================
+    # ======================== First handle base questions =========================
     if 0 < current_q_index <= len(questions):
         key = questions[current_q_index - 1][0]
- 
 
         if key == "mode" and current_q_index == 1:
-           ans = message.strip()
-           user_profile["mode"] = ans
-           questions[:] = []  # 清空基础问答流程
-           if "是" in ans:
-               in_backward_flow = True
-           else:
-               in_forward_flow = True
-
+            ans = message.strip()
+            user_profile["mode"] = ans
+            questions[:] = []  # Clear base questions
+            if "是" in ans:
+                in_backward_flow = True
+            else:
+                in_forward_flow = True
 
-    if current_q_index < len(questions)and not in_forward_flow and not in_backward_flow:
+    if current_q_index < len(questions) and not in_forward_flow and not in_backward_flow:
         nxt = questions[current_q_index][1]
         current_q_index += 1
         return nxt
 
-  
 
 
-    # ======================== 分模式处理 =========================
-    mode = user_profile.get("mode") or ""
+    # ======================== Mode-based Flow Control =========================
+mode = user_profile.get("mode") or ""
 
-    # ~~~~~~~~~ Backward模式 ~~~~~~~~~
-    if mode == "是":
-      if in_backward_flow and not backward_done:
+# ~~~~~~~~~ Backward Mode ~~~~~~~~~
+if mode == "是":
+    if in_backward_flow and not backward_done:
         if backward_index > 0 and backward_index <= len(backward_additional_questions):
             prev_key = backward_additional_questions[backward_index - 1][0]
             user_profile[prev_key] = message.strip()
@@ -493,9 +519,9 @@ def predict(message, history):
         if backward_index < len(backward_additional_questions):
             k, prompt_text = backward_additional_questions[backward_index]
             backward_index += 1
-            return prompt_text  # ✅ 正确：缩进在 if 块内
+            return prompt_text  # ✅ Correct: properly indented inside the `if` block
         else:
-            # 已完成背景收集，生成路径分析
+            # All background info collected, generate career path strategy
             strategy = backward_strategy_plan(
                 specific_career=user_profile.get("specific_career"),
                 bg_info=user_profile.get("bg_info")
@@ -505,37 +531,36 @@ def predict(message, history):
             forward_deep_dive_done = True
             post_career_detail_asked = True
 
-            return strategy + "\n\n我还可以针对以下三方面提供更深入的分析建议：" \
-                "\n- A：专业/选课 & 求职方向" \
-                "\n- B：本校资源利用建议" \
-                "\n- C：实习 & networking 积累" \
-                "\n如果你想查看其中一个或多个，请输入 A / B / C / AB / BC / AC / ABC" \
-                "\n如果都不需要，请回复'不需要'。"
+            return strategy + "\n\nI can also provide in-depth suggestions for the following three aspects:" \
+                "\n- A: Major/Course Planning & Job Entry Advice" \
+                "\n- B: Making Use of Campus Resources" \
+                "\n- C: Internship & Networking Strategy" \
+                "\nIf you'd like to view one or more, please type A / B / C / AB / BC / AC / ABC" \
+                "\nIf not needed, just reply with 'No'."
 
-
-    # 处理 A/B/C 答疑
+    # Handle A/B/C deep-dive answers
     elif post_career_detail_asked and not post_career_detail_done:
         user_choice = message.strip().lower()
         if user_choice in ["不需要", "no", "n"]:
             post_career_detail_done = True
             roadmap_offered = True
-            return "好的，不查看这三个专项。那需要一个时间轴式职业路线图吗？如需，则回复【要】，否则回复【不要】。"
+            return "Understood. Would you like a timeline-style career roadmap? Reply 'yes' or 'no'."
         else:
             abc_text = answer_abc_questions(
                 selected=user_choice,
                 bg_info=user_profile.get("bg_info", ""),
-                wv=user_profile.get("work_value", "未提供"),
-                ps=user_profile.get("personality_summary", "未提供"),
-                dd=user_profile.get("dream_day", "未提供")
+                wv=user_profile.get("work_value", "Not provided"),
+                ps=user_profile.get("personality_summary", "Not provided"),
+                dd=user_profile.get("dream_day", "Not provided")
             )
             post_career_detail_done = True
             roadmap_offered = True
-            return abc_text + "\n\n以上是你所选的A/B/C专项信息。需要一个时间轴式职业路线图吗？如需，则回复【要】，否则回复【不要】。"
+            return abc_text + "\n\nAbove is your selected A/B/C section. Would you like a timeline-style career roadmap? Reply 'yes' or 'no'."
 
-    # 路线图询问
+    # Ask if a roadmap is needed
     elif job_chosen and not roadmap_offered and not roadmap_done:
         roadmap_offered = True
-        return "需要一个时间轴式职业路线图吗？如需，则回复【要】，否则回复【不要】。"
+        return "Would you like a timeline-style career roadmap? Reply 'yes' or 'no'."
 
     elif roadmap_offered and not roadmap_done:
         ans = message.strip().lower()
@@ -546,19 +571,19 @@ def predict(message, history):
         else:
             roadmap_done = True
             backward_done = True
-            return "好的，不生成时间轴，本次规划结束。"
+            return "Alright, no roadmap generated. This concludes the planning session."
 
-    # Backward 最终总结
+    # Final summary for Backward Mode
     if backward_done:
         try:
             api_key = os.environ.get("API_TOKEN")
             if not api_key:
-                return "错误：API_TOKEN 未设置"
+                return "Error: API_TOKEN is not set"
             client = OpenAI(api_key=api_key)
             sprompt = generate_system_prompt()
             msgs = [
                 {"role": "system", "content": sprompt},
-                {"role": "user", "content": f"以下是资料: {user_profile}. 若需要更多咨询可再次输入"}
+                {"role": "user", "content": f"Here is the user profile: {user_profile}. Feel free to ask more questions if needed."}
             ]
             resp = client.chat.completions.create(
                 model=model_default,
@@ -570,165 +595,165 @@ def predict(message, history):
             )
             return resp.choices[0].message.content
         except Exception as e:
-            return f"发生错误: {str(e)}"
-
-
-    # ~~~~~~~~~ Forward模式 ~~~~~~~~~
-    else:
-        # 前期处理：收集信息和推荐大方向
-        if in_forward_flow and not direction_chosen:
-            # 收集 4个基础问题
-            if forward_index > 0 and forward_index <= len(forward_additional_questions):
-                prev_key = forward_additional_questions[forward_index - 1][0]
-                user_profile[prev_key] = message.strip()
+            return f"An error occurred while generating summary: {str(e)}"
+
+   # ~~~~~~~~~ Forward Mode ~~~~~~~~~
+else:
+    # Step 1: Collect user information and recommend 3 career directions
+    if in_forward_flow and not direction_chosen:
+        # Collect the 4 basic background questions
+        if forward_index > 0 and forward_index <= len(forward_additional_questions):
+            prev_key = forward_additional_questions[forward_index - 1][0]
+            user_profile[prev_key] = message.strip()
 
-            if forward_index < len(forward_additional_questions):
-                k, prompt_text = forward_additional_questions[forward_index]
-                forward_index += 1
-                return prompt_text
+        if forward_index < len(forward_additional_questions):
+            k, prompt_text = forward_additional_questions[forward_index]
+            forward_index += 1
+            return prompt_text
 
-            # 问完 4个问题 -> 推荐3方向
-            elif not forward_recommendation_given:
-                forward_recommendation_given = True
-                return recommend_3directions()
+        # After collecting the 4 questions → Recommend 3 directions
+        elif not forward_recommendation_given:
+            forward_recommendation_given = True
+            return recommend_3directions()
 
-            # 等待用户选 1/2/3 or 换
-            else:
-                choice = message.strip().lower()
-                if choice in ["1","2","3"]:
-                    idx = int(choice) - 1
-                    if idx < len(user_profile["recommended_directions"]):
-                        sel_dir = user_profile["recommended_directions"][idx]
-                        user_profile["selected_direction"] = sel_dir
-                        direction_chosen = True
-                        # 不在这里设置jobs_recommended=True，而是在函数内部设置
-                        return recommend_3jobs_for_direction(
-                            direction=sel_dir,
-                            bg_info=user_profile["bg_info"] or "",
-                            wv=user_profile["work_value"] or "",
-                            ps=user_profile["personality_summary"] or "",
-                            dd=user_profile["dream_day"] or ""
-                        )
-                    else:
-                        return "无效选项，请重新输入1/2/3或'换'"
-                elif choice == "换":
-                    recommendation_round += 1
-                    if recommendation_round > 2:
-                        forward_done = True
-                        return "已多次换方向，结束推荐。"
-                    else:
-                        return recommend_3directions()
-                else:
-                    return "请回复1/2/3选择方向，或输入'换'来重新推荐"
-
-        # 已推荐具体职业 -> 等待用户选择
-        elif direction_chosen and jobs_recommended and not job_chosen:
+        # Wait for user to choose 1 / 2 / 3 or ask to switch
+        else:
             choice = message.strip().lower()
-            if choice in ["1","2","3"]:
+            if choice in ["1", "2", "3"]:
                 idx = int(choice) - 1
-                if idx < len(user_profile["recommended_jobs"]):
-                    final_job = user_profile["recommended_jobs"][idx]
-                    user_profile["final_choice"] = final_job
-                    job_chosen = True
-
-                    detail_msg = do_selected_career_detail(
-                        selected_career=final_job,
+                if idx < len(user_profile["recommended_directions"]):
+                    sel_dir = user_profile["recommended_directions"][idx]
+                    user_profile["selected_direction"] = sel_dir
+                    direction_chosen = True
+                    # jobs_recommended is set internally inside the function
+                    return recommend_3jobs_for_direction(
+                        direction=sel_dir,
                         bg_info=user_profile["bg_info"] or "",
                         wv=user_profile["work_value"] or "",
                         ps=user_profile["personality_summary"] or "",
                         dd=user_profile["dream_day"] or ""
                     )
-                    forward_deep_dive_done = True
-
-                    # **询问 A/B/C 专项**
-                    post_career_detail_asked = True
-
-                    return detail_msg + "\n\n我还可以针对以下三方面提供更深入的分析建议：" \
-                    "\n- A：专业/选课 & 求职方向" \
-                    "\n- B：本校资源利用建议" \
-                    "\n- C：实习 & networking 积累" \
-                    "\n如果你想查看其中一个或多个，请输入 A / B / C / AB / BC / AC / ABC" \
-                    "\n如果都不需要，请回复'不需要'。"
                 else:
-                    return "无效的选项，请重新输入1/2/3或'换'"
+                    return "Invalid option. Please reply with 1/2/3 or 'switch'."
             elif choice == "换":
                 recommendation_round += 1
                 if recommendation_round > 2:
                     forward_done = True
-                    return "已多次换职业，结束推荐。"
+                    return "You've switched too many times. Ending recommendation."
                 else:
-                    sel_dir = user_profile.get("selected_direction") or "未知方向"
-                    return recommend_3jobs_for_direction(
-                        direction=sel_dir,
-                        bg_info=user_profile["bg_info"] or "",
-                        wv=user_profile["work_value"] or "",
-                        ps=user_profile["personality_summary"] or "",
-                        dd=user_profile["dream_day"] or ""
-                    )
-            else:
-                return "请回复1/2/3选择具体职业，或输入'换'来重新推荐"
-
-        # 处理 A/B/C 答疑
-        elif post_career_detail_asked and not post_career_detail_done:
-            user_choice = message.strip().lower()
-            if user_choice in ["不需要", "no", "n"]:
-                post_career_detail_done = True
-                roadmap_offered = True
-                return "好的，不查看这三个专项。那需要一个时间轴式职业路线图吗？如需，则回复【要】，否则回复【不要】。"
+                    return recommend_3directions()
             else:
-                abc_text = answer_abc_questions(
-                    selected=user_choice,
-                    bg_info=user_profile["bg_info"],
-                    wv=user_profile["work_value"],
-                    ps=user_profile["personality_summary"],
-                    dd=user_profile["dream_day"]
+                return "Please reply with 1/2/3 to select a direction, or 'switch' to change options."
+
+    # Step 2: Recommend 3 specific job roles and wait for user to choose
+    elif direction_chosen and jobs_recommended and not job_chosen:
+        choice = message.strip().lower()
+        if choice in ["1", "2", "3"]:
+            idx = int(choice) - 1
+            if idx < len(user_profile["recommended_jobs"]):
+                final_job = user_profile["recommended_jobs"][idx]
+                user_profile["final_choice"] = final_job
+                job_chosen = True
+
+                detail_msg = do_selected_career_detail(
+                    selected_career=final_job,
+                    bg_info=user_profile["bg_info"] or "",
+                    wv=user_profile["work_value"] or "",
+                    ps=user_profile["personality_summary"] or "",
+                    dd=user_profile["dream_day"] or ""
                 )
-                post_career_detail_done = True
-                roadmap_offered = True
-                return abc_text + "\n\n以上是你所选的A/B/C专项信息。需要一个时间轴式职业路线图吗？如需，则回复【要】，否则回复【不要】。"
+                forward_deep_dive_done = True
 
-        # 已选定具体职业 -> 问是否需要时间轴
-        elif job_chosen and not roadmap_offered and not roadmap_done:
-            roadmap_offered = True
-            return "需要一个时间轴式职业路线图吗？如需，则回复【要】，否则回复【不要】。"
+                # Ask if user wants A/B/C section suggestions
+                post_career_detail_asked = True
 
-        elif roadmap_offered and not roadmap_done:
-            ans = message.strip().lower()
-            if ans in ["要", "yes", "y"]:
-                roadmap_done = True
-                forward_done = True
-                return do_time_roadmap()
+                return detail_msg + "\n\nI can also provide in-depth suggestions for the following 3 areas:" \
+                    "\n- A: Major/Course Planning & Job Entry Advice" \
+                    "\n- B: Making Use of Campus Resources" \
+                    "\n- C: Internship & Networking Strategy" \
+                    "\nIf you'd like to view one or more, please type A / B / C / AB / BC / AC / ABC" \
+                    "\nIf not needed, just reply with 'no'."
             else:
-                roadmap_done = True
+                return "Invalid option. Please reply with 1/2/3 or 'switch'."
+        elif choice == "换":
+            recommendation_round += 1
+            if recommendation_round > 2:
                 forward_done = True
-                return "好的，不生成时间轴，本次规划结束。"
-
-        # 如果 forward_done，就给个收尾
-        if forward_done:
-            try:
-                api_key = os.environ.get("API_TOKEN")
-                if not api_key:
-                    return "错误：API_TOKEN 未设置"
-                client = OpenAI(api_key=api_key)
-                sprompt = generate_system_prompt()
-                msgs = [
-                    {"role":"system","content":sprompt},
-                    {"role":"user","content": f"以下是资料: {user_profile}. 若需要更多咨询可再次输入"}
-                ]
-                resp = client.chat.completions.create(
-                    model=model_default,
-                    messages=msgs,
-                    max_tokens=token_default,
-                    temperature=temp_default,
-                    top_p=top_p_default,
-                    stream=False
+                return "You've switched too many times. Ending recommendation."
+            else:
+                sel_dir = user_profile.get("selected_direction") or "Unknown Direction"
+                return recommend_3jobs_for_direction(
+                    direction=sel_dir,
+                    bg_info=user_profile["bg_info"] or "",
+                    wv=user_profile["work_value"] or "",
+                    ps=user_profile["personality_summary"] or "",
+                    dd=user_profile["dream_day"] or ""
                 )
-                return resp.choices[0].message.content
-            except Exception as e:
-                return f"发生错误: {str(e)}"
+        else:
+            return "Please reply with 1/2/3 to choose a specific role, or 'switch' to get new ones."
+
+    # Step 3: Answer user-selected A/B/C questions
+    elif post_career_detail_asked and not post_career_detail_done:
+        user_choice = message.strip().lower()
+        if user_choice in ["不需要", "no", "n"]:
+            post_career_detail_done = True
+            roadmap_offered = True
+            return "Okay, skipping the three detailed sections. Would you like a timeline-style career roadmap? Reply 'yes' or 'no'."
+        else:
+            abc_text = answer_abc_questions(
+                selected=user_choice,
+                bg_info=user_profile["bg_info"],
+                wv=user_profile["work_value"],
+                ps=user_profile["personality_summary"],
+                dd=user_profile["dream_day"]
+            )
+            post_career_detail_done = True
+            roadmap_offered = True
+            return abc_text + "\n\nAbove is the A/B/C section you selected. Would you like a timeline-style career roadmap? Reply 'yes' or 'no'."
+
+    # Step 4: Ask if user wants a timeline roadmap
+    elif job_chosen and not roadmap_offered and not roadmap_done:
+        roadmap_offered = True
+        return "Would you like a timeline-style career roadmap? Reply 'yes' or 'no'."
+
+    elif roadmap_offered and not roadmap_done:
+        ans = message.strip().lower()
+        if ans in ["要", "yes", "y"]:
+            roadmap_done = True
+            forward_done = True
+            return do_time_roadmap()
+        else:
+            roadmap_done = True
+            forward_done = True
+            return "Okay, no roadmap generated. This concludes the session."
+
+    # Step 5: Final wrap-up after Forward mode finishes
+    if forward_done:
+        try:
+            api_key = os.environ.get("API_TOKEN")
+            if not api_key:
+                return "Error: API_TOKEN is not set"
+            client = OpenAI(api_key=api_key)
+            sprompt = generate_system_prompt()
+            msgs = [
+                {"role": "system", "content": sprompt},
+                {"role": "user", "content": f"Here is the user profile: {user_profile}. Feel free to ask more questions if needed."}
+            ]
+            resp = client.chat.completions.create(
+                model=model_default,
+                messages=msgs,
+                max_tokens=token_default,
+                temperature=temp_default,
+                top_p=top_p_default,
+                stream=False
+            )
+            return resp.choices[0].message.content
+        except Exception as e:
+            return f"An error occurred: {str(e)}"
+
+# Fallback response
+return "Information collection is complete. If you haven’t received a final reply, send any message to continue."
 
-    # 兜底
-    return "信息收集完毕，如还未得到最终回复，请再输入任意文字继续。"
 
 # ============================ Gradio UI ============================
 import gradio as gr