WPSBot/STARTUP_GUIDE.md

# WPS Bot Game 启动方式说明

## 🚀 多种启动方式

### 1. 命令行参数启动（推荐）

#### 基本启动
```bash
python app.py --webhook-url "https://xz.wps.cn/api/v1/webhook/send?key=your_key"
```

#### 自定义参数启动
```bash
python app.py \
  --webhook-url "https://xz.wps.cn/api/v1/webhook/send?key=your_key" \
  --host 0.0.0.0 \
  --port 8080 \
  --workers 1 \
  --log-level debug
```

#### 短参数形式
```bash
python app.py -w "https://xz.wps.cn/api/v1/webhook/send?key=your_key" -p 8080 -l debug
```

### 2. 使用启动脚本

#### Linux/Mac
```bash
# 基本启动
./start.sh -w "https://xz.wps.cn/api/v1/webhook/send?key=your_key"

# 自定义参数
./start.sh -w "your_webhook_url" -p 8080 -l debug

# 查看帮助
./start.sh --help
```

#### Windows
```cmd
REM 基本启动
start.bat -w "https://xz.wps.cn/api/v1/webhook/send?key=your_key"

REM 自定义参数
start.bat -w "your_webhook_url" -p 8080 -l debug

REM 查看帮助
start.bat --help
```

### 3. 环境变量启动

#### 设置环境变量
```bash
# Linux/Mac
export WEBHOOK_URL="https://xz.wps.cn/api/v1/webhook/send?key=your_key"
export HOST="0.0.0.0"
export PORT="8080"
export LOG_LEVEL="debug"

# Windows
set WEBHOOK_URL=https://xz.wps.cn/api/v1/webhook/send?key=your_key
set HOST=0.0.0.0
set PORT=8080
set LOG_LEVEL=debug
```

#### 启动应用
```bash
python app.py
```

### 4. 配置文件启动

#### 创建配置文件
```bash
# 复制配置模板
cp config.env.example config.env

# 编辑配置文件
nano config.env
```

#### 配置文件内容
```env
WEBHOOK_URL=https://xz.wps.cn/api/v1/webhook/send?key=your_key
HOST=0.0.0.0
PORT=8080
WORKERS=1
LOG_LEVEL=debug
```

#### 启动应用
```bash
python app.py
```

## 📋 参数说明

| 参数 | 短参数 | 默认值 | 说明 |
|------|--------|--------|------|
| `--webhook-url` | `-w` | 无 | WPS Webhook URL |
| `--host` | `-H` | `0.0.0.0` | 服务器主机地址 |
| `--port` | `-p` | `11000` | 服务器端口 |
| `--workers` | 无 | `1` | 工作进程数 |
| `--log-level` | `-l` | `info` | 日志级别 |

## 🔧 生产环境部署

### 使用systemd服务
```bash
# 编辑服务文件
sudo nano /etc/systemd/system/wps-bot.service

# 服务文件内容
[Unit]
Description=WPS Bot Game
After=network.target

[Service]
Type=simple
User=your_user
WorkingDirectory=/path/to/WPSBotGame
ExecStart=/usr/bin/python3 app.py --webhook-url "your_webhook_url" --port 11000
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
```

### 使用Docker
```dockerfile
FROM python:3.10-slim

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .

CMD ["python", "app.py", "--webhook-url", "your_webhook_url"]
```

### 使用Nginx反向代理
```nginx
server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:11000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

## 🐛 故障排除

### 1. 端口被占用
```bash
# 查看端口占用
netstat -tlnp | grep :11000

# 杀死占用进程
sudo kill -9 PID

# 或使用其他端口
python app.py --port 8080
```

### 2. 权限问题
```bash
# 给启动脚本执行权限
chmod +x start.sh

# 检查文件权限
ls -la start.sh
```

### 3. 依赖问题
```bash
# 检查Python版本
python --version

# 安装依赖
pip install -r requirements.txt

# 检查依赖
python -c "import fastapi, uvicorn"
```

### 4. 网络问题
```bash
# 测试Webhook URL
curl -X POST "your_webhook_url" \
  -H "Content-Type: application/json" \
  -d '{"msg_type": "text", "content": {"text": "test"}}'

# 检查防火墙
sudo ufw status
sudo ufw allow 11000
```

## 📊 监控和日志

### 查看日志
```bash
# 实时查看日志
tail -f /var/log/wps-bot.log

# 查看系统日志
journalctl -u wps-bot -f

# 查看错误日志
grep ERROR /var/log/wps-bot.log
```

### 健康检查
```bash
# 检查服务状态
curl http://localhost:11000/health

# 检查统计信息
curl http://localhost:11000/stats
```

### 性能监控
```bash
# 查看进程状态
ps aux | grep python

# 查看内存使用
free -h

# 查看磁盘使用
df -h
```