Skip to content

Commit 2f8f268

Browse files
committed
i18n(mermaid): 337 个 mermaid 图表标签中文化
120 个 zh.md 文件中的 mermaid 图表标签从英文翻译为中文。 规则:自然语言标签翻中文,专业技术术语(agent、token、embedding、 transformer、softmax、LLM、MCP 等)保留英文。 仅修改 ```mermaid 块内部内容,正文不变。
1 parent 57fd323 commit 2f8f268

121 files changed

Lines changed: 1539 additions & 1539 deletions

File tree

  • phases
    • 00-setup-and-tooling
      • 02-git-and-collaboration/docs
      • 04-apis-and-keys/docs
      • 05-jupyter-notebooks/docs
      • 06-python-environments/docs
      • 07-docker-for-ai/docs
      • 08-editor-setup/docs
      • 09-data-management/docs
      • 10-terminal-and-shell/docs
      • 11-linux-for-ai/docs
      • 12-debugging-and-profiling/docs
    • 01-math-foundations
      • 01-linear-algebra-intuition/docs
      • 03-matrix-transformations/docs
      • 04-calculus-for-ml/docs
      • 05-chain-rule-and-autodiff/docs
      • 07-bayes-theorem/docs
      • 08-optimization/docs
      • 09-information-theory/docs
      • 10-dimensionality-reduction/docs
      • 11-singular-value-decomposition/docs
      • 12-tensor-operations/docs
      • 17-linear-systems/docs
      • 18-convex-optimization/docs
      • 19-complex-numbers/docs
      • 20-fourier-transform/docs
      • 21-graph-theory/docs
      • 22-stochastic-processes/docs
    • 02-ml-fundamentals
      • 01-what-is-machine-learning/docs
      • 12-hyperparameter-tuning/docs
    • 03-deep-learning-core
      • 01-the-perceptron/docs
      • 02-multi-layer-networks/docs
      • 03-backpropagation/docs
      • 04-activation-functions/docs
      • 05-loss-functions/docs
      • 06-optimizers/docs
      • 07-regularization/docs
      • 08-weight-initialization/docs
      • 09-learning-rate-schedules/docs
      • 10-mini-framework/docs
      • 11-intro-to-pytorch/docs
      • 13-debugging-neural-networks/docs
    • 04-computer-vision
      • 07-semantic-segmentation-unet/docs
      • 23-diffusion-transformers-rectified-flow/docs
    • 10-llms-from-scratch
      • 01-tokenizers/docs
      • 02-building-a-tokenizer/docs
      • 03-data-pipelines/docs
      • 04-pre-training-mini-gpt/docs
      • 05-scaling-distributed/docs
      • 06-instruction-tuning-sft/docs
      • 07-rlhf/docs
      • 08-dpo/docs
      • 09-constitutional-ai-self-improvement/docs
      • 10-evaluation/docs
      • 11-quantization/docs
      • 12-inference-optimization/docs
      • 13-building-complete-llm-pipeline/docs
      • 14-open-models-architecture-walkthroughs/docs
    • 11-llm-engineering
      • 01-prompt-engineering/docs
      • 02-few-shot-cot/docs
      • 03-structured-outputs/docs
      • 04-embeddings/docs
      • 05-context-engineering/docs
      • 06-rag/docs
      • 07-advanced-rag/docs
      • 08-fine-tuning-lora/docs
      • 09-function-calling/docs
      • 10-evaluation/docs
      • 11-caching-cost/docs
      • 12-guardrails/docs
      • 13-production-app/docs
    • 14-agent-engineering
      • 31-agent-workbench-why-models-fail/docs
      • 32-minimal-agent-workbench/docs
      • 33-instructions-as-executable-constraints/docs
      • 34-repo-memory-and-state/docs
      • 35-initialization-scripts/docs
      • 36-scope-contracts/docs
      • 37-runtime-feedback-loops/docs
      • 38-verification-gates/docs
      • 39-reviewer-agent/docs
      • 40-multi-session-handoff/docs
      • 41-workbench-for-real-repos/docs
      • 42-agent-workbench-capstone/docs
    • 16-multi-agent-and-swarms/03-communication-protocols/docs
    • 19-capstone-projects
      • 20-agent-harness-loop-contract/docs
      • 21-tool-registry-schema-validation/docs
      • 22-jsonrpc-stdio-transport/docs
      • 23-function-call-dispatcher/docs
      • 24-plan-execute-control-flow/docs
      • 25-verification-gates-observation-budget/docs
      • 26-sandbox-runner-denylist/docs
      • 27-eval-harness-fixture-tasks/docs
      • 28-observability-otel-traces/docs
      • 29-end-to-end-coding-task-demo/docs
      • 30-bpe-tokenizer-from-scratch/docs
      • 31-tokenized-dataset-sliding-window/docs
      • 32-token-positional-embeddings/docs
      • 33-multihead-self-attention/docs
      • 34-transformer-block/docs
      • 35-gpt-model-assembly/docs
      • 36-training-loop-eval/docs
      • 37-loading-pretrained-weights/docs
      • 38-classifier-finetuning/docs
      • 39-instruction-tuning-sft/docs
      • 40-dpo-from-scratch/docs
      • 41-eval-pipeline/docs
      • 42-large-corpus-downloader/docs
      • 43-hdf5-tokenized-corpus/docs
      • 44-cosine-lr-warmup/docs
      • 45-gradient-clipping-amp/docs
      • 46-gradient-accumulation/docs
      • 47-checkpoint-save-resume/docs
      • 48-distributed-fsdp-ddp/docs
      • 49-lm-eval-harness/docs
      • 50-hypothesis-generator/docs
      • 51-literature-retrieval/docs
      • 52-experiment-runner/docs
      • 53-result-evaluator/docs
      • 54-paper-writer/docs
      • 55-critic-loop/docs
      • 56-iteration-scheduler/docs
      • 57-end-to-end-research-demo/docs
  • site

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

phases/00-setup-and-tooling/02-git-and-collaboration/docs/zh.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,10 @@ Git 是工具,GitHub 是代码存放的地方。这节课只讲本课程需要
2424

2525
```mermaid
2626
sequenceDiagram
27-
participant WD as Working Directory
28-
participant SA as Staging Area
29-
participant LR as Local Repo
30-
participant R as Remote (GitHub)
27+
participant WD as 工作目录
28+
participant SA as 暂存区
29+
participant LR as 本地仓库
30+
participant R as 远端 (GitHub)
3131
WD->>SA: git add
3232
SA->>LR: git commit
3333
LR->>R: git push

phases/00-setup-and-tooling/04-apis-and-keys/docs/zh.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,10 +22,10 @@
2222

2323
```mermaid
2424
sequenceDiagram
25-
participant C as Your Code
26-
participant S as API Server
27-
C->>S: HTTP Request (with API key)
28-
S->>C: HTTP Response (JSON)
25+
participant C as 你的代码
26+
participant S as API 服务器
27+
C->>S: HTTP 请求 (携带 API key)
28+
S->>C: HTTP 响应 (JSON)
2929
```
3030

3131
每一次 API 调用都包含:

phases/00-setup-and-tooling/05-jupyter-notebooks/docs/zh.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -34,10 +34,10 @@ graph TD
3434

3535
```mermaid
3636
graph LR
37-
A[Notebook UI] <--> B[Kernel\nPython process]
38-
B --> C[Keeps variables in memory]
39-
B --> D[Runs cells in whatever order you click]
40-
B --> E[Dies when you restart it]
37+
A[Notebook UI] <--> B[Kernel\nPython 进程]
38+
B --> C[变量保留在内存中]
39+
B --> D[你点哪个 cell 就跑哪个]
40+
B --> E[重启就没了]
4141
```
4242

4343
那个「你点哪个就跑哪个」的特性,既是超能力,也是脚下的地雷。

phases/00-setup-and-tooling/06-python-environments/docs/zh.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -31,16 +31,16 @@
3131

3232
```mermaid
3333
graph TD
34-
subgraph without["Without virtual environments"]
35-
SP[System Python] --> T24["torch 2.4.0 (CUDA 12.4)\nProject A needs this"]
36-
SP --> T21["torch 2.1.0 (CUDA 11.8)\nProject B needs this"]
37-
SP --> CONFLICT["CONFLICT: only one\ntorch version can exist"]
34+
subgraph without["没有虚拟环境"]
35+
SP[系统 Python] --> T24["torch 2.4.0 (CUDA 12.4)\n项目 A 需要这个"]
36+
SP --> T21["torch 2.1.0 (CUDA 11.8)\n项目 B 需要这个"]
37+
SP --> CONFLICT["冲突:只能有一个\ntorch 版本"]
3838
end
3939
40-
subgraph with["With virtual environments"]
41-
PA["Project A (.venv/)"] --> PA1["torch 2.4.0 (CUDA 12.4)"]
40+
subgraph with["有虚拟环境"]
41+
PA["项目 A (.venv/)"] --> PA1["torch 2.4.0 (CUDA 12.4)"]
4242
PA --> PA2["transformers 4.44"]
43-
PB["Project B (.venv/)"] --> PB1["torch 2.1.0 (CUDA 11.8)"]
43+
PB["项目 B (.venv/)"] --> PB1["torch 2.1.0 (CUDA 11.8)"]
4444
PB --> PB2["diffusers 0.28"]
4545
end
4646
```

phases/00-setup-and-tooling/07-docker-for-ai/docs/zh.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -26,16 +26,16 @@ Docker 把你的代码、运行时、库和系统工具包进一个叫容器(c
2626

2727
```mermaid
2828
graph TD
29-
subgraph without["Without Docker"]
30-
A1["Your machine<br/>Python 3.12<br/>CUDA 12.4<br/>PyTorch 2.3"] -->|crashes| X1["???"]
31-
A2["Their machine<br/>Python 3.10<br/>CUDA 11.8<br/>PyTorch 2.1"] -->|crashes| X2["???"]
32-
A3["Server<br/>Python 3.11<br/>CUDA 12.1<br/>PyTorch 2.2"] -->|crashes| X3["???"]
29+
subgraph without["没有 Docker"]
30+
A1["你的机器<br/>Python 3.12<br/>CUDA 12.4<br/>PyTorch 2.3"] -->|崩了| X1["???"]
31+
A2["同事的机器<br/>Python 3.10<br/>CUDA 11.8<br/>PyTorch 2.1"] -->|崩了| X2["???"]
32+
A3["服务器<br/>Python 3.11<br/>CUDA 12.1<br/>PyTorch 2.2"] -->|崩了| X3["???"]
3333
end
3434
35-
subgraph with_docker["With Docker — Same image everywhere"]
36-
B1["Your machine<br/>Python 3.12 | CUDA 12.4<br/>PyTorch 2.3 | Your code"]
37-
B2["Their machine<br/>Python 3.12 | CUDA 12.4<br/>PyTorch 2.3 | Your code"]
38-
B3["Server<br/>Python 3.12 | CUDA 12.4<br/>PyTorch 2.3 | Your code"]
35+
subgraph with_docker[" Docker —— 到处同一个镜像"]
36+
B1["你的机器<br/>Python 3.12 | CUDA 12.4<br/>PyTorch 2.3 | 你的代码"]
37+
B2["同事的机器<br/>Python 3.12 | CUDA 12.4<br/>PyTorch 2.3 | 你的代码"]
38+
B3["服务器<br/>Python 3.12 | CUDA 12.4<br/>PyTorch 2.3 | 你的代码"]
3939
end
4040
```
4141

phases/00-setup-and-tooling/08-editor-setup/docs/zh.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,11 @@
2626

2727
```mermaid
2828
graph TD
29-
L5["5. Remote Development<br/>SSH into GPU boxes, cloud VMs"] --> L4
30-
L4["4. Terminal Integration<br/>Run scripts, debug, monitor GPU"] --> L3
31-
L3["3. AI-Specific Settings<br/>Auto-format, type checking, rulers"] --> L2
32-
L2["2. Extensions<br/>Python, Jupyter, Pylance, GitLens"] --> L1
33-
L1["1. Base Editor<br/>VS Code — free, extensible, universal"]
29+
L5["5. 远程开发<br/>SSH GPU 机器、云 VM"] --> L4
30+
L4["4. 终端集成<br/>跑脚本、调试、监控 GPU"] --> L3
31+
L3["3. AI 专属设置<br/>自动格式化、类型检查、标尺"] --> L2
32+
L2["2. 扩展<br/>Python, Jupyter, Pylance, GitLens"] --> L1
33+
L1["1. 基础编辑器<br/>VS Code —— 免费、可扩展、通用"]
3434
```
3535

3636
## 动手构建

phases/00-setup-and-tooling/09-data-management/docs/zh.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -22,12 +22,12 @@
2222

2323
```mermaid
2424
graph TD
25-
A["Hugging Face Hub"] --> B["datasets library"]
26-
B --> C["Load / Stream"]
27-
C --> D["Local Cache<br/>~/.cache/huggingface/"]
28-
B --> E["Format Conversion<br/>CSV, JSON, Parquet, Arrow"]
29-
E --> F["Data Splits<br/>train / val / test"]
30-
F --> G["Your Training Pipeline"]
25+
A["Hugging Face Hub"] --> B["datasets "]
26+
B --> C["加载 / 流式读取"]
27+
C --> D["本地缓存<br/>~/.cache/huggingface/"]
28+
B --> E["格式转换<br/>CSV, JSON, Parquet, Arrow"]
29+
E --> F["数据划分<br/>train / val / test"]
30+
F --> G["你的训练流水线"]
3131
```
3232

3333
Hugging Face 的 `datasets` 库是 AI 工作里加载数据的标准方式。它开箱就处理好下载、缓存、格式转换和流式读取。

phases/00-setup-and-tooling/10-terminal-and-shell/docs/zh.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,12 @@
2424

2525
```mermaid
2626
graph TD
27-
subgraph tmux["tmux session: training"]
28-
subgraph top["Top row"]
29-
P1["Pane 1: Training run<br/>python train.py<br/>Epoch 12/100 ..."]
30-
P2["Pane 2: GPU monitor<br/>watch -n1 nvidia-smi<br/>GPU: 78% | Mem: 14/24G"]
27+
subgraph tmux["tmux 会话: training"]
28+
subgraph top["上半部分"]
29+
P1["窗格 1: 训练任务<br/>python train.py<br/>Epoch 12/100 ..."]
30+
P2["窗格 2: GPU 监控<br/>watch -n1 nvidia-smi<br/>GPU: 78% | Mem: 14/24G"]
3131
end
32-
P3["Pane 3: Logs + experiments<br/>tail -f logs/train.log | grep loss"]
32+
P3["窗格 3: 日志 + 实验<br/>tail -f logs/train.log | grep loss"]
3333
end
3434
```
3535

phases/00-setup-and-tooling/11-linux-for-ai/docs/zh.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,13 @@ Linux 把一切都组织在唯一的根 `/` 下面。没有 `C:\`,没有 `/Vol
2626

2727
```mermaid
2828
graph TD
29-
root["/"] --> home["home/your-username/<br/>Your files — clone repos, run training"]
30-
root --> tmp["tmp/<br/>Temporary files, cleared on reboot"]
31-
root --> usr["usr/<br/>System programs and libraries"]
32-
root --> etc["etc/<br/>Config files"]
33-
root --> varlog["var/log/<br/>Logs — check when something breaks"]
34-
root --> mnt["mnt/ or /media/<br/>External drives and volumes"]
35-
root --> proc["proc/ and /sys/<br/>Virtual files — kernel and hardware info"]
29+
root["/"] --> home["home/your-username/<br/>你的文件 —— 克隆仓库、跑训练"]
30+
root --> tmp["tmp/<br/>临时文件,重启后清空"]
31+
root --> usr["usr/<br/>系统程序和库"]
32+
root --> etc["etc/<br/>配置文件"]
33+
root --> varlog["var/log/<br/>日志 —— 出问题时来这看"]
34+
root --> mnt["mnt/ /media/<br/>外接硬盘和存储卷"]
35+
root --> proc["proc/ /sys/<br/>虚拟文件 —— 内核和硬件信息"]
3636
```
3737

3838
你的主目录是 `~``/home/your-username`。你做的几乎一切都发生在这里。

phases/00-setup-and-tooling/12-debugging-and-profiling/docs/zh.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@ AI 调试在三个层级上运作:
2626

2727
```mermaid
2828
graph TD
29-
L3["3. Training Dynamics<br/>Loss curves, gradient norms, activations"] --> L2
30-
L2["2. Tensor Operations<br/>Shapes, dtypes, devices, NaN/Inf values"] --> L1
31-
L1["1. Standard Python<br/>Breakpoints, logging, profiling, memory"]
29+
L3["3. 训练动态<br/>损失曲线、梯度范数、激活值"] --> L2
30+
L2["2. 张量运算<br/>形状、dtype、设备、NaN/Inf "] --> L1
31+
L1["1. 标准 Python<br/>断点、日志、性能分析、内存"]
3232
```
3333

3434
大多数人直接跳到第 3 层(盯着 TensorBoard 看)。但 80% 的 AI bug 住在第 1 层和第 2 层。

0 commit comments

Comments
 (0)