🃏 3分钟上手AI斗地主助手！DouZero_For_HappyDouDiZhu使用指南

🎯 为什么选择这款AI助手？

还在为斗地主记不住牌而烦恼？🤔 想不想拥有一个"透视眼"队友？这款基于DouZero算法的AI助手就是你的秘密武器！它能实时识别游戏界面、分析牌局并推荐最优出牌策略，让你轻松提升胜率。无需复杂配置，小白也能快速上手，快来体验AI带你飞的快乐吧！🚀

📁 项目里都有什么？

想象一下这个项目就像一个精心整理的工具箱🧰，每个文件夹都有它独特的作用：

• baselines/douzero_WP/ 🤖：这里住着我们的AI大脑——以胜率（WP）为目标训练的智能体模型，包含三个角色的专属模型文件
• pics/ 🖼️：存放所有游戏界面需要用到的图片资源，从扑克牌到背景图应有尽有
• douzero/ 🧠：核心算法模块，包含游戏环境模拟、智能体决策等关键代码
• main.py 🚀：程序启动按钮，双击即可开启你的AI斗地主之旅
• requirements.txt 📦：项目依赖清单，确保所有"零件"都能正常工作

💡 特别提示：项目使用PyQt5构建了友好的图形界面，即使不懂代码也能轻松操作哦！

🚀 快速启动步骤

1️⃣ 准备工作：安装依赖包

就像做饭需要先准备食材，运行程序前也需要安装必要的"调料"：

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/do/DouZero_For_HappyDouDiZhu

# 进入项目目录
cd DouZero_For_HappyDouDiZhu

# 安装依赖（这一步可能需要几分钟）
pip install -r requirements.txt

⚠️ 可能遇到的问题：如果安装速度慢，可以尝试添加国内镜像源，比如： pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

2️⃣ 启动AI助手

一切准备就绪，现在只需简单一步就能召唤你的AI队友：

# 启动主程序
python main.py

如果一切顺利，你会看到一个带有扑克牌背景的应用窗口弹出来，这就是我们的AI助手控制台啦！

AI助手主界面展示，背景图来源于项目pics目录

🎮 如何与AI助手配合战斗？

基本操作流程

1. 开始新游戏：点击界面上的"开始"按钮
2. 角色识别：AI会自动检测你是"地主"还是"农民"，如果识别失败会提示你手动选择
3. 实时分析：程序会自动截取游戏画面，分析当前牌局
4. 获取建议：在你的回合，AI会在"AI出牌区域"显示推荐出牌方案和胜率预测

核心功能区介绍

• 手牌显示区：展示AI识别到的你的手牌
• 上家/下家出牌区：显示对手出过的牌
• AI出牌建议区：AI推荐的最佳出牌组合和胜率
• 底牌显示区：显示本局的三张底牌

💡 小技巧：AI助手窗口默认会保持在最前端，方便你一边游戏一边查看建议

⚙️ 高级配置：让AI更懂你

如果你想让AI助手更符合自己的出牌习惯，可以修改main.py中的参数：

# 调整AI决策的置信度（值越高越保守）
self.MyConfidence = 0.95  # 我的牌识别置信度
self.OtherConfidence = 0.9  # 对手牌识别置信度

# 修改识别区域（如果你的游戏窗口大小不同）
self.MyHandCardsPos = (414, 804, 1041, 59)  # 我的手牌位置

为什么需要调整这些参数？因为不同屏幕分辨率、游戏窗口大小可能导致AI识别不准确。通过微调这些数值，可以让AI"看"得更清楚哦！

❓ 常见问题解答

Q: 启动程序后没有反应怎么办？

A: 检查是否安装了所有依赖，特别是PyQt5和pyautogui。可以尝试重新安装依赖：pip install -r requirements.txt --upgrade

Q: AI识别牌不准确怎么办？

A: 1. 确保游戏窗口没有被遮挡；2. 尝试调整main.py中的置信度参数；3. 检查游戏是否使用了默认分辨率

Q: 可以更换AI模型吗？

A: 当然可以！项目支持不同策略的AI模型，只需将新模型文件放入baselines/douzero_WP/目录并修改模型路径配置即可

Q: 会被游戏检测为作弊吗？

A: 本工具仅用于学习研究，通过屏幕识别提供建议，不会修改游戏内存或发送网络请求，请遵守游戏规则合理使用

📝 使用注意事项

1. 启动程序前请确保游戏窗口处于正常显示状态
2. 识别过程中尽量保持游戏窗口不移动、不缩放
3. 网络不稳定可能影响模型加载速度
4. 本项目仅供学习交流使用，请勿用于商业用途

🎉 开始你的AI斗地主之旅吧！

现在你已经掌握了所有使用技巧，快启动程序体验AI带来的全新斗地主乐趣吧！无论是想提升牌技，还是单纯想享受胜利的快感，这款AI助手都能满足你。祝你牌运亨通，把把春天！🃏💥

项目采用Apache-2.0开源协议，欢迎大家贡献代码或提出改进建议！