返回教程目录 · 适用版本：0.1.65
处理步骤或结果
| 现象 | 检查与处理 |
|---|---|
| 第四步无法开始 | 检查第三步是否有当前有效结果；试跑不满足正式前置条件 |
| 重跑上游后下游显示 stale | 下游仍依赖旧输入，需要从受影响步骤重新运行；历史结果保留 |
| 取消或重开后不能从内部进度继续 | 当前恢复以保存步骤为单位，不支持峰检测内部续算 |
| 试跑完成但 Raw data processing 没有打勾 | 正常；检查参数后点击 Process raw data 进行正式处理 |
| 页面显示的 feature 数与导出不同 | 检查当前筛选、分页和预览限制 |
| Exclude 后下游仍有该 feature | 人工 Exclude 是审查标记；实际清洗需另行运行 |
| MS2 / 注释字段为 No 或 NA | 可能未关联谱图或未做注释，不应直接判断“该物质不存在” |
| 修改参数后图没有改变 | 参数影响下一次运行；当前图属于保存的结果 |
输入与统计
| 报错或现象 | 检查与处理 |
|---|---|
| Sample IDs do not match | 检查文件名去扩展名后的 ID、大小写、前导零、重复与漏行 |
| Group column not found | 将 Group column 设置为样品信息中的真实列名 |
| QC filtering enabled but no QC samples | 核对定量 QC 的 class；没有合适 QC 时关闭依赖 QC 的设置 |
| 统计前仍存在缺失值 | 检查 cleaning 设置、填补方法和当前输入版本 |
| 配对分析报错 | 检查 subject ID，两组应一一对应，不能按行号推断 |
| Pathway analysis 没有结果 | 核对注释 ID、背景和输入筛选；空结果可能合理 |
| 峰形提取找不到文件 | 检查原始文件是否移动、改名或被替换 |
运行期间
任务中心面板可以关闭，计算会继续。若提示 R busy，说明当前操作需要新计算而 R 正忙；等待任务完成后再试。浏览已保存摘要与已缓存结果不应被理解为可以并发运行多个分析。
内存接近电脑总量时，先查看 Computer used 和 TidyMass used，区分系统其他进程与当前分析；按实际情况减少 worker 数或试跑规模。不要把增加线程数当作一定更快。
Shiny 与 R 包
- Missing package：在 R environment 安装正确来源的包，之后重启工具。
- Invalid R package name：检查是否把仓库名或 URL 当作包名；包名应以实际包元数据为准。
- not an exported object：检查 Manage tool 中的启动模式和函数名。
- 页面文字可读但图片丢失、样式异常：可能是静态资源路径问题，不一定是字符编码错误；保存日志和截图。
- 安装日志出现 warning：区分警告与导致失败的 error，查看最后状态及首个关键失败原因。
提交问题时提供什么
请提供软件版本、macOS/Windows 版本、具体工具或 workflow 步骤、运行 ID、复现操作和相关日志。数据问题可附脱敏的样品信息表头与几行示例。
保留出现问题的项目和运行记录，先不要删除缓存或历史结果。日志可能包含本地路径和样品标识，分享前检查其中的敏感信息。