Skip to content

Repository files navigation

UESTC Byte Lib

成电人的电子图书馆

期末周要找的不是教材,是学长学姐已经整理过的那份复习提纲。

www.iuestc.com


这是什么

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 · 由成电同学自己维护

About

UESTC Byte Lib

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages