🦖 CourseRaptor

把教务琐事交给小恐龙，把时间留给大学生活。

南京工业大学学生的开源教务 AI 助手 · Web / CLI / 可选 QQ

简体中文 · English

🚀 开始体验 · ✨ 看看能做什么 · 📖 使用指南 · 💬 交流想法 · 🐛 反馈问题

早八在哪栋楼？通识修了哪些类别？考试改时间了吗？通知附件里有没有我需要看的内容？

不用再从一个菜单翻到另一个菜单。打开 CourseRaptor，直接问。

CourseRaptor 把课表、成绩、考试、教务通知和日历导出放进同一个对话窗口。你负责说清楚想知道什么，小恐龙负责调用工具查数据、整理结果。

目前适配南京工业大学，适合个人电脑自用。 这是非官方开源项目；正式查询需要自己的教务账号和 DeepSeek API Key，模型 API 可能产生费用。先运行离线演示，无需填写任何凭证。

✨ 你的问题，小恐龙来接

• 🧠 跨会话记忆：记录偏好与事实，减少重复说明。
• 🌤️ 天气查询：查看天气、降水与穿衣建议。
• 💬 QQ 接入：使用腾讯官方机器人接口；共用本机教务身份，适合个人使用。
• 🔎 选课信息查询：搜索课程、对比教学班与余量；真实选课提交默认关闭。

全部工具、适用范围与限制见能力参考。

🎬 先看一眼

_{真实网页界面，虚构演示数据。宣传插画与产品界面分别展示。}

下面是示例对话，不代表真实查询结果。

你：这周课表，按天整理地点和时间。
小恐龙：周一 1–2 节，示例高等数学，示例教学楼 101……

你：我的通识修了哪些类别？
小恐龙：先按已通过课程汇总。未通过和待出分课程不计已获学分。
        类别覆盖和最低学分，还要对照你的年级与专业培养方案。

你：把课表和考试导出到手机日历。
小恐龙：正式模式会生成 .ics 文件，在网页中下载后即可导入。

🚀 先体验，再登录

01 / 三条命令，认识小恐龙

先安装 Node.js 24 或更高版本，下载仓库并解压，在项目目录打开终端：

npm ci
npm run doctor
npm run demo

打开终端显示的地址，默认 http://127.0.0.1:3211。点击常用问题即可体验。

免教务账号 · 免 API Key · 不调用 AI · 全部虚构数据。 演示使用固定示例回答，不代表实时查询效果；会话只保留在内存，重启清空。Ctrl+C 退出。

git clone https://github.com/Health-525/courseraptor.git
cd courseraptor
npm ci
npm run demo

02 / 配置自己的账号，开始正式使用

Windows： 双击完整项目里的 start.bat，按提示配置。

已经安装依赖，或使用 macOS / Linux：

npm start

1. 输入自己的教务学号和密码，登录验证后加密保存在本机。
2. 按隐藏输入提示填写 DeepSeek API Key；需要更换时，在终端输入无参数 /key。
3. 在终端对话，或打开启动界面显示的网页地址，通常是 http://localhost:3210。

保持终端运行即可。一般无需编辑 .env；遇到问题先看同学使用指南，进阶选项看配置参考。

🧭 下一站，由真实需求决定

现有能力继续打磨，下面这些是规划方向，尚未实现：

查看详细路线图 →　说说你最想要的功能 →

🔐 好用，也把边界说清楚

分享仓库地址或维护者检查过的干净安装包，让每位同学配置自己的账号。请勿转发已经使用过的整个项目目录。 数据去向、使用边界与安全报告方式见 SECURITY.md。

🛠️ 给想一起做点东西的你

你的问题
   ↓
Web / CLI / QQ
   ↓
Vercel AI SDK Agent + DeepSeek
   ↓
教务查询 · 通知附件 · 成绩计算 · 日历 / 文档

学校接口放在 src/jwgl/，工具参数在 src/tools/，成绩概览采用可独立测试的纯计算，正式网页与演示复用 src/web/chat-page.ts。

npm run typecheck
npm run lint
npm test

贡献指南 · 完整能力 · 维护与分发 · 推广素材包

💚 让更多同学遇见小恐龙