kards-env/INTERACTIVE_QUICKSTART.md

98 lines
2.1 KiB
Markdown
Raw Normal View History

2025-09-05 17:05:43 +08:00
# 🎮 KARDS 交互式测试环境 - 快速入门
## 🚀 立即开始
```bash
# 启动简化版推荐用于WSL
./run_interactive.sh simple
# 或直接运行
.venv/bin/python interactive/interactive_simple.py
```
## 📝 提示符说明
```
P1:Germany [回合1] K:3/5 >
```
- `P1:Germany` - 当前是玩家1德军
- `[回合1]` - 当前是第1回合
- `K:3/5` - Kredits: 当前3点最大5点
- `>` - 等待输入命令
## ⚡ 快速命令参考
输入 `?` 显示快速帮助:
| 命令 | 说明 | 示例 |
|------|------|------|
| `deploy <unit>` | 部署单位 | `deploy ger_infantry_grenadier` |
| `move <i> <L> <p>` | 移动单位 | `move 1 FRONT 0` |
| `attack <i> <j>` | 攻击 | `attack 0 2` |
| `show` | 显示战场 | `show``show detailed` |
| `list` | 列出单位 | `list germany` |
| `endturn` | 结束回合 | `endturn` |
| `scenario <name>` | 加载场景 | `scenario frontline` |
| `?` | 快速帮助 | `?` |
| `help` | 详细帮助 | `help` |
| `q` | 退出 | `q``quit` |
## 🎯 快速测试流程
### 1. 基础对战
```
deploy ger_infantry_grenadier
move 0 FRONT 0
endturn
```
### 2. 加载测试场景
```
scenario frontline
show
attack 0 2
```
### 3. 查看单位
```
list germany
info 0
```
## 🎪 可用测试场景
- `basic` - 2v2基础战斗
- `frontline` - 前线争夺战
- `squeeze` - 挤压机制测试
- `resources` - 资源管理测试
- `massive` - 5v5大规模战斗
- `blitz` - 闪击单位测试
- `artillery` - 火炮测试
- `air` - 空战场景
## 💡 提示
1. **战线说明**
- `SUPPORT1` = 玩家1支援线
- `FRONT` = 前线
- `SUPPORT2` = 玩家2支援线
2. **单位索引**从0开始按战场顺序编号
3. **玩家ID**
- 0 = 玩家1蓝色
- 1 = 玩家2红色
## 🔧 WSL/终端问题解决
如果遇到显示或输入问题:
1. 使用简化版:`./run_interactive.sh simple`
2. 确保终端支持ANSI颜色
3. 使用支持UTF-8的终端
## 📚 更多信息
- 详细文档:[interactive/README.md](interactive/README.md)
- 战斗系统:[README.md](README.md)