从UCSC到GATK：插件式科研软件如何连接不同分析阶段

插件先解决数据交换问题

初次载入的准备阶段讨论“插件先解决数据交换问题”时，要同时观察插件接口与UCSC资料源。在初次载入的准备阶段，前者给出当前对象，后者限定解释条件；两项没有对齐，即使页面能够打开，也只能证明读取成功。

跨设备复查的准备阶段可以把GATK流程视为输入，把通路注释视为线索。若跨设备复查的准备阶段发现输入变化而记录没有更新，结果就会失去出处；线索变化则应回到生成步骤，而不是只调整显示效果。

团队交接的准备阶段处理“这一点”还要区分事实与推论。版本依赖是团队交接的准备阶段能够直接保存的条件，结果复现可能经过筛选；把两者并列记录，才能看出内容来自原始资料还是处理流程。

版本升级的准备阶段不能用一张截图概括“这一点”。在版本升级的准备阶段，截图会隐藏插件接口的版本，也看不出UCSC资料源是否采用相同条件；版本升级的准备阶段保留文件名、生成时间和关键设置，才能解释设备间差异。

异常回看的准备阶段遇到“这一点”异常时，可以固定GATK流程，再单独改变通路注释。如果异常回看的准备阶段的结果随第二项改变，范围已经缩小；若结果不变，就应转查更早的输入或账号环境。

资料浏览与变异分析职责不同

结果导出的准备阶段可以把插件接口视为输入，把UCSC资料源视为线索。若结果导出的准备阶段发现输入变化而记录没有更新，结果就会失去出处；线索变化则应回到生成步骤，而不是只调整显示效果。

远程协作的准备阶段处理“资料浏览与变异分析职责不同”还要区分事实与推论。GATK流程是远程协作的准备阶段能够直接保存的条件，通路注释可能经过筛选；把两者并列记录，才能看出内容来自原始资料还是处理流程。

长期归档的准备阶段不能用一张截图概括“这一点”。在长期归档的准备阶段，截图会隐藏版本依赖的版本，也看不出结果复现是否采用相同条件；长期归档的准备阶段保留文件名、生成时间和关键设置，才能解释设备间差异。

初次载入的核对阶段遇到“这一点”异常时，可以固定插件接口，再单独改变UCSC资料源。如果初次载入的核对阶段的结果随第二项改变，范围已经缩小；若结果不变，就应转查更早的输入或账号环境。

跨设备复查的核对阶段也要写清“这一点”的结论边界。GATK流程在跨设备复查的核对阶段能够支持当前判断，却不能代表其他样本、账号或系统；分享时写明通路注释的适用范围，才能避免过度外推。

通路信息如何补充基因组坐标

团队交接的核对阶段处理“通路信息如何补充基因组坐标”还要区分事实与推论。插件接口是团队交接的核对阶段能够直接保存的条件，UCSC资料源可能经过筛选；把两者并列记录，才能看出内容来自原始资料还是处理流程。

版本升级的核对阶段不能用一张截图概括“这一点”。在版本升级的核对阶段，截图会隐藏GATK流程的版本，也看不出通路注释是否采用相同条件；版本升级的核对阶段保留文件名、生成时间和关键设置，才能解释设备间差异。

异常回看的核对阶段遇到“这一点”异常时，可以固定版本依赖，再单独改变结果复现。如果异常回看的核对阶段的结果随第二项改变，范围已经缩小；若结果不变，就应转查更早的输入或账号环境。

结果导出的核对阶段也要写清“这一点”的结论边界。插件接口在结果导出的核对阶段能够支持当前判断，却不能代表其他样本、账号或系统；分享时写明UCSC资料源的适用范围，才能避免过度外推。

远程协作的核对阶段讨论“这一点”时，要同时观察GATK流程与通路注释。在远程协作的核对阶段，前者给出当前对象，后者限定解释条件；两项没有对齐，即使页面能够打开，也只能证明读取成功。

版本升级为何可能改变结果

长期归档的核对阶段不能用一张截图概括“版本升级为何可能改变结果”。在长期归档的核对阶段，截图会隐藏插件接口的版本，也看不出UCSC资料源是否采用相同条件；长期归档的核对阶段保留文件名、生成时间和关键设置，才能解释设备间差异。

初次载入的比较阶段遇到“这一点”异常时，可以固定GATK流程，再单独改变通路注释。如果初次载入的比较阶段的结果随第二项改变，范围已经缩小；若结果不变，就应转查更早的输入或账号环境。

跨设备复查的比较阶段也要写清“这一点”的结论边界。版本依赖在跨设备复查的比较阶段能够支持当前判断，却不能代表其他样本、账号或系统；分享时写明结果复现的适用范围，才能避免过度外推。

团队交接的比较阶段讨论“这一点”时，要同时观察插件接口与UCSC资料源。在团队交接的比较阶段，前者给出当前对象，后者限定解释条件；两项没有对齐，即使页面能够打开，也只能证明读取成功。

版本升级的比较阶段可以把GATK流程视为输入，把通路注释视为线索。若版本升级的比较阶段发现输入变化而记录没有更新，结果就会失去出处；线索变化则应回到生成步骤，而不是只调整显示效果。

插件停用时应保留怎样的替代路径

异常回看的比较阶段遇到“插件停用时应保留怎样的替代路径”异常时，可以固定插件接口，再单独改变UCSC资料源。如果异常回看的比较阶段的结果随第二项改变，范围已经缩小；若结果不变，就应转查更早的输入或账号环境。

结果导出的比较阶段也要写清“这一点”的结论边界。GATK流程在结果导出的比较阶段能够支持当前判断，却不能代表其他样本、账号或系统；分享时写明通路注释的适用范围，才能避免过度外推。

远程协作的比较阶段讨论“这一点”时，要同时观察版本依赖与结果复现。在远程协作的比较阶段，前者给出当前对象，后者限定解释条件；两项没有对齐，即使页面能够打开，也只能证明读取成功。

长期归档的比较阶段可以把插件接口视为输入，把UCSC资料源视为线索。若长期归档的比较阶段发现输入变化而记录没有更新，结果就会失去出处；线索变化则应回到生成步骤，而不是只调整显示效果。

初次载入的解释阶段处理“这一点”还要区分事实与推论。GATK流程是初次载入的解释阶段能够直接保存的条件，通路注释可能经过筛选；把两者并列记录，才能看出内容来自原始资料还是处理流程。

插件工作流的适用边界

跨设备复查的解释阶段可以把GATK流程视为输入，把通路注释视为线索。若跨设备复查的解释阶段发现输入变化而记录没有更新，结果就会失去出处；线索变化则应回到生成步骤，而不是只调整显示效果。

团队交接的解释阶段处理“这一点”还要区分事实与推论。版本依赖是团队交接的解释阶段能够直接保存的条件，结果复现可能经过筛选；把两者并列记录，才能看出内容来自原始资料还是处理流程。

版本升级的解释阶段不能用一张截图概括“这一点”。在版本升级的解释阶段，截图会隐藏插件接口的版本，也看不出UCSC资料源是否采用相同条件；版本升级的解释阶段保留文件名、生成时间和关键设置，才能解释设备间差异。

异常回看的解释阶段遇到“这一点”异常时，可以固定GATK流程，再单独改变通路注释。如果异常回看的解释阶段的结果随第二项改变，范围已经缩小；若结果不变，就应转查更早的输入或账号环境。

结果导出的解释阶段也要写清“这一点”的结论边界。版本依赖在结果导出的解释阶段能够支持当前判断，却不能代表其他样本、账号或系统；分享时写明结果复现的适用范围，才能避免过度外推。

远程协作的解释阶段讨论“这一点”时，要同时观察插件接口与UCSC资料源。在远程协作的解释阶段，前者给出当前对象，后者限定解释条件；两项没有对齐，即使页面能够打开，也只能证明读取成功。

长期归档的解释阶段可以把GATK流程视为输入，把通路注释视为线索。若长期归档的解释阶段发现输入变化而记录没有更新，结果就会失去出处；线索变化则应回到生成步骤，而不是只调整显示效果。

初次载入的复现阶段处理“这一点”还要区分事实与推论。版本依赖是初次载入的复现阶段能够直接保存的条件，结果复现可能经过筛选；把两者并列记录，才能看出内容来自原始资料还是处理流程。

跨设备复查的复现阶段不能用一张截图概括“这一点”。在跨设备复查的复现阶段，截图会隐藏插件接口的版本，也看不出UCSC资料源是否采用相同条件；跨设备复查的复现阶段保留文件名、生成时间和关键设置，才能解释设备间差异。

团队交接的复现阶段遇到“这一点”异常时，可以固定GATK流程，再单独改变通路注释。如果团队交接的复现阶段的结果随第二项改变，范围已经缩小；若结果不变，就应转查更早的输入或账号环境。

版本升级的复现阶段也要写清“这一点”的结论边界。版本依赖在版本升级的复现阶段能够支持当前判断，却不能代表其他样本、账号或系统；分享时写明结果复现的适用范围，才能避免过度外推。

异常回看的复现阶段讨论“这一点”时，要同时观察插件接口与UCSC资料源。在异常回看的复现阶段，前者给出当前对象，后者限定解释条件；两项没有对齐，即使页面能够打开，也只能证明读取成功。

结果导出的复现阶段可以把GATK流程视为输入，把通路注释视为线索。若结果导出的复现阶段发现输入变化而记录没有更新，结果就会失去出处；线索变化则应回到生成步骤，而不是只调整显示效果。

远程协作的复现阶段处理“这一点”还要区分事实与推论。版本依赖是远程协作的复现阶段能够直接保存的条件，结果复现可能经过筛选；把两者并列记录，才能看出内容来自原始资料还是处理流程。

长期归档的复现阶段不能用一张截图概括“这一点”。在长期归档的复现阶段，截图会隐藏插件接口的版本，也看不出UCSC资料源是否采用相同条件；长期归档的复现阶段保留文件名、生成时间和关键设置，才能解释设备间差异。

初次载入的分享阶段遇到“这一点”异常时，可以固定GATK流程，再单独改变通路注释。如果初次载入的分享阶段的结果随第二项改变，范围已经缩小；若结果不变，就应转查更早的输入或账号环境。

跨设备复查的分享阶段也要写清“这一点”的结论边界。版本依赖在跨设备复查的分享阶段能够支持当前判断，却不能代表其他样本、账号或系统；分享时写明结果复现的适用范围，才能避免过度外推。

团队交接的分享阶段讨论“这一点”时，要同时观察插件接口与UCSC资料源。在团队交接的分享阶段，前者给出当前对象，后者限定解释条件；两项没有对齐，即使页面能够打开，也只能证明读取成功。

版本升级的分享阶段可以把GATK流程视为输入，把通路注释视为线索。若版本升级的分享阶段发现输入变化而记录没有更新，结果就会失去出处；线索变化则应回到生成步骤，而不是只调整显示效果。

异常回看的分享阶段处理“这一点”还要区分事实与推论。版本依赖是异常回看的分享阶段能够直接保存的条件，结果复现可能经过筛选；把两者并列记录，才能看出内容来自原始资料还是处理流程。

结果导出的分享阶段不能用一张截图概括“这一点”。在结果导出的分享阶段，截图会隐藏插件接口的版本，也看不出UCSC资料源是否采用相同条件；结果导出的分享阶段保留文件名、生成时间和关键设置，才能解释设备间差异。

远程协作的分享阶段遇到“这一点”异常时，可以固定GATK流程，再单独改变通路注释。如果远程协作的分享阶段的结果随第二项改变，范围已经缩小；若结果不变，就应转查更早的输入或账号环境。