For English description, please read README_EN.md or our technical report on arXiv: https://arxiv.org/abs/1906.08101
为了进一步促进中文自然语言处理的研究发展，我们提供了中文全词覆盖（Whole Word Masking）BERT的预训练模型。 同时在我们的技术报告中详细对比了当今流行的中文预训练模型：BERT、ERNIE、BERT-wwm。 更多细节请参考我们的技术报告：https://arxiv.org/abs/1906.08101
微信公众号文章介绍
- 哈工大讯飞联合实验室：https://mp.weixin.qq.com/s/EE6dEhvpKxqnVW_bBAKrnA
- 机器之心：https://mp.weixin.qq.com/s/88OwaHqnrVMQ7vH98INA3w
本项目基于谷歌官方的BERT：https://github.com/google-research/bert
Upcoming Event: 我们即将发布在更大通用语料上训练的中文BERT-wwm-ext模型
2019/6/20 初始版本，模型已可通过谷歌下载，国内云盘也已上传完毕，查看中文模型下载
| 章节 | 描述 |
|---|---|
| 简介 | 介绍BERT-wwm基本原理 |
| 中文模型下载 | 提供了BERT-wwm的下载地址 |
| 中文基线系统效果 | 列举了部分中文基线系统效果 |
| 使用建议 | 提供了若干使用中文预训练模型的建议 |
| 英文模型下载 | 谷歌官方的英文BERT-wwm下载地址 |
| FAQ | 常见问题答疑 |
| 引用 | 本目录的技术报告 |
Whole Word Masking (wwm)，暂且翻译为全词Mask，是谷歌在2019年5月31日发布的一项BERT的升级版本，主要更改了原预训练阶段的训练样本生成策略。简单来说，原有基于WordPiece的分词方式会把一个完整的词切分成若干个词缀，在生成训练样本时，这些被分开的词缀会随机被mask。在全词Mask中，如果一个完整的词的部分WordPiece被mask，则同属该词的其他部分也会被mask，即全词Mask。
需要注意的是，这里的mask指的是广义的mask（替换成[MASK]；保持原词汇；随机替换成另外一个词），并非只局限于单词替换成[MASK]标签的情况。更详细的说明及样例请参考：issue-4
同理，由于谷歌官方发布的BERT-base , Chinese中，中文是以字为粒度进行切分，没有考虑到传统NLP中的中文分词（CWS）。我们将全词Mask的方法应用在了中文中，使用了中文维基百科（包括简体和繁体）进行训练，并且使用了哈工大LTP作为分词工具），即对组成同一个词的汉字全部进行Mask。
下述文本展示了全词Mask的生成样例（注意：为了方便理解，下述例子中只考虑替换成[MASK]标签的情况。）。
| 说明 | 样例 |
|---|---|
| 原始文本 | 使用语言模型来预测下一个词的probability。 |
| 分词文本 | 使用 语言 模型 来 预测 下 一个 词 的 probability 。 |
| 原始Mask输入 | 使 用 语 言 [MASK] 型 来 [MASK] 测 下 一 个 词 的 pro [MASK] ##lity 。 |
| 全词Mask输入 | 使 用 语 言 [MASK] [MASK] 来 [MASK] [MASK] 下 一 个 词 的 [MASK] [MASK] [MASK] 。 |
由于在中文下，目前只包含base模型，故我们不在模型简称中标注base字样。
BERT-base模型：12-layer, 768-hidden, 12-heads, 110M parameters
| 模型简称 | 语料 | Google下载 | 讯飞云下载 |
|---|---|---|---|
BERT-wwm-ext, Chinese |
Wikipedia + Extended Data | Google Drive | 讯飞云（密码） |
BERT-wwm, Chinese |
Wikipedia | Google Drive | 讯飞云（密码mva8） |
BERT-base, Chinese (Google) |
Wikipedia | Google Cloud | - |
BERT-base, Multilingual Cased (Google) |
Wikipedia | Google Cloud | - |
BERT-base, Multilingual Uncased (Google) |
Wikipedia | Google Cloud | - |
以上均为TensorFlow版本的模型权重。 由于Huggingface出品的PyTorch-Transformers发生较大版本变化，我们不提供转换好的PyTorch版本供下载。 我们建议使用PyTorch-Transformers自带的转换脚本进行权重转换。 具体可参考该目录。
中国大陆境内建议使用讯飞云下载点，境外用户建议使用谷歌下载点，base模型文件大小约400M。 以TensorFlow版本为例，下载完毕后对zip文件进行解压得到：
chinese_wwm_L-12_H-768_A-12.zip
|- bert_model.ckpt # 模型权重
|- bert_model.meta # 模型meta信息
|- bert_model.index # 模型index信息
|- bert_config.json # 模型参数
|- vocab.txt # 词表
其中bert_config.json和vocab.txt与谷歌原版**BERT-base, Chinese**完全一致。
我们提供部分任务数据，请查看data目录了解。
压缩包内包含训练和测试数据，同一目录下的README.md标明数据来源。
由于一部分数据需要原作者授权，故我们无法提供下载链接，敬请谅解。
为了对比基线效果，我们在以下几个中文数据集上进行了测试，包括句子级和篇章级任务。
下面仅列举部分结果，完整结果请查看我们的技术报告。
注意：为了保证结果的可靠性，对于同一模型，我们运行10遍（不同随机种子），汇报模型性能的最大值和平均值。不出意外，你运行的结果应该很大概率落在这个区间内。
CMRC 2018数据集是哈工大讯飞联合实验室发布的中文机器阅读理解数据。根据给定问题，系统需要从篇章中抽取出片段作为答案，形式与SQuAD相同。
| 模型 | 开发集 | 测试集 | 挑战集 |
|---|---|---|---|
| BERT | 65.5 (64.4) / 84.5 (84.0) | 70.0 (68.7) / 87.0 (86.3) | 18.6 (17.0) / 43.3 (41.3) |
| ERNIE | 65.4 (64.3) / 84.7 (84.2) | 69.4 (68.2) / 86.6 (86.1) | 19.6 (17.0) / 44.3 (42.8) |
| BERT-wwm | 66.3 (65.0) / 85.6 (84.7) | 70.5 (69.1) / 87.4 (86.7) | 21.0 (19.3) / 47.0 (43.9) |
| BERT-wwm-ext |
DRCD数据集由中国台湾台达研究院发布，其形式与SQuAD相同，是基于繁体中文的抽取式阅读理解数据集。
| 模型 | 开发集 | 测试集 |
|---|---|---|
| BERT | 83.1 (82.7) / 89.9 (89.6) | 82.2 (81.6) / 89.2 (88.8) |
| ERNIE | 73.2 (73.0) / 83.9 (83.8) | 71.9 (71.4) / 82.5 (82.3) |
| BERT-wwm | 84.3 (83.4) / 90.5 (90.2) | 82.8 (81.8) / 89.7 (89.0) |
| BERT-wwm-ext |
中文命名实体识别（NER）任务中，我们采用了经典的人民日报数据以及微软亚洲研究院发布的NER数据。在这里我们只列F值，其他数值请参看技术报告。
| 模型 | 人民日报 | MSRA |
|---|---|---|
| BERT | 95.2 (94.9) | 95.3 (94.9) |
| ERNIE | 95.7 (94.5) | 95.4 (95.1) |
| BERT-wwm | 95.3 (95.1) | 95.4 (95.1) |
| BERT-wwm-ext |
由清华大学自然语言处理实验室发布的新闻数据集，我们采用的是其中一个子集，需要将新闻分成10个类别中的一个。
| 模型 | 开发集 | 测试集 |
|---|---|---|
| BERT | 97.7 (97.4) | 97.8 (97.6) |
| ERNIE | 97.6 (97.3) | 97.5 (97.3) |
| BERT-wwm | 98.0 (97.6) | 97.8 (97.6) |
| BERT-wwm-ext |
- 初始学习率是非常重要的一个参数（不论是BERT还是其他模型），需要根据目标任务进行调整。
- ERNIE的最佳学习率和BERT/BERT-wwm相差较大，所以使用ERNIE时请务必调整学习率（基于以上实验结果，ERNIE需要的初始学习率较高）。
- 由于BERT/BERT-wwm使用了维基百科数据进行训练，故它们对正式文本建模较好；而ERNIE使用了额外的百度百科、贴吧、知道等网络数据，它对非正式文本（例如微博等）建模有优势。
- 在长文本建模任务上，例如阅读理解、文档分类，BERT和BERT-wwm的效果较好。
- 如果目标任务的数据和预训练模型的领域相差较大，请在自己的数据集上进一步做预训练。
- 如果要处理繁体中文数据，请使用BERT或者BERT-wwm。因为我们发现ERNIE的词表中几乎没有繁体中文。
为了方便大家下载，顺便带上**谷歌官方发布的英文BERT-large（wwm）**模型：
-
BERT-Large, Uncased (Whole Word Masking): 24-layer, 1024-hidden, 16-heads, 340M parameters -
BERT-Large, Cased (Whole Word Masking): 24-layer, 1024-hidden, 16-heads, 340M parameters
Q: 这个模型怎么用？
A: 谷歌发布的中文BERT怎么用，这个就怎么用。
文本不需要经过分词，wwm只影响预训练过程，不影响下游任务的输入。
Q: 请问有预训练代码提供吗？
A: 很遗憾，我不能提供相关代码，实现可以参考 #10 和 #13。
Q: 某某数据集在哪里下载？
A: 请查看data目录。对于有版权的内容，请自行搜索或与原作者联系获取数据。
Q: 会有计划发布更大模型吗？比如BERT-large-wwm版本？
A: 如果我们从实验中得到更好效果，会考虑发布更大的版本。
Q: 你骗人！无法复现结果😂
A: 在下游任务中，我们采用了最简单的模型。比如分类任务，我们直接使用的是run_classifier.py（谷歌提供）。
如果无法达到平均值，说明实验本身存在bug，请仔细排查。
最高值存在很多随机因素，我们无法保证能够达到最高值。
另外一个公认的因素：降低batch size会显著降低实验效果，具体可参考BERT，XLNet目录的相关Issue。
Q: 我训出来比你更好的结果！
A: 恭喜你。
Q: 训练花了多长时间，在什么设备上训练的？
A: 训练是在谷歌TPU v3版本（128G HBM）完成的，训练BERT-wwm-base花费约1.5天，BERT-wwm-base-ext则需要数周时间（使用了更多数据需要迭代更充分）。
需要注意的是，预训练阶段我们使用的是LAMB Optimizer（TensorFlow版本实现）。该优化器对大的batch有良好的支持。
在微调下游任务时，我们采用的是BERT默认的AdamWeightDecayOptimizer。
Q: ERNIE是谁？
A: 本项目中的ERNIE模型特指百度公司提出的ERNIE，而非清华大学在ACL 2019上发表的ERNIE。
Q: 你们这个和百度的ERNIE有什么区别？
A: 因为百度ERNIE的提出先于谷歌提出Whole Word Masking（仅以公开相关工作的时间为基准），基于全词mask的方法应该是百度的相关工作在先。
另外百度ERNIE采用了更多的masking策略，而本工作只针对CWS进行了特殊处理，尽量保持与谷歌BERT-wwm一致。
从数据上看，ERNIE采用了更多的网络数据（百科，贴吧，新闻），而本项目中只使用了中文维基百科数据。
Q: 你们在实验中使用了ERNIE，是怎么用的呢？
A: 我们将ERNIE从PaddlePaddle格式转换为TensorFlow格式，并加载到下游任务的代码中。
很遗憾，目前我们不能提供PP转TF/PT的代码，但GitHub中有一些开源的实现，可以搜索关注一下。
同时，因为版权原因，我们不会提供TensorFlow/PyTorch版本的ERNIE权重供大家下载。
关于ERNIE在PaddlePaddle中使用的相关问题，请咨询ERNIE官方。
Q: BERT-wwm的效果不是在所有任务都很好
A: 本项目的目的是为研究者提供多元化的预训练模型，自由选择BERT，ERNIE，或者是BERT-wwm。
我们仅提供实验数据，具体效果如何还是得在自己的任务中不断尝试才能得出结论。
多一个模型，多一种选择。
Q: 为什么有些数据集上没有试？
A: 很坦率的说：
1）没精力找更多的数据；
2）没有必要；
3）没有钞票；
Q: 简单评价一下这几个模型
A: 各有侧重，各有千秋。
中文自然语言处理的研究发展需要多方共同努力。
Q: 你预测下一个预训练模型叫什么？
A: 可能叫ZOE吧，ZOE: Zero-shOt Embeddings from language model
如果本目录中的内容对你的研究工作有所帮助，请在文献中引用下述技术报告： https://arxiv.org/abs/1906.08101
@article{chinese-bert-wwm,
title={Pre-Training with Whole Word Masking for Chinese BERT},
author={Cui, Yiming and Che, Wanxiang and Liu, Ting and Qin, Bing and Yang, Ziqing and Wang, Shijin and Hu, Guoping},
journal={arXiv preprint arXiv:1906.08101},
year={2019}
}
本项目并非谷歌官方发布的Chinese BERT-base (wwm)。同时，本项目不是哈工大或科大讯飞的官方产品。
技术报告中所呈现的实验结果仅表明在特定数据集和超参组合下的表现，并不能代表各个模型的本质。 实验结果可能因随机数种子，计算设备而发生改变。 由于我们没有直接在PaddlePaddle上使用ERNIE，所以在ERNIE上的实验结果仅供参考（虽然我们在多个数据集上复现了效果）。
该项目中的内容仅供技术研究参考，不作为任何结论性依据。使用者可以在许可证范围内任意使用该模型，但我们不对因使用该项目内容造成的直接或间接损失负责。
第一作者部分受到谷歌TensorFlow Research Cloud (TFRC)计划的支持。
欢迎关注哈工大讯飞联合实验室官方微信公众号。
如有问题，请在GitHub Issue中提交。