本地运行怎么做？
03-02 本地运行怎么做？
Section titled “03-02 本地运行怎么做？”这一课讲本地运行。第一版文件已经生成，项目还要真正跑起来，学员才能看到页面、输出或报错。
本地运行是 AI 编程项目的第一次现场验收。运行成功，学员获得第一份确定感；运行失败，也能拿到报错证据，进入排错流程。
这一课的成果是一份「本地运行记录」。
- 能根据技术路线选择运行方式。
- 能确认当前目录。
- 能运行静态 HTML、Node 项目或 Python 脚本的最小命令。
- 能复制运行结果或完整报错。
- 能把运行命令写入 README。
- 建议时长：30 到 40 分钟。
- 先用静态 HTML 演示，再快速说明 Node 和 Python。
- 每次运行前都强调当前目录。
- 报错出现时保持淡定，把它当作现场证据。
- 收尾把运行命令写进 README。
- 第一版项目文件。
- 技术路线选择卡。
- 终端。
- 浏览器。
- README。
可以这样开场：
“代码生成出来以后，要让它动起来。运行这一步，就像第一次给新做好的小机器通电。”
先讲共同原则：运行前确认当前目录。
终端命令是在某个文件夹里执行的。目录站错了，命令就会找不到文件。每次运行前，先让 AI 或终端确认当前项目目录。
可以这样问 AI：
请先告诉我这个项目的根目录应该是哪一个。我运行命令前应该站在哪个文件夹里？不同路线有不同运行方式。
静态 HTML：
直接双击 index.html，或用浏览器打开。也可以用本地服务打开，地址通常类似 localhost。第一项目如果是简单网页，优先用最容易的方式跑起来。
Node 项目：
常见流程是安装依赖，再运行开发命令。具体命令以 README 或 AI 生成的说明为准。学员要把命令、目录、输出一起记录。
Python 脚本：
常见流程是在项目目录里运行 Python 文件。输入文件放在 inputs，输出文件放在 outputs。
运行成功后，看结果。
- 页面有没有打开。
- 按钮或输入区有没有出现。
- 输出文件有没有生成。
- 终端有没有显示成功信息。
运行失败后，保留证据：
- 当前目录。
- 运行命令。
- 完整报错。
- 期待结果。
- 实际结果。
这里要告诉学员：
“运行失败不是终点，它只是给了我们一份排错材料。我们下一章会专门学怎么把这份材料交给 AI。”
最后收束：
“本地运行的意义，是让项目从文件变成现场。成功和报错都有价值，成功给确定感，报错给线索。”
屏幕演示流程
Section titled “屏幕演示流程”- 打开项目文件夹。
- 查看 README 中的运行说明。
- 确认当前目录。
- 按技术路线运行项目。
- 静态 HTML 用浏览器打开页面。
- Node 或 Python 项目演示最小运行思路。
- 观察页面或终端输出。
- 成功则截图记录。
- 失败则复制完整报错。
- 把运行命令和结果写进 README 或日志。
给 AI 的协作卡
Section titled “给 AI 的协作卡”我准备本地运行这个项目。请先读取 README、技术路线和项目文件列表。
请告诉我：1. 当前项目应该用什么方式运行2. 运行前要确认哪个目录3. 需要执行哪些命令或打开哪个文件4. 运行成功应该看到什么5. 如果失败，我要复制哪些信息给你
请一步一步给我，不要一次给太多命令。本地运行记录
Section titled “本地运行记录”- 项目名称：
- 当前目录：
- 技术路线：
- 运行方式：
- 运行命令或打开文件：
- 期待结果：
- 实际结果：
- 成功截图或报错：
- README 是否已更新：
让学员运行自己的第一版项目。
要求：
- 写出当前目录。
- 写出运行命令或打开方式。
- 保存成功截图或完整报错。
- 更新 README。
- 当前目录错误：先回到项目根目录。
- 双击打开页面但功能失效：看浏览器控制台或改用本地服务。
- Node 依赖缺失：保留完整报错，让 AI 判断安装步骤。
- Python 找不到文件：检查输入文件位置和文件名。
- AI 一次给太多命令：要求它一步一步给。
完成一次主项目本地运行。
提交内容：
- 本地运行记录。
- 运行成功截图或完整报错。
- README 里的运行说明。
- 第 1 页：第一次给小机器通电
- 第 2 页：运行前确认当前目录
- 第 3 页：三类运行方式
- 第 4 页：成功看什么
- 第 5 页：报错留什么
- 第 6 页：本地运行记录