CONTRIBUTING.md

致每一位潜在开源贡献者

很高兴like-minded的同学加入，愿开源精神在SCUT发扬。

上传资料注意先检索是否有此学科再考虑是否创建文件夹，如果有，一定比较现有资料和你所拥有资料是否重复，我们CSer不要把资料变成包打听资料那么混乱哦！

参与开源方法一，不clone到本地，云端进行操作，适合微量资料上传的同学：

📂 场景一：在仓库根目录（主页）添加文件

这是最常用的方式，文件会添加到仓库的根目录下。 路径：进入你 Fork 的仓库主页 → 点击 Add file 下拉菜单 → 选择 Upload files 或 Create new file 操作：

1. Upload files：拖拽或选择本地文件直接上传。
2. Create new file：在线编辑并创建一个新文件（适合纯文本类，如 README.md）。

---

📁 场景二：在子目录内部添加文件

如果你想把文件上传到某个已有的子文件夹（例如 SCUT_CS/操作系统/），可以在该目录内操作。

路径：

1. 进入你 Fork 的仓库，点击进入目标子目录（例如 SCUT_CS/）。
2. 继续点击进入更深的子目录（例如 操作系统/）。
3. 在页面右上角，找到 Add file 下拉菜单，选择 Upload files。

效果：上传的文件会直接保存在当前所在目录下，路径会自动匹配。

💡 小提示：如果你没有在子目录中找到 Add file 按钮，也可以回到仓库根目录上传，然后在 Commit message 中手动指定路径（例如 SCUT_CS/操作系统/文件名），效果是一样的。

---

📁 场景三：大量资料上传

fork并clone本地，再在本地进行调整，适合批量上传，删除的同学使用

项目开发阶段概览

一期仓库初期规模5.73G，最终在12.9G时发觉现有方式难以满足需求，进行迭代。此期内容为1-4学期，此阶段加密采用统一字符，并未开源上机考试，并未涵盖高度复习笔记

⚠目前二期仓库规模约12G，删减了大量第一学期无用冗余资源及其他已开源仓库重复代码，增加第五学期课程资料，合并通选课目录避免视图冗杂，并采用对称加密，进一步缩减加密范围内容。

预计第三期仓库整个规模大致会在15G左右，阶段性要求如下：(ai过于迅猛，高级目标本来是作为社团开发项目的demo,现在看来毫无意义，删去)

• 🟢 最低目标：将每一门课拓展出一个readme.md文件，包括三部分（可置空）：

  • 课程考察制度
  • 相关老师评价
  • 课程备考建议

• 🟡 中等目标：完善通选课部分，将包打听的锐评xlsx进行情感分析（NLP）、不稳定性排除，经过数据处理加权给分情况、考勤情况、热度等，结合各年级的学科树，做一个SCUT通选课智能推荐系统，单列于SCUT_CS，作为第三期仓库子系统。例如做一个纯前端页面，通过加载处理好的 data.json 实现筛选和搜索，部署在 GitHub Pages。（如果数据不足或难以收集，将采用问卷形式，做一个CS选修课智能推荐系统）

• 🔴 高等目标：利用现有仓库资源，做一个基于此的RAG agent及skill市场

📅什么？你说不知道如何在Github提交PR？在Fork后的个人界面不知如何操作？教程：