00｜先让工作台完成一次任务

如果想获取全套课程资料，请关注微信公众号 「AI面包君」，回复 「课程资料」 即可领取。

一篇文章从需求到成稿，往往要经过找资料、写初稿和检查三个环节。我们要做的工作台，负责把这些环节串起来，并让你看见每一步交了什么、哪里还在等人。

这一节先把项目启动，再亲手提交一项任务。结束时，你应该能说清楚“确认计划”和“确认成稿”的区别，并导出一篇 Markdown 文章。暂时不用理解整套源码，先认识后面要拆开的这台机器。

1. 找到项目入口，准备 Python

打开下载后的 bread-collab-platform 文件夹。你应该能看到 run.py、requirements.txt、workbench 和 web。在文件夹地址栏输入 powershell 并回车，终端就会在这里打开。

先检查解释器：

python --version

课程用 Python 3.11 验证。若提示找不到 Python，先安装 Python 3.11，重新打开终端再检查；不要继续输入后面的命令。

接着逐行运行：

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt

第一行建立项目专用环境，第二行把依赖装进这个环境。后面使用完整的解释器路径，就是为了避免“装到一个 Python，运行时却用了另一个”。安装结束且没有报错后，再启动服务。

.\.venv\Scripts\python.exe run.py

终端出现 127.0.0.1:8766 的服务地址后，保持它开着，在浏览器输入 http://127.0.0.1:8766。若端口已被占用，先检查是否已经启动过一个工作台；浏览器无法连接时，先看终端有没有退出。

先把“文件、程序、网页”分清楚

第一次做这类项目，最容易卡住的地方往往还不是代码。你可能双击了 run.py，黑色窗口一闪就没了；也可能直接打开 web/index.html，看见了页面，却创建不了任务。

把它想成一家小餐馆会比较容易：磁盘里的文件是厨房设备和菜谱；执行 python run.py 是让厨房开始工作；浏览器里的网页是点单窗口。只有点单窗口，没有运行中的厨房，订单就不会被处理。这个类比只帮助理解前后端分工，后面真正传递的仍是 HTTP 请求。

所以本节要用两种窗口：终端负责让 Python 程序持续运行，浏览器负责让你提交任务。终端显示服务启动以后不再回到命令提示符，通常是正常现象，它正在等待请求。浏览器关闭了，服务还可以继续运行；终端里的服务停止了，已经打开的页面也可能暂时还在，但新的请求会失败。

例子：命令一样，为什么别人能运行，你却找不到文件

假设项目放在 D:\我的课程\bread-collab-platform，终端却停在 C:\Users\你的用户名。这时执行 python run.py，Python 会在当前目录找 run.py，它不会自动搜索整个硬盘。