用途:面向中国高考志愿填报场景,结合张雪峰方法论(8本书+61门视频课程)与24省42万+条2024-2025年官方录取数据,通过多轮对话自动提取考生省份、位次、专业偏好等信息,查询本地数据库并联网补充最新数据,输出冲/稳/保院校推荐。
主要能力:多轮对话与上下文记忆;按计算机、医学、法学等专业关键词过滤;集成Tavily AI搜索或百度兜底;浏览器界面含对话历史与深色模式;推荐结果标注数据来源([DB]或[联网]);内置17个知识模块(方法论、选科规则、专业解析、学校联盟、考研趋势、就业数据、专科策略、城市选择等)。
使用方式:需Python 3.10+。安装命令:git clone https://github.com/ziqihe10-droid/xuefeng-agent.git;cd xuefeng-agent;pip install flask==2.3.3 openai==1.3.5 tavily-python==0.3.0。首次运行自动解压admission_clean.db.gz(27.6MB)为admission_clean.db(143MB)。Windows双击启动.bat或运行python server.py;macOS/Linux运行python server.py,服务启动于http://localhost:5000并自动打开浏览器。API设置存于浏览器localStorage,可配置apiKey、baseUrl、model、tavilyKey;也可用环境变量OPENAI_API_KEY、OPENAI_BASE_URL、TAVILY_API_KEY。核心接口为POST /chat与GET /conversations。
适用场景:高考志愿咨询、按位次与专业方向筛选院校、多轮追问式填报建议、程序化集成调用。
限制:需自备OpenAI兼容API密钥;数据库覆盖24省2024-2025年数据,其他省份或年份暂未提供;百度兜底搜索可能返回广告或无关内容;位次提取可能出错(如“一万三”误识别为13);AGPL v3许可,个人与教育用途免费,商业使用需另行授权,不得移除署名。