paper-search-cli 0.1.0

package/dist/models/Paper.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 统一的学术论文数据模型
+ * 支持多个学术平台的标准化数据格式
+ */
+export interface Paper {
+    /** 唯一标识符 (如 arXiv ID, PMID, DOI) */
+    paperId: string;
+    /** 论文标题 */
+    title: string;
+    /** 作者列表 */
+    authors: string[];
+    /** 摘要 */
+    abstract: string;
+    /** DOI (数字对象标识符) */
+    doi: string;
+    /** 发布日期 */
+    publishedDate: Date | null;
+    /** PDF直接下载链接 */
+    pdfUrl: string;
+    /** 论文页面URL */
+    url: string;
+    /** 来源平台 (如 'arxiv', 'pubmed', 'webofscience') */
+    source: string;
+    /** 最后更新日期 */
+    updatedDate?: Date;
+    /** 学科分类 */
+    categories?: string[];
+    /** 关键词 */
+    keywords?: string[];
+    /** 被引次数 */
+    citationCount?: number;
+    /** 参考文献ID/DOI列表 */
+    references?: string[];
+    /** 期刊/会议名称 */
+    journal?: string;
+    /** 卷号 */
+    volume?: string;
+    /** 期号 */
+    issue?: string;
+    /** 页码范围 */
+    pages?: string;
+    /** 年份 */
+    year?: number;
+    /** 平台特定的额外元数据 */
+    extra?: Record<string, any>;
+}
+/**
+ * Paper工厂类，用于创建和验证Paper对象
+ */
+export declare class PaperFactory {
+    /**
+     * 创建Paper对象
+     */
+    static create(data: Partial<Paper> & Required<Pick<Paper, 'paperId' | 'title' | 'source'>>): Paper;
+    /**
+     * 将Paper对象转换为字典格式（用于序列化）
+     */
+    static toDict(paper: Paper): Record<string, any>;
+    /**
+     * 验证Paper对象是否有效
+     */
+    static validate(paper: Paper): boolean;
+}
+//# sourceMappingURL=Paper.d.ts.map

package/dist/models/Paper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paper.d.ts","sourceRoot":"","sources":["../../src/models/Paper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,KAAK;IAEpB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IAEd,WAAW;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,SAAS;IACT,QAAQ,EAAE,MAAM,CAAC;IAEjB,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IAEZ,WAAW;IACX,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAE3B,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IAEf,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;IAEZ,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IAGf,aAAa;IACb,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,WAAW;IACX,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,UAAU;IACV,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,WAAW;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,SAAS;IACT,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,SAAS;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC,GAAG,KAAK;IAyBlG;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAyBhD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;CAGvC"}

package/dist/models/Paper.js

@@ -0,0 +1,70 @@
+/**
+ * 统一的学术论文数据模型
+ * 支持多个学术平台的标准化数据格式
+ */
+/**
+ * Paper工厂类，用于创建和验证Paper对象
+ */
+export class PaperFactory {
+    /**
+     * 创建Paper对象
+     */
+    static create(data) {
+        return {
+            paperId: data.paperId,
+            title: data.title,
+            authors: data.authors || [],
+            abstract: data.abstract || '',
+            doi: data.doi || '',
+            publishedDate: data.publishedDate || null,
+            pdfUrl: data.pdfUrl || '',
+            url: data.url || '',
+            source: data.source,
+            updatedDate: data.updatedDate,
+            categories: data.categories || [],
+            keywords: data.keywords || [],
+            citationCount: data.citationCount || 0,
+            references: data.references || [],
+            journal: data.journal,
+            volume: data.volume,
+            issue: data.issue,
+            pages: data.pages,
+            year: data.year,
+            extra: data.extra || {}
+        };
+    }
+    /**
+     * 将Paper对象转换为字典格式（用于序列化）
+     */
+    static toDict(paper) {
+        return {
+            paper_id: paper.paperId,
+            title: paper.title,
+            authors: paper.authors.join('; '),
+            abstract: paper.abstract,
+            doi: paper.doi,
+            published_date: paper.publishedDate?.toISOString() || '',
+            pdf_url: paper.pdfUrl,
+            url: paper.url,
+            source: paper.source,
+            updated_date: paper.updatedDate?.toISOString() || '',
+            categories: paper.categories?.join('; ') || '',
+            keywords: paper.keywords?.join('; ') || '',
+            citation_count: paper.citationCount || 0,
+            references: paper.references?.join('; ') || '',
+            journal: paper.journal || '',
+            volume: paper.volume || '',
+            issue: paper.issue || '',
+            pages: paper.pages || '',
+            year: paper.year || null,
+            extra: JSON.stringify(paper.extra || {})
+        };
+    }
+    /**
+     * 验证Paper对象是否有效
+     */
+    static validate(paper) {
+        return !!(paper.paperId && paper.title && paper.source);
+    }
+}
+//# sourceMappingURL=Paper.js.map

package/dist/models/Paper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paper.js","sourceRoot":"","sources":["../../src/models/Paper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkEH;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,IAA4E;QACxF,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YAC7B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;YACnB,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;YACzC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;YACzB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;YACtC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;SACxB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAY;QACxB,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,cAAc,EAAE,KAAK,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,EAAE;YACxD,OAAO,EAAE,KAAK,CAAC,MAAM;YACrB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE;YACpD,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAC9C,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAC1C,cAAc,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;YACxC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAC9C,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;YACxB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;SACzC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAY;QAC1B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/platforms/ArxivSearcher.d.ts

@@ -0,0 +1,64 @@
+/**
+ * arXiv API集成模块
+ * 基于arXiv API v1.1实现论文搜索和下载功能
+ */
+import { Paper } from '../models/Paper.js';
+import { PaperSource, SearchOptions, DownloadOptions, PlatformCapabilities } from './PaperSource.js';
+export declare class ArxivSearcher extends PaperSource {
+    private readonly rateLimiter;
+    private readonly cache;
+    constructor();
+    getCapabilities(): PlatformCapabilities;
+    /**
+     * 搜索arXiv论文
+     */
+    search(query: string, options?: SearchOptions): Promise<Paper[]>;
+    private searchViaExportApi;
+    private fetchSearchPage;
+    private normalizeMaxResults;
+    private isTimeoutError;
+    private shouldUseWebFallback;
+    private isRateLimitError;
+    private waitForGlobalExportApiSlot;
+    private markGlobalExportApiCooldown;
+    private withArxivRateLimitLock;
+    private acquireArxivRateLimitLock;
+    private removeStaleArxivRateLimitLock;
+    private getArxivRateLimitPaths;
+    private readArxivRateLimitState;
+    private writeArxivRateLimitState;
+    private createArxivCooldownError;
+    private sleep;
+    private searchViaWebFallback;
+    private parseWebSearchResponse;
+    /**
+     * 下载PDF文件
+     */
+    downloadPdf(paperId: string, options?: DownloadOptions): Promise<string>;
+    /**
+     * 读取论文全文内容（从PDF中提取）
+     */
+    readPaper(paperId: string, options?: DownloadOptions): Promise<string>;
+    /**
+     * 构建搜索查询
+     */
+    private buildSearchQuery;
+    private normalizeSearchQuery;
+    private hasArxivQuerySyntax;
+    private escapeArxivTerm;
+    private webFallbackPageSize;
+    private mapWebSortOrder;
+    /**
+     * 映射排序字段
+     */
+    private mapSortField;
+    /**
+     * 解析搜索响应
+     */
+    private parseSearchResponse;
+    /**
+     * 解析单个arXiv条目
+     */
+    private parseArxivEntry;
+}
+//# sourceMappingURL=ArxivSearcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ArxivSearcher.d.ts","sourceRoot":"","sources":["../../src/platforms/ArxivSearcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAqDrG,qBAAa,aAAc,SAAQ,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;;IAe9C,eAAe,IAAI,oBAAoB;IAWvC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YAoD5D,kBAAkB;YAiClB,eAAe;IAwB7B,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,gBAAgB;YAIV,0BAA0B;YAwB1B,2BAA2B;YAW3B,sBAAsB;YAatB,yBAAyB;IAevC,OAAO,CAAC,6BAA6B;IAWrC,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,KAAK;YAIC,oBAAoB;IA8BlC,OAAO,CAAC,sBAAsB;IA0D9B;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAwClF;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBhF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;YACW,mBAAmB;IAqBjC;;OAEG;IACH,OAAO,CAAC,eAAe;CA6DxB"}