📌 1. 架构简介 & 核心思路
目标：构建一个面向未来可扩展的“骗子酒馆”AI博弈平台，支持终端人机对战，后续可无缝引入UI、多人对战、不同模型对接。
核心设计理念：
- 模块职责清晰：前端负责展示交互，后端负责状态管理，AI模块负责决策生成；
- 模型解耦：支持推理模型（如 GPT）、流式输出模型等混合调用；
- 提示词与游戏状态绑定：采用Prompt模板 + 动态上下文拼接；
- 统一配置管理：通过 config 模块集中控制所有角色行为参数与模型路由；
- 支持阶段迭代：第一期聚焦终端模拟AI对战；第二期引入UI组件。
🗂️ 2. 文件名架构图
🧩 3. 代码功能说明
| 模块 |
功能概要 |
config/ |
管理游戏参数、模型选择、日志等级 |
backend/ |
管理玩家回合、出牌流程、枪响判断 |
llm/ |
解耦模型逻辑，统一接口封装提示词构建与响应解析 |
prompts/ |
提示词与规则以YAML格式存储，便于扩展与配置 |
frontend_terminal/ |
实现终端下人类与AI交互的基础界面 |
main.py |
初始化配置，启动主循环 |
🧱 4. 核心技术规范
- 语言/框架：Python 3.9+ / FastAPI (第二阶段支持)/ Typer (终端界面)
- 模型接口统一化：抽象基类 + 工厂方法实现模型解耦
- Prompt拼接策略：
- 固定模板(
prompt_challenge.yaml) + 动态上下文（当前手牌、上轮状态、出牌记录等）
- 配置驱动逻辑：所有行为逻辑受
game_config.py 驱动