---
title: Sanguosha
canonical_url: "https://www.modelscope.cn/datasets/suxinchun/Sanguosha"
md_url: "https://www.modelscope.cn/datasets/suxinchun/Sanguosha.md"
repository: suxinchun/Sanguosha
chinese_name: "三国杀数据集"
last_updated: 2026-09-08
license: "Apache License 2.0"
storage_size: "9.2 MB"
downloads: 36328
stars: 3
---

# Sanguosha

> Sanguosha - suxinchun 在 ModelScope 开源的数据集。三国杀数据集

suxinchun/Sanguosha 是 ModelScope 魔搭社区上的数据集，存储大小 9.2 MB，采用 Apache License 2.0 许可。

- **Repository**: suxinchun/Sanguosha
- **License**: Apache License 2.0
- **Storage size**: 9.2 MB
- **Downloads**: 36328
- **Stars**: 3
- **Last updated**: 2026-09-08

Source: https://www.modelscope.cn/datasets/suxinchun/Sanguosha

---

# 三国杀完整知识库数据集

## 数据集简介

本数据集是《三国杀》卡牌游戏的完整结构化知识库，系统整理了全服务器（OL、十周年、移动版、移动版海外服、线下珍藏版、小程序等）、全扩展包、全版本的武将牌、游戏牌、规则、术语、牌堆结构及谜题数据。数据以 Markdown 格式组织，共 4281 个文件，适用于大语言模型训练微调、RAG 检索增强生成知识库构建、游戏规则查询系统开发及三国杀 AI 研究。

## 数据规模

| 类别 | 文件数 | 说明 |
|------|:------:|------|
| 武将牌 | 3982 | 全服全扩展武将数据，含主文件与版本变体 |
| 游戏牌 | 290 | 基本牌、锦囊牌、装备牌完整数据 |
| 列表 | 6 | 术语、规则、技能、牌堆结构、战功、主公技汇总 |
| 特殊卡牌 | 1 | 早期推广版特殊卡牌 |
| 谜题 | 2 | 推理与探索谜题及解析 |
| **总计** | **4281** | |

## 目录结构

```
references/
├── 武将牌/                                    # 3982 个武将文件
│   ├── 标准版、神话再临系列扩展包及对应界限突破武将/           # 446
│   ├── 一将成名系列、原创之魂系列扩展包及对应界限突破武将/     # 329
│   ├── OL文德武备系列、门阀士族系列、上兵伐谋系列、魔系列、
│   │    祈福系列、璀璨星河系列、江山如故系列、SP系列扩展包武将/ # 330
│   ├── 十周年星火燎原系列、星河璀璨系列、谋定天下系列、
│   │    威震天下系列、限定专属系列、群英荟萃系列、
│   │    专属一将成名系列扩展包武将/                        # 448
│   ├── 移动版（手杀）稀有专属系列、龙血玄黄系列、兵势篇系列、
│   │    谋攻篇系列、始计篇系列、江山如故系列、SP系列扩展包武将/ # 677
│   ├── 移动版（海外服）稀有专属系列、武侠篇系列、IF篇系列、
│   │    龙血玄黄系列、谋攻篇系列、运筹帷幄（原始计篇）系列、
│   │    SP系列扩展包武将/                               # 638
│   ├── 珍藏版（璀璨将星）、江山如故系列、四象封印系列、
│   │    蚀心入魔系列扩展包及其他线下专属武将/                # 557
│   ├── 国战标准版、君临天下系列、不臣篇系列、纵横捭阖系列、
│   │    紫气东来系列、金印紫绶系列扩展包及各服国战专属武将/     # 297
│   ├── 其他武将（1V1、2V2、3V3、斗地主等）/              # 127
│   ├── 桌游志SP系列、☆SP系列、界SP系列、点将DIY专供系列、
│   │    RE系列、国SP系列、锋绘PR系列、COS系列/           # 52
│   ├── 小程序登峰造极系列、稀有限定系列扩展包武将/           # 46
│   └── 欢乐杀喵娘乱舞系列、念系列、战系列、SP系列扩展包武将/   # 35
├── 游戏牌/                                    # 290 个游戏牌文件
│   ├── 基本牌/          # 按扩展包分目录
│   ├── 锦囊牌/          # 按类别与扩展包分目录
│   └── 装备牌/          # 按类别与扩展包分目录
├── 列表/                                      # 6 个参考列表
├── 特殊卡牌/                                  # 1 个特殊卡牌文件
└── 谜题/                                      # 2 个谜题文件
```

## 数据统计与可视化

以下统计基于 `references/武将牌/` 下的 3982 个武将文件（每个文件计为一个武将牌条目）与 `references/游戏牌/` 下的 290 个游戏牌文件。

### 武将牌基本信息

武将势力覆盖魏、蜀、吴、群、晋、神、野、双势力及特殊势力，其中群势力最多（1292），其次为魏（964）、蜀（799）、吴（665）。

![武将势力分布](images/01_武将势力分布.png)

体力与体力上限以 3 体力、4 体力为最常见配置，另有特殊高体力武将。

![武将体力分布](images/02_武将体力分布.png)

![武将体力上限分布](images/03_武将体力上限分布.png)

国战武将使用阴阳鱼作为体力表示，绝大多数为 1.5 或 2 条鱼；珠联璧合是国战专属机制，多数国战武将拥有 1 至 2 名珠联璧合角色。

![国战武将阴阳鱼数分布](images/04_国战阴阳鱼数分布.png)

![国战武将珠联璧合数分布](images/05_国战珠联璧合数分布.png)

武将性别以男性为主（3167），女性 737，另有少量双将组合。

![武将性别分布](images/06_武将性别分布.png)

武将姓名以二字和三字为主。

![武将姓名字数分布](images/07_武将姓名字数分布.png)

绝大多数武将牌为单将（3874），双将 105，三将 1，多人武将牌（十常侍）2。

![武将牌单双三多将分布](images/08_武将单双三多将分布.png)

称号以 4 字为主（2929），其次为 5 字（503），另有 153 个武将文件无称号。

![武将称号字数分布](images/09_武将称号字数分布.png)

### 技能

技能统计以各武将文件简略描述中的技能条目计（不去重）。多数武将拥有 1 至 2 个技能（2 技能 2088、1 技能 682），少数武将超过 10 个技能。

![武将技能数分布](images/10_武将技能数分布.png)

![武将技能字数分布](images/11_武将技能字数分布.png)

技能标签方面，无标签技能数量最多（7783），有标签技能中"锁定技"出现 1951 次，其次为"限定技"（399）、"主公技"（236）、"觉醒技"（212）。

![技能标签数分布](images/12_技能标签数分布.png)

### 台词

约半数武将文件包含台词数据（2091 个有台词条目），非空台词条数多集中在 3 至 8 条。

![武将台词数分布](images/13_武将台词数分布.png)

![武将台词字数分布](images/14_武将台词字数分布.png)

### 评语

多数武将无评语（3829），有评语者 153。

![武将评语有无分布](images/15_武将评语有无分布.png)

### 游戏牌统计

以下统计均基于 `references/游戏牌/` 下的 290 个游戏牌文件（每个文件计为一张牌名条目）。

游戏牌分为三大类：基本牌 16、锦囊牌 122、装备牌 152。

![游戏牌三大类数量](images/16_游戏牌三大类数量.png)

锦囊牌按子类别分为普通锦囊牌 109、延时锦囊牌 9、势力锦囊牌 4。

![锦囊牌子类别数量](images/17_游戏牌锦囊牌子类别.png)

装备牌按子类别分为武器 70、防具 27、坐骑 16、宝物 38，另有 1 个同时属武器与宝物的条目。

![装备牌子类别数量](images/18_游戏牌装备牌子类别.png)

武器攻击范围以 2 至 3 居多，个别武器具有条件变化的攻击范围。

![武器攻击范围分布](images/19_游戏牌武器攻击范围分布.png)

花色点数按分布表中的点数项累计为牌张数（同一张牌在各牌堆出现分别计入，内容完全相同的重复收录文件不重复计入）。四花色中红桃最多（254），其次为黑桃（249）、梅花（226）、方块（215）；锦囊牌最多（413），其次为基本牌（318）、装备牌（213）。

![四花色牌张数堆叠](images/20_游戏牌四花色牌张数堆叠.png)

游戏牌文件中有评语者 152，无评语者 138。

![游戏牌评语有无](images/21_游戏牌评语有无.png)

## 数据文件格式

### 武将牌文件格式

每个武将牌为独立 Markdown 文件，文件名格式为"武将名（版本标识）.md"，多版本武将的变体存放于【其他版本】子目录。文件包含以下固定字段：

- **基本信息**：名称、称号、势力、性别、体力、体力上限、编号、评语
- **技能**：简略描述（通俗语言）与规则集描述（规则集语言，包含时机、消耗、条件、目标、效果等要素）
- **技能特殊说明**：技能的额外规则说明
- **人物简介**：武将的历史背景介绍
- **台词**：以表格形式列出各技能配音台词及阵亡台词
- **上线情况**：标注该武将在各服务器及所属扩展包的信息
- **其他信息**：补充说明

国战武将不设体力与体力上限字段，改用阴阳鱼表示体力，并增加珠联璧合字段。

### 游戏牌文件格式

每个游戏牌为独立 Markdown 文件，文件名格式为"【牌名】.md"。文件包含以下固定字段：

- **基本信息**：牌名、属性、扩展包
- **简略描述**：通俗的功能描述
- **规则集描述**：精确的规则集语言描述
- **花色点数分布表**：该牌在不同牌堆中的花色与点数分布；无花色点数的特殊牌（如虚拟牌与线下模式无花色装备）此表记为无
- **特殊说明**：卡牌的补充规则说明
- **评语**：卡牌引文

## 使用方法

数据可直接以文本方式读取，也可使用随附的查询脚本：

```bash
# 查询武将技能
python scripts/query-general.py <武将名> [编号]

# 查询游戏牌
python scripts/query-card.py <牌名> [编号]

# 按扩展包列出武将
python scripts/list-generals.py [扩展包关键词] [势力]
```

## 免责声明

- 本数据集中的游戏规则、技能描述、卡牌数据等内容的知识产权归《三国杀》版权方（杭州游卡网络技术有限公司）所有。
- 人物简介部分参考自《三国志》、《三国演义》等公共领域历史文献。
- 本数据集仅供学习、研究、非商业用途使用。
- 数据来源于三国杀官方规则集、各服务器公开信息及社区贡献者的整理工作。

## 也可以看看

- 根据本数据集制作的创空间：[AI-Sanguosha](https://www.modelscope.cn/studios/suxinchun/AI-Sanguosha)
- 使用本数据集的 skill：[Sanguosha](https://www.modelscope.cn/skills/suxinchun/Sanguosha)
- 另一个数据集，围棋数据集：[MaedaNobuaki80](https://www.modelscope.cn/datasets/suxinchun/MaedaNobuaki80)
