# word-pk-words

**Repository Path**: chenjunming116/word-pk-words

## Basic Information

- **Project Name**: word-pk-words
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: CC-BY-SA-4.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-03
- **Last Updated**: 2026-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# word-pk 开源词库集

[word-pk](https://wordbattle.top) 单词对战游戏的完整词库，**246 个词库 / 818,245 个单词**。

## 目录结构

本仓库按**许可证分层**，不同目录适用不同许可，请分别遵守：

| 目录 | 词库数 | 词数 | 内容 | 许可证 |
|---|---|---|---|---|
| `cc0/` | 133 | 41,467 | 原创主题词库 + 专业词汇 | **CC0 1.0**（公有领域，随便用） |
| `cc-by-sa-4.0/` | 3 | 652,180 | Wiktionary / JMdict / Tatoeba 衍生 | **CC BY-SA 4.0**（须署名 + 相同方式共享） |
| `wordnet/` | 29 | 51,974 | WordNet 3.0 英英释义 | **WordNet License**（宽松，须保留版权声明） |
| `wordlists/` | 81 | 72,624 | 教材 / 考试 / 其他词表 | **CC0 1.0**（词表部分） |

**⚠️ 重要：不能把整个仓库当作单一许可证使用。** 见 `ATTRIBUTION.md`。

## 数据格式

每个词库是一个 JSON 文件：

```json
{
  "id": "fun-loanwords",
  "name": "英语外来词",
  "units": [
    {
      "unit": "源自法语 French",
      "words": [
        { "en": "café",      "zh": "咖啡馆 · 源自法语" },
        { "en": "restaurant","zh": "餐厅 · 源自法语" }
      ]
    }
  ]
}
```

字段说明：

| 字段 | 含义 |
|---|---|
| `id` | 词库唯一标识 |
| `name` | 词库显示名 |
| `units[].unit` | 分组名 |
| `units[].words[].en` | 词条（英文，少数小语种词库为对应语言） |
| `units[].words[].zh` | 释义（中文） |
| `units[].words[].def` | 英文释义（WordNet 衍生词库用） |
| `units[].words[].syn` / `ant` | 同义词 / 反义词 |
| `units[].words[].example` | 例句 |

## 快速使用

```python
import json, glob

for f in glob.glob('cc0/*.json'):
    d = json.load(open(f, encoding='utf-8'))
    for unit in d['units']:
        for w in unit['words']:
            print(w['en'], w.get('zh') or w.get('def', ''))
```

## 许可证

- `LICENSE-CC0-1.0.txt` —— CC0 1.0 Universal（公有领域贡献）
- `LICENSE-CC-BY-SA-4.0.txt` —— Creative Commons Attribution-ShareAlike 4.0
- `LICENSE-WordNet-3.0.txt` —— Princeton WordNet 3.0 License
- `ATTRIBUTION.md` —— **所有数据来源的完整署名（必须保留）**
- `DISCLAIMER.md` —— 商标声明与免责条款

## 贡献

欢迎提交词库纠错或新增词库。请说明数据来源与许可证。

---

*本词库集由 word-pk 项目维护。*