EEG脑电图数据处理基础

一、用 AI 做分析：让它写代码，而不是替你"办完"

●做法：你用中文提要求，AI 把代码写成脚本、运行，你看代码和输出来验收。

●为什么一定要留下脚本：论文的方法部分要能复现，用了什么软件、什么版本、每一步参数是多少，都得拿得出来。AI 在后台"帮你办完"却不留代码，这些就无从说起。

●你负责 AI 替代不了的部分：提什么要求、参数怎么定、结果对不对。

二、先搭好一个可复现的项目

● 项目文件夹：新建一个空文件夹放这个项目，路径里不要有中文和空格，不少科学计算软件遇到中文路径会出错。

● code、data、results 分开放：数据、代码、结果各归其位，任何一个结果都能追溯到是哪个脚本、哪份数据生成的。

● 独立环境（.venv）：这个项目专用的 Python 和软件包，装在项目文件夹里，不动电脑原有的 Python；别的项目要用不同版本，也互不干扰。

● requirements.txt：环境里每个软件包的确切版本。论文里写软件版本、换电脑重建环境，都靠它。

三、一段提示词搭好环境

●AI 工具：Claude、Antigravity、ChatGPT（Codex）任选其一，用能直接读写文件、运行命令的模式，并在工具里打开项目文件夹。AI 执行命令前可能请你批准，点允许即可。

提示词：

提示词：

我的电脑是【macOS / Windows】，当前文件夹是我的一个脑电数据分析项目。请帮我搭建脑电数据分析环境：

1. 在当前文件夹里建 code、data、results 三个子文件夹；

2. 在当前文件夹里新建一个独立的 Python 虚拟环境，Python 版本用 3.12（MNE 最新版要求 3.10 及以上）；电脑上没有合适的版本就先装一个，不要改动或覆盖电脑上原有的 Python；

3. 在这个环境里安装 MNE-Python 最新稳定版、交互式波形浏览器 mne-qt-browser 和它需要的图形库 PyQt6，优先使用国内镜像源（如清华源），镜像只写在安装命令里，不改全局配置；

4. 把环境里的包及版本导出到 requirements.txt；

5. 在 code 文件夹里写一个脚本 00_check_env.py：打印 Python、MNE、mne-qt-browser 的版本；用 MNE 自带的下载函数把 EEGMMIDB 数据集 1 号被试的第 3 段下载到 data 文件夹，读取后弹出交互式波形窗口；

6. 用这个环境运行脚本，把输出给我看。

每条要求的用意：

|------------------------|---------------------------------------------------------|
| 要求 | 为什么这样写 |
| 建 code、data、results | 一开始就把项目结构定下来 |
| 独立虚拟环境，不改动原有 Python | 不污染系统；装坏了删掉 .venv 重来即可 |
| Python 3.12 | MNE 最新版要求 3.10 及以上，macOS 自带的 3.9 装不上；不写版本，AI 可能直接用系统自带的 |
| mne-qt-browser 和 PyQt6 | 交互式波形窗口靠它们；PyQt6 不会随 mne-qt-browser 自动装上，不写明窗口就弹不出来 |
| 优先国内镜像源，只写在安装命令里 | 下载快；不改全局配置，不影响电脑上其他项目 |
| 导出 requirements.txt | 版本留档，论文和复现都要用 |
| 写 00_check_env.py 并运行 | 用一个脚本一次验收：版本对不对、数据能不能下载、窗口能不能弹出 |

① 发出提示词

② AI 建好子文件夹和独立环境 .venv

③ 用清华镜像安装，并导出 requirements.txt

四、验收：看代码，看输出

看代码：

●脚本做了三件事：打印各软件的版本；用 MNE 自带的下载函数取一段公开脑电数据（EEGMMIDB 1 号被试第 3 段）；弹出交互式波形窗口。

● AI 会自作主张：本例它多装了一个 psutil，又给脚本加了 --auto-close 参数（窗口 3 秒后自动关闭，方便它自己把测试跑完）。都无害，但要看懂；用不上的，让 AI 删掉或说明理由。

看输出：

⑤ 用独立环境运行脚本

⑥ 运行输出：各软件版本

● 运行命令 以.venv/bin/python 开头，解释器路径以.venv/bin/python 结尾：脚本确实在项目的独立环境里运行。

● 版本号：Python 3.12.13、MNE 1.13.2，与 requirements.txt 里的记录一致。

● 弹出波形窗口：数据能下载、能读取、能显示，环境就算装好了。

⑦ 弹出的交互式波形窗口

●窗口刚打开时，波形挤成一团，通道名还带着点号（如Fc5.），都不是环境的问题，下一节专门处理。

五、出错怎么办，下次怎么用

● 出错不必自己查，把完整报错原样贴回给 AI。常见几类：Python 版本太旧；窗口弹不出（缺 PyQt6）；网络超时（换一个镜像源）；AI 工具提示命令被拦或自动模式不可用（改成逐条确认的模式）。

● 之后每条提示词末尾写一句"用项目文件夹里的独立环境运行"，AI 换了对话也不会用错环境。

● 换电脑或请合作者复现，用下面这段提示词按 requirements.txt 重建一模一样的环境：

当前文件夹是一个脑电数据分析项目，里面有 requirements.txt。请新建一个独立的 Python 3.12 虚拟环境，优先使用国内镜像源，按 requirements.txt 安装完全相同版本的软件包，然后用这个环境运行 code/00_check_env.py，把输出给我看。

● 论文方法可以这样写：数据处理使用 Python 3.12 与 MNE-Python 1.13（Gramfort 等，2013）完成，所用软件包及版本见补充材料。

本节留下的文件：

|------------------|-----------------------------------------------|
| 位置 | 内容 |
| .venv/ | 独立的 Python 3.12 环境：MNE、mne-qt-browser、PyQt6 等 |
| requirements.txt | 所有软件包及版本 |
| code/ | 00_check_env.py：环境检查脚本 |
| data/ | EEGMMIDB 1 号被试第 3 段（检查用） |
| results/ | 暂空，后续各节的结果存放于此 |