feat: 添加一键启动脚本

新增文件:
- 启动.command: macOS 双击启动脚本
- 启动说明.md: 启动使用说明

使用方式:
1. 双击 "启动.command" 即可启动前后端
2. 双击 "stop.sh" 即可停止服务

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Yuuuu 2026-02-20 23:00:27 +08:00
parent de57318632
commit 5194bf8c99
2 changed files with 120 additions and 0 deletions

47
启动.command Executable file
View File

@ -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

73
启动说明.md Normal file
View File

@ -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` 清理端口后再启动。