# frederickwilhelmchen/deepseek-v4-guiding architecture

> Architecture diagram of the GitHub repository frederickwilhelmchen/deepseek-v4-guiding, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/frederickwilhelmchen/deepseek-v4-guiding
- Repository: https://github.com/frederickwilhelmchen/deepseek-v4-guiding

## Overview

This repository is an engineer-oriented Chinese guide to DeepSeek V4’s technical report, not a model implementation. Its main user journey starts with the overview and branches into architecture, infrastructure, pre-training, or post-training; supplementary guides compare other model approaches and relate configuration fields to the guide. Toy scripts illustrate selected concepts, while the PDF is the original reference. Relationships shown here follow the README; sampled scripts are explicitly educational examples, not production training or inference code.

Main entry points: [`00-后端人视角下的DeepSeek V4 技术报告解读.md`](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/00-%E5%90%8E%E7%AB%AF%E4%BA%BA%E8%A7%86%E8%A7%92%E4%B8%8B%E7%9A%84DeepSeek%20V4%20%E6%8A%80%E6%9C%AF%E6%8A%A5%E5%91%8A%E8%A7%A3%E8%AF%BB.md) (Guide overview), [`01-第二章 Architecture.md`](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/01-%E7%AC%AC%E4%BA%8C%E7%AB%A0%20Architecture.md) (Model architecture), [`模型参数配置表与导读的对照关系.md`](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/%E6%A8%A1%E5%9E%8B%E5%8F%82%E6%95%B0%E9%85%8D%E7%BD%AE%E8%A1%A8%E4%B8%8E%E5%AF%BC%E8%AF%BB%E7%9A%84%E5%AF%B9%E7%85%A7%E5%85%B3%E7%B3%BB.md) (Parameter mapping), [`02-第三章 General Infrastructure.md`](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/02-%E7%AC%AC%E4%B8%89%E7%AB%A0%20General%20Infrastructure.md) (Training infrastructure)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["V4 Guide"]
  node_overview["Guide overview"]
  node_architecture["Model architecture"]
  node_infrastructure["Training infrastructure"]
  node_pretraining["Pre-training"]
  node_posttraining["Post-training"]
end

subgraph group_supplement["References &amp; Comparisons"]
  node_glmcomparison["GLM-5 comparison"]
  node_kimi["Kimi K3 guide"]
  node_parammapping["Parameter mapping<br/>[模型参数配置表与导读的对照关系.md]"]
  node_flashconfig["Flash config"]
  node_proconfig["Pro config"]
  node_report["Original report<br/>[DeepSeek_V4.pdf]"]
end

subgraph group_examples["Concept Examples"]
  node_affinity["Routing-score demo"]
  node_mhc["mHC demo<br/>[mHC_sample.py]"]
  node_newton["Muon iteration demo"]
end

node_reader(("Engineer reader"))

node_reader -->|"starts with"| node_overview
node_overview -->|"continue to"| node_architecture
node_overview -->|"continue to"| node_infrastructure
node_overview -->|"continue to"| node_pretraining
node_overview -->|"continue to"| node_posttraining
node_reader -->|"explores"| node_glmcomparison
node_reader -->|"explores"| node_kimi
node_architecture -->|"maps fields"| node_parammapping
node_parammapping -->|"explains fields"| node_flashconfig
node_parammapping -->|"explains fields"| node_proconfig
node_reader -->|"consults source"| node_report
node_architecture -->|"illustrates routing"| node_affinity
node_architecture -->|"illustrates mixing"| node_mhc
node_architecture -->|"illustrates iteration"| node_newton

click node_overview "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/00-%E5%90%8E%E7%AB%AF%E4%BA%BA%E8%A7%86%E8%A7%92%E4%B8%8B%E7%9A%84DeepSeek%20V4%20%E6%8A%80%E6%9C%AF%E6%8A%A5%E5%91%8A%E8%A7%A3%E8%AF%BB.md"
click node_architecture "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/01-%E7%AC%AC%E4%BA%8C%E7%AB%A0%20Architecture.md"
click node_infrastructure "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/02-%E7%AC%AC%E4%B8%89%E7%AB%A0%20General%20Infrastructure.md"
click node_pretraining "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/03-%E7%AC%AC%E5%9B%9B%E7%AB%A0%20Pre-Training.md"
click node_posttraining "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/04-%E7%AC%AC%E4%BA%94%E7%AB%A0%20Post-Training.md"
click node_glmcomparison "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/05-GLM-5%20SAO%20%E4%B8%8E%20DeepSeek%20V4%20%E5%90%8E%E8%AE%AD%E7%BB%83%E8%B7%AF%E7%BA%BF%E5%AF%B9%E6%AF%94.md"
click node_kimi "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/06-Kimi%20K3%20%E5%B7%B2%E6%8A%AB%E9%9C%B2%E6%8A%80%E6%9C%AF%E5%AF%BC%E8%AF%BB.md"
click node_parammapping "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/%E6%A8%A1%E5%9E%8B%E5%8F%82%E6%95%B0%E9%85%8D%E7%BD%AE%E8%A1%A8%E4%B8%8E%E5%AF%BC%E8%AF%BB%E7%9A%84%E5%AF%B9%E7%85%A7%E5%85%B3%E7%B3%BB.md"
click node_flashconfig "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/config/deepseek-v4-flash-config.json"
click node_proconfig "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/config/deepseek-v4-pro-config.json"
click node_report "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/DeepSeek_V4.pdf"
click node_affinity "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/scripts/affinity_scores_sample.py"
click node_mhc "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/scripts/mHC_sample.py"
click node_newton "https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/scripts/newton_schulz_sample.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_overview,node_architecture,node_infrastructure,node_pretraining,node_posttraining toneBlue
class node_glmcomparison,node_kimi,node_parammapping,node_flashconfig,node_proconfig,node_report toneAmber
class node_affinity,node_mhc,node_newton toneMint
class node_reader toneIndigo
```

## Components

### V4 Guide

- [Guide overview](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/00-%E5%90%8E%E7%AB%AF%E4%BA%BA%E8%A7%86%E8%A7%92%E4%B8%8B%E7%9A%84DeepSeek%20V4%20%E6%8A%80%E6%9C%AF%E6%8A%A5%E5%91%8A%E8%A7%A3%E8%AF%BB.md): `00-后端人视角下的DeepSeek V4 技术报告解读.md`
- [Model architecture](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/01-%E7%AC%AC%E4%BA%8C%E7%AB%A0%20Architecture.md): `01-第二章 Architecture.md`
- [Training infrastructure](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/02-%E7%AC%AC%E4%B8%89%E7%AB%A0%20General%20Infrastructure.md): `02-第三章 General Infrastructure.md`
- [Pre-training](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/03-%E7%AC%AC%E5%9B%9B%E7%AB%A0%20Pre-Training.md): `03-第四章 Pre-Training.md`
- [Post-training](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/04-%E7%AC%AC%E4%BA%94%E7%AB%A0%20Post-Training.md): `04-第五章 Post-Training.md`

### References & Comparisons

- [GLM-5 comparison](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/05-GLM-5%20SAO%20%E4%B8%8E%20DeepSeek%20V4%20%E5%90%8E%E8%AE%AD%E7%BB%83%E8%B7%AF%E7%BA%BF%E5%AF%B9%E6%AF%94.md): `05-GLM-5 SAO 与 DeepSeek V4 后训练路线对比.md`
- [Kimi K3 guide](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/06-Kimi%20K3%20%E5%B7%B2%E6%8A%AB%E9%9C%B2%E6%8A%80%E6%9C%AF%E5%AF%BC%E8%AF%BB.md): `06-Kimi K3 已披露技术导读.md`
- [Parameter mapping](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/%E6%A8%A1%E5%9E%8B%E5%8F%82%E6%95%B0%E9%85%8D%E7%BD%AE%E8%A1%A8%E4%B8%8E%E5%AF%BC%E8%AF%BB%E7%9A%84%E5%AF%B9%E7%85%A7%E5%85%B3%E7%B3%BB.md): `模型参数配置表与导读的对照关系.md`
- [Flash config](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/config/deepseek-v4-flash-config.json): `config/deepseek-v4-flash-config.json`
- [Pro config](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/config/deepseek-v4-pro-config.json): `config/deepseek-v4-pro-config.json`
- [Original report](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/DeepSeek_V4.pdf): `DeepSeek_V4.pdf`

### Concept Examples

- [Routing-score demo](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/scripts/affinity_scores_sample.py): `scripts/affinity_scores_sample.py`
- [mHC demo](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/scripts/mHC_sample.py): `scripts/mHC_sample.py`
- [Muon iteration demo](https://github.com/frederickwilhelmchen/deepseek-v4-guiding/blob/master/scripts/newton_schulz_sample.py): `scripts/newton_schulz_sample.py`

### Other components

- **Engineer reader**

## Connections

- Engineer reader → Guide overview: starts with (evidence: `README.md`)
- Guide overview → Model architecture: continue to (evidence: `README.md`)
- Guide overview → Training infrastructure: continue to (evidence: `README.md`)
- Guide overview → Pre-training: continue to (evidence: `README.md`)
- Guide overview → Post-training: continue to (evidence: `README.md`)
- Engineer reader → GLM-5 comparison: explores (evidence: `README.md`)
- Engineer reader → Kimi K3 guide: explores (evidence: `README.md`)
- Model architecture → Parameter mapping: maps fields (evidence: `README.md`)
- Parameter mapping → Flash config: explains fields (evidence: `README.md`)
- Parameter mapping → Pro config: explains fields (evidence: `README.md`)
- Engineer reader → Original report: consults source (evidence: `README.md`)
- Model architecture → Routing-score demo: illustrates routing (evidence: `README.md`)
- Model architecture → mHC demo: illustrates mixing (evidence: `README.md`)
- Model architecture → Muon iteration demo: illustrates iteration (evidence: `README.md`)
