Poké-Battle

Poké-Battle

这是一款使用 FastAPI 和 Python 构建的宝可梦游戏，借助 Anthropic 的 Claude AI 生成精彩的战斗描述和攻击建议，并为捕获的宝可梦赋予独特个性。

技术栈

• 后端： FastAPI、Uvicorn（ASGI 服务）
• AI 集成： Anthropic 的 Claude API、自定义 AI 服务（ai_server.py）和客户端（ai_client.py）
• 外部 API： PokeAPI
• 前端： HTML、CSS、JavaScript（由 FastAPI 提供）
• 依赖项： python-dotenv、httpx、websockets、Jinja2

设置说明

1. 克隆代码库：

   git clone <repository_url>
   cd <repository_directory>
   

2. 创建虚拟环境：

   python -m venv .venv
   

3. 激活虚拟环境：

   • Windows：

     .venv\Scripts\activate
     

   • macOS 和 Linux：

     source .venv/bin/activate
     

4. 安装依赖项：

   pip install -r requirements.txt
   

5. 设置 Anthropic API 密钥：

   • 在根目录中创建名为 .env 的文件。
   • 按以下格式添加 Anthropic API 密钥：

     ANTHROPIC_API_KEY=your_api_key_here
     

   注意： 为确保安全，建议使用托管环境提供的环境变量管理 API 密钥，而不是将其存储在 .env 文件中，尤其是在生产环境中。

6. 运行 AI 服务： 在项目根目录中打开终端并运行：

   uvicorn ai_server:app --reload --port 8000
   

7. 运行主游戏服务： 在项目根目录中打开一个新终端（如有需要，请激活虚拟环境），然后运行：

   uvicorn server:app --reload --port 8080
   

8. 在浏览器中打开游戏： 访问 http://localhost:8080

项目结构

• server.py：处理游戏逻辑并提供前端的主 FastAPI 应用。
• ai_server.py：处理与 Anthropic API 通信的 FastAPI 应用。
• ai_client.py：server.py 用于与 ai_server.py 通信的 Python 客户端库。
• index.html：主要的前端 HTML 文件。
• static/：静态资源目录（CSS、JavaScript、图像——目前目录中仅有此目录）。
• requirements.txt：列出 Python 依赖项。
• api.env：用于加载 API 密钥的环境文件（应添加到 .gitignore）。
• .gitignore：指定 Git 应忽略的有意不跟踪的文件。

功能

• 捕捉宝可梦： 捕捉随机宝可梦来组建队伍。
• 宝可梦对战： 与随机对手宝可梦进行回合制对战。
• AI 战斗描述： 由 Anthropic 的 Claude 生成对战行动的精彩解说。
• AI 攻击建议： 获取 AI 对对战中最佳招式的建议。
• AI 宝可梦个性： 每只捕获的宝可梦都会获得独特的 AI 生成个性特征或背景故事。
• 实时更新： 通过 WebSocket 更新游戏状态和消息。
• 响应式 UI： 对 UI 进行基本调整，以便更好地展示捕获的宝可梦。