# 灌篮高手2

**Repository Path**: dubious/slam-dunk2

## Basic Information

- **Project Name**: 灌篮高手2
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-29
- **Last Updated**: 2026-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 灌篮高手2 — top1「AI的奇妙冒险3」策略复刻客户端

从 replay/ 下 20 场实战回放（top1 战绩 19胜1负）逐回合逆向提炼核心策略，
完整复刻的参赛客户端。**仅 Python 标准库，无任何第三方依赖**，`main.py` 为入口。

## 运行

```bash
python main.py -m run -d <4位队伍ID> -i <服务器IP> -p <服务器端口>
# 例: python main.py -m run -d 8277 -i 127.0.0.1 -p 6001
```

本地回放测试（用回放合成的服务端消息流）：

```bash
python tools/gen_test_stream.py 26683            # 生成 test/replay_stream.txt
python main.py -m test -f test/replay_stream.txt -d 8277
```

## 平台提交（源码编译）

```bash
python tools/make_submission.py    # 产出 submission.zip（项目根目录）
```

- zip 内结构：`package.sh` + `requirements.txt` + `src/`（main.py在src/下），
  内部路径全ASCII，直接上传、选**平台编译**（Python 3.10，无需dist目录）
- `package.sh` 为组委会官方脚本原样保留；`requirements.txt` 为空（纯标准库零依赖）
- 队伍名写死于 `core/config.py` 的 `TEAM_NAME`，提交前改成自己的队名
- 平台调用参数 `-d/-i/-p` 名称未做任何修改
- 全部源码已通过 Python 3.10 语法兼容检查


## 复刻的核心策略（详见 STRATEGY.md）

1. **选人**：首发 PG+三分射手+闪电后卫，替补 SG>DF；对方先抢SG时镜像反制
   （对19场实际选人复刻率 100%，tools/draft_check.py 实测 76/76）
2. **进攻**：射手按体力自适应驻翼位 camp（满体力距篮 22，出手点 20=技能加持下
   三分必中最大距离），PG 运球至枢纽位伺机「传球→射手落位同回合接球即投」；
   只投命中率>1 的必中球（被贴身时留 1.3 余量防扑防）；24 回合时钟前兜底强投；
   投失走位捡球从不发 rebound；防转攻先运出三分线。
3. **防守**：PG 锁对方射手，SG 游弋技能抢断持球者（开球抢断是招牌），
   我方射手居中策应，DF 护框；对位防最近对手。
4. **开球**：我方 SG 开球+PG 接应短传；对方开球 SG 压点伺机抢断。
5. **换人**：首发体力跌破 420（70%线）换上替补，板凳回复到 520 换回
   （与 top1 实际换人时机/人数一致）。

## 目录结构

```
main.py            入口（参数解析/日志/启动）
task_resolver.py   消息主循环（注册→选人→开局→开球/换人→回合→结束）
core/              配置、版本、日志
protocol/          协议消息构建/解析（5位长度前缀帧、粘包分包）
net/               TCP 收发（run）与回放 mock（test）
state/             状态访问辅助
ai/engine.py       引擎：消息↔策略衔接
ai/strategy.py     策略本体（选人/开球/进攻/防守/换人）
ai/rules.py        比赛数值规则（能力/命中率/区域公式，按任务书实现）
tools/             验证工具（选人复刻/端到端/保真度/行为签名）
STRATEGY.md        策略还原说明书（每条规则的回放依据）
_work/             回放分析中间产物（games/解压回放, decisions/逐回合决策对）
docs/              比赛任务书与通讯协议
replay/            原始回放（zip伪装的txt）
```

## 验证结论

- 端到端：19 局回放全生命周期跑通，每回合均有合法 action，无超时无非法指令
  （`python tools/e2e_test.py <gid>`）
- 选人复刻 100%（`python tools/draft_check.py`）
- 决策耗时 ~0.3ms/回合（限制 500ms）
- 行为签名（出手分布/角色分工/抢断目标）与 top1 同构
  （`python tools/signature_check.py`，动作级完全一致受回放开环重放限制，
  核心策略层面一致）