feat(route/tsinghua): add thuhs routes (#22942)

* feat(tsinghua): add new route for Tsinghua University High School * feat(tsinghua): add xwdt category and maintainer comments for Tsinghua High School * fix(route): fix typescript type errors in thuhs route * fix(tsinghua/thuhs): set antiCrawler to true as site blocks overseas IPs * docs(tsinghua/thuhs): add note about China-only access and proxy usage * docs(tsinghua/thuhs): fix description about IP blocking behavior * fix(tsinghua/thuhs): remove trailing spaces * fix(tsinghua): fix syntax error * fix(tsinghua): fix anti-patterns * fix(route): fix jsfc category selector * fix(route): shorten route name to avoid namespace duplication * feat(route): add logo and icon to thuhs feed * fix(route/tsinghua): fix CodeQL SSRF warning for thuhs route * fix(route/tsinghua): relax hostname validation to allow subdomains of qhfz.edu.cn * docs(route/tsinghua): refine comment for thuhs route * fix(route/tsinghua): remove antiCrawler configuration for thuhs route * Update lib/routes/tsinghua/thuhs.ts
2026-08-29 01:53:47 +08:00 · 2026-08-12 01:28:05 +08:00
parent 9dc33fe4f7
commit 6a5cd10997
1 changed files with 104 additions and 0 deletions
@@ -0,0 +1,104 @@
+import { load } from 'cheerio';
+import type { Context } from 'hono';
+
+import type { DataItem, Route } from '@/types';
+import cache from '@/utils/cache';
+import ofetch from '@/utils/ofetch';
+import { parseDate } from '@/utils/parse-date';
+import timezone from '@/utils/timezone';
+
+/*
+ * Dictionary of supported text-based categories.
+ * Other sections (such as video news) are intentionally excluded as they require complex media parsing.
+ */
+const categoryMap: Record<string, string> = {
+    tzgg: '通知公告',
+    xstd: '学生活动',
+    jsfc: '教师风采',
+    xwdt: '新闻动态',
+};
+
+export const route: Route = {
+    path: '/thuhs/:category?',
+    categories: ['university'],
+    example: '/tsinghua/thuhs/tzgg',
+    parameters: { category: '分类，见下表，留空则默认获取通知公告' },
+    features: {
+        requireConfig: false,
+        requirePuppeteer: false,
+        antiCrawler: false,
+        supportBT: false,
+        supportPodcast: false,
+        supportScihub: false,
+    },
+    radar: [
+        {
+            source: ['www.qhfz.edu.cn/:category.htm'],
+        },
+    ],
+    name: '附属中学',
+    maintainers: ['Aquarius-Situla'],
+    handler,
+    description: `
+| 通知公告 | 学生活动 | 教师风采 | 新闻动态 |
+| -------- | -------- | -------- | -------- |
+| tzgg     | xstd     | jsfc     | xwdt     |
+`,
+};
+
+async function handler(ctx: Context) {
+    /* Determine the target URL based on the provided category */
+    const category = ctx.req.param('category') || 'tzgg';
+    const host = 'https://www.qhfz.edu.cn';
+    const targetUrl = `${host}/${category}.htm`;
+
+    const response = await ofetch(targetUrl);
+    const $ = load(response);
+
+    /* Locate the list of articles on the specific category page */
+    const list = $('.list ul li, .list_tt ul li');
+
+    /* Extract metadata (title, link, date) for each article */
+    const items = list.toArray().map((item): DataItem & { link: string } => {
+        const $item = $(item);
+        const $a = $item.find('a');
+        const title = $a.attr('title') || $a.text();
+        const time = $item.find('.sj').text();
+        const link = $a.attr('href');
+
+        return {
+            title: title.trim(),
+            link: link ? new URL(link, targetUrl).href : '',
+            pubDate: time ? timezone(parseDate(time, 'YYYY-MM-DD'), 8) : undefined,
+        };
+    }).filter((item) => item.link); // Filter out empty links
+
+    const feedTitle = categoryMap[category] || '通知公告';
+
+    /* Fetch full article content using the RSSHub cache mechanism */
+    const out = await Promise.all(
+        items.map((item) =>
+            cache.tryGet(item.link, async () => {
+                const hostname = new URL(item.link).hostname;
+                if (hostname !== 'www.qhfz.edu.cn') {
+                    return item;
+                }
+                const response = await ofetch(item.link);
+                const $ = load(response);
+                item.description = $('.v_news_content').html() || '';
+                return item;
+            })
+        )
+    );
+
+    const icon = new URL('images/logo.png', host).href;
+
+    return {
+        title: `清华附中 - ${feedTitle}`,
+        link: targetUrl,
+        item: out as DataItem[],
+        image: icon,
+        icon,
+        logo: icon,
+    };
+}