生信论文返修实战20讲 · 第19讲 · 整理稿件与提交材料

系列目录:生信论文返修实战20讲(当前第19讲)
- 第01讲:收到返修意见后怎么办?把审稿问题拆成可执行任务
- 第02讲:返修前先冻结分析:输入、版本与结果怎样重放
- 第03讲:样本量为什么对不上?核查纳入、排除与重复测量
- 第04讲:样本太少怎样回应?报告效应、区间与真实限制
- 第05讲:差异分析被质疑:模型、方向和多重检验逐项核查
- 第06讲:要求校正年龄和批次?先判断资料是否支持
- 第07讲:换个阈值还成立吗?做有边界的敏感性分析
- 第08讲:独立验证不一致怎么办?保留全部候选与证据
- 第09讲:富集结果怎样返修?检查背景、方向和贡献成员
- 第10讲:单细胞显著性可靠吗?先认清细胞、文库与供体
- 第11讲:细胞注释与比例被质疑:标记依据和分母怎样交代
- 第12讲:拟时序和通讯怎样改写?避免把推断写成机制
- 第13讲:模型性能过高先查什么?用随机标签识别数据泄漏
- 第14讲:只有ROC不够:校准、误差与简单基线一起评价
- 第15讲:生存分析怎样返修?事件、截点与模型假设核查
- 第16讲:审稿人要求补实验:公共数据能支持到哪一层
- 第17讲:图形与图注怎样修改?展示样本、效应与不确定性
- 第18讲:方法写到哪里才够?参数、版本与数据代码可用性
- 第19讲:逐条回复怎么写?把动作、证据和修改位置对应起来(本篇)
- 第20讲:提交返修前最后一查:正文、回复与附件保持一致
点击目录按篇次顺序学习;文末复现包包含全系列代码与起始数据。
逐条回复不是礼貌句堆积,而是证据与修改的对应表
分析做完以后,返修信仍可能写得含糊:反复感谢建议,却没有说明具体改变;声称已经修改,却找不到位置;对困难问题只说未来研究。本篇把前面形成的任务账本转成回复账本,让每条意见都能追踪到动作、证据、稿件位置和未解决部分。
教学审稿意见:请逐条说明如何处理上述问题,并指出正文与补充材料中的修改位置。
本篇回复账本是教学示例,使用四项已经有实际输出的任务,包括统计报告、独立研究核查、单细胞解释和因果措辞。位置采用“教学方法段”“教学结果段”等符号定位,不假装存在某份真实稿件的页码行号。真实提交时必须替换为最终文件中的实际位置。
一条完整回复需要五个部分
先准确复述或保留审稿人的问题,再说明采取的动作,随后给出关键证据,指向修改位置,最后说明仍存在的限制。并非每条都要很长,但不能省略影响判断的信息。比如“已增加验证”缺少对象、方法和结果,审稿人仍不知道是否回应了原问题。
回复不需要把正文全部复制过来。可以引用最关键的修改句,并说明完整内容在哪里。涉及模型或主要结论变化时,适当提供前后差异有帮助;纯格式修改则可以简洁说明。篇幅应由问题重要性决定,不能让长篇礼貌表达掩盖缺少实际动作。
PLOS Biology等期刊明确要求逐条回应并保留审稿建议的完整语境,具体提交文件要求仍需查目标期刊。本系列借此说明回复原则,不把某一期刊的所有要求当作通用规则。编辑意见、审稿意见和技术检查也应分别编号,避免遗漏来自编辑的关键要求。
| 回应状态 | 怎样写动作 | 怎样写证据与限制 |
|---|---|---|
| 同意且完成 | 说明实际修改 | 给出结果与定位 |
| 部分同意 | 拆开已解决与未解决部分 | 解释剩余影响 |
| 有依据地不同意 | 准确回应分歧 | 提供适用证据和替代处理 |
| 当前无法完成 | 说明具体障碍 | 调整结论或提出可审阅方案 |

完成与部分完成必须区分
本例统计结果文件、固定面板验证表和文库汇总均实际存在,因此账本检查可以验证文件路径。机制实验没有实施,相关回应只能说明收窄措辞与保留缺口,不能标成实验验证完成。文件存在检查也有限:它不能自动判断文件内容是否真正回答问题,仍需人工阅读。
例如审稿人要求供体级单细胞重分析,而当前资料只能做文库描述。我们可以完成不恰当推断的纠正,但不能声称供体级验证完成。账本状态应体现这个区别。本篇示例将“限制单细胞解释”记为完成动作,不将原始更高层级要求偷换成已经全部解决。
类似地,补充另一研究的表达结果可以完成表达相容性检查,却不能替代功能实验。回复中应直接说清证据层级,避免使用一个含义模糊的“验证”同时指代不同事情。第十六篇的证据缺口表可以作为这类回应的依据。

怎样写一条有内容的统计回复
教学简略版:“感谢建议,我们已修改统计方法。”改进版:“我们明确参考组为对照,比较方向为患者减对照;完整结果包含效应、名义区间及全部测试基因范围内的BH调整结果。方法段与图注使用同一规则,完整表见相应补充文件。”后者让审稿人能够核查动作是否与意见匹配。
英文示例:“We clarified the reference group and the UC-minus-Control contrast. The complete results include effect estimates, nominal confidence intervals, and BH-adjusted values across the tested genes. The methods and figure legends now use the same definitions.”实际稿件还需追加真实位置与文件编号。
如果统计修正改变了结论,应主动说明变化,而不是只报告方法更新。比如某候选不再有明确证据,就要更新结果、摘要和讨论,并在回复中说明影响。审稿人通常更需要知道修正后哪些判断仍成立,而不是软件运行了多少次。
怎样写一条部分完成的回应
教学中文示例:“我们同意原文因果措辞超过当前证据。新增公共资料分析支持表达关联,但功能干预未完成。因此已删除确证机制表述,将相关内容改为待检验假说,并在讨论中说明这一限制。”这段话没有把未完成实验藏起来,也说明了实质修改。
英文示例:“We agree that the original causal wording exceeded the evidence. Additional public-data analyses support an expression association, but intervention experiments have not been performed. We therefore removed the confirmatory mechanistic claim and state the remaining limitation.”
若确实不同意审稿人的某种方法建议,应解释该方法为何不适合数据或目标,提供依据,并提出能够回应担忧的替代检查。不要以“大家都这样做”作为理由,也不要把不同意见写成对审稿人能力的评价。讨论应集中在数据、假设和结论上。

定位信息什么时候填写
正文结构稳定后再生成最终页码与行号,避免回复指向旧版本。若目标期刊接受章节与图表定位,也应使用明确且唯一的名称。多个同名“补充表”或不连续编号会让核查变得困难。修改稿与清洁稿应对应同一内容版本。
本篇脚本使用教学位置字段,不提供虚假的具体页码。读者迁移到真实稿件时,需要逐条打开最终文件核对位置,不能把模板中的示意定位直接提交。代码可以检查字段是否为空,却不能自动保证某个行号确实包含相应修改。
运行方法与交付文件
下载文末完整复现包,先解压并保留目录结构,将R的工作目录切换到workbook目录。输入位于data,公共函数位于scripts/common.R,分篇结果位于results。附件保留前序输出,便于单篇学习;如果改变输入、模型或前序参数,应顺序重跑所有受影响步骤,避免新数据与旧结果混用。
Rscript scripts/19.R
本篇脚本会生成三张图和对应表格。先检查日志是否正常结束,再核对实际输出的样本、字段、尺度与正文,不要仅凭文件存在判断运行成功。环境记录来自实际验证,包版本不是自动锁定;安装时需保持R与依赖相容。完整顺序运行入口和原始公开数据整理方法见包内说明,模拟与公开观测数据分别标注。
下面列出本篇完整R脚本。初学者可先原样运行,再在副本中改变一个参数观察影响。保留原始输入,不通过改组别、补造临床字段或删除不合预期的样本来解决报错。遇到缺少文件,首先检查工作目录和前序依赖;遇到数值差异,先核查版本与输入,再解释科学含义。
source("scripts/common.R")
o<-start(19)
# 教学回复账本。未完成的实验不能写成已经完成。
r<-data.frame(id=c("R1.03","R1.05","R1.06","R1.07"),response=c("Corrected model reporting and FDR","Added fixed-panel separate-study analysis","Restricted single-cell inference to library summaries","Narrowed causal interpretation; experiments not performed"),evidence=c("results/05/discovery_de.csv","results/08/external_panel.csv","results/10/observed_library_means.csv","results/16/evidence_gap.csv"),location=c("Teaching Methods M2","Teaching Results R3","Teaching Limitations L2","Teaching Discussion D1"),status=c("Done","Done","Done","Partial"))
r$file_exists<-file.exists(r$evidence);stopifnot(all(r$file_exists),!anyDuplicated(r$id),all(nzchar(r$location)));tab(r,paste0(o,"/response_audit.csv"))
fig(paste0(o,"/fig1.png"),barplot(table(r$status),col=c("#277D9D","#DF8A49"),ylab="Teaching response items",main="Done and partial must remain distinguishable"))
fig(paste0(o,"/fig2.png"),flow(c("Acknowledge the specific concern","State the actual action","Point to the numerical or methodological evidence","Identify the manuscript location","State what remains unresolved"),"A response is an evidence-linked explanation"))
fig(paste0(o,"/fig3.png"),flow(c("Agree: implement and document","Partly agree: separate resolved and unresolved parts","Disagree: give evidence and scope","Unable: explain impact and revise the claim"),"Different concerns require different responses"))
运行后查看回复审计表,核对意见编号唯一、证据文件存在、位置字段非空。随后人工阅读每个证据文件,确认它与回复描述一致。自动检查与科学核查应互相补充,不能因为表格全是通过就跳过内容阅读。
从审稿人的阅读顺序检查回复
审稿人通常先看自己的问题,再看作者声称做了什么,最后去稿件核查。因此回复应先给结论性的动作说明,再提供必要细节。不要从软件安装过程讲起,也不要让审稿人翻遍几十页附件才知道主要结果有没有改变。
对同一分析被多条意见引用的情况,可以复用证据,但每处应简要说明与当前问题的关系。简单写“见上一条”可能让回复脱离语境。另一方面,不必复制整段长文;给出明确编号和关键结论即可。
最后检查语气中的完成时。只有已经实施并有记录的动作才能写“我们已完成”。计划、正在进行和无法完成应如实表达。下一篇将把回复、正文、图表与附件放到同一张核查清单上,完成整套返修材料的一致性检查。
实操练习:把四种回应分别写一遍
选一条已经完成的统计修改,按问题、动作、证据、位置和限制写回复。不要先写感谢句,而是先确保五项信息齐全,再用简洁礼貌语言连接。完成后删除所有无法对应文件的完成声明,检查每个数值是否来自最终结果。这样的写法会自然减少空泛表达。
再选一条部分完成的意见,例如独立表达资料已经补充,但功能实验没有实施。将两部分分别写清,说明哪一项完成、哪一项仍缺以及结论怎样调整。不能把“已回应”与“已解决”混为一谈;一个问题可以得到认真回应,同时仍然影响论文的证据范围。
第三条练习处理有依据的不同意。先准确说明审稿人的担忧,再解释建议方法为什么与当前数据或目标不匹配,提供直接相关依据,最后给出替代核查。语气聚焦科学问题,避免评价对方水平。即使不同意具体方法,也应尽力回答其背后的合理担忧。
第四条练习处理无法完成。写出具体障碍,说明已查找或尝试的范围,以及这项缺口如何影响主张。若需要编辑决定,应提出可审阅的修改方案,而不是把选择完全留给对方。比如将机制论文定位收窄为表达关联研究,比一句“未来会做”更能说明当前稿件的实际变化。
把四条回复放在一起检查完成时、过去时与计划语气。真实完成的动作使用明确完成表达,计划保持未来或条件表达,资料未知保持未知。英文润色时尤其注意不要为了流畅把“可能”“尚未”删掉,因为这会改变科学含义,不只是语言风格。
随后核对定位。打开最终清洁稿与标记稿,确认回复所说的段落、图表和附录确实存在,并且内容与回复一致。教学账本里的符号位置不能直接提交。若文稿重新排版导致行号改变,应更新全部定位,而不是让审稿人根据过期编号猜测。
请一位没有参与分析的同事按照审稿人视角阅读:能否在短时间内知道问题是否被处理、主要结果有没有改变、哪里可以核查、还有什么限制。如果需要作者口头解释才能理解,就修改回复结构。不要用大量附图替代一段清楚的关键说明。
最后检查是否遗漏编辑意见或同一条意见中的第二个问题。一条评论可能同时要求方法说明与结论收窄,完成前者并不自动完成后者。回复账本可以拆分子任务,但最终回应要保留完整上下文。这样的逐条核查能减少下一轮返修重复追问已经可以一次说清的问题。
代码、数据与继续阅读
下载完整返修复现包:20篇R脚本、整理输入、起始结果、运行说明与版本记录。包含公共观测数据、明确标注的模拟与教学模板;不包含新实施的功能干预实验。解压后先阅读README。
承接第18讲:方法写到哪里才够?参数、版本与数据代码可用性。
下一篇第20讲:提交返修前最后一查:正文、回复与附件保持一致。
数据与方法来源
数据与方法核查日期:2026年11月16日。本文为教学二次分析;具体适用范围见正文。
需要把方法用到自己的数据中?
如果你需要把审稿意见转成具体分析任务,可以准备去标识的意见摘要、数据类型、当前脚本和主要证据缺口,沟通适合的核查范围与交付材料。 联系云生信,说明当前研究任务。
