SCI投稿准备 · 2026/10/22
投稿系统要求代码审阅副本,权限和版本怎样准备?
冻结生成稿件结果的代码版本,检查审阅权限、运行依赖和限制说明。
投稿系统要求提供代码审阅副本时,作者常把正在开发的私有仓库地址贴上去。编辑可能没有权限,或能访问的分支已经不是生成论文结果的版本。代码材料的任务是让审阅者理解并尽可能复核文章结果,因此访问方式和版本必须同时准备。
先定位并冻结实际生成论文图表和统计结果的代码提交。记录提交哈希、发布标签、运行日期及对应的图表和表格。GitHub官方说明发布版本依托标签,标签指向仓库历史中的特定位置;只写默认分支名称不足以锁定结果。若算法需要模型权重或参数文件,还要记录其版本和校验值。清理临时凭据、个人数据与无关文件后,再制作供审阅的副本。
检查目标期刊对代码的具体要求。Nature Portfolio政策指出,支撑核心结论的未公开自编代码或算法可能需要供编辑和审稿人核查,并要求代码可用性声明说明访问条件。若代码受商业、伦理或第三方协议限制,不能简单写“暂不提供”;应事先核对可共享的部分、保密审阅方式和编辑是否接受限制。声明不要承诺作者实际上无法授予的权限。
为审阅副本写简洁的运行说明:环境与依赖版本、输入数据格式、主要命令、随机种子、预期输出和一次最小示例。若原始数据受限,可提供不含个人信息的小型测试数据,让审阅者至少验证接口和关键步骤。商业软件许可证若影响复现,也应列明,不要把许可证问题伪装成代码错误。输出示例应与文中图表编号对应,便于发现版本错位。
权限测试要用不是仓库成员的账号或期刊提供的审阅入口完成。确认匿名审阅要求、链接有效期、下载限制和受邀人员是否正确。私有仓库的普通浏览链接通常不能让外部审稿人直接访问;需要明确授权方式。若审阅阶段通过私密路径分享,发表后仍要按照期刊政策更新公开仓储或受限访问声明,并保持引用版本可追溯。
最后请合作者在干净环境中按说明运行一次最小示例,核对输出文件名、单位和结果摘要。若关键步骤依赖实验室内部路径或未公开脚本,应补齐或明确限制。代码审阅副本不是一个地址,而是一套能与稿件结果对上的确定材料。
还应检查审阅副本是否包含生成文章结果的全部辅助配置,例如排除样本清单、预处理字典和运行顺序。若代码从外部服务实时抓取数据,保存当时取得的输入快照或稳定标识;否则同一提交在不同日期可能输出不同结果。不要让审阅者为了复核一张图而逐个猜测参数。将关键参数表与稿件方法段并列核对。
参考信息:Nature Portfolio代码审阅政策;GitHub发布及访问文档。