人工智能技术应用课程讲义

课前准备：Ollama 安装与模型权重放置 ​

目标：课前完成 Ollama 安装，把 Qwen3-8B 权重放进本机课程目录。课堂上从案例1 开始直接装配模型。 完成标志：ollama -v 能输出版本号；curl.exe http://localhost:11434 返回 Ollama is running；D:\AIGC\lesson-6\models 里能看到 Qwen3-8B-Q4_K_M.gguf。 环境：本机课程目录固定为 D:\AIGC\lesson-6（课次号不补零）。建目录、放文件都用资源管理器点选完成；只有 ollama、curl 这类命令行工具才需要打开命令提示符（cmd）。

1. 机型方案 ​

课堂默认装配 Qwen3-8B 文本模型，导入后的模型名固定为 qwen3:8b。配置较高的同学可选装 Qwen3-VL-8B 多模态模型；8B 明显卡顿时先关闭大型应用，仍不行用教师指定的小文本 GGUF 保底完成导入链路。

方案模型适用同学必需文件建议
标准演示qwen3:8b全班默认Qwen3-8B-Q4_K_M.gguf（约 4.68 GB）纯文本、工具调用和课堂主流程
高配扩展qwen3-vl:8b内存/磁盘充足，想体验看图主模型约 4.7 GB + mmproj 约 1.1 GB两个文件都要导入
低配补救更小文本 GGUF8B 明显卡顿的同学教师指定的 0.6B/1.7B 量化文件只用于保底走通导入链路
检查项课堂建议说明
操作系统Windows 10/11学生机与机房统一
内存8B 建议 16GB 及以上，至少 8GBVL 模型建议预留更多可用内存
磁盘标准方案预留 8GB，追加 VL 再预留 8GB给下载缓存、模型文件和 Ollama 存储留空间
网络课前下载或从 U 盘复制课中只做装配和调试，不耗在大文件下载上
权限允许安装软件、打开命令提示符安装与验证都在命令提示符里完成

2. 安装 Ollama ​

方法 A：图形安装（机房推荐）

  1. 打开 https://ollama.com/download，下载 Windows 安装包（OllamaSetup.exe）。
  2. 双击安装，按提示完成。
  3. 打开命令提示符（Win + R → 输入 cmd → 回车），继续第 3 节的验证。

方法 B：命令行安装（联网可用）。提示找不到 winget 就改用方法 A：

bat
winget install --id Ollama.Ollama

安装结束后关闭并重新打开命令提示符，让 ollama 命令进入新的 PATH。

3. 验证 Ollama 服务 ​

在命令提示符里执行：

bat
ollama -v

能输出版本号说明命令可用。再执行：

bat
curl.exe http://localhost:11434

预期输出：

text
Ollama is running

注意：一律写 curl.exe（带 .exe 后缀），调用的才是系统自带的 curl，参数不会和其他同名命令混淆。服务没有自动启动时，先打开 Ollama 桌面应用，等系统托盘出现羊驼图标再重试。

4. 放置模型权重与课程目录 ​

权重文件已上传学习通：进入学习通 资料 / 2024人工智能 3-4 班 / 实训素材 / ollama 模型权重 下载 Qwen3-8B-Q4_K_M.gguf。

学习通模型权重下载入口

按下面结构放置（目录都用资源管理器右键新建，不敲命令）：

text
D:\AIGC\lesson-6\
├── models\
│   └── Qwen3-8B-Q4_K_M.gguf
├── Modelfile              ← 课上从课程资料页下载后改名（案例1）
├── 教学助手验收问题清单.txt  ← 课上下载（案例2）
├── request.json           ← 课上下载（案例3）
└── 故障工单_3条.txt         ← 课上下载（案例4）

高配同学把 VL 两个文件也放进 models：Qwen3VL-8B-Instruct-Q4_K_M.gguf 和 mmproj-Qwen3VL-8B-Instruct-F16.gguf，下载入口见课程资料「多模态扩展」分组。

5. 课前自查 ​

查什么成功标志
软件ollama -v 输出版本号
服务curl.exe http://localhost:11434 返回 Ollama is running
权重资源管理器里能看到 D:\AIGC\lesson-6\models\Qwen3-8B-Q4_K_M.gguf，大小约 4.68 GB
目录D:\AIGC\lesson-6 已建好，models 子文件夹在位

6. 常见故障 ​

  • ollama -v 提示找不到命令：关闭并重新打开命令提示符刷新 PATH；仍失败重装 Ollama。
  • curl.exe 连接被拒绝：Ollama 没在运行，打开 Ollama 桌面应用等托盘图标出现。
  • 学习通下载权重太慢或中断：改用课程资料页的 hf-mirror 直链，或从老师准备的 U 盘复制到 models 文件夹。
  • 磁盘空间不足：清理 D 盘后再下载；权重文件不到 5 GB，预留 8 GB 空间足够。

7. 教师课前实测 ​

  • 主线实测：按第 2–4 节在机房一台学生机完整走一遍，记录下载与安装耗时。
  • 关键依赖：学习通权重文件可下载、hf-mirror 直链可达、U 盘分发副本已更新到与学习通一致的版本。
  • 机房环境：学生机是否允许安装软件、命令提示符是否可用、托盘图标是否被策略隐藏。
  • 实测结果记录在 deliverables/aigc/lesson-06/备课设计与审查.md，逐项注明已测与未测。