feat: 添加一键启动脚本
新增文件: - 启动.command: macOS 双击启动脚本 - 启动说明.md: 启动使用说明 使用方式: 1. 双击 "启动.command" 即可启动前后端 2. 双击 "stop.sh" 即可停止服务 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
de57318632
commit
5194bf8c99
|
|
@ -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
|
||||
|
|
@ -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` 清理端口后再启动。
|
||||
Loading…
Reference in New Issue