2.4 KiB
后端服务启停说明（Windows）
你当前是 Windows + PowerShell 环境，下面这份是可直接用的后端启停命令。
说明：仓库里的
scripts/*.sh是 Bash 脚本，Windows 原生 PowerShell 不能直接执行，所以会出现“启动不了”。
一、后端目录
后端目录：
offline-backend-20260512/backend/
下面命令默认都在这个目录执行。
二、Windows 下推荐启动方式
1) 开发模式启动（热重载）
uv run uvicorn app.gateway.app:app --host 0.0.0.0 --port 8001 --reload
2) 普通模式启动（无热重载）
uv run uvicorn app.gateway.app:app --host 0.0.0.0 --port 8001
如果你习惯
make dev / make gateway，Windows 上通常还需要额外安装 make，建议直接用上面两条uv run uvicorn更稳。
三、停止后端
如果后端在当前窗口前台运行：
- 直接按
Ctrl + C
如果窗口已经关了，或你想强制结束 8001 端口进程：
netstat -ano | findstr :8001
记下最后一列 PID 后执行：
taskkill /PID <PID> /F
四、首次安装依赖（只需一次）
在 offline-backend-20260512/backend 目录执行：
uv sync
如果 uv 命令不存在，先安装（任选其一）：
pip install uv
或（已安装 winget 时）：
winget install --id Astral-sh.uv -e
五、快速自检
启动后浏览器访问：
返回健康状态即表示后端正常。
六、常见问题
1) 报错：端口 8001 被占用
先执行：
netstat -ano | findstr :8001
然后 taskkill 对应 PID，再重启后端。
2) 报错：uv 不是内部或外部命令
先安装 uv（见上面的“首次安装依赖”），安装后重开一个 PowerShell 窗口再试。
3) 报错：模块/依赖缺失
重新执行：
uv sync
再启动。
{ "agent_type": "leader", "d_agent_thread_id": { "查询天气的智能体": "76c95f3e-ee02-4e9b-b767-6df129a5aea5", "查询黄历的智能体": "9a5536a1-5e1e-4345-b9b7-9807c31154e4", "main-agent": "276eac46-1acb-47e3-ad42-8f01af51e869" }, "agent_name": "main-agent", "new_message": "帮我看看今天出门合适吗", "skill_stop_names": ["查询天气的智能体","查询黄历的智能体"] }