rsshub 1.0.0-master.f9003f9 → 1.0.0-master.f917bdc

package/README.md

@@ -10,6 +10,7 @@
 [![npm publish](https://img.shields.io/npm/dt/rsshub?label=npm%20downloads&logo=npm&style=flat-square)](https://www.npmjs.com/package/rsshub)
 [![test](https://img.shields.io/github/actions/workflow/status/DIYgod/RSSHub/test.yml?branch=master&label=test&logo=github&style=flat-square)](https://github.com/DIYgod/RSSHub/actions/workflows/test.yml?query=event%3Apush+branch%3Amaster)
 [![Test coverage](https://img.shields.io/codecov/c/github/DIYgod/RSSHub.svg?style=flat-square&logo=codecov)](https://app.codecov.io/gh/DIYgod/RSSHub/branch/master)
+[![Visitors](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FDIYgod%2FRSSHub&count_bg=%23FF752E&title_bg=%23555555&icon=rss.svg&icon_color=%23FF752E&title=RSS+lovers&edge_flat=true)](https://github.com/DIYgod/RSSHub)
 
 [![Telegram group](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.swo.moe%2Fstats%2Ftelegram%2Frsshub&query=count&color=2CA5E0&label=Telegram%20Group&logo=telegram&cacheSeconds=3600&style=flat-square)](https://t.me/rsshub) [![Telegram channel](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.swo.moe%2Fstats%2Ftelegram%2FawesomeRSSHub&query=count&color=2CA5E0&label=Telegram%20Channel&logo=telegram&cacheSeconds=3600&style=flat-square)](https://t.me/awesomeRSSHub) [![Twitter](https://img.shields.io/badge/any_text-Follow-blue?color=2CA5E0&label=Twitter&logo=twitter&cacheSeconds=3600&style=flat-square)](https://x.com/intent/follow?screen_name=_RSSHub)
 

package/lib/api/category/one.ts

@@ -0,0 +1,54 @@
+import { namespaces } from '@/registry';
+import { z, createRoute, RouteHandler } from '@hono/zod-openapi';
+
+const categoryList: Record<string, typeof namespaces> = {};
+
+for (const namespace in namespaces) {
+    for (const path in namespaces[namespace].routes) {
+        if (namespaces[namespace].routes[path].categories?.length) {
+            for (const category of namespaces[namespace].routes[path].categories!) {
+                if (!categoryList[category]) {
+                    categoryList[category] = {};
+                }
+                if (!categoryList[category][namespace]) {
+                    categoryList[category][namespace] = {
+                        ...namespaces[namespace],
+                        routes: {},
+                    };
+                }
+                categoryList[category][namespace].routes[path] = namespaces[namespace].routes[path];
+            }
+        }
+    }
+}
+
+const ParamsSchema = z.object({
+    category: z.string().openapi({
+        param: {
+            name: 'category',
+            in: 'path',
+        },
+        example: 'popular',
+    }),
+});
+
+const route = createRoute({
+    method: 'get',
+    path: '/category/{category}',
+    tags: ['Category'],
+    request: {
+        params: ParamsSchema,
+    },
+    responses: {
+        200: {
+            description: 'Namespace list by category',
+        },
+    },
+});
+
+const handler: RouteHandler<typeof route> = (ctx) => {
+    const { category } = ctx.req.valid('param');
+    return ctx.json(categoryList[category]);
+};
+
+export { route, handler };

package/lib/api/index.ts

@@ -3,8 +3,9 @@ import { route as namespaceAllRoute, handler as namespaceAllHandler } from '@/ap
 import { route as namespaceOneRoute, handler as namespaceOneHandler } from '@/api/namespace/one';
 import { route as radarRulesAllRoute, handler as radarRulesAllHandler } from '@/api/radar/rules/all';
 import { route as radarRulesOneRoute, handler as radarRulesOneHandler } from '@/api/radar/rules/one';
+import { route as categoryOneRoute, handler as categoryOneHandler } from '@/api/category/one';
 import { OpenAPIHono } from '@hono/zod-openapi';
-import { swaggerUI } from '@hono/swagger-ui';
+import { apiReference } from '@scalar/hono-api-reference';
 
 const app = new OpenAPIHono();
 
@@ -12,6 +13,7 @@ app.openapi(namespaceAllRoute, namespaceAllHandler);
 app.openapi(namespaceOneRoute, namespaceOneHandler);
 app.openapi(radarRulesAllRoute, radarRulesAllHandler);
 app.openapi(radarRulesOneRoute, radarRulesOneHandler);
+app.openapi(categoryOneRoute, categoryOneHandler);
 
 const docs = app.getOpenAPI31Document({
     openapi: '3.1.0',
@@ -24,8 +26,12 @@ for (const path in docs.paths) {
     docs.paths[`/api${path}`] = docs.paths[path];
     delete docs.paths[path];
 }
-app.get('/docs', (ctx) => ctx.json(docs));
-
-app.get('/ui', swaggerUI({ url: '/api/docs' }));
+app.get('/openapi.json', (ctx) => ctx.json(docs));
+app.get(
+    '/reference',
+    apiReference({
+        spec: { content: docs },
+    })
+);
 
 export default app;

package/lib/app.tsx

@@ -12,6 +12,7 @@ import debug from '@/middleware/debug';
 import header from '@/middleware/header';
 import antiHotlink from '@/middleware/anti-hotlink';
 import parameter from '@/middleware/parameter';
+import trace from '@/middleware/trace';
 import { jsxRenderer } from 'hono/jsx-renderer';
 import { trimTrailingSlash } from 'hono/trailing-slash';
 
@@ -37,6 +38,7 @@ app.use(
     })
 );
 app.use(mLogger);
+app.use(trace);
 app.use(sentry);
 app.use(accessControl);
 app.use(debug);

package/lib/config.ts

@@ -1,5 +1,5 @@
-import 'dotenv/config';
 import randUserAgent from '@/utils/rand-user-agent';
+import 'dotenv/config';
 import { ofetch } from 'ofetch';
 
 let envs = process.env;
@@ -39,8 +39,8 @@ export type Config = {
         port?: string;
         auth?: string;
         url_regex: string;
+        strategy: 'on_retry' | 'all';
     };
-    proxyStrategy: string;
     pacUri?: string;
     pacScript?: string;
     accessKey?: string;
@@ -154,7 +154,6 @@ export type Config = {
         username?: string;
         password?: string;
         bearertoken?: string;
-        iap_receipt?: string;
     };
     instagram: {
         username?: string;
@@ -169,6 +168,9 @@ export type Config = {
     javdb: {
         session?: string;
     };
+    keylol: {
+        cookie?: string;
+    };
     lastfm: {
         api_key?: string;
     };
@@ -233,6 +235,9 @@ export type Config = {
     qingting: {
         id?: string;
     };
+    readwise: {
+        accessToken?: string;
+    };
     saraba1st: {
         cookie?: string;
     };
@@ -250,19 +255,23 @@ export type Config = {
         clientSecret?: string;
         refreshToken?: string;
     };
+    sspai: {
+        bearertoken?: string;
+    };
     telegram: {
         token?: string;
     };
     tophub: {
         cookie?: string;
     };
+    tsdm39: {
+        cookie: string;
+    };
     twitter: {
-        oauthTokens?: string[];
-        oauthTokenSecrets?: string[];
-        username?: string;
-        password?: string;
-        authenticationSecret?: string;
-        cookie?: string;
+        username?: string[];
+        password?: string[];
+        authenticationSecret?: string[];
+        authToken?: string[];
     };
     weibo: {
         app_key?: string;
@@ -283,6 +292,10 @@ export type Config = {
     ximalaya: {
         token?: string;
     };
+    xsijishe: {
+        cookie?: string;
+        userAgent?: string;
+    };
     xueqiu: {
         cookies?: string;
     };
@@ -388,8 +401,8 @@ const calculateValue = () => {
             port: envs.PROXY_PORT,
             auth: envs.PROXY_AUTH,
             url_regex: envs.PROXY_URL_REGEX || '.*',
+            strategy: envs.PROXY_STRATEGY || 'all', // all / on_retry
         },
-        proxyStrategy: envs.PROXY_STRATEGY || 'all', // all / on_retry
         pacUri: envs.PAC_URI,
         pacScript: envs.PAC_SCRIPT,
         // access control
@@ -510,7 +523,6 @@ const calculateValue = () => {
             username: envs.INITIUM_USERNAME,
             password: envs.INITIUM_PASSWORD,
             bearertoken: envs.INITIUM_BEARER_TOKEN,
-            iap_receipt: envs.INITIUM_IAP_RECEIPT,
         },
         instagram: {
             username: envs.IG_USERNAME,
@@ -525,6 +537,9 @@ const calculateValue = () => {
         javdb: {
             session: envs.JAVDB_SESSION,
         },
+        keylol: {
+            cookie: envs.KEYLOL_COOKIE,
+        },
         lastfm: {
             api_key: envs.LASTFM_API_KEY,
         },
@@ -589,6 +604,9 @@ const calculateValue = () => {
         qingting: {
             id: envs.QINGTING_ID,
         },
+        readwise: {
+            accessToken: envs.READWISE_ACCESS_TOKEN,
+        },
         saraba1st: {
             cookie: envs.SARABA1ST_COOKIE,
         },
@@ -606,6 +624,9 @@ const calculateValue = () => {
             clientSecret: envs.SPOTIFY_CLIENT_SECRET,
             refreshToken: envs.SPOTIFY_REFRESHTOKEN,
         },
+        sspai: {
+            bearertoken: envs.SSPAI_BEARERTOKEN,
+        },
         telegram: {
             token: envs.TELEGRAM_TOKEN,
             session: envs.TELEGRAM_SESSION,
@@ -616,13 +637,14 @@ const calculateValue = () => {
         tophub: {
             cookie: envs.TOPHUB_COOKIE,
         },
+        tsdm39: {
+            cookie: envs.TSDM39_COOKIES,
+        },
         twitter: {
-            oauthTokens: envs.TWITTER_OAUTH_TOKEN?.split(','),
-            oauthTokenSecrets: envs.TWITTER_OAUTH_TOKEN_SECRET?.split(','),
-            username: envs.TWITTER_USERNAME,
-            password: envs.TWITTER_PASSWORD,
-            authenticationSecret: envs.TWITTER_AUTHENTICATION_SECRET,
-            cookie: envs.TWITTER_COOKIE,
+            username: envs.TWITTER_USERNAME?.split(','),
+            password: envs.TWITTER_PASSWORD?.split(','),
+            authenticationSecret: envs.TWITTER_AUTHENTICATION_SECRET?.split(','),
+            authToken: envs.TWITTER_AUTH_TOKEN?.split(','),
         },
         weibo: {
             app_key: envs.WEIBO_APP_KEY,
@@ -643,6 +665,10 @@ const calculateValue = () => {
         ximalaya: {
             token: envs.XIMALAYA_TOKEN,
         },
+        xsijishe: {
+            cookie: envs.XSIJISHE_COOKIE,
+            user_agent: envs.XSIJISHE_USER_AGENT,
+        },
         xueqiu: {
             cookies: envs.XUEQIU_COOKIES,
         },

package/lib/errors/index.test.ts

@@ -27,8 +27,12 @@ describe('httperror', () => {
 });
 
 describe('RequestInProgressError', () => {
-    it(`RequestInProgressError`, async () => {
+    it(`RequestInProgressError with retry`, async () => {
         const responses = await Promise.all([request.get('/test/slow'), request.get('/test/slow')]);
+        expect(new Set(responses.map((r) => r.status))).toEqual(new Set([200, 200]));
+    });
+    it(`RequestInProgressError`, async () => {
+        const responses = await Promise.all([request.get('/test/slow4'), request.get('/test/slow4')]);
         expect(new Set(responses.map((r) => r.status))).toEqual(new Set([200, 503]));
         expect(new Set(responses.map((r) => r.headers['cache-control']))).toEqual(new Set([`public, max-age=${config.cache.routeExpire}`, `public, max-age=${config.requestTimeout / 1000}`]));
         expect(responses.filter((r) => r.text.includes('RequestInProgressError: This path is currently fetching, please come back later!'))).toHaveLength(1);
@@ -63,19 +67,19 @@ describe('route throws an error', () => {
             const value = $(item).find('.debug-value').html()?.trim();
             switch (key) {
                 case 'Request Amount:':
-                    expect(value).toBe('9');
+                    expect(value).toBe('11');
                     break;
                 case 'Hot Routes:':
-                    expect(value).toBe('6 /test/:id/:params?<br>');
+                    expect(value).toBe('8 /test/:id/:params?<br>');
                     break;
                 case 'Hot Paths:':
-                    expect(value).toBe('2 /test/error<br>2 /test/slow<br>1 /test/httperror<br>1 /test/config-not-found-error<br>1 /test/invalid-parameter-error<br>1 /thisDoesNotExist<br>1 /<br>');
+                    expect(value).toBe('2 /test/error<br>2 /test/slow<br>2 /test/slow4<br>1 /test/httperror<br>1 /test/config-not-found-error<br>1 /test/invalid-parameter-error<br>1 /thisDoesNotExist<br>1 /<br>');
                     break;
                 case 'Hot Error Routes:':
                     expect(value).toBe('5 /test/:id/:params?<br>');
                     break;
                 case 'Hot Error Paths:':
-                    expect(value).toBe('2 /test/error<br>1 /test/httperror<br>1 /test/slow<br>1 /test/config-not-found-error<br>1 /test/invalid-parameter-error<br>1 /thisDoesNotExist<br>');
+                    expect(value).toBe('2 /test/error<br>1 /test/httperror<br>1 /test/slow4<br>1 /test/config-not-found-error<br>1 /test/invalid-parameter-error<br>1 /thisDoesNotExist<br>');
                     break;
                 default:
             }

package/lib/errors/index.tsx

@@ -1,20 +1,26 @@
 import { type NotFoundHandler, type ErrorHandler } from 'hono';
 import { getDebugInfo, setDebugInfo } from '@/utils/debug-info';
 import { config } from '@/config';
-import Sentry from '@sentry/node';
+import * as Sentry from '@sentry/node';
 import logger from '@/utils/logger';
 import Error from '@/views/error';
 
 import NotFoundError from './types/not-found';
 
+import { requestMetric } from '@/utils/otel';
+
 export const errorHandler: ErrorHandler = (error, ctx) => {
     const requestPath = ctx.req.path;
     const matchedRoute = ctx.req.routePath;
     const hasMatchedRoute = matchedRoute !== '/*';
 
     const debug = getDebugInfo();
-    if (ctx.res.headers.get('RSSHub-Cache-Status')) {
-        debug.hitCache++;
+    try {
+        if (ctx.res.headers.get('RSSHub-Cache-Status')) {
+            debug.hitCache++;
+        }
+    } catch {
+        // ignore
     }
     debug.error++;
 
@@ -61,8 +67,9 @@ export const errorHandler: ErrorHandler = (error, ctx) => {
     const message = `${error.name}: ${errorMessage}`;
 
     logger.error(`Error in ${requestPath}: ${message}`);
+    requestMetric.error({ path: requestPath, method: ctx.req.method, status: ctx.res.status });
 
-    return config.isPackage
+    return config.isPackage || ctx.req.query('format') === 'json'
         ? ctx.json({
               error: {
                   message: error.message ?? error,

package/lib/index.ts

@@ -10,12 +10,15 @@ const hostIPList = getLocalhostAddress();
 logger.info(`🎉 RSSHub is running on port ${port}! Cheers!`);
 logger.info('💖 Can you help keep this open source project alive? Please sponsor 👉 https://docs.rsshub.app/sponsor');
 logger.info(`🔗 Local: 👉 http://localhost:${port}`);
-for (const ip of hostIPList) {
-    logger.info(`🔗 Network: 👉 http://${ip}:${port}`);
+if (config.listenInaddrAny) {
+    for (const ip of hostIPList) {
+        logger.info(`🔗 Network: 👉 http://${ip}:${port}`);
+    }
 }
 
 const server = serve({
     fetch: app.fetch,
+    hostname: config.listenInaddrAny ? undefined : '127.0.0.1',
     port,
 });
 

package/lib/middleware/anti-hotlink.test.ts

@@ -36,7 +36,7 @@ const expects = {
                 `<a href="https://mock.com/DIYgod/RSSHub"></a>
 <img src="https://mock.com/DIYgod/RSSHub.jpg" referrerpolicy="no-referrer">`,
             ],
-            desc: '<img src="http://mock.com/DIYgod/DIYgod/RSSHub"> - Made with love by RSSHub(https://github.com/DIYgod/RSSHub)',
+            desc: '<img src="http://mock.com/DIYgod/DIYgod/RSSHub"> - Powered by RSSHub',
         },
         processed: {
             items: [
@@ -54,7 +54,7 @@ const expects = {
                 `<a href="https://mock.com/DIYgod/RSSHub"></a>
 <img src="https://i3.wp.com/mock.com/DIYgod/RSSHub.jpg" referrerpolicy="no-referrer">`,
             ],
-            desc: '<img src="https://i3.wp.com/mock.com/DIYgod/DIYgod/RSSHub"> - Made with love by RSSHub(https://github.com/DIYgod/RSSHub)',
+            desc: '<img src="https://i3.wp.com/mock.com/DIYgod/DIYgod/RSSHub"> - Powered by RSSHub',
         },
         urlencoded: {
             items: [
@@ -72,7 +72,7 @@ const expects = {
                 `<a href="https://mock.com/DIYgod/RSSHub"></a>
 <img src="https://images.weserv.nl?url=https%3A%2F%2Fmock.com%2FDIYgod%2FRSSHub.jpg" referrerpolicy="no-referrer">`,
             ],
-            desc: '<img src="https://images.weserv.nl?url=http%3A%2F%2Fmock.com%2FDIYgod%2FDIYgod%2FRSSHub"> - Made with love by RSSHub(https://github.com/DIYgod/RSSHub)',
+            desc: '<img src="https://images.weserv.nl?url=http%3A%2F%2Fmock.com%2FDIYgod%2FDIYgod%2FRSSHub"> - Powered by RSSHub',
         },
     },
     multimedia: {
@@ -87,7 +87,7 @@ const expects = {
 <audio src="https://mock.com/DIYgod/RSSHub.mp3"></audio>
 <iframe src="https://mock.com/DIYgod/RSSHub.html" referrerpolicy="no-referrer"></iframe>`,
             ],
-            desc: '<video src="http://mock.com/DIYgod/DIYgod/RSSHub"></video> - Made with love by RSSHub(https://github.com/DIYgod/RSSHub)',
+            desc: '<video src="http://mock.com/DIYgod/DIYgod/RSSHub"></video> - Powered by RSSHub',
         },
         relayed: {
             items: [
@@ -100,7 +100,7 @@ const expects = {
 <audio src="https://i3.wp.com/mock.com/DIYgod/RSSHub.mp3"></audio>
 <iframe src="https://mock.com/DIYgod/RSSHub.html" referrerpolicy="no-referrer"></iframe>`,
             ],
-            desc: '<video src="https://i3.wp.com/mock.com/DIYgod/DIYgod/RSSHub"></video> - Made with love by RSSHub(https://github.com/DIYgod/RSSHub)',
+            desc: '<video src="https://i3.wp.com/mock.com/DIYgod/DIYgod/RSSHub"></video> - Powered by RSSHub',
         },
         partlyRelayed: {
             items: [
@@ -113,7 +113,7 @@ const expects = {
 <audio src="https://i3.wp.com/mock.com/DIYgod/RSSHub.mp3"></audio>
 <iframe src="https://mock.com/DIYgod/RSSHub.html" referrerpolicy="no-referrer"></iframe>`,
             ],
-            desc: '<video src="https://i3.wp.com/mock.com/DIYgod/DIYgod/RSSHub"></video> - Made with love by RSSHub(https://github.com/DIYgod/RSSHub)',
+            desc: '<video src="https://i3.wp.com/mock.com/DIYgod/DIYgod/RSSHub"></video> - Powered by RSSHub',
         },
     },
 };

package/lib/middleware/cache.ts

@@ -6,23 +6,38 @@ import RequestInProgressError from '@/errors/types/request-in-progress';
 import cacheModule from '@/utils/cache/index';
 import { Data } from '@/types';
 
+const bypassList = new Set(['/', '/robots.txt', '/logo.png', '/favicon.ico']);
 // only give cache string, as the `!` condition tricky
 // md5 is used to shrink key size
 // plz, write these tips in comments!
 const middleware: MiddlewareHandler = async (ctx, next) => {
-    const { h64ToString } = await xxhash();
-    const key = 'rsshub:koa-redis-cache:' + h64ToString(ctx.req.path);
-    const controlKey = 'rsshub:path-requested:' + h64ToString(ctx.req.path);
-
-    if (!cacheModule.status.available) {
+    if (!cacheModule.status.available || bypassList.has(ctx.req.path)) {
         await next();
         return;
     }
 
+    const { h64ToString } = await xxhash();
+    const key = 'rsshub:koa-redis-cache:' + h64ToString(ctx.req.path);
+    const controlKey = 'rsshub:path-requested:' + h64ToString(ctx.req.path);
+
     const isRequesting = await cacheModule.globalCache.get(controlKey);
 
     if (isRequesting === '1') {
-        throw new RequestInProgressError('This path is currently fetching, please come back later!');
+        let retryTimes = process.env.NODE_ENV === 'test' ? 1 : 10;
+        let bypass = false;
+        while (retryTimes > 0) {
+            // eslint-disable-next-line no-await-in-loop
+            await new Promise((resolve) => setTimeout(resolve, process.env.NODE_ENV === 'test' ? 3000 : 6000));
+            // eslint-disable-next-line no-await-in-loop
+            if ((await cacheModule.globalCache.get(controlKey)) !== '1') {
+                bypass = true;
+                break;
+            }
+            retryTimes--;
+        }
+        if (!bypass) {
+            throw new RequestInProgressError('This path is currently fetching, please come back later!');
+        }
     }
 
     const value = await cacheModule.globalCache.get(key);

package/lib/middleware/logger.ts

@@ -1,3 +1,4 @@
+import { requestMetric } from '@/utils/otel';
 import { MiddlewareHandler } from 'hono';
 import logger from '@/utils/logger';
 import { getPath, time } from '@/utils/helpers';
@@ -34,7 +35,10 @@ const middleware: MiddlewareHandler = async (ctx, next) => {
 
     await next();
 
-    logger.info(`${LogPrefix.Outgoing} ${method} ${path} ${colorStatus(ctx.res.status)} ${time(start)}`);
+    const status = ctx.res.status;
+
+    logger.info(`${LogPrefix.Outgoing} ${method} ${path} ${colorStatus(status)} ${time(start)}`);
+    requestMetric.success(Date.now() - start, { path, method, status });
 };
 
 export default middleware;

package/lib/middleware/template.tsx

@@ -53,7 +53,7 @@ const middleware: MiddlewareHandler = async (ctx, next) => {
                     // https://stackoverflow.com/questions/1497885/remove-control-characters-from-php-string/1497928#1497928
                     // remove unicode control characters
                     // see #14940 #14943 #15262
-                    item.description = item.description.replaceAll(/[\u0000-\u0009\u000B\u000C\u000E-\u001F\u007F]/g, '');
+                    item.description = item.description.replaceAll(/[\u0000-\u0009\u000B\u000C\u000E-\u001F\u007F\u200B\uFFFF]/g, '');
                 }
 
                 if (typeof item.author === 'string') {
@@ -94,18 +94,22 @@ const middleware: MiddlewareHandler = async (ctx, next) => {
         return ctx.json(result);
     }
 
-    // retain .ums for backward compatibility
-    if (outputType === 'ums' || outputType === 'rss3') {
-        return ctx.json(rss3(result));
-    } else if (outputType === 'json') {
-        ctx.header('Content-Type', 'application/feed+json; charset=UTF-8');
-        return ctx.body(json(result));
-    } else if (ctx.get('no-content')) {
+    if (ctx.get('no-content')) {
         return ctx.body(null);
-    } else if (outputType === 'atom') {
-        return ctx.render(<Atom data={result} />);
     } else {
-        return ctx.render(<RSS data={result} />);
+        // retain .ums for backward compatibility
+        switch (outputType) {
+            case 'ums':
+            case 'rss3':
+                return ctx.json(rss3(result));
+            case 'json':
+                ctx.header('Content-Type', 'application/feed+json; charset=UTF-8');
+                return ctx.body(json(result));
+            case 'atom':
+                return ctx.render(<Atom data={result} />);
+            default:
+                return ctx.render(<RSS data={result} />);
+        }
     }
 };
 

package/lib/middleware/trace.ts

@@ -0,0 +1,25 @@
+import { MiddlewareHandler } from 'hono';
+import { getPath } from '@/utils/helpers';
+import { config } from '@/config';
+import { tracer } from '@/utils/otel';
+
+const middleware: MiddlewareHandler = async (ctx, next) => {
+    if (config.debugInfo) {
+        // Only enable tracing in debug mode
+        const { method, raw } = ctx.req;
+        const path = getPath(raw);
+
+        const span = tracer.startSpan(`${method} ${path}`, {
+            kind: 1, // server
+            attributes: {},
+        });
+        span.addEvent('invoking handleRequest');
+        await next();
+        span.end();
+    } else {
+        // Skip
+        await next();
+    }
+};
+
+export default middleware;

package/lib/registry.test.ts

@@ -29,4 +29,12 @@ describe('registry', () => {
         const response = await app.request('/favicon.ico');
         expect(response.status).toBe(200);
     });
+
+    // healthz
+    it('/healthz', async () => {
+        const response = await app.request('/healthz');
+        expect(response.status).toBe(200);
+        expect(response.headers.get('cache-control')).toBe('no-cache');
+        expect(await response.text()).toBe('ok');
+    });
 });

package/lib/registry.ts

@@ -4,9 +4,12 @@ import { Hono, type Handler } from 'hono';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { serveStatic } from '@hono/node-server/serve-static';
+import { config } from '@/config';
 
 import index from '@/routes/index';
+import healthz from '@/routes/healthz';
 import robotstxt from '@/routes/robots.txt';
+import metrics from '@/routes/metrics';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -84,7 +87,7 @@ const app = new Hono();
 for (const namespace in namespaces) {
     const subApp = app.basePath(`/${namespace}`);
     for (const path in namespaces[namespace].routes) {
-        const wrapedHandler: Handler = async (ctx) => {
+        const wrappedHandler: Handler = async (ctx) => {
             if (!ctx.get('data')) {
                 if (typeof namespaces[namespace].routes[path].handler !== 'function') {
                     const { route } = await import(`./routes/${namespace}/${namespaces[namespace].routes[path].location}`);
@@ -93,12 +96,17 @@ for (const namespace in namespaces) {
                 ctx.set('data', await namespaces[namespace].routes[path].handler(ctx));
             }
         };
-        subApp.get(path, wrapedHandler);
+        subApp.get(path, wrappedHandler);
     }
 }
 
 app.get('/', index);
+app.get('/healthz', healthz);
 app.get('/robots.txt', robotstxt);
+if (config.debugInfo) {
+    // Only enable tracing in debug mode
+    app.get('/metrics', metrics);
+}
 app.use(
     '/*',
     serveStatic({

package/lib/router.js

@@ -66,9 +66,6 @@ router.get('/konachan.net/post/popular_recent/:period', lazyloadRouteHandler('./
 // EZTV
 router.get('/eztv/torrents/:imdb_id', lazyloadRouteHandler('./routes/eztv/imdb'));
 
-// 新京报
-router.get('/bjnews/:cat', lazyloadRouteHandler('./routes/bjnews/news'));
-
 // 米哈游
 router.get('/mihoyo/bh3/:type', lazyloadRouteHandler('./routes/mihoyo/bh3'));
 router.get('/mihoyo/bh2/:type', lazyloadRouteHandler('./routes/mihoyo/bh2'));
@@ -594,12 +591,6 @@ router.get('/zucc/cssearch/latest/:webVpn/:key', lazyloadRouteHandler('./routes/
 // checkee
 router.get('/checkee/:dispdate', lazyloadRouteHandler('./routes/checkee/index'));
 
-// Matters
-router.get('/matters/latest/:type?', lazyloadRouteHandler('./routes/matters/latest'));
-router.redirect('/matters/hot', '/matters/latest/heat'); // Deprecated
-router.get('/matters/tags/:tid', lazyloadRouteHandler('./routes/matters/tags'));
-router.get('/matters/author/:uid', lazyloadRouteHandler('./routes/matters/author'));
-
 // 古诗文网
 router.get('/gushiwen/recommend/:annotation?', lazyloadRouteHandler('./routes/gushiwen/recommend'));