# WPS Bot Game 部署指南

## 📋 前置要求

- Ubuntu 20.04+ 服务器
- Python 3.10+（建议使用conda）
- 1GB内存 + 单核CPU
- sudo权限

## 🚀 快速部署

### 1. 上传项目到服务器

```bash
# 方式1: 使用scp
scp -r WPSBotGame/ user@server:/opt/wps-bot

# 方式2: 使用git
cd /opt
git clone <your-repo-url> wps-bot
```

### 2. 运行安装脚本

```bash
cd /opt/wps-bot
chmod +x deploy/install.sh
sudo bash deploy/install.sh
```

安装脚本会自动完成：
- ✅ 检查环境
- ✅ 安装依赖
- ✅ 创建数据目录
- ✅ 配置systemd服务

### 3. 配置环境变量

```bash
# 编辑配置文件
sudo nano /opt/wps-bot/.env

# 修改Webhook URL
WEBHOOK_URL=https://xz.wps.cn/api/v1/webhook/send?key=你的密钥
```

### 4. 启动服务

```bash
# 使用管理脚本（推荐）
chmod +x deploy/manage.sh
./deploy/manage.sh start

# 或直接使用systemctl
sudo systemctl start wps-bot
sudo systemctl status wps-bot
```

### 5. 配置开机自启

```bash
./deploy/manage.sh enable
# 或
sudo systemctl enable wps-bot
```

## 🛠️ 服务管理

### 使用管理脚本（推荐）

```bash
cd /opt/wps-bot

# 启动服务
./deploy/manage.sh start

# 停止服务
./deploy/manage.sh stop

# 重启服务
./deploy/manage.sh restart

# 查看状态
./deploy/manage.sh status

# 查看实时日志
./deploy/manage.sh logs

# 启用开机自启
./deploy/manage.sh enable

# 禁用开机自启
./deploy/manage.sh disable

# 更新代码并重启
./deploy/manage.sh update
```

### 使用systemctl命令

```bash
# 启动服务
sudo systemctl start wps-bot

# 停止服务
sudo systemctl stop wps-bot

# 重启服务
sudo systemctl restart wps-bot

# 查看状态
sudo systemctl status wps-bot

# 启用开机自启
sudo systemctl enable wps-bot

# 禁用开机自启
sudo systemctl disable wps-bot

# 查看日志
sudo journalctl -u wps-bot -f

# 查看最近100行日志
sudo journalctl -u wps-bot -n 100

# 查看今天的日志
sudo journalctl -u wps-bot --since today
```

## 📊 监控和调试

### 查看系统状态

```bash
# 方式1: 通过API
curl http://localhost:8000/stats

# 方式2: 通过日志
sudo journalctl -u wps-bot | grep "memory_mb"
```

### 常用调试命令

```bash
# 查看服务是否运行
sudo systemctl is-active wps-bot

# 查看服务是否开机自启
sudo systemctl is-enabled wps-bot

# 查看端口占用
sudo netstat -tlnp | grep 8000

# 查看进程
ps aux | grep python

# 查看数据库
sqlite3 /opt/wps-bot/data/bot.db "SELECT * FROM users;"
```

### 日志分析

```bash
# 查看错误日志
sudo journalctl -u wps-bot -p err

# 查看特定时间段的日志
sudo journalctl -u wps-bot --since "2025-10-28 10:00:00" --until "2025-10-28 11:00:00"

# 导出日志到文件
sudo journalctl -u wps-bot > /tmp/wps-bot.log
```

## 🔧 配置WPS Callback

### 获取服务器地址

```bash
# 查看服务器公网IP
curl ifconfig.me

# 或
curl icanhazip.com
```

### 在WPS中配置

1. 进入WPS群聊
2. 找到webhook机器人设置
3. 配置Callback URL：
   ```
   http://你的服务器IP:8000/api/callback
   ```
4. 保存并验证（WPS会发送GET请求）

### 测试Callback

```bash
# 从服务器测试
curl http://localhost:8000/api/callback

# 从外部测试
curl http://你的服务器IP:8000/api/callback
```

## 🔒 安全建议

### 防火墙配置

```bash
# 允许8000端口
sudo ufw allow 8000/tcp

# 查看防火墙状态
sudo ufw status
```

### 使用Nginx反向代理（可选）

```bash
# 安装Nginx
sudo apt update
sudo apt install nginx

# 配置Nginx
sudo nano /etc/nginx/sites-available/wps-bot

# 添加配置（见下方）
```

Nginx配置示例：
```nginx
server {
    listen 80;
    server_name your-domain.com;

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

## 📈 性能优化

### 定期清理数据库

```bash
# 创建清理脚本
cat > /opt/wps-bot/cleanup.sh << 'EOF'
#!/bin/bash
sqlite3 /opt/wps-bot/data/bot.db "DELETE FROM game_states WHERE updated_at < strftime('%s', 'now', '-7 days');"
echo "数据库清理完成"
EOF

chmod +x /opt/wps-bot/cleanup.sh

# 添加定时任务
sudo crontab -e
# 添加：每天凌晨2点清理
0 2 * * * /opt/wps-bot/cleanup.sh
```

### 监控内存使用

```bash
# 创建监控脚本
cat > /opt/wps-bot/monitor.sh << 'EOF'
#!/bin/bash
MEMORY=$(curl -s http://localhost:8000/stats | jq -r '.system.memory_mb')
echo "$(date): 内存使用 ${MEMORY}MB"
if (( $(echo "$MEMORY > 200" | bc -l) )); then
    echo "警告：内存使用过高！"
fi
EOF

chmod +x /opt/wps-bot/monitor.sh

# 添加定时任务：每小时检查一次
0 * * * * /opt/wps-bot/monitor.sh >> /var/log/wps-bot-monitor.log
```

## 🆘 故障排除

### 服务启动失败

```bash
# 查看详细错误
sudo systemctl status wps-bot -l

# 查看最新日志
sudo journalctl -u wps-bot -n 50

# 检查配置文件
sudo systemctl cat wps-bot

# 手动测试启动
cd /opt/wps-bot
sudo -u ubuntu /home/ubuntu/miniconda3/envs/liubai/bin/python app.py
```

### 端口被占用

```bash
# 查看占用进程
sudo lsof -i :8000

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

### 内存不足

```bash
# 查看内存使用
free -h

# 清理缓存
sudo sync && sudo sysctl -w vm.drop_caches=3

# 重启服务
./deploy/manage.sh restart
```

### 数据库锁定

```bash
# 检查数据库
sqlite3 /opt/wps-bot/data/bot.db "PRAGMA integrity_check;"

# 如果损坏，恢复数据库
mv /opt/wps-bot/data/bot.db /opt/wps-bot/data/bot.db.backup
# 重启服务会自动创建新数据库
./deploy/manage.sh restart
```

## 📞 技术支持

如有问题，请查看：
- 应用日志：`sudo journalctl -u wps-bot -f`
- 系统状态：`curl http://localhost:8000/stats`
- README：`/opt/wps-bot/README.md`