XMUHub · 学生资料共享平台
同学们按课程整理、分享往年试卷、笔记、课件和题库的网站。上游站点是 鹭岛书阁（学生自发的非官方学习交流项目，与任何学校及其官方机构无关）。
代码完全开源，任何学校都可以 fork 一份部署给自己学校，并且随时同步这里的更新。
功能
找资料
登录后可使用分类、搜索、预览和免费下载；未登录只展示首页，登录 / 注册、使用须知和隐私政策保持开放。
- 按课程浏览：公共课、专业课、教材参考书、工具模板四大栏目，下面按学院 / 课程分类，还能按本科 / 研究生、学期、资料类型（真题、笔记、题库、课件）、适用专业筛选。
- 搜索：课程名、课程代号、拼音全拼和首字母都能搜（
wjf → 微积分，gdsx → 高等数学），可以只在某个学院或课程里搜，结果多时可以直接跳到第几页。
- 在线预览：PDF、Word、PPT、Excel、图片、音视频、文本代码、电子书，以及压缩包里的文件，不用下载就能看；课程列表里直接点「预览」。
- 免费下载：文件从国内加速镜像直接下载，大文件自动分卷、自动合并并校验完整性；支持勾选多份批量下载。
- 合集：一套连续的资料（第 1–12 讲、历年期末）合成一行，资料页显示「第 3 / 12 份」和上一份 / 下一份，可以一键下载整个合集。
- 求资料：找不到的资料可以发帖求助，别人回复指向站内资料，同样需要的人点「我也要」。
- 收藏夹、关注和提醒：把资料收进自己的收藏夹（可以申请公开分享）；关注课程或学院，有新资料时站内提醒。
- 评分和留言：给资料打分，留下哪几页最有用、答案有没有错之类的建议。
- 站外资源：大家推荐的其他资料仓库、网盘合集。
- 统计：全站和各课程的资料数量、下载量。
分享资料
- 批量上传：一次拖入多个文件，按原文件名自动识别课程、学年、学期、卷别、类型、是否含答案，系统生成规范的文件名；传错课程时会提醒。
- 放进合集：上传时就可以把一套资料建成合集（写上来源、年份），审核员一次审完。
- 断点续传和秒传：刷新页面后能接着传，别人传过的相同文件秒传。
- 不知道放哪：放进「待整理」，交给审核员归类。
- 改错和申请删除：上传者可以修改自己的资料，改备注或删除时提交申请。
管理和审核
- 先审后发：新同学的上传由审核员通过后公开；可信贡献者先发后审；审核员自己提交的内容也要由另一位审核员审核，管理员免审。
- 分批审核：审核员每次领一批、互不重复；拿不准的可以留给别人或「问上传者」。
- 改课程、整理分类树、处理投诉和反馈、全站公告。
- 一键封禁并清理：对恶意账号一次性封号，并撤下他发布的所有内容。
- 资料永不真正删除：驳回、下架只改状态，随时可以恢复。
账号和接入
- 任何邮箱都能注册，学校邮箱显示认证标记；非常用邮箱注册需要人机验证。
- AI 助手接入（MCP）：在「我的」页面创建个人令牌，Claude、Cursor 等 AI 助手就能帮你搜资料、下载、上传，网页上能做的它都能做；同一个令牌也可以调用 REST API。
部署一份给自己的学校
- Fork 本仓库，
git remote add upstream https://github.com/vintcessun/XMUHub.git；
cp -r site/example site/<你的站>，在 site.json 里填上站名、学校、域名，再放上自己的 Logo 和背景图；cp -r .secrets.example .secrets，填好服务器地址和密钥；pwsh scripts/sync.ps1 一键编译部署；- 以后同步上游：
git fetch upstream && git merge upstream/main，再运行一次 sync.ps1。
你只改自己的 site/<你的站>/ 和 .secrets/，所以同步上游不会冲突。完整步骤见 docs/fork.md，站点配置的每一项见 site/README.md。
参与开发
许可证
GNU AGPL-3.0。如果你修改后以网站形式对外提供服务，需要向使用者公开修改后的源代码。
