用途:在 NGS 工作流需要包检查、安装规划或运行时验证时使用,先确认工具与资源是否已存在,再决定是否下载或安装。
主要能力:按顺序检查 PATH 可执行文件(command -v 或 shutil.which)、Python 导入、conda/mamba/micromamba/pip 已装包,必要时检查包索引或容器仓库;生成安装计划;单独检查参考基因组与数据库 bundle 就绪情况;支持 nf-core 适配器自动资源门禁。
使用方式:从仓库根目录运行 ngs_preflight.py,例如 --list、--tool fastqc --emit-install-plan、--pipeline dna_variant_calling --network-checks --emit-install-plan。用 --install-plan-outdir 输出 install_plan.json 与 install_commands.sh,后者默认仅审查,需显式设置 NGS_RUN_INSTALL_COMMANDS=1 才执行。资源检查用 ngs_reference_manager.py 的 list、check、explain-missing、plan、setup-plan、inventory、lock、verify-lock、check-all 等子命令。仅在用户明确要求时安装,优先隔离的 conda/mamba 环境或容器,不修改系统 Python。
适用场景:本地轻量 QC、DNA 变异检测、shotgun 宏基因组、ATAC 等流程的运行时与资源就绪评估,以及需要可审查权限交接的安装规划。
限制:缺失事实暂未提供,如具体支持的工具清单、平台兼容性、收费与价格信息。安装与下载需用户明确批准;大型参考/数据库下载默认保持审慎可审查。