paper-search-cli 0.1.0

package/dist/platforms/SciHubSearcher.js

@@ -0,0 +1,398 @@
+/**
+ * Sci-Hub 论文搜索和下载器
+ * 支持多镜像站点轮询、自动健康检测和故障转移
+ */
+import axios from 'axios';
+import * as cheerio from 'cheerio';
+import * as fs from 'fs';
+import * as path from 'path';
+import { PaperSource } from './PaperSource.js';
+import { PaperFactory } from '../models/Paper.js';
+import { logDebug, logWarn } from '../utils/Logger.js';
+import { TIMEOUTS } from '../config/constants.js';
+export class SciHubSearcher extends PaperSource {
+    mirrorSites;
+    currentMirrorIndex = 0;
+    axiosInstance;
+    maxRetries = 3;
+    mirrorTestTimeout = TIMEOUTS.HEALTH_CHECK;
+    lastHealthCheck = null;
+    healthCheckInterval = 300000; // 5 minutes
+    constructor() {
+        super('Sci-Hub', 'https://sci-hub.se');
+        // 初始化镜像站点列表
+        this.mirrorSites = [
+            { url: 'https://sci-hub.se', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.st', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.ru', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.ren', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.mksa.top', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.ee', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.wf', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.yt', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.sci-hub.se', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.sci-hub.st', isWorking: true, failureCount: 0 },
+            { url: 'https://sci-hub.sci-hub.ru', isWorking: true, failureCount: 0 },
+        ];
+        this.axiosInstance = axios.create({
+            timeout: TIMEOUTS.DEFAULT,
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8',
+                'Accept-Language': 'en-US,en;q=0.5',
+                'Accept-Encoding': 'gzip, deflate, br',
+                'DNT': '1',
+                'Connection': 'keep-alive',
+                'Upgrade-Insecure-Requests': '1'
+            },
+            maxRedirects: 5,
+            validateStatus: (status) => status < 500
+        });
+    }
+    getCapabilities() {
+        return {
+            search: true,
+            download: true,
+            fullText: false,
+            citations: false,
+            requiresApiKey: false,
+            supportedOptions: ['maxResults']
+        };
+    }
+    /**
+     * 检测所有镜像站点的健康状态
+     */
+    async checkMirrorHealth() {
+        logDebug('Checking Sci-Hub mirror sites health...');
+        const healthPromises = this.mirrorSites.map(async (mirror, index) => {
+            try {
+                const startTime = Date.now();
+                const response = await axios.get(mirror.url, {
+                    timeout: this.mirrorTestTimeout,
+                    headers: this.axiosInstance.defaults.headers,
+                    maxRedirects: 2
+                });
+                const responseTime = Date.now() - startTime;
+                // 检查响应是否包含 Sci-Hub 特征
+                const html = response.data;
+                const isValidSciHub = html.includes('sci-hub') ||
+                    html.includes('Sci-Hub') ||
+                    html.includes('alexandra elbakyan');
+                this.mirrorSites[index] = {
+                    ...mirror,
+                    lastChecked: new Date(),
+                    responseTime,
+                    isWorking: response.status === 200 && isValidSciHub,
+                    failureCount: 0
+                };
+                if (this.mirrorSites[index].isWorking) {
+                    logDebug(`${mirror.url} - OK (${responseTime}ms)`);
+                }
+                else {
+                    logDebug(`${mirror.url} - Invalid response`);
+                }
+            }
+            catch (error) {
+                this.mirrorSites[index] = {
+                    ...mirror,
+                    lastChecked: new Date(),
+                    isWorking: false,
+                    failureCount: mirror.failureCount + 1
+                };
+                logDebug(`${mirror.url} - Failed`);
+            }
+        });
+        await Promise.allSettled(healthPromises);
+        // 按响应时间排序可用的镜像
+        this.mirrorSites.sort((a, b) => {
+            if (a.isWorking && !b.isWorking)
+                return -1;
+            if (!a.isWorking && b.isWorking)
+                return 1;
+            if (a.isWorking && b.isWorking) {
+                return (a.responseTime || Infinity) - (b.responseTime || Infinity);
+            }
+            return 0;
+        });
+        this.lastHealthCheck = new Date();
+        const workingCount = this.mirrorSites.filter(m => m.isWorking).length;
+        logDebug(`Health check complete: ${workingCount}/${this.mirrorSites.length} mirrors working`);
+        if (workingCount === 0) {
+            logWarn('Warning: No Sci-Hub mirrors are currently accessible!');
+        }
+    }
+    /**
+     * 获取当前可用的镜像站点
+     */
+    async getCurrentMirror() {
+        // 定期进行健康检查
+        if (!this.lastHealthCheck ||
+            Date.now() - this.lastHealthCheck.getTime() > this.healthCheckInterval) {
+            await this.checkMirrorHealth();
+        }
+        // 找到第一个可用的镜像
+        const workingMirror = this.mirrorSites.find(m => m.isWorking);
+        if (!workingMirror) {
+            // 如果没有可用镜像，重新检测
+            await this.checkMirrorHealth();
+            const retryMirror = this.mirrorSites.find(m => m.isWorking);
+            if (!retryMirror) {
+                throw new Error('No working Sci-Hub mirrors available');
+            }
+            return retryMirror.url;
+        }
+        return workingMirror.url;
+    }
+    /**
+     * 标记镜像站点失败并切换到下一个
+     */
+    async markMirrorFailed(mirrorUrl) {
+        const mirrorIndex = this.mirrorSites.findIndex(m => m.url === mirrorUrl);
+        if (mirrorIndex !== -1) {
+            this.mirrorSites[mirrorIndex].failureCount++;
+            if (this.mirrorSites[mirrorIndex].failureCount >= 3) {
+                this.mirrorSites[mirrorIndex].isWorking = false;
+                logDebug(`Mirror ${mirrorUrl} marked as failed after multiple attempts`);
+            }
+        }
+        // 尝试下一个镜像
+        const nextWorkingMirror = this.mirrorSites.find((m, idx) => idx > mirrorIndex && m.isWorking);
+        if (nextWorkingMirror) {
+            return nextWorkingMirror.url;
+        }
+        // 如果没有更多镜像，重新检测健康状态
+        await this.checkMirrorHealth();
+        return this.getCurrentMirror();
+    }
+    /**
+     * 通过 DOI 或 URL 搜索论文
+     */
+    async search(query, options) {
+        // Sci-Hub 主要通过 DOI 或直接 URL 工作
+        // 如果输入不是 DOI 或 URL，返回空结果
+        if (!this.isValidDOIOrURL(query)) {
+            return [];
+        }
+        try {
+            const paperInfo = await this.fetchPaperInfo(query);
+            if (paperInfo) {
+                return [paperInfo];
+            }
+        }
+        catch (error) {
+            logDebug('Sci-Hub search error:', error);
+        }
+        return [];
+    }
+    /**
+     * 验证输入是否为有效的 DOI 或 URL
+     */
+    isValidDOIOrURL(input) {
+        // DOI 模式：10.xxxx/xxxxx
+        const doiPattern = /^10\.\d{4,}\/[-._;()\/:a-zA-Z0-9]+$/;
+        // URL 模式
+        const urlPattern = /^https?:\/\/.+/;
+        // 也接受带有 doi: 前缀的格式
+        const doiPrefixPattern = /^doi:\s*10\.\d{4,}\/[-._;()\/:a-zA-Z0-9]+$/i;
+        return doiPattern.test(input) ||
+            urlPattern.test(input) ||
+            doiPrefixPattern.test(input);
+    }
+    /**
+     * 从 Sci-Hub 获取论文信息
+     */
+    async fetchPaperInfo(doiOrUrl) {
+        let currentMirror = await this.getCurrentMirror();
+        let retries = 0;
+        // 清理 DOI 格式
+        const cleanedQuery = doiOrUrl.replace(/^doi:\s*/i, '');
+        while (retries < this.maxRetries) {
+            try {
+                const searchUrl = `${currentMirror}/${cleanedQuery}`;
+                logDebug(`Searching on ${currentMirror} for: ${cleanedQuery}`);
+                const response = await this.axiosInstance.get(searchUrl);
+                if (response.status === 200) {
+                    const $ = cheerio.load(response.data);
+                    // 检查是否找到论文
+                    const pdfFrame = $('#pdf');
+                    const pdfEmbed = $('embed[type="application/pdf"]');
+                    const pdfIframe = $('iframe[src*=".pdf"]');
+                    let pdfUrl = '';
+                    // 尝试多种方式获取 PDF URL
+                    if (pdfFrame.length > 0) {
+                        pdfUrl = pdfFrame.attr('src') || '';
+                    }
+                    else if (pdfEmbed.length > 0) {
+                        pdfUrl = pdfEmbed.attr('src') || '';
+                    }
+                    else if (pdfIframe.length > 0) {
+                        pdfUrl = pdfIframe.attr('src') || '';
+                    }
+                    else {
+                        // 查找下载按钮
+                        const downloadButton = $('button[onclick*="download"]');
+                        if (downloadButton.length > 0) {
+                            const onclickAttr = downloadButton.attr('onclick') || '';
+                            const match = onclickAttr.match(/location\.href='([^']+)'/);
+                            if (match) {
+                                pdfUrl = match[1];
+                            }
+                        }
+                    }
+                    // 处理相对 URL
+                    if (pdfUrl && !pdfUrl.startsWith('http')) {
+                        if (pdfUrl.startsWith('//')) {
+                            pdfUrl = 'https:' + pdfUrl;
+                        }
+                        else if (pdfUrl.startsWith('/')) {
+                            pdfUrl = currentMirror + pdfUrl;
+                        }
+                    }
+                    if (pdfUrl) {
+                        // 提取标题（尝试从页面标题或 citation 信息获取）
+                        let title = $('title').text();
+                        const citation = $('#citation').text();
+                        if (citation) {
+                            // 从引用信息中提取标题
+                            const titleMatch = citation.match(/([^.]+)\./);
+                            if (titleMatch) {
+                                title = titleMatch[1].trim();
+                            }
+                        }
+                        // 清理标题
+                        title = title.replace(/\s*\|\s*Sci-Hub.*$/, '')
+                            .replace(/Sci-Hub\s*:\s*/, '')
+                            .trim();
+                        return PaperFactory.create({
+                            paperId: cleanedQuery,
+                            title: title || `Paper: ${cleanedQuery}`,
+                            source: 'scihub',
+                            authors: [],
+                            abstract: '',
+                            doi: this.isValidDOIOrURL(cleanedQuery) && cleanedQuery.includes('10.')
+                                ? cleanedQuery
+                                : '',
+                            publishedDate: null,
+                            pdfUrl: pdfUrl,
+                            url: searchUrl,
+                            extra: {
+                                mirror: currentMirror,
+                                fetchedAt: new Date().toISOString()
+                            }
+                        });
+                    }
+                    else {
+                        logDebug(`Paper not found on ${currentMirror}`);
+                        currentMirror = await this.markMirrorFailed(currentMirror);
+                        retries++;
+                    }
+                }
+                else {
+                    logDebug(`Unexpected status ${response.status} from ${currentMirror}`);
+                    currentMirror = await this.markMirrorFailed(currentMirror);
+                    retries++;
+                }
+            }
+            catch (error) {
+                logDebug(`Error fetching from ${currentMirror}:`, error.message);
+                currentMirror = await this.markMirrorFailed(currentMirror);
+                retries++;
+            }
+        }
+        return null;
+    }
+    /**
+     * 下载 PDF 文件
+     */
+    async downloadPdf(paperId, options) {
+        const savePath = options?.savePath || './downloads';
+        // 确保下载目录存在
+        if (!fs.existsSync(savePath)) {
+            fs.mkdirSync(savePath, { recursive: true });
+        }
+        // 首先获取论文信息
+        const paperInfo = await this.fetchPaperInfo(paperId);
+        if (!paperInfo || !paperInfo.pdfUrl) {
+            throw new Error(`Cannot find PDF for: ${paperId}`);
+        }
+        const fileName = `${paperId.replace(/[^a-zA-Z0-9]/g, '_')}.pdf`;
+        const filePath = path.join(savePath, fileName);
+        // 检查文件是否已存在
+        if (fs.existsSync(filePath) && !options?.overwrite) {
+            return filePath;
+        }
+        // 下载 PDF
+        let retries = 0;
+        let currentPdfUrl = paperInfo.pdfUrl;
+        while (retries < this.maxRetries) {
+            try {
+                logDebug(`Downloading PDF from: ${currentPdfUrl}`);
+                const response = await this.axiosInstance.get(currentPdfUrl, {
+                    responseType: 'stream',
+                    timeout: TIMEOUTS.DOWNLOAD
+                });
+                if (response.status === 200) {
+                    const writer = fs.createWriteStream(filePath);
+                    response.data.pipe(writer);
+                    return new Promise((resolve, reject) => {
+                        writer.on('finish', () => {
+                            resolve(filePath);
+                        });
+                        writer.on('error', reject);
+                    });
+                }
+                else {
+                    throw new Error(`Failed to download PDF: status ${response.status}`);
+                }
+            }
+            catch (error) {
+                logDebug(`Download attempt ${retries + 1} failed:`, error.message);
+                retries++;
+                if (retries < this.maxRetries) {
+                    // 尝试重新获取论文信息（可能 PDF URL 已更改）
+                    const updatedInfo = await this.fetchPaperInfo(paperId);
+                    if (updatedInfo?.pdfUrl && updatedInfo.pdfUrl !== currentPdfUrl) {
+                        currentPdfUrl = updatedInfo.pdfUrl;
+                        logDebug('Trying updated PDF URL...');
+                    }
+                    else {
+                        // 等待后重试
+                        await new Promise(resolve => setTimeout(resolve, 2000 * retries));
+                    }
+                }
+            }
+        }
+        throw new Error(`Failed to download PDF after ${this.maxRetries} attempts`);
+    }
+    /**
+     * 读取论文内容（Sci-Hub 不提供文本提取）
+     */
+    async readPaper(paperId, options) {
+        // Sci-Hub 只提供 PDF 下载，不提供文本提取
+        const filePath = await this.downloadPdf(paperId, options);
+        return `PDF downloaded to: ${filePath}. Please use a PDF reader to view the content.`;
+    }
+    /**
+     * 根据 DOI 获取论文
+     */
+    async getPaperByDoi(doi) {
+        return this.fetchPaperInfo(doi);
+    }
+    /**
+     * 获取镜像站点状态
+     */
+    getMirrorStatus() {
+        return this.mirrorSites.map(mirror => ({
+            url: mirror.url,
+            status: mirror.isWorking ? 'Working' : 'Failed',
+            responseTime: mirror.responseTime
+        }));
+    }
+    /**
+     * 手动触发健康检查
+     */
+    async forceHealthCheck() {
+        await this.checkMirrorHealth();
+    }
+}
+//# sourceMappingURL=SciHubSearcher.js.map

package/dist/platforms/SciHubSearcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SciHubSearcher.js","sourceRoot":"","sources":["../../src/platforms/SciHubSearcher.ts"],"names":[],"mappings":"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"}

package/dist/platforms/ScienceDirectSearcher.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ScienceDirect (Elsevier) Searcher
+ *
+ * Documentation: https://dev.elsevier.com/
+ * API Endpoints:
+ * - Search API: https://api.elsevier.com/content/search/sciencedirect
+ * - Article API: https://api.elsevier.com/content/article/doi/
+ *
+ * Required API Key: Yes (X-ELS-APIKey header)
+ * Get API key from: https://dev.elsevier.com/apikey/manage
+ */
+import { PaperSource, SearchOptions, DownloadOptions, PlatformCapabilities } from './PaperSource.js';
+import { Paper } from '../models/Paper.js';
+export declare class ScienceDirectSearcher extends PaperSource {
+    private client;
+    private rateLimiter;
+    private quotaManager;
+    constructor(apiKey?: string);
+    search(query: string, options?: SearchOptions): Promise<Paper[]>;
+    /**
+     * Parse result from new PUT API format
+     */
+    private parseNewApiResult;
+    /**
+     * Enrich papers with abstracts using Article Retrieval API
+     */
+    private enrichPapersWithAbstracts;
+    private parseEntry;
+    getArticleDetails(doi: string): Promise<Paper | null>;
+    getCapabilities(): PlatformCapabilities;
+    downloadPdf(paperId: string, options?: DownloadOptions): Promise<string>;
+    readPaper(paperId: string, options?: DownloadOptions): Promise<string>;
+    /**
+     * 获取引用此论文的文献列表(通过Crossref/OpenCitations)
+     */
+    getCitations(paperId: string): Promise<Paper[]>;
+    /**
+     * 获取论文的参考文献列表(通过Crossref)
+     */
+    getReferences(paperId: string): Promise<Paper[]>;
+}
+//# sourceMappingURL=ScienceDirectSearcher.d.ts.map

package/dist/platforms/ScienceDirectSearcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScienceDirectSearcher.d.ts","sourceRoot":"","sources":["../../src/platforms/ScienceDirectSearcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AA+DzD,qBAAa,qBAAsB,SAAQ,WAAW;IACpD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;gBAEvB,MAAM,CAAC,EAAE,MAAM;IA8BrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAsE1E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;OAEG;YACW,yBAAyB;YA6BzB,UAAU;IAwClB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAiD3D,eAAe,IAAI,oBAAoB;IAWjC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQhF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAkBrD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAiBvD"}