课前准备：DeepSeek Harness 架构与配置跑通
1. 软件与账号
| 准备项 | 必要动作 | 成功标志 |
|---|---|---|
| Node.js | 教师课前统一安装到学生机 | 命令提示符输出版本号 |
| Harness 运行时 | 教师课前统一安装或学生课堂安装 | 命令提示符能启动 dsh |
| DeepSeek API Key | 课前找老师领取或自己注册 | 能复制出一串 Key |
| 记事本 | 系统自带，记录配置路径 | 双击 txt 能正常打开 |
| Chrome 或 Edge | 能正常打开网页 | 双击图标能启动 |
| DeepSeek 官方仓库（选读） | 想深入了解架构的同学课前浏览 github.com/deepseek-ai | 能打开仓库页面即可 |
Node.js 的安装包来源与版本以教师课前指南为准：[课前演练补充]。DeepSeek API Key 与前两节课共用，上节课领过的这节课不用再领。
2. 本课目录
- 双击「此电脑 → D盘」，空白处右键「新建 → 文件夹」，建 AIGC；进入后同样建立 lesson-29，得到 D:\AIGC\lesson-29。
- 本课素材极少，目录用来放启动截图和任务记录，学生用记事本随手记。
- 课程资料见课程资料页。
3. 课前自查
| 查什么 | 成功标志 |
|---|---|
| Node.js 可用 | 命令提示符输入 node 后能看到版本号或帮助 |
| DeepSeek API Key | 已复制到记事本，长度较长且以 sk- 开头 |
| 本课目录 | 已建立 D:\AIGC\lesson-29 |
| 浏览器可打开本地服务 | 知道启动 Harness 后浏览器会自动打开 127.0.0.1 页面 |
4. 常见故障
- node 命令找不到：Node.js 未装或环境变量未生效，找老师处理；不要自行下载安装。
- npm 安装很慢：机房网络偶发慢速，等一会儿；超过 5 分钟找老师换镜像。
- dsh 命令找不到：npm 全局安装路径未进环境变量，找老师处理。
- DeepSeek Key 无效：核对是否完整复制、有没有多复制空格；仍失败找老师换备用 Key。
5. 教师课前实测
以下操作需要在实际机房电脑执行；素材检查通过不代表这些步骤已经验证。
| 实测项目 | 通过标志 |
|---|---|
| Node.js 版本 | 学生机 node --version 输出 v22 或更高 |
| Harness npm 源 | 机房网络下 npm install 全班能在 5 分钟内装完 |
| dsh web 可启动 | 演示机启动成功，浏览器自动打开界面 |
| DeepSeek Key 余额 | 备用 Key 数量足够，班级课前能跑通一轮测试 |
| 配置文件路径 | 记录机房实际配置文件所在目录，课堂讲到时直接告诉学生 |
| 四案例主线预演 | 各照讲义走一遍，产出与验收表一致，记录耗时 |
实测记录写入教师侧「备课设计与审查.md」，注明电脑环境、结果和耗时。配置文件的实际路径、插件市场的当前入口，以最新一次实测结果为准补充到讲义。