第一部分：WSL Ubuntu 基础配置

1. 区分 GitHub 用户名（Username）与显示名（Display Name）

在浏览器中操作（用于自查）：

1. 打开 GitHub。

2. 用户名（Username）：

   • 查看浏览器地址栏：https://github.com/UWKWHDH。

   • 这里的 UWKWHDH是用户名，是唯一的、用于 Git 推送和系统识别的 ID。

3. 显示名（Display Name）：

   • 点击右上角头像 → Settings​ → Profile。

   • Name​ 字段显示的是 Dangio（或其他自定义名字），这是别人看到的昵称，不影响 Git 操作。

---

2. 配置 Git 全局身份

在 Ubuntu 终端执行：

# 2.1 设置用户名（必须与 GitHub 用户名一致）
git config --global user.name "UWKWHDH"

# 2.2 设置邮箱（必须与 GitHub 注册邮箱一致）
git config --global user.email "2860953036@qq.com"

# 2.3 验证配置
git config --global --list | grep user

✅ 验证标准（必须完全一致）：

user.name=UWKWHDH
user.email=2860953036@qq.com

---

第二部分：GitHub 仓库管理

3. 配置 SSH 免密登录 GitHub

在 Ubuntu 终端执行：

# 3.1 生成 ED25519 密钥对（一路回车，不设置密码）
ssh-keygen -t ed25519 -C "2860953036@qq.com"

# 3.2 启动 SSH 代理
eval "$(ssh-agent -s)"

# 3.3 将私钥添加到代理
ssh-add ~/.ssh/id_ed25519

# 3.4 复制公钥内容（整段复制）
cat ~/.ssh/id_ed25519.pub

✅ 操作动作：将复制的公钥粘贴到 GitHub → Settings → SSH and GPG keys → New SSH key。

---

4. 修复 GitHub SSH 端口封锁（关键步骤）

在 Ubuntu 终端执行：

# 4.1 创建 SSH 配置文件
cat >> ~/.ssh/config << 'EOF'
Host github.com
  Hostname ssh.github.com
  Port 443
  User git
EOF

# 4.2 设置文件权限
chmod 600 ~/.ssh/config

# 4.3 测试连接
ssh -T git@github.com

✅ 验证标准（必须完全一致）：

Hi uwkwhdh! You've successfully authenticated, but GitHub does not provide shell access.

---

第三部分：Fork 与 Clone 仓库

5. Fork 与 Clone 仓库

在 Ubuntu 终端执行：

# 5.1 创建项目根目录
mkdir -p ~/projects
cd ~/projects

# 5.2 Clone 你 Fork 后的仓库（使用 SSH）
git clone git@github.com:UWKWHDH/ai-engineering-from-scratch.git

# 5.3 进入仓库目录
cd ai-engineering-from-scratch

# 5.4 添加原课程仓库为 Upstream（用于同步更新）
git remote add upstream git@github.com:rohitg00/ai-engineering-from-scratch.git

# 5.5 验证 Remote 配置
git remote -v

✅ 验证标准（必须完全一致）：

origin  git@github.com:UWKWHDH/ai-engineering-from-scratch.git (fetch)
origin  git@github.com:UWKWHDH/ai-engineering-from-scratch.git (push)
upstream  git@github.com:rohitg00/ai-engineering-from-scratch.git (fetch)
upstream  git@github.com:rohitg00/ai-engineering-from-scratch.git (push)

---

第四部分：Git 协作节点实战

6. 创建个人学习分支

在 Ubuntu 终端执行：

# 6.1 创建并切换到个人分支
git checkout -b my-progress

# 6.2 推送到远程并建立追踪
git push -u origin my-progress

✅ 验证标准（必须完全一致）：

1. 终端输出：branch 'my-progress' set up to track 'origin/my-progress'.

2. 网页验证：打开浏览器访问 https://github.com/UWKWHDH/ai-engineering-from-scratch/branches，页面中应显示 my-progress分支。

---

7. 完成 Git 协作练习（02-git-and-collaboration）

在 Ubuntu 终端执行：

# 7.1 进入课程节点目录
cd ~/projects/ai-engineering-from-scratch/phases/00-setup-and-tooling/02-git-and-collaboration

# 7.2 创建完成标记文件
echo "# Git collaboration workflow verified" > git-checkpoint.md

# 7.3 Git 工作流提交
git status
git add git-checkpoint.md
git commit -m "Complete git collaboration setup for AI course"
git push origin my-progress

✅ 验证标准（必须完全一致）：

打开浏览器访问：

https://github.com/UWKWHDH/ai-engineering-from-scratch/tree/my-progress/phases/00-setup-and-tooling/02-git-and-collaboration

页面中应显示文件列表包含 git-checkpoint.md。

---

第五部分：VSCode 集成

8. Windows 侧安装与连接

在 Windows 浏览器操作：

1. 打开 VSCode 官网下载 Windows x64 User Installer。

2. 运行安装程序，务必勾选以下选项：

   • ✅ Add "Open with Code" action to Windows Explorer context menu

   • ✅ Add "Open with Code" action to Windows Explorer directory context menu

   • ✅ Register Code as an editor for supported file types

   • ✅ Add to PATH (requires shell restart)

在 Windows PowerShell 执行：

# 8.1 进入 WSL 环境
wsl

# 8.2 启动 VSCode（会自动安装 Server）
code .

✅ 验证标准：

1. VSCode 左下角状态栏显示 >< WSL: Ubuntu。

2. 左侧文件树根目录显示为 /home/lovasuka/projects/ai-engineering-from-scratch。

六：VSCode阅读中文版

fancyboi999/ai-engineering-from-scratch-zh: Agent工程师最全学习路径 · 从零精通 AI 工程 · 20 阶段 503 课 · 中文全量翻译 + 配套站点 · 如何成为 AI Agent 工程师的修成指南

进入链接fork，中文版是单独的fork仓库（例如你或他人维护的中文翻译仓库），

直接在Ubuntu中克隆即可：

# 1. 进入你已有的项目根目录（和英文版仓库同级）
cd ~/projects

# 2. 克隆中文版仓库（替换为实际的中文仓库SSH地址，示例：）
git clone git@github.com:UWKWHDH/ai-engineering-from-scratch-zh.git

# 3. 用VSCode打开中文版项目
cd ai-engineering-from-scratch-zh
code .

✅ 完成后，Ubuntu中会同时存在ai-engineering-from-scratch（英文）和ai-engineering-from-scratch-zh（中文）两个文件夹，可以通过ubuntu输入在vscode中切换打开。