Spectronaut Pipeline Pro用户使用说明书

适用版本：v3.3 (Windows x64)

Spectronaut_Pipeline_v33

1. 安装与环境准备

1.  软件依赖：确保本机已安装 Biognosys Spectronaut (v20.3+)，并且你有对应的License。

2.  运行程序：双击 `OmicSolution_Pipeline_v33.exe`。

注意：首次运行可能会弹窗询问 Spectronaut.dll 位置，通常位于 `C:\\Program Files x86\\Biognosys\\Spectronaut\\bin\\Spectronaut.dll`。*

2. 界面概览

软件分为四个主要标签页：

●Configuration: 设置路径和参数（由此开始）。

●Step 1: Library: 构建谱图库流程。

●Step 2: DIA Analysis: DIA定量分析流程。

●Analysis Summary: 数据质量统计表。

底部为 Log Panel（日志面板），实时显示系统状态和正在运行的任务。

3. 快速上手流程

OmicSolution-2025-VIP

第一步：项目配置 (Configuration)

1.  Raw Dir: 点击Browse选择存放 `.raw` 或 `.htrms` 文件的文件夹。

2.  Out Dir: 选择结果输出的根目录。建议新建一个空文件夹。

3.  Exp Name: 输入实验名称（将用于最终结果文件的命名）。

4.  Input Files:

    *   Fasta: 添加参考基因组数据库。

    *   Settings: 加载Spectronaut的 `.prop` 配置文件（如无，使用默认）。

    *   Schema: 加载结果导出格式 `.rs` 文件。

5.  点击 Validate & Initialize。

系统会自动扫描目录。如果是旧项目，会弹出“恢复向导”；如果是新项目，将解锁 Step 1 标签页。*

第二步：库构建 (Step 1)

进入 "Step 1: Library" 标签页。建议按顺序点击，或直接点击 >>> RUN ALL STEP 1 <<< 一键全自动运行。

●1.1 Database Search: 对每个Raw文件进行脉冲搜索。

●1.2 QSP Generation: 生成优化的搜索参数。

●1.3 Batch Processing: 基于QSP进行精细化处理。

●1.4 Library Generation: 合并生成最终谱图库 (.kit)。

第三步：DIA分析 (Step 2)

当 Step 1 完成（生成.kit文件）后，"Step 2" 标签页解锁。

1.  点击 2.1 DIA Analysis：对每个样本进行DIA定量。

2.  选择合并模式：

    *   Merge: 标准流程，生成一个合并的SNE文件。

    *   Combine: 适用于超大规模数据，扁平化处理。

3.  点击 2.2 Execute Merge：生成最终报表。

第四步：查看结果与清洗

●   切换到 Analysis Summary 标签页，点击 Refresh，查看各样本的蛋白鉴定数。

●   点击 2.3 View Results (在Step 2页面) 打开数据清洗器：

    *   检查是否有重复运行产生的冗余文件。

    *   一键清理 Log 和 Temp 文件，打包归档。

4. 常见问题 (FAQ)

Q: 程序运行中途崩溃或我手动关掉了，怎么办？

A: 直接重新打开程序，加载相同的 Out Dir。Resume Wizard 会自动弹出，显示哪些步骤已完成（打钩✅），哪些未完成。点击 "Resume Project"，程序会自动跳过已完成的文件，只处理剩下的。

Q: 为什么日志里显示 "Skipped"？

A: 这是正常的。因为该样本在目标文件夹中已经存在结果文件，为了节省时间，程序自动跳过了它。如果您想重跑，请手动去文件夹删除对应的结果文件，或者使用工具自带的 Data Cleaner 删除。

Q: 能够同时处理多少个样本？

A: 在 Configuration 页面可以设置 Parallel Tasks。程序会根据您的CPU和内存自动推荐数值（通常为4-8个）。设置过高可能导致内存溢出报错。

Q: 如何强制停止？

A: 点击任何一个标签页底部的红色 STOP ALL 按钮。这会强制杀死后台所有的Spectronaut进程。请注意，正在写入的文件可能会损坏，下次运行时建议删除受影响的文件。