💡 欢迎加入 BJUT-SWIFT 组织！
如果你有兴趣参与项目维护、贡献资料或加入我们的团队，欢迎通过邮箱bjutswift.cn@gmail.com联系我们。
推荐使用本项目网页端进行文件检索与下载。
若要下载单个文件夹，将该文件夹网址复制到 DownGit 点击 download 即可下载。
感谢对本项目贡献的同学：
... 还有屏幕前的你。
by 项目发起人
毕业后才意识到其实这里一直疏忽了放一段给新生们的欢迎语，于是今天在这里添上：欢迎来到北京工业大学！
作为一名普通的大学生，这四年可以做的事情很多，但是你能做的事其实比你想的更多！
- 你可以学会提问，让自己收获更多助力自我发展的新鲜信息；
- 你可以学会求助，从校内外获取帮助远比你想的更触手可及；
- 你可以学会付出，被帮助的你向曾经的自己们伸出有力的手；
- 你可以学会自学，我们做的编程入门也许是个还不错的起点；
- 你可以试着寻路，像寻路之南一样去探索那只属于自己的路；
- 你可以...
（引自 浙江大学课程攻略共享计划 ）
来到一所大学，从第一次接触许多课，直到一门一门完成，这个过程中我们时常收集起许多资料和情报。
有些是需要在网上搜索的电子书，每次见到一门新课程，Google 一下教材名称，有的可以立即找到，有的却是要花费许多眼力；有些是历年试卷或者 A4 纸，前人精心收集制作，抱着能对他人有用的想法公开，却需要在各个群或者 CC98 中摸索以至于从学长手中代代相传；有些是上完一门课才恍然领悟的技巧，原来这门课重点如此，当初本可以更轻松地完成得更好……
我也曾很努力地收集各种课程资料，但到最后，某些重要信息的得到却往往依然是纯属偶然。这种状态时常令我感到后怕与不安。我也曾在课程结束后终于有了些许方法与总结，但这些想法无处诉说，最终只能把花费时间与精力才换来的经验耗散在了漫漫的遗忘之中。
我为这一年一年，这么多人孤军奋战的重复劳动感到不平。
我希望能够将这些隐晦的、不确定的、口口相传的资料和经验，变为公开的、易于获取的和大家能够共同完善、积累的共享资料。
我希望只要是前人走过的弯路，后人就不必再走。这是我的信念，也是我建立这个项目的原因。
你不需要会写代码，不需要本地部署，只需要一个 GitHub 账号。 提交 PR 后，CI 会自动构建和部署，你什么都不用管。
第 1 步：Fork 本项目
点击页面右上角的 Fork 按钮，将项目复制到你自己的 GitHub 账号下。
第 2 步：上传文件
在你 Fork 的仓库中，找到对应的课程文件夹（如 高等数学(工)/），点击 Add file → Upload files，把你的资料拖进去。
- 如果需要新建课程文件夹：点击 Add file → Create new file，在文件名处输入
课程名/.gitkeep，提交后就能在新文件夹里上传文件了。 - 文件格式推荐：PDF、Markdown、$\LaTeX$、docx（建议用 Markdown 代替 Word）
- 不收录老师的课件原件
第 3 步：提交 PR
回到本项目主页，点击 Pull requests → New pull request，选择你的 Fork 分支，提交即可。
合并后网站会自动更新，无需任何手动操作。🎉
更简单的方式：不想学 Fork/PR？直接在 Issues 里上传文件附件，说明是哪门课的资料，维护者会帮你添加。
📺 视频教程
B 站视频：3 分钟成为 GitHub 开源项目贡献者
- 欢迎：笔记、复习资料、历年试卷、选课攻略、课程评价
- 课程评价可以写在对应课程文件夹的
README.md中 - 命名建议：
届-专业-姓名.md（如24-信管-张三.md） - 有任何问题欢迎通过
bjutswift.cn@gmail.com联系我们
提示：GitHub 仓库界面按下快捷键
t，就能进入文件搜索模式，输入你想要寻找的文件名或者文件夹名，即可实时展示搜索结果
使用本项目网页端，找到并点击相应文件即可下载。
复制想下载的文件夹网址，粘贴入 DownGit 中，点击 Download 即可。
- 点击蓝色的 Code 部分
- 点击 Download ZIP 即可下载到本地
- （可选）
git clone本仓库以随时同步更新
🔧 开发者：本地部署指南
本地部署仅供项目维护者或想要预览修改效果的同学参考，普通贡献者不需要这一步。
# 1. 克隆项目
git clone https://github.com/bjut-swift/BJUT-Helper.git && cd BJUT-Helper
# 2. 安装依赖（需要 uv，也可用 conda/pip）
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync
# 3. 生成文档页面
uv run update.py
# 4. 启动本地预览
uv run mkdocs serveupdate.py 会扫描所有课程文件夹，自动生成对应的 Markdown 文档到 docs/ 目录。
欢迎贡献个人学习心得、复习笔记等内容，请使用者自行分辨这些内容的时效性和是否完整/正确。
再次重申，提交的内容推荐为 PDF、
资料来自网络，相关权利仍由原作者所有，本项目仅用于收集现有资料。
本项目不会为收集到的资料收费，或是尝试收取捐赠。
只是想尝试为后来的同学节省一些时间。
由于资料来源复杂，如果收录的资料侵犯了您的著作权，请发起 issue 或发邮件至 bjutswift.cn@gmail.com ，我们将立即停止使用您的资料。