diff --git a/启动.command b/启动.command new file mode 100755 index 0000000..0ead187 --- /dev/null +++ b/启动.command @@ -0,0 +1,47 @@ +#!/bin/bash +# Neural Sync 一键启动器 +# 双击此文件即可启动前后端服务 + +cd "$(dirname "$0")" + +echo "🚀 正在启动 Neural Sync..." +echo "" + +# 停止现有服务 +lsof -ti:8000 2>/dev/null | xargs kill -9 2>/dev/null || true +lsof -ti:5173 2>/dev/null | xargs kill -9 2>/dev/null || true +sleep 1 + +# 创建日志目录 +mkdir -p logs + +# 启动后端 +echo "▶️ 启动后端..." +cd backend +source ../venv/bin/activate +nohup uvicorn app.main:app --reload --port 8000 > ../logs/backend.log 2>&1 & +cd .. + +# 等待后端启动 +sleep 3 + +# 启动前端 +echo "▶️ 启动前端..." +cd frontend +nohup npm run dev -- --host > ../logs/frontend.log 2>&1 & +cd .. + +# 等待前端启动 +sleep 3 + +echo "" +echo "✅ 启动完成!" +echo "" +echo " 前端地址: http://127.0.0.1:5173" +echo " 后端地址: http://127.0.0.1:8000" +echo "" +echo "💡 停止服务: 双击 stop.sh 或 运行 ./stop.sh" +echo "💡 查看日志: tail -f logs/backend.log" +echo "" +echo "按任意键关闭此窗口..." +read -n 1 diff --git a/启动说明.md b/启动说明.md new file mode 100644 index 0000000..64106b7 --- /dev/null +++ b/启动说明.md @@ -0,0 +1,73 @@ +# Neural Sync 一键启动指南 + +## 启动方式 + +### 方式一:双击启动(推荐) + +在 Finder 中**双击**以下文件即可: + +| 文件 | 功能 | +|------|------| +| 📄 `启动.command` | 一键启动前后端 | +| 📄 `stop.sh` | 停止所有服务 | + +### 方式二:命令行启动 + +```bash +# 启动所有服务 +./start.sh + +# 或使用简化版 +./启动.command + +# 停止所有服务 +./stop.sh +``` + +### 方式三:Python 脚本(跨平台) + +```bash +# 启动 +python launcher.py + +# 停止 +python stop.py +``` + +## 服务地址 + +启动后访问以下地址: + +| 服务 | 地址 | 说明 | +|------|------|------| +| 前端 | http://127.0.0.1:5173 | 主界面 | +| 后端 | http://127.0.0.1:8000 | API 服务 | +| API 文档 | http://127.0.0.1:8000/docs | Swagger 文档 | + +## 查看日志 + +```bash +# 查看后端日志 +tail -f logs/backend.log + +# 查看前端日志 +tail -f logs/frontend.log +``` + +## 常见问题 + +### Q: 双击 .command 文件提示无法执行? +A: 在终端中运行以下命令添加执行权限: +```bash +chmod +x 启动.command +``` + +### Q: 前端/后端启动失败? +A: 检查日志文件: +```bash +cat logs/backend.log +cat logs/frontend.log +``` + +### Q: 端口被占用? +A: 运行 `./stop.sh` 清理端口后再启动。