Skip to content

ziqihe10-droid/xuefeng-agent

Repository files navigation

雪峰 Agent — AI 高考志愿顾问

不是 ChatGPT 套壳。 是基于大量高考志愿规划方法论和院校数据构建的、有咨询逻辑的 AI 顾问。

License: MIT Python 3.10+


🎬 观看完整演示视频 — 把视频发 B站或抖音后把链接贴这里


知识库规模

这个 Agent 不是空壳。它的知识体系来自对海量志愿填报资料的深度学习:

来源 数量 说明
志愿填报专著 8 本 涵盖选专业、报志愿、稳就业、考研、专科、升学规划等
原始页数 1,932 页 全部 OCR 提取,总文字量 2.7MB
专业视频课程 61 节 / 1,500+ 分钟 涵盖全部学科门类专业详解
专业就业数据 792 个本科专业 12大学科门类完整就业方向+薪资
院校数据 2,600+ 所高校 覆盖985/211/双非/专科全层次
行业联盟分类 20+ 个 C9/国防七子/五院四系/两电一邮等
知识库模块 17 个 方法论/选科/专业/学校/考研/就业/专科/趋势

一句话:把志愿填报领域能找到的系统性知识,全塞进去了。


效果展示

👤:湖北物理类580分,位次28000,普通工薪家庭,想去武汉学计算机

🤖:你这情况很典型——湖北580分,2万8位次,普通家庭想靠技术吃饭。
    我说句实话,你这个分在湖北不差,但也别想985了。

    冲的话——武汉理工。211,工科底子硬。你的位次冲它的计算机
    有点悬,但电子信息类专业组可以试试。冲上了血赚,冲不上也正常。

    稳的——湖北大学、武汉科技大。这两个在武汉本地口碑很好,
    580分稳稳地进计算机或电气。毕业在武汉找个IT工作,日子不会差。

    保底——武汉工程大学、三峡大学。三峡大学的电气是原电力部直属,
    年年电网来校招,虽然不在武汉,但就业真不差。

    提醒你一句:现在计算机行业在分化。基础码农岗位在减少,
    大学期间必须往AI方向靠,别光学学校教的那点东西。

案例精选

案例一:普通家庭选专业

👤:我是湖北的,物理类,考了580,位次大概2万8。
    家里就是普通工薪,爸妈一年加起来十来万,没什么特别的资源。
    想去武汉或者南方大城市,学个好就业的专业,能挣钱就行。

🤖:你这情况很典型——湖北580分,2万8位次,普通家庭想靠技术吃饭。
    我说句实话,你这个分在湖北不差,但也别想985了。

    我先确认一下——你数学和物理怎么样?能接受天天对着电脑写代码吗?
    还是说想学个能进国企的、比较稳的方向?

👤:数学还行,物理也可以。写代码能接受,国企也行,都行。

🤖:那方向很明确了。普通家庭没资源,就两条路最稳:

    第一,计算机/电子信息。靠技术吃饭,不用拼爹。
    第二,电气工程。进国家电网,稳定体面。

    冲的话——武汉理工。211,工科底子硬。你的位次冲它的计算机
    有点悬,但电子信息类专业组可以试试。

    稳的——湖北大学、武汉科技大。这两个在武汉本地口碑很好,
    580分稳稳地进计算机或电气。长沙理工也可以,
    原电力部的学校,电气进电网有优势。

    保底——武汉工程大学、三峡大学。三峡大学的电气是原电力部直属,
    年年电网来校招,虽然不在武汉,但就业真不差。

    提醒你一句:现在计算机行业在分化。大学期间必须往AI和大数据
    方向靠,别光学学校教的那点东西。

案例二:文科考公方向

👤:河南文科生,考了510。家在县城,爸妈都是普通打工人,
    没什么背景。我想考公务员,能去哪个学校?

🤖:河南文科510,想考公。方向很明确,但分数确实不算高。

    我先问你一句——你是想留在河南,还是能接受去外省?
    还有,你讨厌背书吗?因为考公的专业,大学四年基本都在背。

👤:留在河南就行,背书我倒是不怕。

🤖:那好办了。文科考公,专业选汉语言文学和法学,
    千万别选英语——英语考公岗位少得可怜。

    冲的话河南大学——双一流,法学和汉语言都是考公大户。

    稳的是河南师范大学——汉语言文学和思政都是强项,
    毕业考公考编都方便,新乡生活成本也低。

    还有河南财经政法大学在郑州,法学和会计学都不错,
    考公岗位多,而且在省会。

    保底就是洛阳师范、河南科技学院——分数肯定够,
    进去把行测申论刷起来,大四直接考。

    提醒你:考公这件事,专业比学校重要。汉语言和法学是
    万金油——哪个单位都招。大一开始看行测和申论,
    别等到大四才慌。

案例三:家里有电网资源

👤:河北物理600分,家里亲戚在电力系统,想进国家电网,怎么选学校?

🤖:家里有电网的资源?那这条路就是通的!

    我跟你说,电气这个行业,资源是可以传代的。
    别人挤破头进不去的国家电网,你里面有熟人,那就不一样了。

    你这个分很舒服。冲的话——华北电力大学,保定校区或者
    北京校区都行。电力系统的黄埔军校,全国电网都认。

    稳的——东北电力大学、上海电力大学。都是原电力部直属,
    每年电网校招大户。选电气工程及其自动化,别选其他专业。

    保底——三峡大学。也是原电力部直属,分不高但就业好,
    年年电网来招人。

    但有一点你必须记住:资源是敲门砖,本事才是铁饭碗。
    进了大学好好学,别因为有关系就混日子。
    电网招人也要考试的,你专业不行照样进不去。

案例四:金融劝退

👤:河南560分,想学金融,怎么样?

🤖:停停停,你先别急着说金融。我问你几个问题。

    家里是做金融的吗?爸妈在银行、证券、基金公司?
    有没有亲戚在这个行业里?

👤:没有,就是觉得金融听起来高大上,能赚钱。

🤖:那我跟你说句实话——金融这个行业,千万别碰。

    你去看看每年金融专业毕业的学生,中位数去了哪?
    不是去了高盛中金,是去了你家门口的银行网点卖理财。

    560分在河南,大概率去个双非一本学金融。
    毕业出来跟985的抢岗位,你拿什么抢?

    金融是典型的看起来光鲜,进去才知道是坑。
    你看到的是年薪百万的基金经理,看不到的是90%的人
    在银行网点站着数钱。

    你这560分,我建议你学计算机或者电气工程。
    理工科选专业,文科选学校。学门手艺,不用求人。

案例五:专科也有出路

👤:我只考了380分,只能上专科了。是不是这辈子废了?

🤖:谁跟你说专科就废了?我告诉你,专科选对了专业,
    就业比很多普通本科还强。

    专科的关键是:必须选有技术壁垒的专业。

    第一,电力类专科。毕业进电网基层、电厂,稳定有保障。
    第二,铁路类专科。进铁路局,福利待遇不差。
    第三,医护类专科。护理、医学检验,医院永远缺人。

    千万别学市场营销、行政管理——本科都不好就业,
    你专科学了更完蛋。也别碰什么电子商务、物流管理,
    听着高大上,出来就是送快递。

    还有一条路——专升本想好了吗?有些省专升本政策好,
    你选学校的时候就要考虑到。专科不是终点,但你得选对路。

案例六:高分+有资源(多轮追问)

👤:河北物理类650分,位次1500名,家里在电力系统有亲戚,
    想去北京或者天津,能冲985吗?电气和计算机选哪个?

🤖:能冲985。但先确认几个关键——你家里在电力系统具体做什么?
    电网、发电还是设备?这关系到你能不能直接进系统。

👤:亲戚在国家电网做管理层的。物理数学都还行。

🤖:那这条路就是通的!家里有电网管理层的亲戚,
    你学电气就是最优解。别人挤破头进不去的国家电网,
    你里面有熟人,只要专业对口、考试过关,基本稳。

    计算机虽然热门,但你家资源用不上。何必放着现成的
    电网资源不用,去跟几百万人卷计算机?

    冲——天津大学,985,电气学科评估B+。
    稳——华北电力大学,电气王牌,全国电网都认。
    保——河北工业大学,211,电气在河北就业很吃香。

    记住,资源是敲门砖,本事才是铁饭碗。

案例七:低分求生存(多轮追问)

👤:河南文科430分,家在县城,爸妈打工没资源,
    不想离家太远,就想毕业能找个稳定工作,大专也行。

🤖:430分在河南确实不高,但大专选对了专业,就业不比本科差。
    先问几个关键的——讨厌什么科目?河南本省行不行?
    稳定工作是想考编还是学技术进企业?

👤:讨厌数学,河南本省就行。最好能考个编制那种。

🤖:方向很明确,三条路:

    第一条,护理。河南省内各大医院年年招护士。
    护理考编岗位多,很多县医院护士都有编制。

    第二条,学前教育。公办幼儿园招人越来越多,
    有寒暑假、不用跟数学打交道。

    第三条,铁道类专科。郑州铁路职业技术学院,
    毕业进郑州铁路局,铁饭碗。

    千万别学会计——你讨厌数学,学会计就是折磨自己。

案例八:新高考选科

👤:我高一,马上要选科了。以后想学医,该怎么选?

🤖:想学医,选科很简单——物理+化学+生物,纯理组合。
    这个组合能覆盖全国所有医学院的临床医学专业。

    如果你觉得生物太难,物理+化学+地理也可以。

    但千万别选历史——选了历史,临床医学基本跟你说再见了。

    另外提醒你:学医是条长路。5年本科+3年规培+3年专硕,
    11年起步。35岁以前基本挣不到什么钱。
    家里经济条件一般的话,要跟父母商量好。

    但如果你真的喜欢、能坚持,医生是个越老越吃香的职业。

案例九:考研方向

👤:本科普通二本计算机,想考研。冲985还是稳211?

🤖:先问你——考研是为了做科研,还是想要个名校文凭好找工作?

👤:想要个名校文凭好找工作。

🤖:那别盲目冲985。二本冲985计算机,难度太大了。
    你竞争对手是985本校生和211的卷王。

    我建议你稳211。选一个计算机学科评估B以上的211,
    比如合肥工业大学、西安电子科技大学。

    还有一个思路——考行业特色院校。
    比如南京邮电大学、杭州电子科技大学。
    不是211,但在IT行业认可度极高,华为中兴年年去校招。

    关键是:考研先定专业,再定地区,最后定学校。
    毕业在哪上学,大概率就在哪工作。

为什么选择它

对比维度 普通志愿工具 雪峰Agent
交互方式 输入分数→吐表格 先反问:家里干什么的?想去哪?讨厌什么?
推荐逻辑 只看分 分数 + 家庭资源 + 地域偏好 + 就业诉求
表达风格 冷冰冰 敢说真话,不适合的专业直接劝退
数据来源 不明 教育部评估+考试院公告+就业报告,全公开可查
模型兼容 绑定特定模型 DeepSeek/通义千问/GLM/GPT/Ollama 任意换
部署方式 需特定平台 一个 Python 脚本,Windows/Mac/Linux 都能跑

核心能力

① 意图识别 → 自动判断你是否在咨询志愿问题
② 结构化采集 → 省份+分数+兴趣+家庭资源+就业诉求,缺啥问啥
③ 冲稳保匹配 → 位次法 + 家庭资源禀赋 + 专业就业前景
④ 敢说真话 → 不适合你的专业直接告诉你
⑤ 实时搜索 → 最新政策、分数线变化自动查
⑥ 模型无关 → OpenAI 兼容协议,换模型改一行配置

快速开始

完全零基础、不懂编程?小白教程:10分钟,复制粘贴搞定

三步跑起来

# 1. 安装依赖
pip install openai pywin32

# 2. 配置 API Key
cp .env.example .env
# 用记事本打开 .env,填入 LLM_API_KEY=你的key

# 3. 运行
python agent.py

Windows 用户直接双击 启动.bat

模型选择

任何 OpenAI 兼容协议的模型都能用。但不同模型效果差异很大:

模型 推荐度 中文 指令遵循 速度 费用 说明
DeepSeek V3 首选 极好 ~1元/百万token 综合最佳
通义千问 Qwen-Plus 推荐 极好 ~2元/百万token 有免费额度
智谱 GLM-4 推荐 较强 ~1元/百万token 国产稳定
Moonshot v1 可选 较强 ~2元/百万token 128K长上下文
GPT-4o 可选 极强 较贵 需国外网络
Ollama 本地 可用 看模型 弱-中 看配置 免费 推荐 qwen2.5:14b+

不推荐

  • 7B 级别小模型 — 无法稳定遵循复杂指令,容易复读、格式错乱
  • DeepSeek R1 — 推理模型会自言自语,不适合对话场景

.env 里设置 LLM_PROVIDER 即可,不用记 base_url:

LLM_PROVIDER=deepseek   # DeepSeek(首选)
LLM_PROVIDER=qwen       # 通义千问
LLM_PROVIDER=glm        # 智谱 GLM
LLM_PROVIDER=moonshot   # Moonshot
LLM_PROVIDER=openai     # GPT-4o
LLM_PROVIDER=ollama     # 本地模型

完整配置说明 → TUTORIAL.md

完全零基础?小白教程:10分钟,复制粘贴就能用


技术架构

用户输入 → 意图检测 → 槽位提取 → LLM 推理 → 冲稳保输出
              │            │           │
              ▼            ▼           ▼
         知识库检索    实时搜索    OpenAI兼容API
         (17模块)    (最新数据)   (任意模型)
  • 模型无关:任何 OpenAI 兼容 API 都可以
  • 独立部署:一个 Python 文件,不依赖任何特定平台
  • 本地知识库:Markdown 格式,可随时修改扩充

⚠️ 重要免责声明

  1. 本工具仅供决策参考,不构成任何形式的专业志愿填报建议。
  2. AI 生成的内容可能存在错误、过时或不准确。最终志愿填报决定必须由用户本人根据官方发布的最新招生简章和录取数据做出。
  3. 项目开发者不对使用本工具产生的任何后果承担法律责任。高考志愿关系重大,请务必以官方数据为准。
  4. 录取分数线、招生计划等信息每年变化。请到目标院校官网和各省教育考试院官网核实。
  5. 本项目中所有知识均整理自教育部公开数据、高校公开信息、公开就业报告等公开来源,不包含任何受版权保护的未公开内容。
  6. 本项目与任何教育机构、招生机构、志愿填报服务机构无关。

我们的建议供你参考,官方数据才是决策依据。


项目结构

├── agent.py              # 主程序
├── knowledge_base.md     # 知识库(17模块,850+行)
├── system_prompt.md      # Agent 行为规则
├── README.md             # 本文件
├── TUTORIAL.md           # 零基础安装使用教程
├── LICENSE               # MIT 协议
├── .env.example          # 配置模板
├── .gitignore
├── 启动.bat              # Windows 一键启动
└── examples/
    └── demo_conversation.md  # 案例对话

贡献

欢迎提 Issue 和 PR:

  • Web 界面(Gradio/Streamlit)
  • 更多省份录取数据
  • 语音输入
  • 微信/Telegram Bot 接入

开源协议

MIT License — 自由使用、修改、分发。

About

AI 高考志愿顾问 — 会追问、会分析、敢说真话

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors