# xuefeng-agent

**Repository Path**: q6200/xuefeng-agent

## Basic Information

- **Project Name**: xuefeng-agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-22
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 雪峰 Agent — AI 高考志愿顾问

> 不是套壳。内置 24 省官方录取数据库，真的会查数据、盘志愿。
> 方法论源自张雪峰八本志愿填报专著 + 61节专业视频课程（1500+分钟），把"张雪峰那套"塞进了AI。
> 浏览器打开即用，不需要命令行。

[![License: AGPLv3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)

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

<p align="center">
  <img src="demo-preview.gif" alt="演示" width="700">
</p>

---

## 5 分钟跑起来

**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 小白教程](小白教程-零基础也能用.md) | [Mac 安装教程](Mac安装教程.md)

---

## 界面

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

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

---

## 核心能力

| 功能 | 说明 |
|------|------|
| 🗄️ **本地数据库** | 24 省 × 2024-2025 年官方投档线，42 万条，位次精确匹配 |
| 🤖 **AI 智能提取** | 自动从你的描述中识别省份、位次、专业偏好（"一万三"→13000、"川籍"→四川） |
| 🎯 **专业过滤** | 说"要计算机"只推计算机相关。医学、法学、会计自动筛掉 |
| 🔍 **联网搜索** | 填了 Tavily Key 用 AI 搜索（更准）；不填用百度兜底 |
| 📋 **省份政策感知** | 浙江 80 志愿 / 山东 96 志愿 / 老高考 8-12 所…自动适配 |
| 💬 **上下文记忆** | 追问不用重复说，agent 记得你前面说过什么 |
| 🔒 **隐私安全** | 数据全在本地，Key 存浏览器，不上传任何服务器 |

---

## 知识体系

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

| 来源 | 体量 | 说明 |
|------|------|------|
| 志愿填报专著 | 8本 | 选专业/报志愿/稳就业/考研/专科/升学规划全覆盖 |
| 专业视频课程 | 61节 / 1500+分钟 | 全部学科门类专业详解 |
| 行业联盟分类 | 20+个 | C9/国防七子/五院四系/两电一邮等 |
| 知识库模块 | 17个 | 方法论/选科/专业/学校/考研/就业/专科/趋势 |

一句话：把张雪峰那套志愿填报的逻辑和方法论，喂给了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）。

---

## 支持哪些 AI？

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

| 模型 | 推荐 | 说明 |
|------|------|------|
| DeepSeek | ⭐首选 | 便宜好用，送免费额度 |
| 通义千问 | 推荐 | 有免费额度 |
| 智谱 GLM | 推荐 | 国产稳定 |
| GPT-4o | 可选 | 贵，需网络 |

---

## 项目结构

```
├── 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 安装教程](Mac安装教程.md)

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

---

## ⚠️ 免责声明

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

---

## 📱 作者抖音

| | |
|------|------|
| 抖音名 | **OLO** |
| 抖音号 | `27608595542` |
| 主页链接 | [douyin.com/user/OLO](https://www.douyin.com/user/MS4wLjABAAAAefIKNArplrWG6MWFKtPgqruFujYdBPa-Izh6j_b3je8383KNNs-AAxWDFqYQrC0L) |

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

---

## 开源协议

**AGPL v3 — 强传染性开源协议**

| 使用场景 | 是否允许 |
|----------|---------|
| 个人学习、研究、非商业使用 | ✅ 完全免费 |
| 修改后自己用（不发布） | ✅ 允许 |
| Fork 后重新开源 | ⚠️ 必须保留原作者署名 + 仓库地址 + 继续使用 AGPLv3 + 完整公开所有修改 |
| 通过网络提供服务（SaaS/网站） | ⚠️ 必须完整公开全部源码（含修改） |
| **商业使用 / 闭源商用** | ❌ **禁止** |
| **删除原作者署名 / 宣称原创** | ❌ **侵权，无论是否商业使用** |
| **改为 MIT 等宽松协议重新发布** | ❌ **违反 AGPLv3 传染性条款** |

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

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