一个基于强化学习的掼蛋 AI 系统，支持 Actor-Critic（A2C）网络，具备训练与推理功能，使用自定义状态空间与奖励机制。

git clone https://github.com/746505972/guandan.git
cd guandan

建议使用虚拟环境：

pip install -r requirements.txt

python actor.py  # 训练主循环

或打开 Streamlit 界面：

streamlit run app.py

或打开Vue前端

1.start fastapi

uvicorn server.main:app --reload --port 8000

2.start Vue(dev)

in cmd

cd guandan-frontend
npm run dev

请在guandan\guandan-frontend\src\utils\axios.ts的第三行配置好url

• actor.py: 训练主脚本，包含 Actor/Critic 网络结构
• app.py: Streamlit 可视化前端
• FrontendGame.py: Streamlit 可视化后端
• display.py: 控制台可视化前后端&胜率计算
• give_cards.py、rule.py: 工具函数、规则逻辑
• doudizhu_actions.json: 结构化动作空间
• setup.py: Cython编译文件
• model/: 存放模型结构
• server/: 提供FastAPI后端

• ActorNet：输出结构动作 action_id 的概率分布（考虑了合法性 mask）。
• CriticNet：输出当前状态的 value 估计。

r = reward + gamma ** (len(memory) - i - 1) * final_reward

• reward：即时奖励 = 出牌长度 × 牌型的 logic_point
• final_reward：整局奖励。队伍获胜时，等级为：12名→3，13名→2，14名→1，失败则为相反。
• memory：记录整局信息：

  memory = [{state, action_id, reward}, ...]

$$ \text{advantage} = r + \gamma \cdot V(s') - V(s) $$

最后一个 transition 无 s'，设 $\gamma \cdot V(s') = 0$

• Actor Loss: $-\log(p) \cdot \text{advantage}$
• Critic Loss: $\text{advantage}^2$

使用 One-Hot 或多热编码，构造状态维度如下：

hand = ['红桃2', '红桃2','黑桃3', '红桃3', '黑桃4', '红桃4', '红桃4', '黑桃4',
        '黑桃5', '红桃5','大王','小王','大王']

其编码如下：

[0. 1. 1. 1. 0. 0. 0. 0. 0. 0. 0. 0. 0. 1. 1. 1. 1. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 1. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 1. 0. 1. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. 1. 1. 0. 1.]

108维具体为{黑桃、红桃、梅花、方块}与{2、3、4、…、K、A}作积，生成52维。具体是{黑桃、红桃、梅花、方块}2、{黑桃、红桃、梅花、方块}3、…，如此再重复一遍为104维，再加上{小王、大王、小王、大王}得到最终108维。

本项目遵循 MIT License