协会日历

协会日历是 NBTCA 以 iCalendar（ICS）格式发布的日历订阅源，部署在 ical.nbtca.space，提供协会活动和校历两份日程。源码在 calendar 仓库，读取这些数据的 TypeScript 库是 nbtcal。

技术: Cloudflare Worker · ICS
线上: ical.nbtca.space
始于: 2024 年
维护: wen-templari

使用方	读取的地址
协会主页的日历页	根路径 `/`，与 `/events.ics` 内容相同
命令行工具 Prompt	根路径 `/`，经 nbtcal 读取
群机器人 HuaJiBot.NET 的日程提醒	`/events.ics`，每 15 分钟同步一次
状态页 heartbeat	根路径 `/`，每 5 分钟检查一次是否在线

calendar 仓库

一个没有运行时依赖的 Cloudflare Worker，代码在 src/index.js：

活动源：代理协会在 Google 日历上维护的公开日历。上游超时、出错或返回的不是日历时，改为返回上一次成功取到的内容，并在响应头里标上 X-Calendar-Stale: 1；
校历：从 data/school/ 下按学年划分的 YAML 文件生成，目前覆盖 2022–2023 至 2026–2027 五个学年、共 85 个事件，构建时生成 dist/school.ics。

bash

git clone https://github.com/nbtca/calendar.git
cd calendar
pnpm install
pnpm check
pnpm dev

pnpm check 会重新生成校历并跑测试，PR 上的 CI 跑的也是它。部署是手动的：先部署预览版、核对每个地址，再替换线上版本。

新学年校历发布后，照 data/school/README.md 的字段说明补一个 YAML 文件，就是一次完整的贡献。结束日期字段叫 endDateExclusive，填的是最后一天的次日，这是 ICS 的规定，照填可以避免差一天的错误：

yaml

startDate: 2026-09-14
endDateExclusive: 2026-09-15

主要维护者是 wen-templari。

nbtcal 库

@nbtca/nbtcal 是读取上述订阅源的 TypeScript 库，唯一的运行时依赖是 ical.js，负责解析 ICS、展开重复事件、按日期查询、生成热力图数据和输出 ICS：

import { loadCalendar } from '@nbtca/nbtcal'

const calendar = await loadCalendar()
const upcoming = calendar.upcoming({ days: 30 })

它的 @nbtca/nbtcal/timetable 子模块还能把学校教务系统里的个人课表转成日历。登录由调用方负责，库本身不接触账号密码。

bash

npm install @nbtca/nbtcal

需要先讨论的：nbtcal 靠带 [NBT] 前缀的“秋季学期开始上课”等标题推断开学第一周，但校历拆出去之后，两个订阅源里都已经没有这类标题，推断会落空，Prompt 课表页因此需要手动填开学日期。修复要同时改库和数据约定。

维护者是 m1ngsama。仓库地址：github.com/nbtca/nbtcal。

沿革

ical.nbtca.space 至少在 2024 年 5 月就已上线，协会主页的日历页从那时起读取它；当时的 Worker 代码没有进仓库，校历也和活动混在同一个 Google 日历里，标题带 [NBT] 前缀。2026 年 9 月，Worker 的代码进了 calendar 仓库，校历改由 YAML 生成、独立发布。

nbtcal 于 2026 年 1 月以命令行工具起步，6 月改写为只处理数据的库，7 月加入课表支持。

2023 年 11 月的例会讨论过成员生日提醒：当时日程只放在苹果日历里，提醒方案在 QQ 机器人、钉钉和内网主页之间还没有定。

协会日历 ​

订阅 ​

calendar 仓库 ​

nbtcal 库 ​

沿革 ​

相关 ​

协会日历

订阅

calendar 仓库

nbtcal 库

沿革

相关