fulltext-mode

全文模式开发规范

全文模式架构

环境变量配置

// 全文模式配置
const FULLTEXT_MODE = (process.env.FULLTEXT_MODE || 'disabled').toLowerCase();
const FULLTEXT_ENABLED = FULLTEXT_MODE === 'enabled' || FULLTEXT_MODE === 'auto';
const FULLTEXT_AUTO_DOWNLOAD = FULLTEXT_MODE === 'auto';

模式说明

• disabled: 禁用全文功能（默认）
• enabled: 启用全文检测，手动下载
• auto: 启用全文检测，自动下载可用的OA论文

全文检测流程

1. 开放获取检测

// 检测OA论文和全文可用性
async detectOpenAccess(article) {
    const oaInfo = {
        isOpenAccess: false,
        sources: [],
        downloadUrl: null,
        pmcid: null,
        doi: article.doi
    };
    
    // 1. 检查PMC免费全文
    // 2. 检查DOI的Unpaywall
    // 3. 检查出版商直接OA
    
    return oaInfo;
}

2. 多源检测策略

// PMC检测
async checkPMCContent(pmid) {
    const pmcUrl = `${PMC_BASE_URL}/?term=${pmid}`;
    // 检查PMC免费全文可用性
}

// Unpaywall检测
async checkUnpaywall(doi) {
    const unpaywallUrl = `${UNPAYWALL_API_URL}/${doi}?email=${email}`;
    // 检查Unpaywall数据库
}

// 出版商直接检测
async checkPublisherOA(doi) {
    const doiUrl = `https://doi.org/${doi}`;
    // 检查出版商网站免费PDF
}

PDF下载和缓存

下载配置

// PDF下载配置
const FULLTEXT_CACHE_DIR = path.join(CACHE_DIR, 'fulltext');
const PDF_CACHE_EXPIRY = 90 * 24 * 60 * 60 * 1000; // 90天过期
const MAX_PDF_SIZE = 50 * 1024 * 1024; // 50MB最大PDF大小

下载流程

// PDF下载方法
async downloadPDF(pmid, downloadUrl, oaInfo) {
    const response = await fetch(downloadUrl, {
        timeout: 60000, // 60秒超时
        headers: {
            'User-Agent': 'Mozilla/5.0 (compatible; PubMed-MCP-Server/2.0)',
            'Accept': 'application/pdf,text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8'
        }
    });
    
    // 检查文件大小限制
    // 保存PDF文件
    // 更新全文索引
}

缓存管理

// 检查PDF是否已缓存
isPDFCached(pmid) {
    const pdfPath = path.join(FULLTEXT_CACHE_DIR, `${pmid}.pdf`);
    if (fs.existsSync(pdfPath)) {
        const stats = fs.statSync(pdfPath);
        const age = Date.now() - stats.mtime.getTime();
        if (age < PDF_CACHE_EXPIRY) {
            return { cached: true, filePath: pdfPath, fileSize: stats.size };
        }
    }
    return { cached: false };
}