section-r-packages

# R 包教程 ## 开工核验 1. 先执行 `tutorial-authoring`，再读取 [content-structure.md](references/content-structure.md)。 2. 从包的 `DESCRIPTION`、官方站点、参考手册和 `NAMESPACE` 核对包名、版本、发布日期、许可证、依赖、导出函数和发布渠道。 3. 包处于 GitHub 开发、归档、同名冲突或接口快速变化时，在正文标注核验日期和版本。用户提供的介绍文只作为入口。 4. 对照 [package-comparison.md](references/package-comparison.md) 选择比较维度，不用星级、流行度或未经实测的速度下结论。 5. 按 [共同辨析合同](../tutorial-authoring/references/comparison-and-visuals.md) 检查相邻包、底层实现、同名函数和返回对象。若误选会改变方法或下游工作流，在第一个核心函数前先给定位表。 ## 内容主线 先回答包解决什么任务、与底层包或替代包是什么关系，再按真实任务组织函数。比较应覆盖任务边界、输入输出类型、默认行为、诊断和何时直接使用底层包；不能用接口更简洁推导方法更准确。至少给出一个从输入、函数调用、返回对象到诊断和解释的完整工作流。函数清单只保留能帮助导航的部分，不逐项抄写帮助页。 重要参数说明其改变的行为和失败边界。包封装统计模型时，既解释接口，也解释底层方法假设；“开箱即用”不等于结果可直接解释。 ## 代码与环境 - 所有声称可运行的函数都在文章标注版本下实跑，并检查返回对象结构。 - 优先使用小而有意义的内置或自建数据。随机示例设置种子。 - CRAN/Bioconductor 与官方 GitHub 安装分开说明；GitHub 包建议锁定版本或提交。教程构建不自动安装系统依赖。 - 若站点环境不含该包，可把安装示例保留为展示代码，并用独立、可追溯脚本生成真实图件；不能伪造输出。 - 批量示例必须记录失败分组，不用 `tryCatch()` 静默吞错。 ## 图件 按 [visual-templates.md](references/visual-templates.md) 选择真实函数输出、模型诊断、渲染截图或必要架构图。每张图说明包函数产生了什么对象，以及图不能证明什么。 ## 验证与导航 运行项目审计脚本、示例代码和目标文章渲染，扫描完整日志。更新 `doc/_quarto.yml` 后从 `doc/` 运行 `Rscript generate_sections.R`，再定向渲染 `sections/packages.qmd` 与 `index.qmd`。不因包教程更新而全站构建。