制作可复现分析报告

Build a Reproducible Analysis Report · 🟡进阶 · 所属分类：科研办公、复现与知识管理

分析做完靠手动截图、复制数字贴进Word，改个阈值或换批数据就得从头核对一遍；过几个月自己都想不起某张图是哪段代码、什么参数跑出来的，更别说让合作者原样重跑。它把你的分析整理成文学化报告（Quarto/Rmd/Jupyter）——叙述、代码和图表放一起，所有数字由代码内联生成不用手打，顶部参数一改就能一键重跑，一条命令导出HTML/PDF/docx多种格式。

适合谁

分析要反复调参、换数据的研究生、想让报告可溯源可重跑的科研人、需要交付可复现分析的生信/数据工程师。

给它什么 · 得到什么

• 你提供：现有分析材料（R/Python脚本、Jupyter单元格，或「图表+文字解读」草稿）与输入数据路径、想暴露成参数的变量（阈值/分组/随机种子）、需缓存的耗时步骤、目标载体与产物格式
• 你得到：参数化的报告工程——.qmd/.Rmd/.ipynb源文件（叙述+代码+内联生成的图表）、顶部params声明支持换参重跑、一条命令导出多格式的渲染配置、固定种子与会话/依赖记录，外加一份「换参重跑核对」说明

怎么用

示例提问：「把我这个差异分析的脚本和图整理成Quarto报告，把显著性阈值和随机种子提成顶部参数，以后换数据或改阈值能一键重渲成HTML和PDF。」 触发后它把零散脚本拆成「叙述-代码块-输出」结构，抽出阈值/路径/种子做成参数，让所有数字图表由代码内联生成，再配好渲染工程和缓存。

提个醒

它只把你自己的真实分析结构化进报告，不代写结论、不美化数据，所有数字图表必须由代码从数据生成、不许手工贴。它本质是编排Quarto/knitr等渲染工具再做质控，不是自己算结果；可复现依赖你固定随机种子、导出PDF需要LaTeX环境，换参重跑若对不上会如实报告差异而非硬凑一致。