一个利用pydantic ai实现的AIAgent，使其能在MCBE中使用Websocket服务器实现的游戏内调用LLM"In MCBE, a WebSocket server is used to enable the use of LLM within the game."

MCBE GPT Agent v2.0 - 现代化重构

概述

这是 MCBE WebSocket GPT 项目的完全重构版本，采用现代化异步架构，基于 PydanticAI 框架，支持多种 LLM 提供商，实现了 WebSocket 和 LLM 请求的完全解耦。

核心特性

🚀 现代化架构

• 异步非阻塞: WebSocket 通信与 LLM 请求完全分离
• 消息队列: 使用 asyncio.Queue 实现生产者-消费者模式
• 类型安全: 全面使用 Pydantic 进行数据验证
• 结构化日志: 基于 structlog 的现代日志系统

🤖 AI Agent 能力

• PydanticAI 框架: 类型安全的 AI Agent 实现
• 流式响应: 支持实时流式输出，按完整句子发送
• Agent Tools: 内置 Minecraft 命令执行、MCWiki 搜索等工具
• 动态系统提示词: 根据玩家信息动态调整
• 模型预热: 启动时自动预热 LLM 模型，提高首次响应速度
• 命令响应回传: Agent 执行命令后自动回传 commandResponse，工具调用更流畅

🔌 多 LLM 支持

• DeepSeek: deepseek-reasoner (支持思维链)
• OpenAI: GPT-5 等模型
• Anthropic: Claude Sonnet 4.5
• Ollama: 本地模型支持

🎮 用户友好

• 非阻塞通信: LLM 请求不影响 MC 连接
• 实时切换模型: 游戏内动态切换 LLM
• 上下文管理: 灵活的对话历史控制
• JWT 认证: 安全的令牌认证机制
• ScriptEvent 支持: 支持发送 scriptevent，方便后续对接SAPI

项目结构

MCBE-AI-Agent/
├── config/                 # 配置管理
│   ├── settings.py        # Pydantic Settings
│   └── logging.py         # 日志配置
├── models/                # 数据模型
│   ├── messages.py        # WebSocket 消息
│   ├── minecraft.py       # MC 协议模型
│   └── agent.py           # Agent 相关模型
├── core/                  # 核心模块
│   ├── queue.py           # 消息队列 (MessageBroker)
│   ├── events.py          # 事件系统
│   └── exceptions.py      # 自定义异常
├── services/              # 服务层
│   ├── agent/            # AI Agent 服务
│   │   ├── core.py       # PydanticAI Agent
│   │   ├── providers.py  # LLM Provider 注册表
│   │   ├── worker.py     # Agent Worker
│   │   ├── tools.py      # Agent 工具定义
│   │   └── mcwiki.py     # MCWiki 搜索工具
│   ├── websocket/        # WebSocket 服务
│   │   ├── server.py     # WS 服务器
│   │   ├── connection.py # 连接管理
│   │   └── minecraft.py  # MC 协议处理
│   └── auth/             # 认证服务
│       └── jwt_handler.py
├── storage/               # 存储层 (TODO)
├── tests/                 # 测试用例
├── docs/                  # 文档
├── data/                  # 数据文件
├──