雪峰 Agent — AI 高考志愿顾问

不是套壳。内置 24 省官方录取数据库，真的会查数据、盘志愿。 v3 更新：支持用户自填Excel数据、综合两年排名、联网搜学校条件、填表即不查库

• 自定义数据表：项目自带 自定义数据.xlsx，填了学校的两年分数位次后，AI 只用你的数据分析，不查系统数据库
• 综合排名：2024+2025两年位次平均排序，等分冲/稳/保三档，两个年份分数位次全部展示
• 联网搜学校条件：填表后联网搜索自动转搜校园环境、宿舍食堂、王牌专业，不再搜分数线
• 容错设计：表格填写不规范自动纠正（700分→700、河南省→河南、分数位次反了自动换）
• 无表照旧：不填表时和以前完全一样，走系统数据库
• 多线程服务器：支持多人同时使用

方法论源自张雪峰八本志愿填报专著 + 61节专业视频课程（1500+分钟），把"张雪峰那套"塞进了AI。 浏览器打开即用，不需要命令行。

⚠️ 版权声明：本项目采用 AGPL v3 强传染性协议。Fork/修改/再发布必须保留原作者署名和仓库地址，继续使用 AGPLv3 开源全部源码。擅自改为 MIT 等宽松协议重新发布 = 侵权。原作者保留单独商业授权的权利。

Windows：

1. 装 Python（python.org，勾选 Add to PATH）
2. 下载本项目 ZIP → 解压到桌面
3. 双击 启动.bat → 浏览器自动打开
4. 点右上角 API设置 → 填 DeepSeek Key → 保存测试
5. 打字提问

Mac：

1. 装 Python（python.org）
2. 下载本项目 ZIP → 解压到桌面
3. 终端进入文件夹 → python3 server.py
4. 双击 打开我.html → 浏览器打开
5. 填 DeepSeek Key → 打字提问

📖 完全零基础？ → Windows 小白教程 | Mac 安装教程

浏览器打开后就是一个聊天窗口，跟微信用法一样：

• 左侧对话列表 — 多轮对话独立保存，新建/切换/删除，关了浏览器回来还在
• 顶部模式切换 — 报考（正经志愿分析）←→ 娱乐（张雪峰风格吐槽），一键切
• 右上角 API 设置 — 填 Key、换模型，浏览器本地记住，下次不用重填
• 🌓 深色模式 — 晚上用不刺眼
• 输入框 — 打字回车发送，Shift+回车换行

不是空壳AI。底层学完了张雪峰的核心方法论，才敢叫"雪峰Agent"：

一句话：把张雪峰那套志愿填报的逻辑和方法论，喂给了AI。

你: "浙江655分位次10500，想学计算机电子，不接受调剂"
         ↓
    AI 提取 → 省份:浙江  位次:10500  专业:计算机,电子
         ↓
    本地 DB 查询 → keyword=计算机,电子 → 只返回对口学校
         ↓
    联网搜索 → Tavily/Baidu 搜最新分数线、就业薪资、学校介绍
         ↓
    整合 → [DB数据 + 联网数据] → 发给 LLM
         ↓
    输出 → 冲稳保建议，每条标注数据来源（DB/联网）

🤖：你是浙江考生，专业+院校模式，可填80个志愿。

    冲（位次高于你，试试）：
    · 湖南大学 计算机科学与技术  662分/7354位 [DB]
    · 西北工业大学 电子信息类    658分/7351位 [DB]
    · 北京邮电大学 软件工程      658分/7449位 [DB]

    稳（位次匹配，有把握）：
    · 南京理工大学 计算机类      651分/10529位 [DB]
    · 河海大学 计算机类(大禹班)  654分/10586位 [DB]
    · 东北大学 软件工程(特色班)  651分/10637位 [DB]

    保（稳录）：
    · 深圳大学 电子信息工程      648分/13653位 [DB]
    · 华中师范大学 计算机类      648分/13680位 [DB]

每条数据标注 [DB]（本地数据库）或 [联网]（网上搜索），来源清楚。没数据的学校绝编。

24 省，42 万条，2024-2025 年

浙江 · 河北 · 山东 · 重庆 · 黑龙江 · 江苏 · 湖南 · 湖北 · 北京 · 天津 · 上海 · 广东 · 河南 · 福建 · 陕西 · 甘肃 · 青海 · 宁夏 · 江西 · 内蒙古 · 海南 · 山西 · 云南 · 安徽

数据来源：各省教育考试院官方投档线。经多轮联网交叉验证，分数 0 误差。首次运行自动解压（27.6 MB → 143 MB）。

任何 OpenAI 兼容 API 都能用。API 设置里改 Base URL 和 Model 即可。

├── server.py              # Web 服务器 + 完整 HTML 页面（主程序）
├── admission_clean.db.gz  # 录取数据库（首次运行自动解压）
├── 启动.bat               # Windows 一键启动
├── 打开我.html             # 浏览器入口（自动检测服务器状态）
├── rebuild_db.py          # 数据库重建脚本（从原始考试院 Excel 构建）
├── clean_data.py          # 数据库清洗脚本
├── 小白教程-零基础也能用.md
├── 提问模板-这样问最准.md
└── 更新说明.md

数据准不准？ — 来自各省考试院官方投档线，多轮联网交叉验证。但录取数据每年变，最终以官方为准。

怎么更新？ — 重新下载 ZIP 覆盖文件夹。

要钱吗？ — 个人使用完全免费。AI 调用按量计费（DeepSeek 聊几百次才几毛钱）。

支持手机吗？ — 目前支持 Windows 和 Mac 电脑。Mac 安装教程

能换别的 AI 吗？ — 能，API 设置里改。

1. 志愿填报是考生自己的事。本工具提供的数据、分析和建议仅供决策参考，不构成专业志愿填报指导意见。
2. AI 可能出错。大语言模型生成的内容可能存在事实性错误、过时信息或片面判断。请务必自行核实。
3. 数据已尽力但不敢保证。数据库来自各省教育考试院官方投档线，经多轮联网交叉验证，但录取数据每年变化，最终以各省教育考试院官网和学校官方招生网公布的当年数据为准。
4. 开发者不承担任何责任。使用本工具产生的任何志愿填报决策及其后果，由考生和家长自行承担。开发者不对因使用或依赖本工具信息而导致的任何损失负责。
5. 不要盲信任何工具。包括本工具在内，所有 AI 志愿填报辅助工具都只能作为参考。填报前请咨询学校老师、招生办等专业渠道。

关注获取最新更新、使用教程和志愿填报干货。

AGPL v3 — 强传染性开源协议

原作者（ziqihe10-droid / ziqihe10-droid）保留单独商业授权的权利。

完整协议文本：LICENSE · https://www.gnu.org/licenses/agpl-3.0.html