PharmaCrawler v1.0.0 —— 便携版使用说明
==========================================

【怎么用】

  双击 START.bat          启动图形界面
  双击 SELFTEST.bat       自检（检查环境和接口是否正常）

  不需要安装 Python，也不需要 pip install 任何东西。


【重要：请整个文件夹一起用】

  不要把 PharmaCrawler.exe 单独拖出来！
  它旁边的 _internal 文件夹是程序的一部分，缺了就启动不了。

  想放到别处，请移动/复制**整个文件夹**。


【数据存在哪】

  数据就在这个文件夹里的 library\ 目录下：

    library\_records\     原始记录
    library\_index\       CSV / Excel / SQLite / Markdown 索引
    library\_export\      RIS / BibTeX / MEDLINE（给 EndNote / Zotero 用）
    library\_state\       断点续爬状态

  整个文件夹可以随便挪到别的盘、别的路径，数据始终跟着走。


【强烈建议：先配 API key】

  不配也能用，但配额差 120 倍：

                     无 key                有 key
    openFDA     1,000 次/天           120,000 次/天
    PubMed      3 请求/秒             10 请求/秒

  在图形界面「设置」页填入即可，或命令行：

    PharmaCrawler.exe auth set --openfda-key 你的KEY --pubmed-key 你的KEY --pubmed-email 你的邮箱

  openFDA 申请：https://open.fda.gov/apis/authentication/
  NCBI  申请：https://account.ncbi.nlm.nih.gov/   （Account settings → API Key Management）

  凭据存在用户目录 %USERPROFILE%\.pharma_crawler\，不会写进这个文件夹。


【命令行用法】

  在本文件夹打开命令行，例如：

    PharmaCrawler.exe crawl --dataset label --search "openfda.brand_name:\"aspirin\""
    PharmaCrawler.exe crawl --term "metformin[Title/Abstract] AND 2024:2024[PDAT]"
    PharmaCrawler.exe crawl --dataset shortages --search "status:\"Current\"" --dry-run
    PharmaCrawler.exe search 阿司匹林
    PharmaCrawler.exe stats
    PharmaCrawler.exe --help

  也可以直接跑源码（需 Python 3.9+）：

    python pharma_crawler.py --help


【注意】

  · 数据未经 FDA 校验，不得用于医疗决策。
  · PubMed 摘要可能受版权保护，再分发需权利人许可。
  · 上游改版时程序会明确报错，不会静默失败。
  · 详细说明见 README.md；接口实测细节见 docs\DATA_SOURCE_NOTES.md。

  项目主页：https://github.com/leerogerstheman/LeebertyPharma
