v2er-insight 1.0.0

package/dist/core/analyzer/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Analyzer 类型入口
+ */
+export type { RawUserData } from './input';
+export type { ActivePeriod, TopicWithDate, ReplyWithDate, PeriodBoundary } from './internal';
+export type { UserOverview, SinglePeriodStats, PeriodsSummary, ContentTopic, ContentReply, PeriodContent, PeriodContentChunk, AnalyzerOutput, } from './output';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/analyzer/types/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Analyzer 类型入口
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/core/analyzer/types/input.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Analyzer 输入类型
+ */
+import type { V2exReply, V2exTopicDetail } from '../../../core/v2ex/types/entities';
+import type { UserProfileParseResult } from '../../../core/v2ex/types/parse-result';
+/** V2EX 抓取的原始用户数据 */
+export interface RawUserData {
+    profile: UserProfileParseResult;
+    topics: V2exTopicDetail[];
+    replies: V2exReply[];
+    isTopicsHidden: boolean;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/core/analyzer/types/input.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Analyzer 输入类型
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=input.js.map

package/dist/core/analyzer/types/internal.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Analyzer 内部类型
+ */
+import type { V2exReply, V2exTopicDetail } from '../../../core/v2ex/types/entities';
+/** 活跃期：两个暂停期之间的连续活动时间段 */
+export interface ActivePeriod {
+    index: number;
+    startDate: Date;
+    endDate: Date;
+    topics: V2exTopicDetail[];
+    replies: V2exReply[];
+}
+/** 带解析日期的帖子 */
+export interface TopicWithDate {
+    topic: V2exTopicDetail;
+    createdDate: Date;
+}
+/** 带解析日期的回复 */
+export interface ReplyWithDate {
+    reply: V2exReply;
+    replyDate: Date;
+}
+/** 活跃期边界 */
+export interface PeriodBoundary {
+    startDate: Date;
+    endDate: Date;
+}
+//# sourceMappingURL=internal.d.ts.map

package/dist/core/analyzer/types/internal.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Analyzer 内部类型
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=internal.js.map

package/dist/core/analyzer/types/output.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Analyzer 输出类型
+ */
+/** 用户总览 */
+export interface UserOverview {
+    joinDate: string;
+    lastActiveTime: string;
+    topicReplyRatio: number | null;
+    totalTopics: number | null;
+    totalReplies: number;
+    isTopicsHidden: boolean;
+    dailyRanking: number | null;
+}
+/** 单个活跃期统计 */
+export interface SinglePeriodStats {
+    timeRange: string;
+    topicCount: number;
+    avgTopicReplyCount: number;
+    avgTopicClickCount: number;
+    avgTopicLifecycleDays: number;
+    topicInteractionRatio: number;
+    topicHourDistribution: Record<number, number>;
+    topicNodeDistribution: Record<string, number>;
+    replyCount: number;
+    avgReplyLength: number;
+    directReplyRatio: number;
+    avgRepliedTopicHeat: number;
+    replyWeekdayDistribution: Record<string, number> | null;
+    replyNodeDistribution: Record<string, number>;
+}
+/** 活跃期统计汇总 */
+export interface PeriodsSummary {
+    totalPeriods: number;
+    periods: SinglePeriodStats[];
+}
+/** 发送给 AI 的帖子 */
+export interface ContentTopic {
+    title: string;
+    nodeName: string;
+    content: string;
+}
+/** 发送给 AI 的回复 */
+export interface ContentReply {
+    topicTitle: string;
+    nodeName: string;
+    content: string;
+}
+/** 活跃期内容（完整版） */
+export interface PeriodContent {
+    periodIndex: number;
+    topics: ContentTopic[];
+    replies: ContentReply[];
+}
+/** 活跃期内容分片 */
+export interface PeriodContentChunk {
+    periodIndex: number;
+    chunkIndex: number;
+    totalChunksInPeriod: number;
+    topics: ContentTopic[];
+    replies: ContentReply[];
+}
+/** Analyzer 最终输出 */
+export interface AnalyzerOutput {
+    userOverview: UserOverview;
+    summary: PeriodsSummary;
+    contents: Array<PeriodContent | PeriodContentChunk>;
+}
+//# sourceMappingURL=output.d.ts.map

package/dist/core/analyzer/types/output.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Analyzer 输出类型
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=output.js.map

package/dist/core/analyzer/utils/date-parser.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 日期解析工具
+ */
+/** 解析结果 */
+export interface ParsedDate {
+    date: Date;
+    hasTime: boolean;
+}
+/**
+ * 解析绝对时间
+ * 格式: "2024-01-16 10:00:00 +08:00"
+ */
+export declare function parseAbsoluteDate(dateStr: string): ParsedDate | null;
+/**
+ * 解析相对时间
+ * 格式: "3 分钟前", "2 小时前", "5 天前"
+ * @param relativeStr 相对时间字符串
+ * @param referenceDate 参考时间，默认为当前时间
+ */
+export declare function parseRelativeTime(relativeStr: string, referenceDate?: Date): ParsedDate | null;
+/**
+ * 解析中文日期格式
+ * 格式: "2025 年 4 月 21 日", "4 月 21 日", "1 月 7 日"
+ * @param dateStr 日期字符串
+ * @param referenceDate 参考时间，用于补充年份
+ */
+export declare function parseChineseDate(dateStr: string, referenceDate?: Date): ParsedDate | null;
+/**
+ * 格式化时间范围
+ * 输出: "2015-04-01 to 2017-08-15"
+ */
+export declare function formatTimeRange(start: Date, end: Date): string;
+/**
+ * 获取星期几
+ */
+export declare function getWeekday(date: Date): string;
+/**
+ * 获取小时 (0-23)
+ */
+export declare function getHour(date: Date): number;
+//# sourceMappingURL=date-parser.d.ts.map

package/dist/core/analyzer/utils/date-parser.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * 日期解析工具
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAbsoluteDate = parseAbsoluteDate;
+exports.parseRelativeTime = parseRelativeTime;
+exports.parseChineseDate = parseChineseDate;
+exports.formatTimeRange = formatTimeRange;
+exports.getWeekday = getWeekday;
+exports.getHour = getHour;
+/**
+ * 解析绝对时间
+ * 格式: "2024-01-16 10:00:00 +08:00"
+ */
+function parseAbsoluteDate(dateStr) {
+    const date = new Date(dateStr);
+    if (isNaN(date.getTime())) {
+        return null;
+    }
+    return { date, hasTime: true };
+}
+/**
+ * 解析相对时间
+ * 格式: "3 分钟前", "2 小时前", "5 天前"
+ * @param relativeStr 相对时间字符串
+ * @param referenceDate 参考时间，默认为当前时间
+ */
+function parseRelativeTime(relativeStr, referenceDate = new Date()) {
+    const patterns = [
+        { regex: /(\d+)\s*分钟前/, unit: 'minute', hasTime: true },
+        { regex: /(\d+)\s*小时前/, unit: 'hour', hasTime: true },
+        { regex: /(\d+)\s*天前/, unit: 'day', hasTime: false },
+    ];
+    for (const { regex, unit, hasTime } of patterns) {
+        const match = relativeStr.match(regex);
+        if (match?.[1]) {
+            const value = parseInt(match[1], 10);
+            const date = new Date(referenceDate);
+            switch (unit) {
+                case 'minute':
+                    date.setMinutes(date.getMinutes() - value);
+                    break;
+                case 'hour':
+                    date.setHours(date.getHours() - value);
+                    break;
+                case 'day':
+                    date.setDate(date.getDate() - value);
+                    break;
+            }
+            return { date, hasTime };
+        }
+    }
+    // 尝试解析中文日期格式
+    const chineseDateResult = parseChineseDate(relativeStr, referenceDate);
+    if (chineseDateResult) {
+        return chineseDateResult;
+    }
+    return null;
+}
+/**
+ * 解析中文日期格式
+ * 格式: "2025 年 4 月 21 日", "4 月 21 日", "1 月 7 日"
+ * @param dateStr 日期字符串
+ * @param referenceDate 参考时间，用于补充年份
+ */
+function parseChineseDate(dateStr, referenceDate = new Date()) {
+    // "2025 年 4 月 21 日" 格式
+    const fullMatch = dateStr.match(/(\d{4})\s*年\s*(\d{1,2})\s*月\s*(\d{1,2})\s*日/);
+    if (fullMatch) {
+        const year = parseInt(fullMatch[1], 10);
+        const month = parseInt(fullMatch[2], 10) - 1; // JS 月份从 0 开始
+        const day = parseInt(fullMatch[3], 10);
+        return { date: new Date(year, month, day), hasTime: false };
+    }
+    // "4 月 21 日" 格式（使用参考年份）
+    const shortMatch = dateStr.match(/(\d{1,2})\s*月\s*(\d{1,2})\s*日/);
+    if (shortMatch) {
+        const month = parseInt(shortMatch[1], 10) - 1;
+        const day = parseInt(shortMatch[2], 10);
+        const year = referenceDate.getFullYear();
+        const date = new Date(year, month, day);
+        // 如果日期在未来，则为去年
+        if (date > referenceDate) {
+            date.setFullYear(year - 1);
+        }
+        return { date, hasTime: false };
+    }
+    return null;
+}
+/**
+ * 格式化时间范围
+ * 输出: "2015-04-01 to 2017-08-15"
+ */
+function formatTimeRange(start, end) {
+    const format = (d) => {
+        const year = d.getFullYear();
+        const month = String(d.getMonth() + 1).padStart(2, '0');
+        const day = String(d.getDate()).padStart(2, '0');
+        return `${year}-${month}-${day}`;
+    };
+    return `${format(start)} to ${format(end)}`;
+}
+/** 星期几名称 */
+const WEEKDAY_NAMES = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'];
+/**
+ * 获取星期几
+ */
+function getWeekday(date) {
+    return WEEKDAY_NAMES[date.getDay()] ?? '未知';
+}
+/**
+ * 获取小时 (0-23)
+ */
+function getHour(date) {
+    return date.getHours();
+}
+//# sourceMappingURL=date-parser.js.map

package/dist/core/analyzer/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utils 入口
+ */
+export { parseAbsoluteDate, parseRelativeTime, formatTimeRange, getWeekday, getHour, type ParsedDate, } from './date-parser';
+export { average, topN, hourDistribution, weekdayDistribution } from './stats';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/analyzer/utils/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Utils 入口
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.weekdayDistribution = exports.hourDistribution = exports.topN = exports.average = exports.getHour = exports.getWeekday = exports.formatTimeRange = exports.parseRelativeTime = exports.parseAbsoluteDate = void 0;
+var date_parser_1 = require("./date-parser");
+Object.defineProperty(exports, "parseAbsoluteDate", { enumerable: true, get: function () { return date_parser_1.parseAbsoluteDate; } });
+Object.defineProperty(exports, "parseRelativeTime", { enumerable: true, get: function () { return date_parser_1.parseRelativeTime; } });
+Object.defineProperty(exports, "formatTimeRange", { enumerable: true, get: function () { return date_parser_1.formatTimeRange; } });
+Object.defineProperty(exports, "getWeekday", { enumerable: true, get: function () { return date_parser_1.getWeekday; } });
+Object.defineProperty(exports, "getHour", { enumerable: true, get: function () { return date_parser_1.getHour; } });
+var stats_1 = require("./stats");
+Object.defineProperty(exports, "average", { enumerable: true, get: function () { return stats_1.average; } });
+Object.defineProperty(exports, "topN", { enumerable: true, get: function () { return stats_1.topN; } });
+Object.defineProperty(exports, "hourDistribution", { enumerable: true, get: function () { return stats_1.hourDistribution; } });
+Object.defineProperty(exports, "weekdayDistribution", { enumerable: true, get: function () { return stats_1.weekdayDistribution; } });
+//# sourceMappingURL=index.js.map

package/dist/core/analyzer/utils/stats.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 统计工具
+ */
+/** 计算平均值 */
+export declare function average(values: number[]): number;
+/** 统计分布并返回 Top N */
+export declare function topN<T>(items: T[], getKey: (item: T) => string, n: number): Record<string, number>;
+/** 计算小时分布 (0-23) */
+export declare function hourDistribution(dates: Date[]): Record<number, number>;
+/** 计算星期分布（百分比） */
+export declare function weekdayDistribution(dates: Date[]): Record<string, number>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/core/analyzer/utils/stats.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * 统计工具
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.average = average;
+exports.topN = topN;
+exports.hourDistribution = hourDistribution;
+exports.weekdayDistribution = weekdayDistribution;
+/** 计算平均值 */
+function average(values) {
+    if (values.length === 0)
+        return 0;
+    const sum = values.reduce((acc, val) => acc + val, 0);
+    return sum / values.length;
+}
+/** 统计分布并返回 Top N */
+function topN(items, getKey, n) {
+    const counts = {};
+    for (const item of items) {
+        const key = getKey(item);
+        counts[key] = (counts[key] ?? 0) + 1;
+    }
+    // 按数量降序排序，取前 N
+    const sorted = Object.entries(counts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, n);
+    return Object.fromEntries(sorted);
+}
+/** 计算小时分布 (0-23) */
+function hourDistribution(dates) {
+    const dist = {};
+    for (const date of dates) {
+        const hour = date.getHours();
+        dist[hour] = (dist[hour] ?? 0) + 1;
+    }
+    return dist;
+}
+/** 计算星期分布（百分比） */
+function weekdayDistribution(dates) {
+    if (dates.length === 0)
+        return {};
+    const weekdays = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'];
+    const counts = {};
+    // 初始化所有天数为 0
+    weekdays.forEach((day) => {
+        counts[day] = 0;
+    });
+    for (const date of dates) {
+        const day = weekdays[date.getDay()] ?? '未知';
+        counts[day] = (counts[day] ?? 0) + 1;
+    }
+    // 转换为百分比
+    const total = dates.length;
+    const result = {};
+    for (const day of weekdays) {
+        // 即使无活动也要返回 0
+        result[day] = total === 0 ? 0 : (counts[day] ?? 0) / total;
+    }
+    // 按占比降序排序
+    const sortedEntries = Object.entries(result).sort(([, a], [, b]) => b - a);
+    return Object.fromEntries(sortedEntries);
+}
+//# sourceMappingURL=stats.js.map

package/dist/core/v2ex/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * V2EX 模块公共导出
+ * 提供 V2EX 业务相关的类型、URL 生成和 HTML 解析功能
+ */
+export type { V2exReply, V2exTopicDetail, UserProfileParseResult, RepliesPageParseResult, TopicsPageParseResult, TopicDetailParseResult, } from './types';
+export { getUserProfileUrl, getUserRepliesUrl, getUserTopicsUrl, getTopicUrl, extractTopicIdFromPath, } from './urls';
+export { parseUserProfile, parseRepliesPage, parseTopicsListPage, parseTopicDetail, } from './parsers';
+export { getUserProfile, getAllUserReplies, getAllUserTopicUrls, getAllUserTopicsDetail, } from './use-cases';
+export type { ServiceOptions, PagedResult, UserTopicUrlsResult, UserTopicsDetailResult, } from './use-cases';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/v2ex/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * V2EX 模块公共导出
+ * 提供 V2EX 业务相关的类型、URL 生成和 HTML 解析功能
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllUserTopicsDetail = exports.getAllUserTopicUrls = exports.getAllUserReplies = exports.getUserProfile = exports.parseTopicDetail = exports.parseTopicsListPage = exports.parseRepliesPage = exports.parseUserProfile = exports.extractTopicIdFromPath = exports.getTopicUrl = exports.getUserTopicsUrl = exports.getUserRepliesUrl = exports.getUserProfileUrl = void 0;
+// URL 生成器导出
+var urls_1 = require("./urls");
+Object.defineProperty(exports, "getUserProfileUrl", { enumerable: true, get: function () { return urls_1.getUserProfileUrl; } });
+Object.defineProperty(exports, "getUserRepliesUrl", { enumerable: true, get: function () { return urls_1.getUserRepliesUrl; } });
+Object.defineProperty(exports, "getUserTopicsUrl", { enumerable: true, get: function () { return urls_1.getUserTopicsUrl; } });
+Object.defineProperty(exports, "getTopicUrl", { enumerable: true, get: function () { return urls_1.getTopicUrl; } });
+Object.defineProperty(exports, "extractTopicIdFromPath", { enumerable: true, get: function () { return urls_1.extractTopicIdFromPath; } });
+// 解析器导出
+var parsers_1 = require("./parsers");
+Object.defineProperty(exports, "parseUserProfile", { enumerable: true, get: function () { return parsers_1.parseUserProfile; } });
+Object.defineProperty(exports, "parseRepliesPage", { enumerable: true, get: function () { return parsers_1.parseRepliesPage; } });
+Object.defineProperty(exports, "parseTopicsListPage", { enumerable: true, get: function () { return parsers_1.parseTopicsListPage; } });
+Object.defineProperty(exports, "parseTopicDetail", { enumerable: true, get: function () { return parsers_1.parseTopicDetail; } });
+// 服务层导出
+var use_cases_1 = require("./use-cases");
+Object.defineProperty(exports, "getUserProfile", { enumerable: true, get: function () { return use_cases_1.getUserProfile; } });
+Object.defineProperty(exports, "getAllUserReplies", { enumerable: true, get: function () { return use_cases_1.getAllUserReplies; } });
+Object.defineProperty(exports, "getAllUserTopicUrls", { enumerable: true, get: function () { return use_cases_1.getAllUserTopicUrls; } });
+Object.defineProperty(exports, "getAllUserTopicsDetail", { enumerable: true, get: function () { return use_cases_1.getAllUserTopicsDetail; } });
+//# sourceMappingURL=index.js.map

package/dist/core/v2ex/parsers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * V2EX 解析器导出
+ */
+export { parseUserProfile } from './user-profile';
+export { parseRepliesPage } from './replies-page';
+export { parseTopicsListPage } from './topics-list-page';
+export { parseTopicDetail } from './topic-detail';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/v2ex/parsers/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * V2EX 解析器导出
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTopicDetail = exports.parseTopicsListPage = exports.parseRepliesPage = exports.parseUserProfile = void 0;
+var user_profile_1 = require("./user-profile");
+Object.defineProperty(exports, "parseUserProfile", { enumerable: true, get: function () { return user_profile_1.parseUserProfile; } });
+var replies_page_1 = require("./replies-page");
+Object.defineProperty(exports, "parseRepliesPage", { enumerable: true, get: function () { return replies_page_1.parseRepliesPage; } });
+var topics_list_page_1 = require("./topics-list-page");
+Object.defineProperty(exports, "parseTopicsListPage", { enumerable: true, get: function () { return topics_list_page_1.parseTopicsListPage; } });
+var topic_detail_1 = require("./topic-detail");
+Object.defineProperty(exports, "parseTopicDetail", { enumerable: true, get: function () { return topic_detail_1.parseTopicDetail; } });
+//# sourceMappingURL=index.js.map

package/dist/core/v2ex/parsers/replies-page.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 回复列表页解析器
+ */
+import type { RepliesPageParseResult } from '../types/parse-result';
+/**
+ * 解析回复列表页
+ * @param html - 页面 HTML
+ * @returns 回复列表解析结果
+ */
+export declare function parseRepliesPage(html: string): RepliesPageParseResult;
+//# sourceMappingURL=replies-page.d.ts.map

package/dist/core/v2ex/parsers/replies-page.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * 回复列表页解析器
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRepliesPage = parseRepliesPage;
+const cheerio = __importStar(require("cheerio"));
+const utils_1 = require("./utils");
+const selectors_1 = require("./selectors");
+const { totalRepliesContainer: TOTAL_CONTAINER, replyItem: REPLY_ITEM, replyContent: REPLY_CONTENT, replyTime: REPLY_TIME, topicLink: TOPIC_LINK, nodeLink: NODE_LINK, memberLink: MEMBER_LINK, } = selectors_1.REPLIES_PAGE_SELECTORS;
+/**
+ * 解析回复列表页
+ * @param html - 页面 HTML
+ * @returns 回复列表解析结果
+ */
+function parseRepliesPage(html) {
+    const $ = cheerio.load(html);
+    const replies = [];
+    // 获取用户回复总数
+    let totalReplies = 0;
+    const headerText = $(TOTAL_CONTAINER).text();
+    const totalMatch = headerText.match(/回复总数\s+(\d+)/);
+    if (totalMatch?.[1]) {
+        totalReplies = parseInt(totalMatch[1], 10);
+    }
+    // 分页信息
+    const { currentPage, totalPages } = (0, utils_1.parsePagination)($);
+    // 解析每条回复
+    $(REPLY_ITEM).each((_, dockEl) => {
+        const dockArea = $(dockEl);
+        // .reply_content 在 .dock_area 的下一个兄弟元素 (.inner 或 .cell) 内部
+        const replyContentWrapper = dockArea.next();
+        const replyContent = replyContentWrapper.find(REPLY_CONTENT);
+        // 主题标题和回复总数
+        const topicLink = dockArea.find(TOPIC_LINK);
+        const topicTitle = topicLink.text().trim();
+        const topicHref = topicLink.attr('href') ?? '';
+        const replyCountMatch = topicHref.match(/#reply(\d+)/);
+        const topicReplyCount = replyCountMatch?.[1] ? parseInt(replyCountMatch[1], 10) : 0;
+        // 节点名称
+        const nodeLink = dockArea.find(NODE_LINK);
+        const nodeName = nodeLink.text().trim();
+        // 回复时间
+        const timeSpan = dockArea.find(REPLY_TIME);
+        const replyTime = timeSpan.text().trim();
+        // 回复内容处理
+        const contentHtml = replyContent.html() ?? '';
+        let content = replyContent.text().trim();
+        let isDirectReply = true;
+        let replyTo = null;
+        // 检查是否以 @ 开头（回复他人）
+        if (contentHtml.trim().startsWith('@')) {
+            isDirectReply = false;
+            const memberLink = replyContent.find(MEMBER_LINK).first();
+            if (memberLink.length > 0) {
+                replyTo = memberLink.text().trim();
+                // 移除 @用户名 部分（使用字符串方法避免 ReDoS）
+                const atPrefix = `@${replyTo}`;
+                if (content.startsWith(atPrefix)) {
+                    content = content.slice(atPrefix.length).trim();
+                }
+            }
+        }
+        replies.push({
+            topicTitle,
+            topicReplyCount,
+            nodeName,
+            replyTime,
+            content,
+            isDirectReply,
+            replyTo,
+        });
+    });
+    return {
+        totalReplies,
+        replies,
+        currentPage,
+        totalPages,
+    };
+}
+//# sourceMappingURL=replies-page.js.map

package/dist/core/v2ex/parsers/selectors/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * V2EX 选择器导出
+ * 集中管理所有页面的 DOM 选择器
+ */
+export { USER_PROFILE_SELECTORS } from './user-profile';
+export { REPLIES_PAGE_SELECTORS } from './replies-page';
+export { TOPICS_LIST_PAGE_SELECTORS } from './topics-list-page';
+export { TOPIC_DETAIL_SELECTORS } from './topic-detail';
+export { PAGINATION_SELECTORS } from './pagination';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/v2ex/parsers/selectors/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * V2EX 选择器导出
+ * 集中管理所有页面的 DOM 选择器
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGINATION_SELECTORS = exports.TOPIC_DETAIL_SELECTORS = exports.TOPICS_LIST_PAGE_SELECTORS = exports.REPLIES_PAGE_SELECTORS = exports.USER_PROFILE_SELECTORS = void 0;
+var user_profile_1 = require("./user-profile");
+Object.defineProperty(exports, "USER_PROFILE_SELECTORS", { enumerable: true, get: function () { return user_profile_1.USER_PROFILE_SELECTORS; } });
+var replies_page_1 = require("./replies-page");
+Object.defineProperty(exports, "REPLIES_PAGE_SELECTORS", { enumerable: true, get: function () { return replies_page_1.REPLIES_PAGE_SELECTORS; } });
+var topics_list_page_1 = require("./topics-list-page");
+Object.defineProperty(exports, "TOPICS_LIST_PAGE_SELECTORS", { enumerable: true, get: function () { return topics_list_page_1.TOPICS_LIST_PAGE_SELECTORS; } });
+var topic_detail_1 = require("./topic-detail");
+Object.defineProperty(exports, "TOPIC_DETAIL_SELECTORS", { enumerable: true, get: function () { return topic_detail_1.TOPIC_DETAIL_SELECTORS; } });
+var pagination_1 = require("./pagination");
+Object.defineProperty(exports, "PAGINATION_SELECTORS", { enumerable: true, get: function () { return pagination_1.PAGINATION_SELECTORS; } });
+//# sourceMappingURL=index.js.map

package/dist/core/v2ex/parsers/selectors/pagination.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 分页选择器
+ * 用于解析分页信息
+ */
+export declare const PAGINATION_SELECTORS: {
+    /** 当前页码 */
+    readonly currentPage: "a.page_current";
+    /** 其他页码链接 */
+    readonly pageLinks: "a.page_normal";
+};
+//# sourceMappingURL=pagination.d.ts.map