Files
Obsidian/MyBestNanobot/Nanobot斗地主游戏开发及游戏总结要点.md
T
2026-07-21 14:53:24 +08:00

499 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
你在做完博客项目的时候,写了一个UI设计相关的总结文档,/home/ubuntu/nanocode/personal-blog/ DESIGN.md 你读一下这个文件。然后,编写/home/ubuntu/nanocode/net-games 及/home/ubuntu/nanocode/happy-games的UI设计规范,主要参考项目/home/ubuntu/nanocode/happy-games/下的doudizhu, slither-io之类,net-games的doudizhu和game hub本身。文档放在/home/ubuntu/nanocode/net-games/docs 下面。尽可能详细,内容除了我们的项目UI本身的设计规范之外,需要这么设计的意图,参考来源等
---
# 斗地主游戏需求文档
## 一、项目概述
### 1.1 游戏定位
- **名称**:AI斗地主
- **类型**:Web 卡牌对战游戏
- **玩家**:1名人类玩家 vs 2名AI玩家
- **平台**:移动端优先(支持PC)
### 1.2 核心体验
- 经典斗地主玩法,规则简化易懂
- AI对手有策略性,不是随机出牌
- 流畅的发牌、出牌动画
- 清晰的游戏状态提示
---
## 二、游戏规则(简化版)
### 2.1 牌组构成
- **总牌数**:54张(含大小王)
- **牌点大小**:3 < 4 < 5 < 6 < 7 < 8 < 9 < 10 < J < Q < K < A < 2 < 小王 < 大王
### 2.2 发牌规则
- 每人17张牌
- 剩余3张为底牌
- 叫地主后,底牌归地主所有(地主20张,农民各17张)
### 2.3 牌型定义(仅6种)
| 牌型 | 说明 | 示例 | 大小比较 |
|------|------|------|----------|
| 单张 | 任意1张 | 3♠ | 点数大者胜 |
| 对子 | 2张同点数 | 3♠3♥ | 点数大者胜 |
| 三带一 | 3张同点数+1张单张 | 333+4 | 只比较三张部分 |
| 顺子 | ≥5张连续单张 | 34567 | 点数大者胜,长度必须相同,不能含2和王 |
| 炸弹 | 4张同点数 | 3333 | 炸弹>非炸弹 |
| 王炸 | 小王+大王 | 大小王 | 最大 |
### 2.4 游戏流程
1. **发牌** → 17张/人
2. **叫地主** → 人类玩家选择是否当地主
3. **底牌** → 地主获得3张底牌
4. **出牌** → 地主先出,顺时针轮流
5. **结算** → 有人出完牌即结束
### 2.5 胜负条件
- 地主先出完 → 地主胜
- 任一农民先出完 → 农民胜
---
## 三、功能需求
### 3.1 核心功能
#### 3.1.1 发牌系统
- [ ] 随机洗牌算法
- [ ] 发牌动画(17张牌依次发到3位玩家)
- [ ] 底牌展示(3张背面朝上,确定地主后翻开)
#### 3.1.2 叫地主
- [ ] 人类玩家:按钮选择"叫地主"/"不叫"
- [ ] AI玩家:根据手牌强度自动决策
- [ ] 显示当前选择(如"P1叫地主,P2不叫")
#### 3.1.3 出牌系统
- [ ] 人类玩家:点击选牌,系统自动识别牌型
- [ ] 牌型验证:非法牌型提示(如"这不是顺子")
- [ ] 大小验证:不够大提示(如"管不上")
- [ ] AI玩家:自动思考后出牌或"不出"
- [ ] 出牌动画:牌从手牌区飞到桌面中央
#### 3.1.4 牌型识别
- [ ] 自动识别选中的牌是什么牌型
- [ ] 牌型合法性检查
- [ ] 与桌面牌比较大小
### 3.2 UI功能
#### 3.2.1 牌桌布局
```
+------------------------+
| [AI1: 17张] | ← 顶部:AI1玩家
| |
| [AI2:17张] [桌面牌] | ← 左侧AI2,中央出牌区
| |
| [人类玩家手牌区] | ← 底部:自己(正面朝上)
| [出牌] [不出] [提示] | ← 操作按钮
+------------------------+
```
#### 3.2.2 牌显示规则
| 位置 | 显示方式 | 交互 |
|------|----------|------|
| 自己 | 正面,扇形排列 | 可点击选择 |
| AI | 背面,显示数量 | 不可操作 |
| 桌面 | 正面,最新出牌 | 只读 |
#### 3.2.3 动画效果
- [ ] 发牌动画:牌从牌堆飞到玩家位置
- [ ] 出牌动画:牌从手牌区飞到桌面中央
- [ ] 胜利动画:显示"你赢了"或"你输了"
- [ ] 炸弹特效:屏幕震动 + 音效
### 3.3 AI功能
#### 3.3.1 AI决策逻辑(非A*,采用规则型)
**叫地主决策:**
```
手牌评分 = 大牌数量(2/A/K) + 炸弹数量 + 顺子完整性
if 手牌评分 > 阈值:
叫地主
else:
不叫
```
**出牌决策(优先级):**
1. 能管上且牌力刚好(不浪费大牌)
2. 出牌后剩余牌更容易走
3. 队友(农民)可能有的牌型
4. 必要时拆牌
**农民AI协作:**
- 识别队友牌力(通过出牌历史)
- 适当放牌给队友
- 拦截地主关键牌型
#### 3.3.2 AI难度等级
- [ ] 简单:随机出牌,偶尔出错
- [ ] 中等:基本策略,合理管牌
- [ ] 困难:记牌、算牌,最优决策
### 3.4 游戏辅助功能
- [ ] 记牌器(显示剩余牌统计)
- [ ] 提示功能(推荐可出的牌)
- [ ] 托管功能(AI替人类玩家出牌)
- [ ] 重新开局
---
## 四、技术架构
### 4.1 技术栈
- **引擎**:PlayCanvas(3D渲染)或 Canvas 2D
- **语言**:JavaScript
- **UI**:HTML + CSS
### 4.2 模块划分
```
doudizhu/
├── index.html # 主页面
├── css/
│ └── style.css # 样式
├── js/
│ ├── main.js # 游戏入口
│ ├── game.js # 游戏逻辑
│ ├── cards.js # 牌组管理
│ ├── player.js # 玩家类(人类+AI)
│ ├── ai.js # AI策略
│ ├── ui.js # UI渲染
│ └── animation.js # 动画效果
└── assets/
├── cards/ # 扑克牌素材
└── sounds/ # 音效
```
### 4.3 核心类设计
#### Game(游戏主类)
```javascript
class Game {
constructor() {
this.deck = new Deck(); // 牌组
this.players = [ // 3位玩家
new Player(0, 'human'), // 人类
new Player(1, 'ai'), // AI1
new Player(2, 'ai') // AI2
];
this.lordId = null; // 地主ID
this.currentPlayer = 0; // 当前出牌玩家
this.desktopCards = null; // 桌面牌
this.gameState = 'init'; // 游戏状态
}
start() { /* 开始游戏 */ }
deal() { /* 发牌 */ }
callLord() { /* 叫地主 */ }
playCards(playerId, cards) { /* 出牌 */ }
checkWin() { /* 检查胜负 */ }
}
```
#### Player(玩家类)
```javascript
class Player {
constructor(id, type) {
this.id = id;
this.type = type; // 'human' | 'ai'
this.cards = []; // 手牌
this.isLord = false; // 是否地主
}
addCard(card) { /* 加牌 */ }
removeCards(cards) { /* 出牌 */ }
think() { /* AI思考 */ } // AI专用
}
```
#### CardType(牌型识别)
```javascript
class CardType {
static identify(cards) { /* 识别牌型 */ }
static canBeat(cards1, cards2) { /* 比较大小 */ }
static isLegal(cards, desktop) { /* 是否可出 */ }
}
```
---
## 五、数据结构
### 5.1 单张牌
```javascript
{
id: 0-53, // 唯一ID
suit: 'spade', // 花色: spade|heart|club|diamond
rank: 3-17, // 点数: 3-15(3-2), 16(小王), 17(大王)
display: 'A♠' // 显示文本
}
```
### 5.2 牌型
```javascript
{
type: 'single', // 类型
cards: [...], // 包含的牌
value: 14, // 用于比较的值
length: 1 // 牌数量
}
```
### 5.3 游戏状态
```javascript
{
state: 'playing', // init|dealing|calling|playing|ended
players: [
{ id: 0, cardCount: 17, isLord: true },
{ id: 1, cardCount: 17, isLord: false },
{ id: 2, cardCount: 17, isLord: false }
],
currentPlayer: 0, // 当前轮到谁
desktop: { // 桌面牌
playerId: 0, // 谁出的
cardType: {...} // 牌型
},
lastAction: 'play', // play|pass
winner: null // 胜利者ID
}
```
---
## 六、UI设计规范
### 6.1 色彩方案
- **背景**:深绿色(经典牌桌色)#0d5c3b
- **牌背**:蓝色花纹 #1e3a5f
- **高亮**:金色 #ffd700
- **按钮**:蓝色渐变 #2196F3 → #1976D2
### 6.2 牌尺寸(移动端适配)
- **宽度**:60px
- **高度**:84px
- **间距**:重叠显示(选中牌上移20px)
### 6.3 响应式布局
- **移动端**:竖屏,手牌扇形排列
- **PC端**:横屏,手牌水平排列
---
## 七、开发计划
### Phase 1:核心逻辑(3天)
- [ ] 牌组生成与洗牌
- [ ] 发牌逻辑
- [ ] 牌型识别算法
- [ ] 大小比较算法
### Phase 2:UI框架(2天)
- [ ] 牌桌布局
- [ ] 牌的显示与交互
- [ ] 按钮与状态显示
### Phase 3:游戏流程(2天)
- [ ] 叫地主
- [ ] 出牌流程
- [ ] 胜负判断
### Phase 4:AI实现(2天)
- [ ] 叫地主AI
- [ ] 出牌AI(基础版)
- [ ] 记牌器
### Phase 5: polish(2天)
- [ ] 动画效果
- [ ] 音效
- [ ] 移动端适配
- [ ] Bug修复
**总计:约11个工作日**
---
## 八、风险与注意事项
### 8.1 技术风险
1. **AI复杂度**:斗地主AI需要大量调优,初期可用简单规则
2. **移动端性能**:大量卡牌渲染需要优化
3. **浏览器兼容**:确保主流浏览器支持
### 8.2 游戏体验
1. **AI不能太强**:否则玩家沮丧
2. **AI不能太弱**:否则没意思
3. **出牌要流畅**:动画不能卡顿
### 8.3 替代方案
如果完整实现难度大,可先实现:
- 单机版,跳过叫地主(随机选地主)
- 简单AI(随机可出的牌)
- 无动画版本
---
## 九、参考资料
- [原始规则文档] Web 前端 + AI 三方斗地主规则及实现.md
- 经典斗地主规则(QQ游戏/欢乐斗地主)
---
**文档版本**:v1.0
**创建时间**:2026-04-04
**适用项目**:happy-games 斗地主游戏
---
## 规则型 AI vs A* 算法对比
### 1. 核心原理
| 特性 | 规则型 AI | A* 算法 |
|------|-----------|---------|
| **原理** | 人工定义规则,按优先级决策 | 搜索最优路径,评估每一步的代价 |
| **决策方式** | `if-else` + 优先级列表 | 遍历所有可能,选择 `f = g + h` 最小的 |
| **数据依赖** | 需要专家经验 | 需要完整状态空间 |
---
### 2. 斗地主场景下的对比
#### 规则型 AI 工作流程
```javascript
// 简化示例
function aiPlay(handCards, desktopCards) {
// 1. 能管上吗?
const canBeat = findCardsThatCanBeat(handCards, desktopCards);
// 2. 规则优先级
if (canBeat.length > 0) {
// 优先出:不拆牌、保留大牌、走牌优先
return selectBestByRules(canBeat);
}
// 3. 管不上就过
return "pass";
}
// 具体规则示例
const rules = [
"优先出顺子/连对(减少手牌数)",
"小牌优先出(留大牌收尾)",
"农民要拦截地主,队友剩少牌时放牌",
"不要拆炸弹",
"记牌器辅助判断"
];
```
#### A* 工作流程
```javascript
// 理想化示例(实际在斗地主中很难实现)
function aStarSearch(currentState) {
// 问题:currentState 不包含对手的牌!
openList = [currentState];
while (openList.length > 0) {
state = openList.pop(); // 取 f 值最小的
if (state.isWin()) return state;
// 问题:无法知道对手会出什么牌
for (action of getPossibleActions(state)) {
nextState = apply(state, action);
nextState.f = nextState.cost + heuristic(nextState);
openList.push(nextState);
}
}
}
```
---
### 3. 关键区别
| 对比维度 | 规则型 AI | A* 算法 |
|----------|-----------|---------|
| **信息完整性** | ✅ 适应不完美信息(看不到对手牌) | ❌ 需要完美信息(必须知道所有牌) |
| **计算量** | ✅ 极小,`O(n)` 遍历手牌 | ❌ 极大,状态空间爆炸 |
| **可解释性** | ✅ 人类能理解为什么出这张牌 | ❌ 黑盒,难以调试 |
| **最优性** | ⚠️ 局部最优,依赖规则质量 | ✅ 理论上全局最优 |
| **开发难度** | ✅ 简单,调规则参数即可 | ❌ 复杂,需要设计启发函数 |
| **灵活性** | ⚠️ 需要人工添加新规则 | ✅ 自动发现新策略 |
| **实时性** | ✅ 毫秒级响应 | ❌ 秒级甚至分钟级搜索 |
---
### 4. 为什么斗地主不适合 A*
```
斗地主的本质是:不完美信息 + 不完全信息 + 随机性
1. 不完美信息:你看不到对手的牌
→ A* 需要知道完整状态才能搜索
2. 对手行为不确定:你无法预测 AI2 会出什么
→ A* 的分支因子无限大
3. 底牌随机:发牌后才知道地主多3张什么牌
→ 无法预先计算最优路径
```
**A* 适合的游戏:**
- ✅ 象棋、围棋(能看到完整棋盘)
- ✅ 华容道、推箱子(单人解谜)
- ✅ 俄罗斯方块(单人,状态可控)
**规则型 AI 适合的游戏:**
- ✅ 斗地主、麻将(信息不对称)
- ✅ 德州扑克(隐藏信息 + 概率)
- ✅ 大多数卡牌游戏
---
### 5. 规则型 AI 的实际能力
虽然叫"规则型",但配合一些技巧可以很强:
| 技巧 | 效果 |
|------|------|
| **记牌器** | 记录已出的牌,推算剩余牌分布 |
| **牌型计数** | 估计对手可能有什么牌型 |
| **概率估算** | 根据剩余牌数计算出现概率 |
| **局势判断** | 根据出牌历史判断谁是强/弱 |
| **协作逻辑** | 农民之间简单的配合策略 |
**实际水平:** 调优后的规则型 AI 可以达到中级人类玩家水平,足够提供有挑战性的对战体验。
---
### 6. 总结
| 您的需求 | 推荐方案 |
|----------|----------|
| 快速实现、可解释、实时响应 | ✅ 规则型 AI |
| 研究性质、有完整信息、离线计算 | ✅ A* 或蒙特卡洛 |
**斗地主选规则型 AI 是正确选择** —— 不是因为 A* 不强大,而是斗地主的"不完美信息"特性让 A* 无从下手。规则型 AI 更适合这个场景。
---