Files
olmo3-190m-zh-v2-continue/README.md

231 lines
8.0 KiB
Markdown
Raw Normal View History

---
base_model: Nwna/olmo3-190m-zh-v2-base
license: apache-2.0
language:
- zh
tags:
- pretrained
- olmo3
- chinese
- continue-pretrain
- mid-training
- llm001
library_name: transformers
pipeline_tag: text-generation
datasets:
- Nwna/olmo3-190m-zh-v2-continue-data
- wikimedia/wikipedia
- opencsg/chinese-cosmopedia
---
# OLMo3-190M-zh-v2-continue
**中文 continue-pretrain 教学模型**,基于 `Nwna/olmo3-190m-zh-v2-base`,继续注入 **Wikipedia-zh + Cosmopedia-Chinese + base replay** 组成的 1.194B tokens 中文语料。
> 这是《零基础 AI 大模型研发训练营》第 04 讲进阶作业模型。它是 continue-pretrained base model不是 instruction/chat model。
## 来源与动机
本模型的目标是验证 continue pretrain / mid-training 的工业范式:在已有 base model 上继续训练较小规模但更高事实密度、更强解释风格的数据,以较低成本改变模型的数据分布和表达风格。
本次实验特别关注:
```text
1. 是否能从 base checkpoint 正确继续训练,而不是重新随机初始化。
2. tokenizer 是否和 base 模型严格一致。
3. Wiki / Cosmopedia 是否能提升事实密度和解释型表达。
4. continue pretrain 是否能替代 SFT。
```
结论简述:
- ✅ 训练链路健康loss 从 smoke 阶段约 3.42 降到 full final 约 3.04。
- ✅ Continue 模型更容易生成教材式、百科式长段落。
- ⚠️ 事实问答仍不可靠,例如“北京大学位于”“四大发明是”仍可能答错。
- ⚠️ 该模型不能替代 SFT后续仍需要监督微调来学习问答格式和事实表达。
## 架构
`Nwna/olmo3-190m-zh-v2-base` 相同:
| 字段 | 值 |
|---|---:|
| `architectures` | `["Olmo3ForCausalLM"]` |
| `hidden_size` | 768 |
| `num_hidden_layers` | 12 |
| `num_attention_heads` | 12 |
| `intermediate_size` | 3072 |
| `vocab_size` | 48,000 |
| `max_position_embeddings` | 4096 |
| training seq_len | 2048 |
| total params | ~187M |
## 使用
```python
from transformers import AutoModelForCausalLM, AutoTokenizer
tok = AutoTokenizer.from_pretrained("Nwna/olmo3-190m-zh-v2-continue")
model = AutoModelForCausalLM.from_pretrained("Nwna/olmo3-190m-zh-v2-continue")
inputs = tok("人工智能是", return_tensors="pt")
outputs = model.generate(
**inputs,
max_new_tokens=120,
do_sample=True,
temperature=0.8,
top_p=0.9,
)
print(tok.decode(outputs[0], skip_special_tokens=True))
```
### 用于 SFT
v2-continue 是 continue-pretrained base model。它可以作为后续 SFT 底座:
```python
from transformers import AutoModelForCausalLM
model = AutoModelForCausalLM.from_pretrained("Nwna/olmo3-190m-zh-v2-continue")
# ... 用 SFTTrainer / 自定义 Trainer 做监督微调
```
## 训练配方
### 数据混合1.194B tokens
| 数据源 | 来源 | tokens | 作用 |
|---|---|---:|---|
| base replay | base raw 抽样 | 300M | 防止灾难性遗忘,保留通用中文能力 |
| Wikipedia-zh | `wikimedia/wikipedia` config `20231101.zh` | 394M | 注入实体、地点、历史、文学等百科事实 |
| Cosmopedia-Chinese | `opencsg/chinese-cosmopedia` | 500M | 注入解释型、教材型、知识组织文本 |
| 合计 | - | 1.194B | continue pretrain full data |
所有 continue 数据都使用 `Nwna/olmo3-190m-zh-v2-tokenizer` 重新编码,没有直接复用其他模型或数据集中的 tokenized `.bin`。这是必须条件token id 的语义由 tokenizer 决定,混用 tokenizer 会导致 embedding / lm_head 语义错位。
### 数据健康检查
```text
actual_tokens: 1,194,000,000
documents: 1,203,778
file_size_bytes: 2,388,000,000
max_token_id: 47,999
eos_token_id: 0
avg_traditional_probe_ratio: 0.000508
noise_pattern_hit: false
```
定向抽查覆盖了 `北京大学``四大发明``造纸术``印刷术``火药``指南针``红楼梦``贾宝玉``林黛玉``Python``人工智能` 等关键词。抽查只能证明语料中有覆盖,不能保证模型一定稳定回答。
### 超参
| 项目 | 值 |
|---|---:|
| base checkpoint | `Nwna/olmo3-190m-zh-v2-base` |
| GPU | H100 |
| precision | bf16 |
| attention | SDPA |
| epochs | 1.0 |
| total steps | 4,328 |
| per-device batch | 16 |
| grad accumulation | 8 |
| effective batch | 128 sequences |
| tokens / step | 262,144 |
| peak lr | 2e-4 |
| min lr | 2e-5 |
| warmup ratio | 10% |
| scheduler | warmup + cosine |
| optimizer | AdamW |
| weight decay | 0.1embedding / norm / bias excluded |
为什么学习率低于 basecontinue 阶段模型已有中文语言建模能力,过大学习率容易破坏已有能力;因此使用更低 peak lr 和更长 warmup使模型更平滑地适应新分布。
## Loss 轨迹
### 20-step smoke
| steps | train_loss | eval_loss | GPU |
|---:|---:|---:|---|
| 20 | 3.4235 | 3.3283 | A100-80G |
A100 40G 在同样 batch 配置下 OOMA100-80G 可跑通;正式 full 使用 H100。
### Full 1 epoch
| metric | value |
|---|---:|
| total steps | 4,328 |
| train_runtime | 8,964.52s |
| train_steps_per_second | 0.483 |
| train_loss | 3.0431 |
| last_eval_loss | 2.9404 |
| final learning_rate | 2.0002e-05 |
| final grad_norm | 0.2779 |
## Base → Continue 7-prompt 抽测
使用 `src/eval.py` 的采样生成设置:
```text
max_new_tokens=120
do_sample=True
temperature=0.8
top_p=0.9
repetition_penalty=1.1
```
| Prompt | Base | Continue | 变化 |
|---|---|---|---|
| 人工智能是 | 🟡 可生成科普,但较泛 | 🟡 更像教材式分领域展开 | 风格增强 |
| 山里有座庙 | 🟡 偏文物/寺庙说明 | 🟡 更像故事长叙事 | 续写更长,但仍虚构 |
| 今天天气不错,我准备 | 🟡 对话关系混乱 | 🟡 叙事更完整但漂移到奇幻故事 | 表达增强,控制仍弱 |
| 北京大学位于 | 🔴 答错地点 | 🔴 仍答错地点 | 未解决事实问答 |
| 四大发明是 | 🔴 错到电力设备列表 | 🔴 错到科学史人物 | 未解决事实问答 |
| 《红楼梦》人物 | 🔴 标题式重复 | 🔴 输出过短,未答人物 | 未解决文学知识 |
| Python 是一种 | 🟡 知道与编程相关但定义混乱 | 🟡 更像解释型文本,但仍不准确 | 小幅改善 |
关键 takeaways
- ✅ Continue pretrain 改变了表达风格,模型更容易生成解释型、教材型文本。
- ⚠️ Continue pretrain 没有把模型变成可靠问答模型。
- ⚠️ 事实问答、格式控制和重复控制应交给后续 SFT。
## 限制
1. **事实记忆上限**190M 参数规模较小,即使语料中包含事实,也不保证稳定召回。
2. **未做 SFT**:该模型不是 chat model不会稳定遵循指令。
3. **采样评估会波动**`do_sample=True` 时,同一 prompt 多次生成可能不同。
4. **Wiki / 网页格式风险**:尽管已清洗,仍可能出现标题腔、列表腔或重复。
5. **in-domain eval 不能等同通用能力**continue eval loss 在 continue 数据分布上更低,不能直接代表所有下游任务变好。
## License
- **模型权重**Apache-2.0
- **训练数据**:混合 license
- base replay 来自 base 阶段中文网页/教育数据
- Cosmopedia-Chinese请参考原数据集许可
- Wikipedia-zh含 CC-BY-SA-3.0 + GFDL 许可风险,商用前请咨询法律
权重声明为 Apache-2.0,但训练数据含 Wikipedia-zh使用者应自行评估 share-alike 数据对下游使用的影响。
## 配套资源
- Base model: <https://huggingface.co/Nwna/olmo3-190m-zh-v2-base>
- Tokenizer: <https://huggingface.co/Nwna/olmo3-190m-zh-v2-tokenizer>
- Continue data card: <https://huggingface.co/datasets/Nwna/olmo3-190m-zh-v2-continue-data>
- Space demo: <https://huggingface.co/spaces/Nwna/olmo3-190m-zh-v2-continue>
- 作业报告:`ch04进阶作业持续预训练_v2.md`
## Citation
```bibtex
@misc{nwna-olmo3-190m-zh-v2-continue,
title={OLMo3-190M-zh-v2-continue: Chinese Continue-Pretrained Teaching Model},
author={Nwna},
year={2026},
howpublished={\url{https://huggingface.co/Nwna/olmo3-190m-zh-v2-continue}},
note={LLM001 Course, Lecture 04 advanced homework}
}
```