feat(route): add codefather (编程导航) routes (#20922)

* feat(route): add LinuxDo RSS routes

- Add /linux-do/posts route for latest posts
- Add /linux-do/top/:period route for trending topics with period filter
- Optimize /linux-do/latest route
- Update namespace documentation with descriptions
- Handle Zstandard compression by using Accept-Encoding: identity

* revert: remove linux-do routes (PR rejected)

* feat(route): add codefather (编程导航) routes

- Add posts route with hot/new/recommend sorting and category filter
- Add questions route with new/hot sorting
- Support for 编程导航 programming community

* fix: address all PR review comments

- Reorder path params: category before sort
- Remove config.trueUA (not needed)
- Use upvotes/comments fields instead of description
- Remove title slicing
- Change default sort to 'new'
- Remove title from description
- Remove content truncation

Author: JackyST0

lib/routes/codefather/namespace.ts

@@ -0,0 +1,7 @@
+import type { Namespace } from '@/types';
+
+export const namespace: Namespace = {
+    name: '编程导航',
+    url: 'www.codefather.cn',
+    description: '编程导航是一个编程学习交流社区，由程序员鱼皮创建，提供学习路线、项目教程、求职攻略、技术交流等内容。',
+};

lib/routes/codefather/posts.ts

@@ -0,0 +1,111 @@
+import type { Route } from '@/types';
+import ofetch from '@/utils/ofetch';
+import { parseDate } from '@/utils/parse-date';
+
+const validCategories = new Set(['交流', '学习', '项目', '资源', '经验']);
+
+const sortFieldMap: Record<string, { field: string; name: string }> = {
+    hot: { field: 'thumbNum', name: '热门' },
+    new: { field: 'createTime', name: '最新' },
+    recommend: { field: 'recommendTime', name: '推荐' },
+};
+
+export const route: Route = {
+    path: '/posts/:category?/:sort?',
+    categories: ['programming'],
+    example: '/codefather/posts',
+    parameters: {
+        category: '分类，可选 `交流`、`学习`、`项目`、`资源`、`经验`，默认为全部',
+        sort: '排序方式，可选 `new`（最新）、`hot`（热门）、`recommend`（推荐），默认为 `new`',
+    },
+    features: {
+        requireConfig: false,
+        requirePuppeteer: false,
+        antiCrawler: false,
+        supportBT: false,
+        supportPodcast: false,
+        supportScihub: false,
+    },
+    radar: [
+        {
+            source: ['www.codefather.cn/', 'www.codefather.cn'],
+            target: '/posts',
+        },
+    ],
+    name: '帖子',
+    maintainers: ['JackyST0'],
+    handler,
+    description: '获取编程导航社区的帖子，支持按热门、最新、推荐排序，支持按分类筛选。',
+};
+
+async function handler(ctx) {
+    const category = ctx.req.param('category');
+    const sort = ctx.req.param('sort') || 'new';
+
+    const sortConfig = sortFieldMap[sort] || sortFieldMap.new;
+
+    const requestBody: Record<string, unknown> = {
+        current: 1,
+        pageSize: 20,
+        sortField: sortConfig.field,
+        sortOrder: 'descend',
+    };
+
+    if (category && validCategories.has(category)) {
+        requestBody.category = category;
+    }
+
+    const response = await ofetch('https://api.codefather.cn/api/post/list/page/vo', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: requestBody,
+    });
+
+    if (response.code !== 0) {
+        throw new Error(`API error: ${response.message}`);
+    }
+
+    const records = response.data?.records || [];
+
+    const items = records.map((item: Record<string, unknown>) => {
+        const content = (item.content as string) || '';
+        const pictureList = (item.pictureList as string[]) || [];
+        const user = (item.user as Record<string, unknown>) || {};
+        const tags = (item.tags as Array<{ tagName: string }>) || [];
+
+        // Build description content
+        let description = `<p>${content.replaceAll('\n', '<br>')}</p>`;
+
+        // Add images
+        if (pictureList.length > 0) {
+            description += '<div>';
+            for (const pic of pictureList) {
+                description += `<img src="${pic}" style="max-width: 100%;" />`;
+            }
+            description += '</div>';
+        }
+
+        return {
+            title: content.split('\n')[0] || '无标题',
+            link: `https://www.codefather.cn/post/${item.id}`,
+            description,
+            pubDate: parseDate(item.createTime as number),
+            author: user.userName as string,
+            category: [item.category as string, ...tags.map((t) => t.tagName)].filter(Boolean),
+            upvotes: item.thumbNum as number,
+            comments: item.commentNum as number,
+        };
+    });
+
+    const categoryName = category ? `${category} - ` : '';
+    const sortName = sortConfig.name;
+
+    return {
+        title: `编程导航 - ${categoryName}${sortName}帖子`,
+        link: 'https://www.codefather.cn/',
+        description: `编程导航社区${categoryName}${sortName}帖子`,
+        item: items,
+    };
+}

lib/routes/codefather/questions.ts

@@ -0,0 +1,92 @@
+import type { Route } from '@/types';
+import ofetch from '@/utils/ofetch';
+import { parseDate } from '@/utils/parse-date';
+
+export const route: Route = {
+    path: '/questions/:sort?',
+    categories: ['programming'],
+    example: '/codefather/questions',
+    parameters: {
+        sort: '排序方式，可选 `new`（最新）、`hot`（热门），默认为 `new`',
+    },
+    features: {
+        requireConfig: false,
+        requirePuppeteer: false,
+        antiCrawler: false,
+        supportBT: false,
+        supportPodcast: false,
+        supportScihub: false,
+    },
+    radar: [
+        {
+            source: ['www.codefather.cn/qa', 'www.codefather.cn'],
+            target: '/questions',
+        },
+    ],
+    name: '问答',
+    maintainers: ['JackyST0'],
+    handler,
+    description: '获取编程导航社区的问答内容，支持按最新、热门排序。',
+};
+
+async function handler(ctx) {
+    const sort = ctx.req.param('sort') || 'new';
+
+    const sortConfig = sort === 'hot' ? { field: 'favourNum', name: '热门' } : { field: 'createTime', name: '最新' };
+
+    const response = await ofetch('https://api.codefather.cn/api/qa/list/page/vo', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: {
+            current: 1,
+            pageSize: 20,
+            sortField: sortConfig.field,
+            sortOrder: 'descend',
+        },
+    });
+
+    if (response.code !== 0) {
+        throw new Error(`API error: ${response.message}`);
+    }
+
+    const records = response.data?.records || [];
+
+    const items = records.map((item: Record<string, unknown>) => {
+        const title = (item.title as string) || '无标题';
+        const content = (item.content as string) || '';
+        const user = (item.user as Record<string, unknown>) || {};
+        const tags = (item.tags as string[]) || [];
+        const bestComment = item.bestComment as Record<string, unknown> | undefined;
+
+        // Build description content
+        let description = `<div>${content.replaceAll('\n', '<br>')}</div>`;
+
+        // Add best answer
+        if (bestComment) {
+            const answerUser = (bestComment.user as Record<string, unknown>) || {};
+            description += '<hr><h4>💡 最佳回答</h4>';
+            description += `<p><strong>${answerUser.userName || '匿名'}</strong>：</p>`;
+            description += `<p>${(bestComment.plainTextDescription as string) || ''}</p>`;
+        }
+
+        return {
+            title,
+            link: `https://www.codefather.cn/qa/${item.id}`,
+            description,
+            pubDate: parseDate(item.createTime as number),
+            author: user.userName as string,
+            category: tags,
+            upvotes: item.thumbNum as number,
+            comments: item.commentNum as number,
+        };
+    });
+
+    return {
+        title: `编程导航 - ${sortConfig.name}问答`,
+        link: 'https://www.codefather.cn/qa',
+        description: `编程导航社区${sortConfig.name}问答`,
+        item: items,
+    };
+}