Calix-L/DanKS

这是什么？

核心功能

• 01结构化候选检索，评估每次出牌后剩余手牌的组合
• 02基于 PPO 与 GAE 自我对弈训练的 Actor-Critic 策略
• 03V3Pro 推理增强，支持残局搜索与等价出牌规则
• 04带房间后端和裁判逻辑的浏览器掼蛋牌桌
• 05通过 HTTP 接口接入自定义 AI
• 06链接到 899 场人类掼蛋对局的公开数据集

适用场景

• 研究组队类纸牌游戏中信息不完全条件下的决策
• 在纸牌游戏环境中训练和比较强化学习策略
• 开发自定义掼蛋 AI 并接入本地网页牌桌
• 分析人类对局记录中的手牌结构与组队配合

快速上手

1. 1

   克隆仓库

   git clone https://github.com/Calix-L/DanKS.git
2. 2

   进入服务目录并创建 Python 3.12 虚拟环境

   cd DanKS/services/v2 && python3.12 -m venv .venv && source .venv/bin/activate
3. 3

   安装依赖并构建理牌模块

   python -m pip install -r requirements.txt && python scripts/build_arranger.py
4. 4

   启动本地牌桌，然后打开 http://127.0.0.1:8000/solo

   python run.py

使用前须知

• !本地牌桌需要 Python 3.12 和 Go 1.23+。
• !不包含训练好的模型权重和私有 AI 服务基础设施。

标签

常见问题

DanKS 是什么？

面向掼蛋（四人对战组队出牌游戏）的开源强化学习智能体，附带可在浏览器中游玩的牌桌服务。 DanKS 是一个用于构建掼蛋 AI 玩家的研究代码库。掼蛋是一种四人组队、信息不完全的牌类游戏。智能体先通过结构化检索生成候选出牌，再评估每种出法对手中剩余牌型组合的影响，最后由基于状态与候选动作的 Actor-Critic 网络结合 PPO 与 GAE 进行训练和选择。

DanKS 可以免费使用吗？用的什么许可证？

DanKS 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

DanKS 还在维护吗？

活跃维护中。DanKS 最近一次提交是在 2026年10月5日。

DanKS 适合用来做什么？

研究组队类纸牌游戏中信息不完全条件下的决策 在纸牌游戏环境中训练和比较强化学习策略 开发自定义掼蛋 AI 并接入本地网页牌桌 分析人类对局记录中的手牌结构与组队配合

DanKS 怎么安装和运行？

克隆仓库: git clone https://github.com/Calix-L/DanKS.git 进入服务目录并创建 Python 3.12 虚拟环境: cd DanKS/services/v2 && python3.12 -m venv .venv && source .venv/bin/activate 安装依赖并构建理牌模块: python -m pip install -r requirements.txt && python scripts/build_arranger.py 启动本地牌桌，然后打开 http://127.0.0.1:8000/solo: python run.py

在哪里获取 DanKS？

源代码和安装说明在 GitHub 上：https://github.com/Calix-L/DanKS