# H03 Qwen Code、Python、Jupyter 分别做什么

适用：全部教材，第3章起

---

## 工具分工

| 工具 | 做什么 | 不做什么 |
|---|---|---|
| **Qwen Code** | AI 协同开发：用自然语言描述任务，AI 生成代码和修改建议，你审查差异后决定接受或拒绝 | 不会自动保证修改正确；不能替你授权、验收或承担责任 |
| **Python** | 运行数据处理、模型训练、测试和评估的代码 | 不是 AI 本身；它只是执行你（或 AI）写的指令 |
| **Jupyter Notebook** | 把说明文字、代码、运行结果和实验记录按顺序放在一起 | 不是只看输出的演示幻灯片；你应该能解释每个核心代码单元 |
| **VS Code** | 打开限定工作区、查看差异、运行命令、管理文件 | 不会自动保证文件安全或项目正确 |
| **Ollama** | 在本地运行 AI 模型，提供 chat/embedding 等能力 | 不是云端服务；能力取决于模型大小和你的硬件 |

## 它们怎样配合

```
你在 Qwen Code 中描述任务
    ↓
Qwen Code 调用本地模型（Ollama）生成代码建议
    ↓
你查看差异（diff），决定接受哪些修改
    ↓
接受的修改写入 Python 文件或 Jupyter Notebook
    ↓
你在 VS Code 终端中运行 Python 或 Notebook
    ↓
观察输出、结果和错误
    ↓
把结果和解释记录在 Notebook 或实验日志中
```

## Qwen Code 使用要点

### 它能帮你做什么
- 生成数据处理代码
- 解释报错信息
- 建议修改方案
- 生成测试用例
- 帮你理解不熟悉的代码

### 你必须自己做什么
- 审查每次修改的差异
- 运行代码并观察结果
- 判断结果是否合理
- 决定接受或拒绝修改
- 保留协同证据

### 安全边界
- 工作目录限定在当前章节项目内
- 安装依赖、运行命令前必须你确认
- 不允许读取系统文件或其他私人文件
- 不自动批准所有修改

## Python 基础要求

你不需要从零学会 Python，但需要能：
- 读懂变量赋值、函数调用、条件判断和循环
- 看出代码中的输入、处理和输出
- 在 AI 协助下修改参数和数据
- 运行 `.py` 文件和 `.ipynb` Notebook

## Jupyter Notebook 使用要点

- 每个单元格可以独立运行
- 按从上到下的顺序运行，不要跳过
- 代码单元格旁的 `[1]` 表示第几次运行
- 如果结果不对，选 "Restart Kernel and Run All" 从头运行
- 在 Markdown 单元格中写你的观察和解释