# OpenGwent

**Repository Path**: andershsueh/open-gwent

## Basic Information

- **Project Name**: OpenGwent
- **Description**: 既然不能流畅使用，那我自己做一个吧。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Open Gwent — 巫师之昆特牌 资料库

> 一个由 AI 助手驱动的**昆特牌（Gwent: The Witcher Card Game）**卡牌资料库：以 `mmx search` 抓取猎魔人中文维基（`witcher.huijiwiki.com`）数据，结构化整理为可直接消费的 markdown / HTML 文件。

## 这是什么

`open-gwent` 是把昆特牌（Gwent）卡牌资料**系统化、可重复、结构化**地沉淀下来的项目，目标受众包括：

- 《巫师 3：狂猎》玩家，需要在《石之心》《血与酒》资料片中**全部收集** / 对应 NPC 的**对局策略**参考。
- 《巫师之昆特牌》独立游戏玩家，需要为卡组构筑准备**图文对照资料**。
- **二次开发**：把这份资料作为语料库喂给 LLM、训练嵌入、做 RAG、构成本地化检索数据库。
- 数据可视化 / 卡牌工具开发者（本地缓存、离线 HUD 等）。

数据源：[猎魔人中文维基（灰机 wiki）](https://witcher.huijiwiki.com/)。

## 当前规模

| 维度 | 数据 |
|---|---|
| 维基总条目 | ~374 |
| 已抓取卡牌（`.md`） | **59 张**（约 16%） |
| 卡牌技能关键词分类 | 烧灼 / 间谍 / 提振士气 / 领导号角 / 医生 / 集合 / 同袍之情 / 狂战士 / 玛德罗弥 / 呼唤复仇者 |
| 阵营 | 中立 / 北方领域 / 尼弗迦德帝国 / 松鼠党 / 怪物 / 史凯利杰 / 辛迪加 |
| 稀有度 | 铜 / 银 / 金 / 领袖 |

> 进度统计见 `./raw/_index.md`。

## 目录结构

```
kwent/
├── README.md                  ← 本文件
├── CLAUDE.md                  ← 给 Claude / AI 助手的工程偏好（mmx 抓取方法）
├── .gitignore                 ← 已排除 raw/ wiki/ outputs/ 与各类本地产物
├── .claude/
│   └── settings.local.json    ← Claude 工具本地配置
├── raw/                       ← 【不纳入版本库】mmx search 抓取产物
│   ├── _index.md              ← 卡牌全集导航索引
│   ├── base_info.html         ← 昆特牌综合科普（玩法、阵营、术语）
│   ├── 利维亚的杰洛特.md
│   ├── 卓尔坦·齐瓦.md
│   ├── 烧灼.md
│   └── …（每张卡一张 .md）
├── wiki/                      ← 【不纳入版本库】二次加工的对外文档
│   └── （待填充：阵营 / 卡组 / 关键词教程）
└── outputs/                   ← 【不纳入版本库】最终发布物 / 渲染产物
    └── （待填充：可读 HTML / PDF / 数据集）
```

**`raw/` 与 `outputs/` 的分工**
- `raw/` — mmx search 直接抓取的、尚未归一化的卡牌数据；
- `wiki/` — 经过结构化整理、可直接对外发布的文档；
- `outputs/` — 终端用户消费的格式（HTML / PDF / SQLite / 单页应用）。

## 数据来源与方法

### 为什么用 `mmx search` 而不是 `curl` / `WebFetch` / `WebSearch`？

| 工具 | 对 huijiwiki 的访问 |
|---|---|
| `curl` / `WebFetch` | ❌ 被 Cloudflare challenge 拦截，全部返回"Just a moment..." |
| `mcp__web-reader` | ❌ 同上 |
| `WebSearch`（Claude 内置） | ✅ 可工作但无 `site:` 倾向 |
| **`mmx search query`** | ✅ **唯一稳定可用**，可 `site:` 限定、返回结构化摘要 |

### 标准抓取命令

```bash
# 单张卡
mmx search query --q "site:witcher.huijiwiki.com 卡牌名 (昆特牌)" --output text

# 按阵营批量
mmx search query --q "site:witcher.huijiwiki.com 北方领域 单位牌 (昆特牌)" --output text
```

> 详见 [`CLAUDE.md`](./CLAUDE.md) — 完整方案。

### 单张卡牌输出格式

每个 `./raw/<卡名>.md` 包含：

- 牌组归属（中立 / 北方 / 尼弗迦德 / 松鼠党 / 怪物 / 史凯利杰 / 辛迪加）
- 类型（领袖 / 英雄 / 单位 / 天气 / 特别）
- 战列（近战 / 远程 / 攻城 / 敏捷）
- 战力点数
- 卡牌 ID（`gwint_card_xxx`，游戏内 ID）
- 能力描述（含《巫师 3》原版 + 独立版多个版本）
- 卡牌台词（中英双语）
- 衍生卡（如乌德维克之王之于哈尔玛）
- 关联卡牌、所属资料片、获得方式
- 对应维基页面 URL（用于手工取图）

## 阵营速览

| 阵营 | 关键词机制 | 风格 |
|---|---|---|
| 🧛 **怪物** | 吞噬、遗愿、成长 | 天气控场、卡差爆发 |
| ⚔️ **北方领域** | 增强自身、杀伤对手 | 攻城 + 蓝衣铁卫引擎 |
| 🏴‍☠️ **史凯利杰** | 自伤、伤人、挖坟 | 弃牌回手（挖坟流） |
| 🐿️ **松鼠党** | 和谐、增益 | 矮人 + 精灵组件 |
| 👑 **尼弗迦德** | 揭示、间谍、控制 | 滤牌 + 帝博尔 |
| 🃏 **辛迪加** | 金币、契约 | 后期法伤爆发 |

## 路线图

- [x] 阶段 1：基础资料 + 首批 ~60 张已索引卡牌抓取
- [x] 阶段 2：CLAUDE.md 建立 mmx 抓取规范
- [ ] 阶段 3：剩余 ~315 张卡牌逐一抓取（目标在 100% 之前完成）
- [ ] 阶段 4：把所有卡牌标准化为统一 schema，转入 `./wiki/cards/` 可发布目录
- [ ] 阶段 5：渲染 `./outputs/gwent-cards.html`（单页 wiki）
- [ ] 阶段 6：导出为 `gwent.json` / `gwent.csv` 供下游语料使用

## 贡献

PR 欢迎。任何形式：

1. 改进 `.md` 内容，纠正 / 补充卡牌信息。
2. 在 `./wiki/` 下写新的对照文档（阵营解析、卡组构筑）。
3. 自动化抓取脚本（计划中的 `scripts/scrape.sh`）。

请保持在每张卡的 markdown 结构上可解析（参见 `利维亚的杰洛特.md`），方便后续生成 HTML / JSON。

## 版权与来源声明

> "昆特牌"和"GWENT®"品牌由 CD Projekt RED 及 CD Projekt 持有。
> 本站仅整理其卡牌资料供学习 / 研究 / 工程使用；
> 所有卡牌图片 / 原画版权归 **CD Projekt RED**、**CD Projekt** 与「巫师之昆特牌」中国大陆代理商 **盖娅互娱** 所有。
> 维基原始资料来源于 [猎魔人中文维基](https://witcher.huijiwiki.com/)。

## 工具与依赖

| 工具 | 用途 |
|---|---|
| [`mmx`](https://MiniMax.io) | MiniMax CLI（提供 `mmx search` 网页搜索） |
| `bash` / PowerShell | Shell 编排 |
| `git` | 版本控制 |
| Markdown / HTML | 主要文档格式 |

如需在中国大陆境外访问受限站点，请在 `mmx` 中使用 `--region global`。

— *open-gwent · 2026 · MiniMax-driven dump of Gwent card data.*