UESTC Byte Lib 是一个由同学自己维护的期末复习文档库。
电子科大的复习资料一直散在群文件、网盘链接和私聊记录里,找的时候全靠运气,找到了也不知道是哪一年的版本。我们把这些材料集中写进一个开源的飞书知识库,再用这个站点当门面:打开首页就能按学院翻,翻到就能读。
文档本体仍然长在飞书云文档里——可以协同编辑、可以评论、可以看修订记录;站点负责把它们排好、标清楚、让人找得到。
| 学院 / 分类 | 文档 |
|---|---|
| 医学院 | 34 |
| 计算机学院 | 24 |
| 公共必修课 | 9 |
| 软件学院 | 6 |
| 格拉斯哥 | 4 |
| 生命学院 | 3 |
| Others(转专业 / 就业) | 3 |
| 电子 & 集电 | 2 |
| 光电学院 | 2 |
| 经管学院 | 2 |
| 自动化学院 | 1 |
| 信通学院 | 1 |
合计 12 个分类、91 篇文档、约 160 万字,累计被读了 43 万次,来自 23 万人次的访问。
这些数字随站点构建自动刷新,上表是最近一次同步(2026-09-02)的结果。
按学院翻。 首页是一排横移的学院卡片,当前学院居中展开,左右两侧露出相邻学院的边缘。滚轮、触控板、方向键、拖拽都能翻,卡片上直接列出这个学院最热的几篇文档。
一键搜全站。 任何页面按 ⌘K(Windows 上是 Ctrl+K),或者直接敲 /,输入课名就能跳到对应文档,拼音首字母和英文课名也能搜到。
先判断值不值得点开。 每张文档卡片会标出篇幅(几万字还是几千字)、多少人读过、拿了多少赞。只建了标题、正文还没写的页面会诚实地标成「占位页」,不会让你白点一次。
把一门课直接甩给同学。 学院页、单篇文档的高亮链接都有独立网址,复制粘贴就能分享,对方打开时那篇文档会自动滚到屏幕中间并高亮。
看看别人家的站。 友情链接页收录同类的学生开源项目,也写清楚了怎么申请交换友链。
| 操作 | 效果 |
|---|---|
| 滚轮 / 触控板 / 拖拽 | 在首页切换学院 |
← → ↑ ↓ |
切换学院 |
1–9 |
直接跳到第 n 个学院 |
Home / End |
跳到第一个 / 最后一个学院 |
Enter / Space |
进入当前学院 |
Esc |
从学院页返回首页 |
⌘K / Ctrl+K / / |
打开全站搜索 |
| 地址 | 内容 |
|---|---|
/ |
首页,学院卡片舞台 |
/c/all |
全部馆藏摊开看 |
/c/<学院> |
单个学院的文档列表 |
/c/<学院>?focus=<文档> |
学院列表,并高亮某篇文档 |
/friends |
友情链接与申请方式 |
<学院> 就是学院的英文短名,例如 cs、medicine、software、general。
写文档——这是最需要人的部分。编辑组是一群来自各个学院的开源爱好者,想少一点「闭门造车」的复习方式。如果你手里有整理好的笔记,或者愿意花时间把一门课的提纲补完,在飞书上联系 zbwer 就能加入。你在飞书知识库里新建的页面,站点下次构建就会自己收进来。
顺手改一处——在飞书文档里直接留评论、补一段、订正一个公式,都算。
交换友链——如果你也在做面向大学生的开源站点,去 /friends 看申请方式,准备好站名、网址、一句话简介和 Logo 就行。
改站点本身——欢迎 issue 和 PR,本地跑起来只要两行命令,见下。
需要 Node.js 22 和 pnpm。
pnpm install
pnpm dev打开 http://localhost:3000 就是完整的站点。
课程目录来自飞书知识空间 UESTC Byte Lib,由 pnpm sync:wiki 写入 lib/data/catalog.json,每次 pnpm build 都会先跑一遍。没有飞书凭证时会沿用仓库里已提交的目录,不会卡住构建;要在构建时真的刷新,配置 FEISHU_APP_ID + FEISHU_APP_SECRET(或 FEISHU_TENANT_ACCESS_TOKEN)。
其它命令:
pnpm sync:wiki # 从飞书知识空间刷新课程目录
pnpm build # 先同步目录,再生产构建
pnpm typecheck # tsc --noEmit
pnpm lint # eslint
pnpm format # prettier --write站点是 Next.js 16 App Router + React 19 + Tailwind CSS v4,UI 用 shadcn/ui(底层 Base UI),部署在 Vercel。唯一的服务端代码是两个取头像和站点图标的代理,挂了也只会让图标退化成字母图章。更细的目录结构和数据约定写在 AGENTS.md 和 lib/data/types.ts 里。
© 2023 UESTC Byte Lib · 由成电同学自己维护
