# GameCopilot

**Repository Path**: aiwebops_admin/game-copilot

## Basic Information

- **Project Name**: GameCopilot
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-30
- **Last Updated**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 次神微信小游戏 AI 自动挂机代理

分布式 LLM 游戏代理系统，实现次神小游戏的全自动挂机。

## 🌟 主要特性

- **Windows 本地优先**：单台电脑即可运行，降低入门门槛
- **一键部署**：简单的 Batch 脚本，自动完成环境配置
- **状态监控**：美观的 Web 监控页面，实时查看运行状态
- **智能错误处理**：自动重试、连续错误检测、详细日志
- **灵活配置**：支持多种模型、可自定义参数
- **纯视觉决策**：基于 GPT-4o 视觉分析，无游戏逆向
- **可扩展**：支持后续扩展到 Ubuntu + Windows 分布式部署

## 📁 项目结构

```
game-copilot/
├── openclaw-gateway/          # 服务端 - LLM 决策网关
│   ├── skills/               # 技能脚本目录
│   │   └── play-cishen.md   # 次神挂机核心决策技能
│   ├── gateway.py            # 网关主程序（FastAPI）
│   ├── requirements.txt      # Python 依赖
│   ├── .env.example         # 环境变量模板
│   ├── setup.sh             # Linux 部署脚本
│   └── start.sh             # Linux 启动脚本
├── windows-executor/          # Windows 执行端 - 截图和键鼠操作
│   ├── win_agent.py         # 执行代理主程序
│   ├── requirements.txt      # Python 依赖
│   ├── .env.example         # 环境变量模板
│   ├── setup.bat            # Windows 部署脚本
│   └── start.bat            # Windows 启动脚本
├── DOCS/                     # 项目文档
│   ├── 01-ProjectPlan.md   # 开发计划
│   └── 02-ConfigInfo.md    # 配置说明
├── docs/                     # 详细部署文档
├── logs/                    # 日志目录（自动创建）
├── start-all.bat            # Windows 一键启动脚本
└── README.md
```

## 🚀 快速开始（Windows 本地部署）

### 方式一：一键启动（推荐）

```cmd
# 在项目根目录下运行
start-all.bat
```

脚本会自动：
1. 检查并创建虚拟环境
2. 安装依赖
3. 启动网关服务
4. 启动执行端
5. 打开监控页面

### 方式二：手动分步启动

#### 1. 启动网关服务

```cmd
cd openclaw-gateway
setup.bat          # 首次运行需要
start.bat          # 启动网关
```

网关运行在：`http://localhost:8000`

#### 2. 启动执行端（新开窗口）

```cmd
cd windows-executor
setup.bat          # 首次运行需要
start.bat         # 启动执行端
```

#### 3. 打开游戏

使用腾讯游戏助手打开「次神」微信小游戏。

#### 4. 查看监控

浏览器访问：`http://localhost:8000/`

## 📊 监控界面

启动服务后，访问网关地址可看到美观的状态监控页面：

- 📈 实时运行统计（请求数、成功率、运行时间）
- 📋 最近动作记录
- ⚠️ 错误日志追踪
- 🔧 API 文档

## 🔧 配置说明

### 首次使用配置

#### 1. 配置 API 密钥

编辑 `openclaw-gateway\.env`：

```env
OPENAI_API_KEY=sk-xxxxxx          # 必填：OpenAI API 密钥
MODEL_NAME=gpt-4o                 # 可选：模型名称
```

#### 2. 调整游戏窗口（可选）

编辑 `windows-executor\.env`：

```env
GAME_WINDOW_TITLE=次神             # 游戏窗口标题关键词
SCREENSHOT_INTERVAL=1.0           # 截图间隔（秒）
```

### 完整配置参数

#### Ubuntu 服务端配置 (.env)

```env
OPENAI_API_KEY=sk-xxxxxx          # 必填：OpenAI API 密钥
OPENAI_BASE_URL=https://api.openai.com/v1  # 可选：API 基础地址
MODEL_NAME=gpt-4o                 # 可选：模型名称
GATEWAY_HOST=0.0.0.0             # 可选：监听地址
GATEWAY_PORT=8000                 # 可选：监听端口
LOG_LEVEL=INFO                    # 可选：日志级别
```

#### Windows 执行端配置 (.env)

```env
GATEWAY_URL=http://localhost:8000  # 本地部署用 localhost
                                     # Ubuntu 分布式用 http://192.168.101.7:8000
GAME_WINDOW_TITLE=次神              # 可选：游戏窗口标题关键词
SCREENSHOT_INTERVAL=1.0            # 可选：截图间隔（秒）
REQUEST_TIMEOUT=30                 # 可选：请求超时（秒）
```

## 🎯 支持的模型

- `gpt-4o` - 最新多模态模型（推荐）
- `gpt-4-turbo` - GPT-4 Turbo 视觉版
- `gpt-4o-mini` - 轻量快速版
- 其他兼容 OpenAI 视觉 API 的模型

## 📝 开发计划

- ✅ **迭代一**：Windows 本地快速部署（已完成）
- ⏳ **迭代二**：核心挂机功能完善
- ⏳ **迭代三**：稳定性与自愈优化
- ⏳ **迭代四**：Ubuntu 分布式扩展
- ⏳ **迭代五**：扩展兼容更多游戏

## 🔒 安全说明

- 仅局域网/本地运行，不暴露公网
- 纯视觉键鼠模拟，无游戏逆向
- API 密钥通过 .env 文件管理，不上传仓库
- 代理环境变量自动清理，避免配置冲突

## ❓ 常见问题

### 服务端报错 "Client.__init__() got an unexpected keyword argument 'proxies'"

这是因为环境中有代理配置，新版 OpenAI 库不兼容。代码已自动清理代理环境变量，请重新启动服务。

### 找不到游戏窗口

1. 确保游戏已打开且窗口可见
2. 检查窗口标题是否包含配置的关键词
3. 尝试修改 `.env` 中的 `GAME_WINDOW_TITLE`

### 连接不到网关

1. 确认网关服务已启动（看到 "Uvicorn running on" 信息）
2. 检查网络连接（ping 测试）
3. 确认防火墙设置
4. 访问 `http://localhost:8000/health` 检查服务状态

## 📚 更多文档

- [项目开发计划](DOCS/01-ProjectPlan.md)
- [配置说明](DOCS/02-ConfigInfo.md)
- [Ubuntu 详细部署指南](docs/deploy-ubuntu.md)
- [Windows 详细部署指南](docs/deploy-windows.md)

## 📄 许可证

本项目仅供学习交流使用。