499 lines
14 KiB
Markdown
499 lines
14 KiB
Markdown
|
||
---
|
||
你在做完博客项目的时候,写了一个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 更适合这个场景。
|
||
|
||
---
|
||
|
||
|