快速开始
这份快速开始以“第一次成功执行”为目标,而不是覆盖所有功能。完成下面流程后,你应该能在本地构建 FastQTools、查看帮助,并对 stat / filter 两类工作负载有一个清晰印象。
成功标准
当你完成本页时,应该已经做到:
- 在仓库根目录准备好依赖;
- 构建出可执行文件;
- 成功查看 CLI 帮助;
- 知道下一步该去哪里查命令、配置与部署细节。
环境准备
在仓库根目录执行:
bash
./scripts/core/install-deps
./scripts/core/build --dev如果你只关心运行时验证,也可以使用默认 Release 构建:
bash
./scripts/core/build项目默认使用 scripts/core/* 作为统一入口,这样可以减少手动维护 Conan、CMake 目录与 preset 细节的成本。
第一次确认 CLI 可用
构建完成后,先确认二进制存在,再查看帮助:
bash
./build/clang-debug/FastQTools --help如果你刚刚执行的是默认 Release 构建,请改用:
bash
./build/clang-release/FastQTools --help你会看到全局日志选项以及 stat、filter 两个核心子命令。到这里为止,你已经验证了“工具能启动、命令入口存在”。
认识第一批工作流
stat:先建立证据
stat 负责把 FASTQ 输入转化为长度、碱基组成、质量分布等统计证据。它适合放在你正式过滤、调参或写报告之前。
bash
./build/clang-debug/FastQTools stat -i reads.fastq.gz -o stats.txtfilter:再执行清洗
filter 负责把质量阈值、长度阈值、修剪与预处理策略应用到输入数据上。
bash
./build/clang-debug/FastQTools filter -i reads.fastq.gz -o filtered.fastq.gz \
--min-quality 20 \
--min-length 50 \
--trim-quality 20 \
--trim-mode both上面两条命令不要求你现在就记住全部参数;真正的目标是让你知道项目的使用节奏通常是“先看证据,再决定过滤与部署策略”。