Update images via Git LFS

.gitattributes

@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 junwei li
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,3 +1,287 @@
 ---
 license: mit
 ---
+
+<div align="center">
+
+# 💫 GrandLine_LLM
+
+![GrandLine_LLM](https://img.shields.io/badge/Model-💫GrandLine_LLM-yellow.svg)
+![Architecture](https://img.shields.io/badge/Architecture-Qwen3_Dense-8D64FF.svg)
+![Architecture](https://img.shields.io/badge/Architecture-DeepSeek_MoE-4D53E8.svg)
+![RL](https://img.shields.io/badge/RL-GRPO-blue.svg)
+![Reasoning](https://img.shields.io/badge/Reasoning-CoT-00BFFF.svg)
+![Python](https://img.shields.io/badge/Python-3.8+-2CB8B8.svg)
+![PyTorch](https://img.shields.io/badge/PyTorch-2.0+-EE4C2C.svg)
+![License](https://img.shields.io/badge/License-MIT-green.svg)
+
+</div>
+
+GrandLine_LLM 是一个从零开始构建的 **类 Qwen 3 Dense架构 / Deepseek MoE架构** 大语言模型。本项目实现了完整的 LLM 研发管线，通过从模型架构手动实现到 BBPE 分词器训练、分布式预训练、SFT 以及 GRPO 强化学习对齐，最终培育出一个具有极低参数量却能流畅对话的 Chatbot。
+
+- **GitHub 源码仓库**: [https://github.com/Justin-ljw/GrandLine_LLM](https://github.com/Justin-ljw/GrandLine_LLM)
+- **模型权重**: 包含 **类Qwen3 Dense 架构模型** 在 Pre-train、SFT、CoT Distillation 与 GRPO 对齐阶段的 Checkpoints。
+
+---
+
+<br>
+
+## ✨ 核心特性 (Key Features)
+
+- 🧠 **原生的 Dense 架构设计**：从底层构建大语言模型结构，包含以下核心实现：
+  - **GQA (分组查询注意力)**、**SwiGLU (门控前馈神经网络)**、**MoE (混合专家机制)**。
+  - **RoPE (旋转位置编码)**、**KV Cache (键值缓存加速)**、**RMS Norm (均方根归一化)**。
+- 🔠 **定制化 BBPE Tokenizer**：针对项目语料从头训练 Byte-Level BPE 分词器，提供更高的中文分词效率。
+- 🚀 **全链路训练体系**：
+  - **Pre-training (PT)**: 大规模无监督语料知识注入。带有 **LR Warmup & Cosine Decay (学习率预热与余弦衰减)** 策略。
+  - **Supervised Fine-Tuning (SFT)**: 高质量指令微调，激发指令遵循能力。
+  - **CoT 思维链蒸馏 (Chain-of-Thought Distillation)**: 借助强大的前沿大模型生成包含复杂推理步骤的 CoT 数据，精炼并迁移至本项目小参数模型，使其初步具备“想后填答”的逻辑推理惯性。
+  - **Reinforcement Learning (GRPO)**: 从0全手写实现了组相对策略优化 (GRPO) 训练代码，对齐人类偏好。
+- ⚡ **高效稳定分布式训练**：完整实现原生 **DDP (Distributed Data Parallel)** 单机多卡分布式训练，且支持完全无损的断点续训 (Lossless Checkpoint Resuming)。
+- 📊 **多维评测体系**：内置标准的 Benchmark 评测管线，并引入前沿的 **LLM-as-a-Judge** 自动化评估机制。
+
+---
+
+<br>
+
+## 🏗️ 架构概览与训练流程 (Architecture & Pipeline)
+
+### 模型结构图
+**类 Qwen 3 Dense 架构**
+![Dense Model](images/GranLine_Dense.jpg)
+
+- **参数规模**: 87M (0.087B)
+- **架构类型**: Causal Decoder-only (Dense Architecture)
+- **并行策略**: Distributed Data Parallel (DDP) / 混合精度训练 (AMP)
+
+---
+
+<br>
+
+**Deepseek MoE 架构**
+![MoE Model](images/GranLine_MoE.jpg)
+
+
+- **总参数量**: 257M(0.257B)
+- **激活参数量**: 87M (0.087B)
+- **架构类型**: Causal Decoder-only (MoE Architecture)
+- **并行策略**: Distributed Data Parallel (DDP) / 混合精度训练 (AMP)
+
+---
+
+<br>
+
+### 全链路训练流程
+这些权重文件见证了模型从“随机初始化”到“掌握逻辑推理”的完整过程：
+1. **PT (预训练)**: 通过大规模无监督语料注入语言常识，模型具备了连贯的中文续写能力。
+2. **SFT (指令微调)**: 通过优质问答对微调，模型能够听懂指令并以 Assistant 的身份执行结构化回复。
+3. **CoT (思维链蒸馏)**: 引入 `<think>` 标签，使极小参数模型获得了通过拆解步骤解决复杂问题的能力。
+4. **GRPO (强化学习)**: 结合 LLM-as-Judge 与规则格式约束进行本地强化学习，大幅降低虚假幻觉，人类偏好对齐度显著提升。
+
+![Training Pipeline](images/Training_Pipeline.jpg)
+
+---
+
+<br>
+
+## 🔠 Tokenizer 配置 (Tokenizer Config)
+
+<details>
+<summary>点击查看 Tokenizer Config 信息</summary>
+
+```json
+{
+  "vocab_size": 15000,
+  "model_type": "BPE",
+  "bos_token": "<|im_start|>",
+  "eos_token": "<|im_end|>",
+  "pad_token": "<|endoftext|>",
+  "unk_token": "<|endoftext|>",
+  "model_max_length": 8192,
+  "tokenizer_class": "PreTrainedTokenizerFast",
+}
+```
+</details>
+
+---
+
+<br>
+
+## 📚 训练数据 (Training Data)
+
+### 数据配比图
+![Data Distribution](images/data_distribution_professional.png)
+
+### 训练数据示例
+<details>
+<summary>点击查看数据样例 (Pre-train / SFT)</summary>
+
+**预训练 (Pre-train) 数据示例:**
+```json
+{"text": "建议公司如何降低成本和提高效率。 1. 自动化和数字化：采用现代化技术和工具，例如自动化生产线和数字化软件，可 以降低公司的成本并提高效率。\n2. 减少浪费：公司应该削减浪费和不必要的支出，例如，纸质文档应该被数字文档所取代，减少生产过程中的浪费，比如回收再利用废料、采用环保的物料等。\n3. 精简流程：在生产过程中，公司可以采用精简流程的方法，有效地减少不必要的环节和流程，例如，简化审批流程，减少组织层级等。\n4. 节约能源：公司可以通过节约能源的方式降低成本，例如，减少非必要的照明、使用节能器材等。\n5. 优化供应链：优化供应链可以降低成本和提高效率，例如，与可信任的供应商合作，选择合适的运输方式，以及优化库存管理等。\n6. 培训员工：公司可以通过培训员工，提高员工素质和技能，增强员工的工作效率和生产力。\n7. 客户关系：与良好的客户关系可以提高公司的收入，例如，加强客户服务，提供有效的营销方案，以及满足客户需求等。\n总之，公司可以采取多种方法来降低成本和提高效率，但最关键的是要制定合理的计划和有效的策略，并实施科学的方案，以达到预 期的目标。"}
+```
+
+**指令微调 (SFT) 数据示例:**
+```json
+{"conversations": [
+  {"content": "描述一个自然景观的美丽和神秘之处。", "role": "user"}, 
+  {"content": "远离城市的喧嚣，在一片静谧的自然中心里，就能找到一个美丽而神秘的自然景观。那里有壮观的瀑布、茂密的森林、纯净的溪流和广阔的草原，它们有 着若干的奥秘，让人心生向往。在这个自然景观中，每一个细节都展现着上帝的魔幻艺术。阳光透过茂密的树叶，投射着温柔的光芒 ，在林间跳舞，给森林带来了充沛的生命之力，让它充满了生机。沿着河流缓缓走过，感受潺潺流水的声音，看那些石头在河水中闪 烁着光芒，犹如美丽的群舞一样，与周围的景色相互映衬着。或许最引人入胜的是那座壮观的瀑布，它气势磅礴，宛如天降飞瀑。瀑 布的水流中包含了岁月的沧桑，其中蕴含着神秘的传说。在瀑布下面，空气中弥漫着水雾的清香味，给人带来无与伦比的感官体验。 站在瀑布下面，片刻之间就能感受到自然界的伟大力量，深深地感受到了人与大自然的交融。美丽和神秘之处不仅仅停留于景观之中 ，更是在自然的故事中体现。这些景观只是自然里的一个结晶物，还隐藏着无数的秘密和神话传说，让人越来越向往和钦佩。总之， 这个自然景观的美丽和神秘之处无处不在，令人流连忘返，令人心神荡漾。它让人们真正领略到了大自然深邃的魅力，感受到了人与 自然不可分割的紧密联系。", "role": "assistant"}]}
+```
+
+**思维链蒸馏 (CoT Distill) 数据示例:**
+```json
+{"conversations": [
+  {"role": "user", "content": "请描述一下“晨曦”给人的感觉。"}, 
+  {"role": "assistant", "content": "<think>\n
+  好，用户让我描述“晨曦”给人的感觉。我需要先理解“晨曦”是什么样的时间，还有它的影响。早上通常比较宁静，但可能还有 一些情绪上的波动，比如宁静又带有丝iness。\n\n接下来，考虑“晨曦”的视觉，比如阳光刚刚升起，衣服、家具可能都显得鲜活有力。同时，带着一丝柔和的感觉，给人一种温暖的感觉，但又不是过于轻盈。\n\n然后，思考“晨曦”背后的感受，可能带有宁静、安详 或者深藏的意味，这样才有层次感。同时，晨曦还能让人联想到清晨的故事，或者静谧的场景，这样的联想会让描述更生动。\n\n另 外，结构上可以用过去时态，描绘时间线，从清晨开始，阳光升起，阳光足够大地，以及微风带来的温暖感觉。这样层次分明，内容 全面。\n\n还要注意用词要细腻，比如“轻盈”、“倔强”、“温柔”、“宁静”、“安详”等，这些词汇能更好地传达出晨曦的特质。\n\n最 后，检查整个描述是否流畅，是否有遗漏的部分。确保涵盖视觉、触觉、嗅觉等多重感觉，让读者能够感受到晨曦的不同方面。\n
+  </think>\n
+  晨曦是一个充满宁静感和生机感的时间，给人以不同的感受和体验。它通常出现在清晨，阳光刚刚升起，空气中弥漫着清新的气息。这时候，万物都显得格外活泼，脸上也带着一丝轻盈和倔强。晨曦是一种温柔但又带着一丝不安的温暖，仿佛在向人们诉说着 一个静谧而安详的故事。它让人想起清晨的宁静时光，那些似乎永远也无法忘怀的宁静时刻。晨曦不仅是一种环境的温暖，更是一种 精神的慰藉，让人在不经意间感受到内心的宁静与安详。"}]}
+```
+
+**强化学习 (RL) 数据示例:**
+```json
+{"id": 174, "category": "指令与逻辑", "prompt": "写一个关于狗的句子。"}
+```
+</details>
+
+---
+
+<br>
+
+## 📈 训练管线与收敛分析 (Training Pipeline & Metrics)
+
+本项目在全周期训练链路中进行了严格的指标监控与可视化分析，确保模型在各阶段均能稳定收敛并获得预期的能力提升。
+
+### 🔵 Dense 架构模型 (0.087B)
+
+#### 1. 预训练阶段 (Pre-training)
+在该阶段，模型通过大规模无监督语料进行 Next-Token Prediction 训练，旨在构建底层语言模型的通用语法结构认知、词汇关联与基础世界知识体系。
+![Pre-train Loss](images/Pretrain_Loss.jpg)
+
+#### 2. 指令微调阶段 (Supervised Fine-Tuning)
+通过注入高质量的问答对与结构化指令数据进行全参数微调。此阶段主要激发模型的指令遵循能力与多轮对话格式对齐。
+![SFT Loss](images/SFT_Loss.jpg)
+
+#### 3. CoT 思维链蒸馏 (Chain-of-Thought Distillation)
+为弥补小参数模型原生推理能力的不足，本阶段引入了由顶尖前沿大模型生成的思维链（`<think>...</think>`）数据。通过将复杂的推理拆解能力“蒸馏”给本项目模型，使其在作答复杂问题时具备了“先思考逻辑、后输出结论”的惯性特征。
+![CoT Distill Loss](images/Distil_Loss.jpg)
+
+#### 4. RL 对齐阶段 (GRPO)
+在模型具备基础指令遵循与初步推理能力后，本项目引入了**组相对策略优化 (Group Relative Policy Optimization, GRPO)** 进行人类偏好对齐。与传统依赖 Critic 网络的 PPO 不同，GRPO 显著降低了显存开销，极度契合轻量级模型的强化学习需求。
+本阶段设计了**启发式规则与 LLM-as-a-Judge 混合驱动的复合奖励机制**：
+- **格式约束奖励**：通过严格的正则匹配，强制模型输出标准化的高质量 CoT（`<think>`）思维链格式。
+- **多维语义奖励**：引入前沿大模型作为 Reward Model，从“**语法流畅度 (Fluency)**”、“**事实准确性 (Factuality)**”与“**指令遵从度 (Instruction Following)**”三个核心维度对生成质量进行评判。
+通过最大化复合反馈收益，该阶段不仅有效抑制了小参数模型固有的“幻觉 (Hallucination)”问题，更进一步提升了其回复的逻辑深度与人类偏好契合度。
+
+![GRPO Mean Reward](images/GRPO_Mean.jpg)
+![GRPO Format](images/GRPO_Format.jpg)
+![GRPO Judge](images/GRPO_LLM_Judge.jpg)
+![GRPO Solve All Solve None](images/GRPO_Solve_All_None.jpg)
+![GRPO KL and Length](images/GRPO_KL_Length.jpg)
+
+**训练结果分析**：
+量化指标表明，经过 GRPO 本地组相对策略优化后，模型在格式遵循与文本连贯性上展现出极高的收敛度：CoT 推理范式掌握率（Format Reward）达到 **0.99**，语法流畅度（Fluency）接近物理极限收敛至 **0.985**。然而，受限于 0.08B 极小参数规模的固有知识容量（Knowledge Capacity）瓶颈，事实准确性（Factuality）与指令遵循度（Instruction Following）的收敛上界分别停靠在 **0.73** 和 **0.35** 左右，全局平均期望奖励（Mean Reward）稳定在 **0.68** 区间。
+
+**策略退化与 Reward Hacking 现象观察**：
+在长尾迭代的定性评测中，我们观察到模型出现了强化学习中经典的 **Reward Hacking（奖励欺骗）** 现象。为了过度迎合 Reward Model 对“友好度与流畅性”的隐性偏好，模型在后期迭代中逐渐演化出一种防御性的话术策略：倾向于输出极度礼貌的套话，甚至通过高频反问用户来规避正面作答，导致实际的信息熵下降。
+基于上述对齐税（Alignment Tax）与策略退化的考量，本项目最终采取 Early Stopping 策略，截取 **Step 800** 的 Checkpoint 作为 GRPO 阶段的最佳可用模型（Best-Available Model），以求在 CoT 推理能力与实质性内容输出之间取得最佳平衡。
+
+---
+
+### 🟠 MoE 架构模型 (0.257B)
+> **[TODO: 将在此处补充 MoE 模型的训练流水线、Loss 收敛图表与相应的训练策略分析]**
+
+---
+
+<br>
+
+## ⚖️ 评测结果与生成示例 (Evaluation & Generation)
+
+模型不仅通过了传统的 NLP 基础 Benchmark 测试，同时记录了各阶段的真实输出作为定性参考。以下展示了模型在全链路各节点的能力演进过程：
+
+### 🔵 Dense 架构模型表现
+
+#### 1. 预训练阶段 (Pre-training)
+本阶段主要评估模型的基础文本困惑度 (Perplexity) 以及文本续写能力，验证其对中文语法和基础知识的掌握。
+- **C3 & XCOPA Benchmark 测试结果**:
+  ![C3 and XCOPA](images/Pretrain_Benchmark.jpg)
+- **文本生成示例**:
+  ![PT Generation](images/Pretrain_sample_1.jpg)
+
+#### 2. 指令微调阶段 (Supervised Fine-Tuning)
+本阶段引入了前沿的 LLM-as-a-Judge 自动化评测范式，从语法流畅度、事实准确性与指令遵从度三个核心维度对模型输出进行多维量化评估。这不仅深刻校验了 SFT 阶段的意图对齐效果，同时也为后续强化学习的奖励建模与策略优化探明了基准潜力。
+- **LLM as Judge 测试结果**:
+  
+  量化分析表明，在流畅性、事实性与指令遵从度这三项核心评价指标上，模型的平均生成质量 (Average Score) 与 Best-of-N (Bo3) 采样的最优生成边界之间，稳定存在 0.15 至 0.20 的得分域差异 (Gap)。这一显著分歧揭示了模型当前策略尚未收敛至最优解，具备可观的偏好对齐与强化学习升维潜力。
+  ![SFT Mean](images/SFT_Mean.jpg)
+  ![SFT Fluency](images/SFT_Fluency.jpg)
+  ![SFT Factuality](images/SFT_Factuality.jpg)
+  ![SFT Instruction Following](images/SFT_Instruction_Following.jpg)
+- **对话生成示例**:
+  ![SFT Generation](images/SFT_sample_1.jpg)
+
+#### 3. CoT 思维链蒸馏 (Chain-of-Thought Distillation)
+本阶段重点评估模型在面对复杂逻辑推理问题时的拆解能力，关注 `<think>` 标签内隐式推理过程的有效性。
+- **推理生成示例**:
+  ![CoT Generation](images/CoT_sample_1.jpg)
+
+#### 4. RL 对齐阶段 (GRPO)
+引入前沿大模型进行 LLM-as-a-Judge 自动化评估打分（综合考量语法流畅度、事实真实性和指令遵循度），并验证模型幻觉抑制的效果。
+  
+- **对齐生成示例**:
+  ![RL Generation](images/GRPO_Sample_1.jpg)
+
+---
+
+### 🟠 MoE 架构模型表现
+> **[TODO: 将在此处补充 MoE 模型在各指标下的 Benchmark 打分，以及其在多专家调度下的实际生成用例比对]**
+
+---
+
+<br>
+
+## 💻 如何使用 (How to Use)
+
+由于本项目是从零用纯 PyTorch 框架搭建的模型架构，**您需要配搭官方的 GitHub 源码方可加载模型权重并执行对话。**
+
+### 步骤 1：克隆代码仓库并安装依赖
+
+```bash
+git clone https://github.com/Justin-ljw/GrandLine_LLM.git
+cd GrandLine_LLM
+pip install -r requirements.txt
+```
+
+### 步骤 2：下载模型权重
+
+您可以使用 Hugging Face 的 Python SDK 快速下载权重：
+```bash
+pip install huggingface_hub
+huggingface-cli download JustinLeee/GrandLine_LLM --include "dense/*" --local-dir ./model_weight
+```
+
+### 步骤 3：加载权重并开启对话
+
+将下载的 .pth 权重文件放入项目的 model_weight 目录下（或指定绝对路径），运行 eval.py 进入终端交互界面：
+```bash
+python eval.py --model_path model_weight/dense/grpo_768.pth
+```
+
+随后，您就可以在控制台中与模型进行流式对话测试了！
+
+---
+
+<br>
+
+## ⚠️ 局限性与免责声明 (Limitations)
+
+**1.知识容量限制**：受限于极小的参数规模（不到 100M），模型内部能够存储的世界知识非常有限。强依赖大量记忆的事实性问答可能会发生“幻觉（Hallucination）”。
+
+**2.定位与用途**：本模型旨在用作学术研究、教育学习及 LLM 管线跑通论证，不具备处理复杂生产任务与高精度商业部署的能力。
+
+---
+
+<br>
+
+## 📄 协议 (License)
+本项目源码与模型权重均基于 MIT 开源许可证发布，更多详细信息请参阅 [LICENSE](LICENSE) 文件。

configuration.json

@@ -0,0 +1 @@
+{"framework":"Pytorch","task":"chatbot"}

dense/grpo_768.pth

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9bec3def89cbdfe0840882ba071ad13e2bc8ba76330ea903b42fd5b74c4c4a65
+size 197149142

dense/pretrain_768.pth

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:28e6c58f3ef92403570ae55021d5d712df1f1580aa5ad53b8cc86e5ea96f6f62
+size 197149610

dense/sft_768.pth

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a62f3d16acba0d0192d4047578878f13ccc66a24ff64791a0c502911217ebd15
+size 197148449

dense/thinking_distill_768.pth

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:44692e520ccfbc690c14b9d82a3333ed37ce1da5c07870f81a4da942c7964a78
+size 197150546