北京科技大学（USTB）开源项目及资料导航站
欢迎来到 USTB-All-In-One！这里集中整理了北京科技大学校友们开源的 GitHub 实用工具、校园服务脚本、学习资料、同好社群 以及 校内外常用站点。
本项目是基于 VitePress 搭建的静态导航站，所有数据都是纯文本 Markdown，零门槛即可参与贡献！
🎉 点击这里访问导航站 🎉
五个页面（首页 + 四个分区页），四页共享同一套 UI 骨架（顶部跳转条 + 右侧 sidebar 锚点导航 + 同样的卡片与分区组件）：
| 页面 | 路径 | 收录内容 |
|---|---|---|
| 🏠 首页 | / |
Hero 展示；四个分区入口统一位于顶部菜单栏 |
| 🏫 学校官方网站 | /official |
教务 / 图书馆 / 网络教学 / 学院 / 实验室 / 学生事务 / IT / AI 等官方服务 |
| 🛠️ 开源工具 | /tools |
抢课、校园网、平安报、AI 等校友开源 GitHub 项目 |
| 📚 学习资料 | /materials |
课程合集、LaTeX 模板、复习宝典、实验报告等 |
| 👥 同好社群 | /communities |
北科兴趣交流 QQ 群头像、群号与一键加群入口 |
USTB 自建校以来人才辈出，许多校友留下了大量宝藏项目。但它们散落在 GitHub 的各个角落难以检索。 USTB-All-In-One 把它们集中归类、统一展示，方便所有北科学子采撷使用、前人栽树后人乘凉！
发现了好用的工具 / 资料？写了一键脚本？整理了期末复习宝典？通通欢迎提交 PR！
整个仓库不依赖数据库，主要内容由 5 个 Markdown 页面维护；QQ 群列表单独保存在
docs/.vitepress/data/qqGroups.js。四个分区页使用同一套 UI（顶部跳转条 + 右侧 sidebar 锚点导航 + 卡片/分区组件），保持视觉一致。
USTB-All-In-One/
├── docs/ # 📦 VitePress 站点根目录
│ ├── index.md # 首页（Hero 展示，分区入口位于顶部菜单栏）
│ ├── official.md # 🏫 学校官方网站（按章节维护 SiteCard）
│ ├── tools.md # 🛠️ 开源工具（GitHub 项目）
│ ├── materials.md # 📚 学习资料（GitHub 项目）
│ ├── communities.md # 👥 同好社群（QQ群列表）
│ ├── CNAME # GitHub Pages 域名
│ └── .vitepress/
│ ├── config.mjs # VitePress 站点配置（导航 / 侧边栏 / logo）
│ ├── data/qqGroups.js # QQ 群号与官方加群链接
│ └── theme/ # 🎨 自定义主题
│ ├── index.js # 主题入口（注册全局组件）
│ ├── style.css # 卡片样式（3/2/1 列响应式）
│ └── components/
│ ├── SiteCard.vue # 站点卡片（图标 + 标题 + 简介；图标三级 fallback）
│ ├── QqGroupCard.vue # QQ 群卡片（群头像 + 群号 + 加群入口）
│ ├── SiteGrid.vue # 卡片网格容器（响应式）
│ └── SiteSection.vue # 章节块（仅副标题，由 markdown ## 提供主标题）
└── docs/
└── public/
├── icon/ # 🖼️ 站点图标（icon_p / monochrome_p / original_p / ustb 默认）
└── img/ # 🖼️ 卡片本地图标素材（由 <SiteCard icon="/img/..."> 引用）
├── Dockerfile # 多阶段 Docker 构建（node:20-alpine → nginx:1.27-alpine）
├── docker-compose.yml # docker compose 配置（含 healthcheck / 资源限制）
├── docker/
│ └── nginx.conf # nginx 配置（SPA fallback / gzip / 不可变缓存）
├── package.json # npm scripts（dev / build / preview）
└── README.md
点击仓库右上角 Fork 按钮：Fork USTB-All-In-One。
根据你要添加的内容，打开对应的 Markdown 文件，新增一段 SiteCard：
| 想添加什么 | 编辑哪个文件 | 插入位置 |
|---|---|---|
| 新的官方站点 | docs/official.md |
对应章节的 <SiteSection>…</SiteSection> 块内 |
| 新的开源工具 | docs/tools.md |
对应章节的 <SiteSection>…</SiteSection> 块内 |
| 新的学习资料 | docs/materials.md |
对应章节的 <SiteSection>…</SiteSection> 块内 |
| 新的同好社群 | docs/.vitepress/data/qqGroups.js |
在数组中添加群号与 QQ 官方加群链接 |
四个分区页顶部共享同一套跳转条与右侧 sidebar 锚点导航，UI 完全一致。如果你想新增一个全新章节，在对应 Markdown 文件中按下面的模板新增一段即可（不需要改任何 Vue 组件或 CSS）：
## 🌟 新章节标题 {#分区-anchor}
<SiteSection subtitle="共 N 个">
<SiteCard title="项目名" url="https://github.com/xxx/yyy" desc="一句话简介" />
</SiteSection>说明：
<SiteSection>不会重复渲染标题。Markdown 的##是唯一的章节标题，subtitle仅在标题下方显示一条灰色副文本（如条目数）。{#分区-anchor}给出右侧 sidebar 可跳转的稳定锚点。
在你的仓库中点击 Pull requests → New pull request，目标分支一般为 dev 或 main。
⚠️ 提交 PR 前，请确保你的 Fork 已是最新版本（点击自己仓库的Sync fork按钮同步）。
<SiteCard
title="项目标题" <!-- 必填：卡片主标题 -->
url="https://..." <!-- 必填：点击跳转的链接 -->
desc="一句话简介" <!-- 可选：单行说明 -->
icon="/img/xxx.png" <!-- 可选：本地图标路径（docs/public/img/ 下的文件） -->
badge="推荐" <!-- 可选：右上角小徽标 -->
/>iconprop（手动指定）→ 例如icon="/img/edaee93f024d164ba6c29fe77ba1463b.png"- 远程 favicon（自动从
url提取 host，调用favicon.im获取）→ 例如https://favicon.im/www.ustb.edu.cn - 默认 ustb.png（
docs/public/icon/ustb.png，前两级都加载失败时兜底）
- 把图片放到
docs/public/img/（项目根目录的 img/ 在 build 时不会被打包，必须是 docs/public/img/） - 在对应
<SiteCard>上加icon="/img/文件名"，例如：
<SiteCard title="就业服务" url="https://job.ustb.edu.cn/" icon="/img/edaee93f024d164ba6c29fe77ba1463b.png" />图标素材源：北京科技大学融合门户 i.ustb.edu.cn/home/app-list。
| 位置 | 文件 |
|---|---|
| 浏览器标签页 / 书签 icon | docs/public/icon/icon_p.png（去背景版） |
| 白天模式 Logo | docs/public/icon/original_p.png（去背景版） |
| 黑夜模式 Logo | docs/public/icon/monochrome_p.png（去背景版） |
| 卡片图标兜底 | docs/public/icon/ustb.png |
# 1. 克隆代码
git clone https://github.com/LYOfficial/USTB-All-In-One.git
cd USTB-All-In-One
# 2. 安装依赖
npm install
# 3. 启动本地开发服务器（默认 http://localhost:5173）
npm run docs:dev
# 4. 构建生产产物到 docs/.vitepress/dist/
npm run docs:build
# 5. 本地预览构建产物（默认 http://localhost:2000）
npm run start主题开发：自定义主题源码全部在 docs/.vitepress/theme/ 下，包含 3 个 Vue 组件和 1 个 CSS 文件。VitePress 的扩展点参见官方文档。
无需在本地安装 Node.js：
# 1. 启动容器（默认监听宿主 2000 端口）
docker compose up -d
# 2. 自定义宿主机端口
USTB_PORT=8080 docker compose up -d
# 3. 查看状态 / 日志
docker compose ps
docker compose logs -f ustb-site
# 4. 停止
docker compose down或直接 docker build + docker run：
docker build -t ustb-all-in-one .
docker run -d --name ustb-all-in-one -p 2000:80 ustb-all-in-one镜像基于 nginx:1.27-alpine，构建阶段使用 node:20-alpine，最终产物仅约 40 MB，包含 healthcheck、资源限制与 CNAME 热更新。详见 Dockerfile 与 docker-compose.yml。
- VitePress 1.6：静态站点生成、Markdown 渲染、Vue 3 组件支持
- Vue 3：自定义卡片组件（
SiteCard/SiteGrid/SiteSection） - nginx 1.27：生产环境部署
- Docker：多阶段镜像构建
感谢每一位为本项目添砖加瓦的校友！
如果觉得本项目对你有帮助，请不要吝啬右上角的 ⭐ Star，你的支持是我们持续整理的动力！