Skip to content

Huaji-tye2007/NJUxkHelper-dev

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

南京大学选课小助手

项目简介

南京大学选课小助手是一款专为南京大学学生设计的浏览器扩展程序,旨在为同学们提供更加便捷的选课体验。通过集成历年课程评价信息,帮助学生更好地了解课程和教师情况,做出明智的选课决策。

主要功能

1. 按课程查询红黑榜:帮助同学查找最适合自己的课程

  • 评论栏:当前课程的教师评论信息
  • 相关评论栏:其他教师的相同或相似课程评论

2. 按教师查询:更加全面地了解教师的上课风格和教学特点

  • 教师评论:显示当前教师的所有课程评论
  • 相关课程:该教师的其他授课课程评论

3. 收藏功能:便于管理心仪的课程

  • 一键收藏:点击面板右上角⭐按钮即可收藏心仪课程
  • 收藏夹管理:统一管理所有收藏的课程信息
  • 拖拽调整位置:可自由拖拽收藏夹位置,方便查看
  • 随时管理: 收藏夹不受选课开放时间影响,随时随地都可以管理收藏夹

使用指南

  1. 访问选课网站

    • 登录南京大学选课系统
  2. 查看课程信息

    • 在课程列表中,点击课程名称或教师名称
    • 自动弹出信息面板显示相关评价
  3. 切换查看模式

    • 评论标签:查看当前选择的课程/教师评论
    • 相关评论标签:查看相关课程或该教师的其他课程评论
  4. 收藏管理

    • 点击面板右上角⭐按钮收藏课程
    • 收藏夹面板会自动显示在页面右上角
    • 可拖拽调整收藏夹位置

项目结构

NJUxkHelper/
├── manifest.json          # 扩展程序清单文件
├── LICENSE                # 许可证文件(发布时不包含)
├── popup.html              # 扩展程序弹出页面
├── PRIVACY.md             # 隐私政策文件(发布时不包含)
├── css/                   # 样式文件夹
│   ├── common.css         # 通用样式
│   ├── favorites.css      # 收藏功能样式
│   └── panel.css         # 信息面板样式
├── js/                   # JavaScript文件
│   ├── content-script.js # 内容脚本
│   ├── dataStore.js      # 数据存储模块
│   ├── favorites.js      # 收藏功能模块
│   └── panel-inject.js   # 面板注入脚本
├── data/                 # 原始数据文件(发布时不包含)
│   ├── 2020.json
│   ├── 2021.json
│   ├── 2023.json
│   ├── 2024.json
│   ├── 2024_new.json
│   └── 2025.json
├── normalized_data/      # 标准化数据文件
│   └── 2020.json
│   └── 2021.json
│   └── 2023.json
│   └── 2024.json
│   └── 2024_new.json
│   └── 2025.json
├── README.md              # 项目说明(发布时不包含)
├── icons/               # 图标文件
└── test/                # 测试文件(发布时不包含)
    └── Dockerfile
    └── index.html 
    └── package-lock.json
    └── package.json  
    └── run_test.js  
    └── serve_only.js

环境要求

  • Chrome浏览器 88+ 或其他Chromium内核浏览器
  • 支持Manifest V3的浏览器扩展环境

数据来源

本扩展使用的课程评价数据来源于:

贡献与测试

欢迎为项目贡献代码!

可以使用我提供的docker测试文件进行本地测试。使用方法如下:

在项目根目录下构建镜像并运行

docker build -f test/Dockerfile -t njuxkhelper-test .
docker run --rm -v "$PWD":/app -p 8000:8000 njuxk-test node serve_only.js

然后在本地浏览器打开http://localhost:8000/test/index.html即可。

联系方式

致谢

  • 感谢南京大学提供的选课平台
  • 感谢所有使用本扩展的同学们

免责声明

本扩展程序仅供学习交流使用,课程评价信息仅作参考。学生应根据自身情况和兴趣进行选课决策。扩展程序不对课程质量或教学效果承担任何责任,也不包含任何自动化选课功能。

许可证

本项目采用 MIT 许可证,详见 LICENSE 文件。


本扩展目前由作者独立开发,难免存在考虑不周或不尽如人意之处,敬请理解。也诚挚欢迎各位同学在项目 Issue 区提出宝贵建议,与我一同打磨细节,让南京大学的选课体验不断优化、日益完善。 如果觉得这个项目有帮助,请给个⭐Star支持一下!

About

针对南京大学选课网站制作的简单选课插件,支持查看相关课程与教师评价。

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors