# another-poker-game

**Repository Path**: ngcb/another-poker-game

## Basic Information

- **Project Name**: another-poker-game
- **Description**: No description available
- **Primary Language**: NodeJS
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-27
- **Last Updated**: 2026-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ♠ 单人德州扑克 · 锦标赛

纯前端（零依赖、无构建）实现的德州扑克单人游戏：你 vs 一桌性格迥异的 AI 对手，
在盲注不断上涨的锦标赛中坚持到最后即夺冠。

## 如何运行

直接双击打开 `index.html` 即可（推荐 Chrome / Edge）。
无需安装任何东西；也可以本地起个静态服务：

```bash
cd poker-game
python -m http.server 8000     # 然后访问 http://localhost:8000
```

## 功能一览

**完整规则引擎**
- 盲注轮转（小盲/大盲/庄位，含单挑特殊规则）
- 四条街下注（翻牌前 → 翻牌 → 转牌 → 河牌），弃牌/过牌/跟注/下注/加注/全下
- 最小加注约束与「不足额全下不重开行动权」的正规处理
- 多层边池精确划分、奇数筹码归属、未被跟注部分自动退还
- 摊牌七选五比牌（同花顺>四条>葫芦>…）、平分底池
- 全员全下自动跑马亮牌
- 锦标赛制：每 6 手盲注升级、淘汰名次记录、破产重购、观战模式

**AI 对手**
- 5 种性格预设：教授陈（均衡）、闪电李（松凶疯子）、石头周（极紧缩）、
  鲨鱼浩（攻守兼备爱设陷）、鱼妹圆（跟注站）
- 决策核心为蒙特卡洛胜率模拟（每步采样数百次随机对局），
  叠加性格参数（紧度/进攻性/诈唬率/慢打率/失误率）产生差异化打法
- 行为覆盖：价值下注 sizing 随牌力浮动、C-bet、半诈唬与干燥面/湿润面判断、
  底池赔率跟注、短码推进、平跟设陷阱、反加诈唬

**界面**
- 牌桌拟物渲染、发牌/翻牌动画、筹码丸随注移动
- 加注滑杆 + 快捷预设（最小/半池/满池/两倍池/全下）
- 快捷键：`F` 弃牌 · `C` 过牌/跟注 · `R` 确认加注 · `A` 全下 · 方向键微调
- 对局日志、生涯战绩持久化（localStorage）、音效开关、疾速模式
- 结算榜 + 重购询问 + 规则速查表

## 测试

```bash
node tests/test.js          # 核心算法单测（评估器 vs 暴力枚举 3000 组对拍等）
node tests/integration.js   # 引擎集成压测：机器人连打多场锦标赛校验筹码守恒
```

## 目录结构

```
poker-game/
├─ index.html          入口页面
├─ css/style.css       样式与动画
├─ js/core.js          纯逻辑库：洗牌/评估器/胜率模拟/边池（可 Node 复用）
├─ js/game.js          游戏引擎：状态机/AI/锦标赛流程（可 Node 复用）
├─ js/ui.js            界面控制与交互
├─ src-tauri/          Tauri 桌面版工程（Windows exe）
├─ tests/              自动化测试
└─ dist/               前端静态副本（Tauri 打包时使用，已 gitignore）
```

## 版本控制（Git）

仓库已配置好 `.gitignore`、`.gitattributes`、`.editorconfig`。被忽略的构建产物：
`node_modules/`、`src-tauri/target/`、`dist/`、`src-tauri/gen/`、`*.exe`（含打包出的免安装版）、
`package-lock.json`，以及 Tauri 生成的多平台移动端图标（`icons/android/`、`icons/ios/`）。

克隆项目后需要重新生成被忽略的产物，才能正常游玩或打包：

```bash
# 1. 浏览器版：直接打开 index.html 即可，无需生成任何东西

# 2. 重新生成 Tauri 桌面 exe（需 Rust + Node，已装 CLI 可跳过 npm 步骤）：
npm install -D @tauri-apps/cli
npx tauri build          # 生成 target/release/poker-game.exe（免安装版）
```

## 打包成 Windows exe

```bash
npx tauri build
```

输出：
- 免安装可执行文件 `src-tauri/target/release/poker-game.exe`（约 2.9 MB，可重新命名拷贝即用）
- 若网络正常还会生成 NSIS 安装包 `src-tauri/target/release/bundle/nsis/*.exe`

注意：NSIS 安装包需要下载 Tauri 附加工具 `nsis-tauri-utils.dll`，若网络对 GitHub release 受限会失败，
此时不影响免安装 exe（它已能独立运行）。

仅供本地娱乐，不涉及任何真实货币。