rsshub 1.0.0-master.fc1b99f → 1.0.0-master.fc2cf18

package/lib/routes/telegram/blog.ts

@@ -1,6 +1,6 @@
 import { Route } from '@/types';
 import cache from '@/utils/cache';
-import cherrio from 'cheerio';
+import * as cheerio from 'cheerio';
 import got from '@/utils/got';
 import { parseDate } from '@/utils/parse-date';
 
@@ -32,7 +32,7 @@ async function handler() {
     const link = 'https://telegram.org/blog';
 
     const res = await got(link);
-    const $$ = cherrio.load(res.body);
+    const $$ = cheerio.load(res.body);
 
     const items = await Promise.all(
         $$('.dev_blog_card_link_wrap')
@@ -42,7 +42,7 @@ async function handler() {
                 const link = 'https://telegram.org' + $.attr('href');
                 return cache.tryGet(link, async () => {
                     const result = await got(link);
-                    const $ = cherrio.load(result.body);
+                    const $ = cheerio.load(result.body);
                     return {
                         title: $('#dev_page_title').text(),
                         link,

package/lib/routes/telegram/channel.ts

@@ -1,18 +1,18 @@
-import { Route } from '@/types';
+import { Route, ViewType } from '@/types';
 import { getCurrentPath } from '@/utils/helpers';
-const __dirname = getCurrentPath(import.meta.url);
-
 import cache from '@/utils/cache';
 import { config } from '@/config';
 import got from '@/utils/got';
 import { load } from 'cheerio';
 import { parseDate } from '@/utils/parse-date';
 import { art } from '@/utils/render';
-import * as path from 'node:path';
+import path from 'node:path';
 import querystring from 'querystring';
 import { fallback, queryToBoolean } from '@/utils/readable-social';
 import tglibchannel from './tglib/channel';
 
+const __dirname = getCurrentPath(import.meta.url);
+
 /* message types */
 const REPLY = 'REPLY';
 const FORWARDED = 'FORWARDED';
@@ -57,9 +57,40 @@ const mediaTagDict = {
 
 export const route: Route = {
     path: '/channel/:username/:routeParams?',
-    categories: ['social-media'],
-    example: '/telegram/channel/awesomeDIYgod/searchQuery=twitter',
-    parameters: { username: 'channel username', routeParams: 'extra parameters, see the table below' },
+    categories: ['social-media', 'popular'],
+    view: ViewType.SocialMedia,
+    example: '/telegram/channel/awesomeRSSHub',
+    parameters: {
+        username: 'channel username',
+        routeParams: `extra parameters, see the table below
+| Key                    | Description                                                           | Accepts                                            | Defaults to  |
+| :--------------------: | :-------------------------------------------------------------------: | :------------------------------------------------: | :----------: |
+| showLinkPreview        | Show the link preview from Telegram                                   | 0/1/true/false                                     | true         |
+| showViaBot             | For messages sent via bot, show the bot                               | 0/1/true/false                                     | true         |
+| showReplyTo            | For reply messages, show the target of the reply                      | 0/1/true/false                                     | true         |
+| showFwdFrom            | For forwarded messages, show the forwarding source                    | 0/1/true/false                                     | true         |
+| showFwdFromAuthor      | For forwarded messages, show the author of the forwarding source      | 0/1/true/false                                     | true         |
+| showInlineButtons      | Show inline buttons                                                   | 0/1/true/false                                     | false        |
+| showMediaTagInTitle    | Show media tags in the title                                          | 0/1/true/false                                     | true         |
+| showMediaTagAsEmoji    | Show media tags as emoji                                              | 0/1/true/false                                     | true         |
+| showHashtagAsHyperlink | Show hashtags as hyperlinks (\`https://t.me/s/channel?q=%23hashtag\`) | 0/1/true/false                                     | true         |
+| includeFwd             | Include forwarded messages                                            | 0/1/true/false                                     | true         |
+| includeReply           | Include reply messages                                                | 0/1/true/false                                     | true         |
+| includeServiceMsg      | Include service messages (e.g. message pinned, channel photo updated) | 0/1/true/false                                     | true         |
+| includeUnsupportedMsg  | Include messages unsupported by t.me                                  | 0/1/true/false                                     | false        |
+| searchQuery            | search query                                                          | keywords; replace \`#hashtag\` with \`%23hashtag\` | (no keyword) |
+
+Specify different option values than default values can meet different needs, URL
+
+\`\`\`
+https://rsshub.app/telegram/channel/NewlearnerChannel/showLinkPreview=0&showViaBot=0&showReplyTo=0&showFwdFrom=0&showFwdFromAuthor=0&showInlineButtons=0&showMediaTagInTitle=1&showMediaTagAsEmoji=1&includeFwd=0&includeReply=1&includeServiceMsg=0&includeUnsupportedMsg=0
+\`\`\`
+
+generates an RSS without any link previews and annoying metadata, with emoji media tags in the title, without forwarded messages (but with reply messages), and without messages you don't care about (service messages and unsupported messages), for people who prefer pure subscriptions.
+
+For backward compatibility reasons, invalid \`routeParams\` will be treated as \`searchQuery\` .
+`,
+    },
     features: {
         requireConfig: false,
         requirePuppeteer: false,
@@ -77,33 +108,8 @@ export const route: Route = {
     name: 'Channel',
     maintainers: ['DIYgod', 'Rongronggg9'],
     handler,
-    description: `| Key                   | Description                                                           | Accepts                                              | Defaults to       |
-  | --------------------- | --------------------------------------------------------------------- | ---------------------------------------------------- | ----------------- |
-  | showLinkPreview       | Show the link preview from Telegram                                   | 0/1/true/false                                       | true              |
-  | showViaBot            | For messages sent via bot, show the bot                               | 0/1/true/false                                       | true              |
-  | showReplyTo           | For reply messages, show the target of the reply                      | 0/1/true/false                                       | true              |
-  | showFwdFrom           | For forwarded messages, show the forwarding source                    | 0/1/true/false                                       | true              |
-  | showFwdFromAuthor     | For forwarded messages, show the author of the forwarding source      | 0/1/true/false                                       | true              |
-  | showInlineButtons     | Show inline buttons                                                   | 0/1/true/false                                       | false             |
-  | showMediaTagInTitle   | Show media tags in the title                                          | 0/1/true/false                                       | true              |
-  | showMediaTagAsEmoji   | Show media tags as emoji                                              | 0/1/true/false                                       | true              |
-  | includeFwd            | Include forwarded messages                                            | 0/1/true/false                                       | true              |
-  | includeReply          | Include reply messages                                                | 0/1/true/false                                       | true              |
-  | includeServiceMsg     | Include service messages (e.g. message pinned, channel photo updated) | 0/1/true/false                                       | true              |
-  | includeUnsupportedMsg | Include messages unsupported by t.me                                  | 0/1/true/false                                       | false             |
-  | searchQuery           | search query                                                          | keywords; replace \`#\` by \`%23\` for hashtag searching | (search disabled) |
-
-  Specify different option values than default values can meet different needs, URL
-
-  \`\`\`
-  https://rsshub.app/telegram/channel/NewlearnerChannel/showLinkPreview=0&showViaBot=0&showReplyTo=0&showFwdFrom=0&showFwdFromAuthor=0&showInlineButtons=0&showMediaTagInTitle=1&showMediaTagAsEmoji=1&includeFwd=0&includeReply=1&includeServiceMsg=0&includeUnsupportedMsg=0
-  \`\`\`
-
-  generates an RSS without any link previews and annoying metadata, with emoji media tags in the title, without forwarded messages (but with reply messages), and without messages you don't care about (service messages and unsupported messages), for people who prefer pure subscriptions.
-
+    description: `
   :::tip
-  For backward compatibility reasons, invalid \`routeParams\` will be treated as \`searchQuery\` .
-
   Due to Telegram restrictions, some channels involving pornography, copyright, and politics cannot be subscribed. You can confirm by visiting \`https://t.me/s/:username\`.
   :::`,
 };
@@ -124,12 +130,13 @@ async function handler(ctx) {
     let showInlineButtons = false;
     let showMediaTagInTitle = true;
     let showMediaTagAsEmoji = true;
+    let showHashtagAsHyperlink = true;
     let includeFwd = true;
     let includeReply = true;
     let includeServiceMsg = true;
     let includeUnsupportedMsg = false;
     let searchQuery = routeParams; // for backward compatibility
-    if (routeParams && routeParams.search(/(^|&)(show(LinkPreview|ViaBot|ReplyTo|FwdFrom(Author)?|InlineButtons|MediaTag(InTitle|AsEmoji))|include(Fwd|Reply|(Service|Unsupported)Msg)|searchQuery)=/) !== -1) {
+    if (routeParams && routeParams.search(/(^|&)(show(LinkPreview|ViaBot|ReplyTo|FwdFrom(Author)?|InlineButtons|MediaTag(InTitle|AsEmoji)|HashtagAsHyperlink)|include(Fwd|Reply|(Service|Unsupported)Msg)|searchQuery)=/) !== -1) {
         routeParams = querystring.parse(ctx.req.param('routeParams'));
         showLinkPreview = !!fallback(undefined, queryToBoolean(routeParams.showLinkPreview), showLinkPreview);
         showViaBot = !!fallback(undefined, queryToBoolean(routeParams.showViaBot), showViaBot);
@@ -139,6 +146,7 @@ async function handler(ctx) {
         showInlineButtons = !!fallback(undefined, queryToBoolean(routeParams.showInlineButtons), showInlineButtons);
         showMediaTagInTitle = !!fallback(undefined, queryToBoolean(routeParams.showMediaTagInTitle), showMediaTagInTitle);
         showMediaTagAsEmoji = !!fallback(undefined, queryToBoolean(routeParams.showMediaTagAsEmoji), showMediaTagAsEmoji);
+        showHashtagAsHyperlink = !!fallback(undefined, queryToBoolean(routeParams.showHashtagAsHyperlink), showHashtagAsHyperlink);
         includeFwd = !!fallback(undefined, queryToBoolean(routeParams.includeFwd), includeFwd);
         includeReply = !!fallback(undefined, queryToBoolean(routeParams.includeReply), includeReply);
         includeServiceMsg = !!fallback(undefined, queryToBoolean(routeParams.includeServiceMsg), includeServiceMsg);
@@ -159,6 +167,24 @@ async function handler(ctx) {
     );
 
     const $ = load(data);
+
+    /*
+     * Since 2024/4/20, t.me/s/ mistakenly have every '&' in **hyperlinks** replaced by '&'.
+     * The characteristic of a hyperlink is [onclick] (pop-up confirmation), which is not present in ordinary links.
+     * This is a workaround to fix the issue until Telegram fixes it.
+     */
+    $('a[onclick][href]').each((_, elem) => {
+        const $elem = $(elem);
+        const href = $elem.attr('href');
+        href && $elem.attr('href', href.replaceAll('&', '&'));
+    });
+
+    !showHashtagAsHyperlink &&
+        $('a[href^="?q=%23"]').each((_, elem) => {
+            const $elem = $(elem);
+            $elem.replaceWith($elem.text());
+        });
+
     const list = includeServiceMsg
         ? $('.tgme_widget_message_wrap:not(.tgme_widget_message_wrap:has(.tme_no_messages_found))') // exclude 'no posts found' messages
         : $('.tgme_widget_message_wrap:not(.tgme_widget_message_wrap:has(.service_message,.tme_no_messages_found))'); // also exclude service messages
@@ -402,7 +428,9 @@ async function handler(ctx) {
                                 const background = $node.css('background-image');
                                 const backgroundUrl = background && background.match(/url\('(.*)'\)/);
                                 const backgroundUrlSrc = backgroundUrl && backgroundUrl[1];
-                                tag_media += backgroundUrlSrc ? `<img src="${backgroundUrlSrc}">` : '';
+                                const width = Number.parseFloat($node.css('width') || '0');
+                                const height = ((Number.parseFloat($node.find('.tgme_widget_message_photo').css('padding-top') || '0') / 100) * width).toFixed(2);
+                                tag_media += backgroundUrlSrc ? `<img width="${width}" height="${height}" src="${backgroundUrlSrc}">` : '';
                             }
                             if (tag_media) {
                                 tag_media_all += tag_media;

package/lib/routes/telegram/stickerpack.ts

@@ -1,6 +1,7 @@
 import { Route } from '@/types';
 import got from '@/utils/got';
 import { config } from '@/config';
+import ConfigNotFoundError from '@/errors/types/config-not-found';
 
 export const route: Route = {
     path: '/stickerpack/:name',
@@ -22,7 +23,7 @@ export const route: Route = {
 
 async function handler(ctx) {
     if (!config.telegram || !config.telegram.token) {
-        throw new Error('Telegram Sticker Pack RSS is disabled due to the lack of <a href="https://docs.rsshub.app/install/#pei-zhi-bu-fen-rss-mo-kuai-pei-zhi">relevant config</a>');
+        throw new ConfigNotFoundError('Telegram Sticker Pack RSS is disabled due to the lack of <a href="https://docs.rsshub.app/deploy/config#route-specific-configurations">relevant config</a>');
     }
     const name = ctx.req.param('name');
 

package/lib/routes/telegram/tglib/channel.ts

@@ -1,3 +1,4 @@
+import InvalidParameterError from '@/errors/types/invalid-parameter';
 import { client, decodeMedia, getClient, getFilename, getMediaLink, streamDocument, streamThumbnail } from './client';
 import { returnBigInt as bigInt } from 'telegram/Helpers';
 import { HTMLParser } from 'telegram/extensions/html';
@@ -8,7 +9,7 @@ function parseRange(range, length) {
     }
     const [typ, segstr] = range.split('=');
     if (typ !== 'bytes') {
-        throw `unsupported range: ${typ}`;
+        throw new InvalidParameterError(`unsupported range: ${typ}`);
     }
     const segs = segstr.split(',').map((s) => s.trim());
     const parsedSegs = [];

package/lib/routes/telegram/tglib/client.ts

@@ -1,15 +1,15 @@
-import readline from 'node:readline/promises';
 import { Api, TelegramClient } from 'telegram';
 import { UserAuthParams } from 'telegram/client/auth';
 import { StringSession } from 'telegram/sessions';
 import { getAppropriatedPartSize } from 'telegram/Utils';
 
 import { config } from '@/config';
+import ConfigNotFoundError from '@/errors/types/config-not-found';
 
 let client: TelegramClient | undefined;
 export async function getClient(authParams?: UserAuthParams, session?: string) {
     if (!config.telegram.session && session === undefined) {
-        throw new Error('TELEGRAM_SESSION is not configured');
+        throw new ConfigNotFoundError('TELEGRAM_SESSION is not configured');
     }
     if (client) {
         return client;
@@ -187,20 +187,3 @@ function streamDocument(obj, thumbSize = '', offset, limit) {
 }
 
 export { client, getMediaLink, decodeMedia, getFilename, streamDocument, streamThumbnail };
-
-if (require.main === module) {
-    Promise.resolve().then(async () => {
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        const client = await getClient(
-            {
-                phoneNumber: () => rl.question('Please enter your phone number: '),
-                password: () => rl.question('Please enter your password: '),
-                phoneCode: () => rl.question('Please enter the code you received: '),
-                onError: (err) => process.stderr.write(err.toString()),
-            },
-            ''
-        );
-        process.stdout.write(`TELEGRAM_SESSION=${client.session.save()}\n`);
-        process.exit(0);
-    });
-}

package/lib/routes/tencent/cloud/developer/column.ts

@@ -0,0 +1,81 @@
+import { Route } from '@/types';
+import ofetch from '@/utils/ofetch'; // 统一使用的请求库
+import { parseDate } from '@/utils/parse-date';
+import cache from '@/utils/cache';
+
+const PAGE = 1;
+const PAGE_SIZE = 20;
+
+export const route: Route = {
+    path: '/cloud/developer/column/:categoryId?',
+    categories: ['programming'],
+    example: '/tencent/cloud/developer/column/1',
+    parameters: { categoryId: 'categoryId from page url' },
+    radar: [
+        {
+            source: ['cloud.tencent.com/developer/column'],
+        },
+    ],
+    name: '腾讯云开发者社区专栏',
+    maintainers: ['lyling'],
+    handler: async (ctx) => {
+        const categoryId = ctx.req.param('categoryId') ?? 0;
+        const link = `https://cloud.tencent.com/developer/api/home/article-list`;
+        const response = await ofetch(link, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: {
+                classifyId: categoryId,
+                page: PAGE,
+                pagesize: PAGE_SIZE,
+                type: '',
+            },
+        });
+
+        const items = response.list.map((item) => ({
+            // 文章标题
+            title: item.title,
+            // 文章链接
+            link: `https://cloud.tencent.com/developer/article/${item.articleId}`,
+            // 文章正文
+            description: item.summary,
+            // 文章发布日期
+            pubDate: parseDate(item.createTime * 1000),
+            // 如果有的话，文章作者
+            author: item.author.nickname,
+            // 如果有的话，文章分类
+            category: item.tags.map((tag) => tag.tagName),
+        }));
+
+        const classify = await findClassifyById(categoryId);
+
+        const title = classify ? classify.name : '';
+        const description = `${title} - 腾讯云开发者社区`;
+
+        return {
+            title,
+            description,
+            item: items,
+        };
+    },
+};
+
+async function findClassifyById(id) {
+    const classifylink = 'https://cloud.tencent.com/developer/api/column/get-classify-list-by-scene';
+    const response = await cache.tryGet(classifylink, async () => {
+        const response = await ofetch(classifylink, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: {
+                scene: 0,
+            },
+        });
+        return response;
+    });
+
+    return response.list.find((classify) => classify.id === Number(id));
+}

package/lib/routes/tencent/namespace.ts

@@ -1,6 +1,6 @@
 import type { Namespace } from '@/types';
 
 export const namespace: Namespace = {
-    name: '王者荣耀',
-    url: 'mp.weixin.qq.com',
+    name: '腾讯',
+    url: 'tencent.com',
 };

package/lib/routes/tencent/news/author.ts

@@ -8,7 +8,7 @@ import { load } from 'cheerio';
 import { parseDate } from '@/utils/parse-date';
 import { config } from '@/config';
 import { art } from '@/utils/render';
-import * as path from 'node:path';
+import path from 'node:path';
 
 export const route: Route = {
     path: '/news/author/:mid',
@@ -68,17 +68,19 @@ async function handler(ctx) {
                               .text()
                               .match(/window\.DATA = ({.+});/)[1]
                       );
-                      const $data = load(data.originContent.text, null, false);
-
-                      $data('*')
-                          .contents()
-                          .filter((_, elem) => elem.type === 'comment')
-                          .replaceWith((_, elem) =>
-                              art(path.join(__dirname, '../templates/news/image.art'), {
-                                  attribute: elem.data.trim(),
-                                  originAttribute: data.originAttribute,
-                              })
-                          );
+                      const $data = load(data.originContent?.text || '', null, false);
+                      if ($data) {
+                          // Not video page
+                          $data('*')
+                              .contents()
+                              .filter((_, elem) => elem.type === 'comment')
+                              .replaceWith((_, elem) =>
+                                  art(path.join(__dirname, '../templates/news/image.art'), {
+                                      attribute: elem.data.trim(),
+                                      originAttribute: data.originAttribute,
+                                  })
+                              );
+                      }
 
                       return {
                           title,

package/lib/routes/tencent/news/coronavirus/data.ts

@@ -5,7 +5,8 @@ const __dirname = getCurrentPath(import.meta.url);
 import { getData } from './utils';
 import { parseDate } from '@/utils/parse-date';
 import { art } from '@/utils/render';
-import * as path from 'node:path';
+import path from 'node:path';
+import InvalidParameterError from '@/errors/types/invalid-parameter';
 
 export const route: Route = {
     path: '/news/coronavirus/data/:province?/:city?',
@@ -50,7 +51,7 @@ async function handler(ctx) {
         }
     }
     if (!coronavirusData) {
-        throw new Error(`未找到 ${placeName} 的疫情数据，请检查输入的省市名称是否正确`);
+        throw new InvalidParameterError(`未找到 ${placeName} 的疫情数据，请检查输入的省市名称是否正确`);
     }
     todayConfirm = coronavirusData.today?.confirm;
     totalNowConfirm = coronavirusData.total?.nowConfirm;

package/lib/routes/tencent/news/coronavirus/total.ts

@@ -5,7 +5,7 @@ const __dirname = getCurrentPath(import.meta.url);
 import { getData } from './utils';
 import { parseDate } from '@/utils/parse-date';
 import { art } from '@/utils/render';
-import * as path from 'node:path';
+import path from 'node:path';
 
 export const route: Route = {
     path: '/news/coronavirus/total',

package/lib/routes/tencent/qq/sdk/changelog.ts

@@ -1,3 +1,4 @@
+import InvalidParameterError from '@/errors/types/invalid-parameter';
 import { Route } from '@/types';
 import got from '@/utils/got';
 import { load } from 'cheerio';
@@ -32,7 +33,7 @@ async function handler(ctx) {
         title = 'Android SDK 历史变更';
         link = 'https://wiki.connect.qq.com/android_sdk历史变更';
     } else {
-        throw new Error('not support platform');
+        throw new InvalidParameterError('not support platform');
     }
 
     const response = await got.get(link);

package/lib/routes/tesla/cx.ts

@@ -7,7 +7,7 @@ import got from '@/utils/got';
 import { load } from 'cheerio';
 import { parseDate } from '@/utils/parse-date';
 import { art } from '@/utils/render';
-import * as path from 'node:path';
+import path from 'node:path';
 
 export const route: Route = {
     path: '/cx/:category?/:city?',
@@ -127,7 +127,7 @@ async function handler(ctx) {
         },
     });
 
-    const categoryObject = categoryResponse.data.filter((c) => c.name === category).pop();
+    const categoryObject = categoryResponse.data.findLast((c) => c.name === category);
 
     const { data: response } = await got(apiUrl, {
         searchParams: {

package/lib/routes/test/index.ts

@@ -3,12 +3,15 @@ import { config } from '@/config';
 import got from '@/utils/got';
 import wait from '@/utils/wait';
 import cache from '@/utils/cache';
+import { fetchArticle } from '@/utils/wechat-mp';
+import ConfigNotFoundError from '@/errors/types/config-not-found';
+import InvalidParameterError from '@/errors/types/invalid-parameter';
 
 let cacheIndex = 0;
 
 export const route: Route = {
-    path: '/:id',
-    name: 'Unknown',
+    path: '/:id/:params?',
+    name: 'Test',
     maintainers: ['DIYgod', 'NeverBehave'],
     handler,
 };
@@ -23,6 +26,12 @@ async function handler(ctx) {
             url: 'https://httpbingo.org/status/404',
         });
     }
+    if (ctx.req.param('id') === 'config-not-found-error') {
+        throw new ConfigNotFoundError('Test config not found error');
+    }
+    if (ctx.req.param('id') === 'invalid-parameter-error') {
+        throw new InvalidParameterError('Test invalid parameter error');
+    }
     let item: DataItem[] = [];
     switch (ctx.req.param('id')) {
         case 'filter':
@@ -79,13 +88,9 @@ async function handler(ctx) {
             break;
 
         case 'cache': {
-            const description = await cache.tryGet(
-                'test',
-                () => ({
-                    text: `Cache${++cacheIndex}`,
-                }),
-                config.cache.routeExpire * 2
-            );
+            const description = await cache.tryGet('test', () => ({
+                text: `Cache${++cacheIndex}`,
+            }));
             item.push({
                 title: 'Cache Title',
                 description: description.text,
@@ -371,6 +376,10 @@ async function handler(ctx) {
         await wait(1000);
     }
 
+    if (ctx.req.param('id') === 'slow4') {
+        await wait(4000);
+    }
+
     if (ctx.req.query('mode') === 'fulltext') {
         item = [
             {
@@ -380,6 +389,15 @@ async function handler(ctx) {
         ];
     }
 
+    if (ctx.req.param('id') === 'wechat-mp') {
+        const params = ctx.req.param('params');
+        if (!params) {
+            throw new InvalidParameterError('Invalid parameter');
+        }
+        const mpUrl = 'https:/mp.weixin.qq.com/s' + (params.includes('&') ? '?' : '/') + params;
+        item = [await fetchArticle(mpUrl)];
+    }
+
     return {
         title: `Test ${ctx.req.param('id')}`,
         itunes_author: ctx.req.param('id') === 'enclosure' ? 'DIYgod' : null,

package/lib/routes/test/namespace.ts

@@ -1,5 +1,5 @@
 import type { Namespace } from '@/types';
 
 export const namespace: Namespace = {
-    name: 'Unknown',
+    name: 'RSSHub Test',
 };

package/lib/routes/tfc-taiwan/common.ts

@@ -0,0 +1,38 @@
+import cache from '@/utils/cache';
+import got from '@/utils/got';
+import { load } from 'cheerio';
+import { baseUrl, parseList, parseItems } from './utils';
+import { getSubPath } from '@/utils/common-utils';
+
+export async function handler(ctx) {
+    const requestPath = getSubPath(ctx);
+    const isTopic = requestPath.startsWith('/topic/');
+    let link = baseUrl;
+
+    if (isTopic) {
+        link += `/topic/${ctx.req.param('id')}`;
+    } else if (requestPath === '/') {
+        link += `/articles/report`;
+    } else {
+        link += `/articles${requestPath}`;
+    }
+
+    const { data: response } = await got(link);
+    const $ = load(response);
+
+    const list = $(`${isTopic ? '.view-grouping' : '.pane-clone-of-article'} .views-row-inner`)
+        .toArray()
+        .map((item) => parseList($(item)));
+
+    const items = await parseItems(list, cache.tryGet);
+
+    return {
+        title: $('head title').text(),
+        description: $('head meta[name="description"]').attr('content'),
+        image: $('head meta[property="og:image"]').attr('content'),
+        logo: $('head link[rel="shortcut icon"]').attr('href'),
+        icon: $('head link[rel="shortcut icon"]').attr('href'),
+        link,
+        item: items,
+    };
+}

package/lib/routes/tfc-taiwan/index.ts

@@ -1,47 +1,17 @@
 import { Route } from '@/types';
-import cache from '@/utils/cache';
-import got from '@/utils/got';
-import { load } from 'cheerio';
-import { baseUrl, parseList, parseItems } from './utils';
+import { handler } from './common';
 
 export const route: Route = {
-    path: ['/', '/category/:id{.+}', '/info', '/report', '/topic/:id'],
-    name: 'Unknown',
+    name: '最新相關資訊 / 最新查核報告',
     maintainers: ['TonyRL'],
+    example: '/tfc-taiwan',
+    path: '/:type?',
+    parameters: {
+        type: '分類，見下表，預設為 `report`',
+    },
     handler,
     url: 'tfc-taiwan.org.tw/articles/report',
-    url: 'tfc-taiwan.org.tw/articles/info',
+    description: `| 最新相關資訊 | 最新查核報告 |
+| ------------ | ------------ |
+| info         | report       |`,
 };
-
-async function handler(ctx) {
-    const requestPath = ctx.req.path;
-    const isTopic = requestPath.startsWith('/topic/');
-    let link = baseUrl;
-
-    if (isTopic) {
-        link += `/topic/${ctx.req.param('id')}`;
-    } else if (requestPath === '/') {
-        link += `/articles/report`;
-    } else {
-        link += `/articles${requestPath}`;
-    }
-
-    const { data: response } = await got(link);
-    const $ = load(response);
-
-    const list = $(`${isTopic ? '.view-grouping' : '.pane-clone-of-article'} .views-row-inner`)
-        .toArray()
-        .map((item) => parseList($(item)));
-
-    const items = await parseItems(list, cache.tryGet);
-
-    return {
-        title: $('head title').text(),
-        description: $('head meta[name="description"]').attr('content'),
-        image: $('head meta[property="og:image"]').attr('content'),
-        logo: $('head link[rel="shortcut icon"]').attr('href'),
-        icon: $('head link[rel="shortcut icon"]').attr('href'),
-        link,
-        item: items,
-    };
-}

package/lib/routes/tfc-taiwan/topic.ts

@@ -0,0 +1,17 @@
+import { Route } from '@/types';
+import { handler } from './common';
+
+export const route: Route = {
+    name: '專題 / 重點專區',
+    maintainers: ['TonyRL'],
+    example: '/tfc-taiwan/category/242',
+    path: '/:type/:id{.+}',
+    parameters: {
+        type: '分類，見下表，預設為 `report`',
+    },
+    handler,
+    url: 'tfc-taiwan.org.tw/articles/report',
+    description: `| 專題     | 重點專區 |
+| -------- | -------- |
+| category | topic    |`,
+};