教程 03 · R 数据分析
用 Wisp Science + R 推进一次可核查的数据分析。
沿着一套图文工作流，建立本地项目，通过对话准备 R 环境，管理包与数据，并把分析要求落实为可以检查的代码、日志、表格和图表。
原文发布
01 / 学完你将能够
学完你将能够
- 创建 Wisp Science 项目，并为任务准备可用的 R 环境。
- 在改变系统之前，检查安装命令和危险操作授权。
- 安装所需 R 包，同时记录实际使用的精确版本。
- 根据文件大小把数据可靠地放入项目，并保留原始输入。
- 把分析需求写成包含输入、产物和检查点的明确计划。
- 接受结果之前，核查代码、日志、表格、图片和环境记录。
02 / 开始之前
开始之前
- 已经安装当前版本的 Wisp Science，并准备好本地项目目录。
- 已经配置可用的模型服务；原文以 DeepSeek 为例。
- 具备安装 R 和所需软件包的网络、磁盘空间与系统权限。
- 分析开始前，已经备份无法替代的原始数据。
1. 从项目开始，而不是从一条孤立提示词开始
原文首先安装 Wisp Science、配置模型服务，然后创建新项目。演示使用 DeepSeek API Key，但长期有效的方法是：先配置一个受支持的模型服务，再开始分析。
项目目录应当能够长期跟随这项工作。原始数据、脚本、日志、图片、表格和环境记录，在对话结束后仍应容易找到。
- 用研究问题或数据集为项目命名。
- 不要把模型服务密钥写进分析脚本或导出的报告。
- 长任务开始之前，先说明结果应该写入哪个目录。
2. 让 Wisp Science 准备 R，但逐项审查高权限操作
原文演示的请求是“在当前的电脑上安装最新的 R 语言环境”。更适合重复使用的写法是：先检查操作系统和已有 R 环境，展示计划执行的命令与目标版本，在得到授权后再修改电脑。
安装 R 可能下载程序、修改系统路径或申请管理员权限。Wisp Science 识别到危险操作时会暂停并要求确认；这里的确认是实际审查点，不应习惯性直接通过。
- 检查软件来源、安装位置、权限范围和完整命令。
- 优先使用 R 官方来源或操作系统可信的软件包管理器。
- 拒绝无法解释的删除、覆盖、放宽权限或系统级改动。
- 安装完成后运行 `R --version`，把结果保存在项目中。
3. 不仅要安装 R 包，还要记录实际安装的版本
原文展示了通过对话说出包名来发起安装。只有包名并不足以复现分析，因为软件源、R 兼容性和最终解析出的依赖版本都会随时间变化。
让 Wisp Science 保存 `R.version.string`、`sessionInfo()` 和实际调用的软件包版本。使用 Bioconductor 时记录其版本；需要长期复跑的项目可以选择使用 `renv` 锁定依赖。
- 只安装分析计划真正需要的软件包。
- 区分 CRAN、Bioconductor 和其他软件来源。
- 保存安装日志与警告，不要只留下最终成功状态。
- 分析进行到一半时，不要未经评估就整体升级环境。
4. 根据数据大小和敏感程度选择导入方式
较小文件可以像原文一样拖入窗口或作为附件添加。如果文件太大导致附件失败，可以把文件复制到项目目录，再把相对路径告诉 Agent，而不是反复尝试把整份数据塞进对话。
保留一份不改动的输入文件，建议放在 `data/raw` 等明确目录中，并把派生数据写到其他位置。正式分析前检查文件大小、行列数、列名、数据类型、缺失值、标识符和分组标签。
- 复制原始文件，不要移动或覆盖唯一一份原件。
- 使用稳定的文件名和项目相对路径。
- 确认分隔符、文本编码、工作表名称和标识符列。
- 处理敏感数据时，先确认哪些项目内容可能发送给所配置的模型服务。
5. 不要只说“分析一下”，而要建立分析契约
运行前写清研究目标、输入文件、关键变量、分组或比较、必须完成的检查、预期表格和图片，以及输出目录。先让 Wisp Science 展示计划，可以在耗时任务开始之前纠正错误假设。
计划、路径和授权确认以后，耗时分析可以继续运行，研究者可以暂时处理其他工作。但回来看到图片已经生成，并不能自动证明分析方法正确。
- 选择统计方法之前，先定义研究问题和比较设计。
- 明确要求工作流不修改原始数据。
- 为耗时或不可逆步骤设置中间检查点。
- 要求保留脚本、日志、表格和图片，而不只是文字答案。
6. 把生成结果当作待核查的材料
原文最后回到项目检查分析结果和图片。首先确认读取的是预期文件，样本数或行数符合预期，没有错误或警告悄悄改变分析路径。
随后把文字解释与保存的代码、日志、数据表和图片逐项对照。条件允许时，从干净会话重新生成关键汇总或图片。Wisp Science 可以加快执行和组织产物，但统计有效性与专业解释仍由研究者负责。
- 核对行列数、缺失值、组内样本数、过滤和转换步骤。
- 阅读警告与失败命令，而不只是最终成功信息。
- 确认 R 与软件包版本和 Methods 记录一致。
- 确认图片与其来源表格、图注相互一致。
- 记录假设、局限和所有人工修正。
SUMMARY
关键结论
- 01
可靠分析从清晰的项目边界和明确计划开始。
- 02
安全授权意味着检查命令内容、来源和影响范围。
- 03
R 与软件包版本应当和代码、结果一起保存。
- 04
大文件可以通过项目路径引用，不必强行作为对话附件。
- 05
生成图片是需要核查的产物，不是结论自动成立的证明。
- 06
代码、日志、表格、环境记录与解释共同构成可检查的分析记录。
来源与署名
来源与署名
本文经授权依据「果子学生信」于 2026 年 7 月 15 日发布的《2026年学习R语言进行数据分析的新姿势》整理。本站保留原文工作流与截图，并补充安全审批、版本记录、大文件导入与结果核查说明。
原文作者: 果子学生信