wsl --update                  # 更新到正式版
wsl --update --pre-release    # 尝鲜预览特性（可能不稳定）
where.exe wsl                 # 确认实际解析路径

wsl --install

wsl --list --verbose

wsl --list --online                  # 查看可选发行版
wsl --install -d Debian
wsl --install -d Ubuntu-24.04
wsl --install -d kali-linux
wsl --install -d openSUSE-Tumbleweed

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

wsl --set-default-version 2

# 语法：wsl --import <新名称> <安装目录> <tar文件> --version 2
wsl --import MyUbuntu D:\WSL\MyUbuntu D:\downloads\ubuntu-rootfs.tar --version 2

# 注意：导入后默认用户会变回 root，需在 /etc/wsl.conf 中重新指定（见第五章）

wsl --install --web-download -d Ubuntu-24.04

# 获取 Windows 主机 IP（NAT 模式）
export host_ip=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')

export http_proxy="http://${host_ip}:7890"
export https_proxy="http://${host_ip}:7890"

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

# Ubuntu 24.04 使用新的 DEB822 格式
sudo tee /etc/apt/sources.list.d/ubuntu.sources > /dev/null <<'EOF'
Types: deb
URIs: https://mirrors.tuna.tsinghua.edu.cn/ubuntu/
Suites: noble noble-updates noble-backports
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

Types: deb
URIs: https://mirrors.tuna.tsinghua.edu.cn/ubuntu/
Suites: noble-security
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
EOF

sudo apt update && sudo apt upgrade -y

wsl --install                  # 一键安装
wsl --list --online            # 列出可安装的发行版
wsl --list --verbose           # 列出已安装发行版及状态（简写 wsl -l -v）
wsl --list --running           # 仅列出运行中的
wsl --set-default Ubuntu       # 设置默认发行版（简写 wsl -s Ubuntu）
wsl --set-default-version 2    # 设置新装发行版的默认 WSL 版本
wsl --set-version Ubuntu 2     # 转换已有发行版版本
wsl --terminate Ubuntu         # 终止指定发行版
wsl --shutdown                 # 关闭所有发行版与 WSL 虚拟机
wsl --update                   # 更新 WSL 组件
wsl --status                   # 查看状态、内核版本、默认配置
wsl --version                  # 打印版本信息
wsl --export Ubuntu D:\ubuntu-backup.tar          # 导出备份
wsl --import MyUbuntu D:\WSL D:\ubuntu-backup.tar # 导入
wsl --unregister Ubuntu        # 注销（删除）发行版 —— 危险，先导出
wsl --mount \\.\PHYSICALDRIVE1 --partition 1      # 挂载物理磁盘

wsl -d Debian bash -lc "npm --version"    # 在 Debian 中执行
wsl -d Ubuntu -u root                     # 以 root 进入 Ubuntu

exit                    # 退出 WSL 会话
cd /                    # 进入 Linux 根目录
explorer.exe .          # 用资源管理器打开当前目录
code .                  # 用 VS Code 打开当前目录

wsl --install -d Ubuntu-24.04

# 导出后用新名字导入，得到一个可随时丢弃的独立环境
wsl --export Ubuntu-24.04 D:\tmp\proj-a.tar
wsl --import project-a D:\WSL\project-a D:\tmp\proj-a.tar --version 2
wsl --unregister Ubuntu-24.04

winget install --id Microsoft.WindowsTerminal --exact

{
    "name": "Ubuntu",
    "source": "Windows.Terminal.Wsl",
    "hidden": false,
    "colorScheme": "One Half Dark",
    "font": { "face": "Cascadia Code NF", "size": 11 },
    "startingDirectory": "//wsl.localhost/Ubuntu/home/YOURNAME",
    "useAcrylic": true,
    "acrylicOpacity": 0.9
}

sudo apt update && sudo apt install -y zsh git curl

# Oh My Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Powerlevel10k 主题
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
  ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

# 两个必备插件
git clone https://github.com/zsh-users/zsh-autosuggestions \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

ZSH_THEME="powerlevel10k/powerlevel10k"
plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

sudo apt install -y ripgrep fd-find bat fzf jq eza tree htop ncdu

echo 'alias fd=fdfind'  >> ~/.zshrc
echo 'alias bat=batcat' >> ~/.zshrc

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --global core.autocrlf input      # 关键：写入时统一为 LF
git config --global core.fileMode true       # Linux 下保留文件权限位

# 在 WSL 内生成 SSH 密钥，权限模型才正确
ssh-keygen -t ed25519 -C "you@example.com" -f ~/.ssh/id_ed25519
cat ~/.ssh/id_ed25519.pub     # 复制到 GitHub / GitLab

ssh -T git@github.com         # 验证

# 全局设置，适用于所有 WSL2 发行版
[wsl2]

# 内存上限。默认是 Windows 总内存的 50%，或小内存机器上的 8GB
# 建议设为物理内存的 50%~60%，留足给 Windows 本身
memory=16GB

# 虚拟处理器数量。默认等于 Windows 逻辑核心数
processors=8

# 交换空间。默认是内存的 25%，设为 0 可禁用
swap=4GB

# 交换文件路径。建议放到非系统盘，避免频繁读写影响 C 盘
swapfile=D:\\WSL\\swap.vhdx

# 内存自动回收（重要！老版本 WSL2 会一直占着内存不放）
# 可选值：disabled / gradual / dropCache
autoMemoryReclaim=gradual

# localhost 转发：WSL 内服务可从 Windows 的 localhost 访问
# 注意：networkingMode=mirrored 时此项被忽略
localhostforwarding=true

# 嵌套虚拟化（在 WSL 里跑 Docker 或再开虚拟机时需要）
nestedVirtualization=true

# 磁盘大小上限（默认 1TB）
# diskSize=256GB

# 崩溃转储保留数量
maxCrashDumpCount=5

# 实验性特性 —— 以下均为 Windows 11 22H2+ 才支持
[experimental]

# 镜像网络模式：WSL 与 Windows 共享同一网络栈
# 优点：双向 localhost 直通；VPN 自动继承；IPv6 可用
# 缺点：绑定特定接口的应用可能异常
networkingMode=mirrored

# DNS 隧道，解决 VPN 场景下的 DNS 解析问题
dnsTunneling=true

# 通过 Windows 的代理设置自动配置 WSL 内代理
autoProxy=true

# 应用 Windows 防火墙规则到 WSL 流量
firewall=true

# 稀疏 VHD：磁盘按实际使用量增长，不再预占上限空间
sparseVhd=true

# 自动挂载 Windows 驱动器
[automount]
enabled=true
# 挂载点根目录。默认 /mnt/，即 C: → /mnt/c
root=/mnt/
# 关键：metadata 让 Linux 权限位在 NTFS 上生效（否则 chmod 无效）
options="metadata,umask=22,fmask=11"
mountFsTab=true

# 网络
[network]
# 自定义主机名，避免 WSL 改 hosts 引起某些软件报错
hostname=devbox
generateHosts=true
generateResolvConf=true

# 互操作：能否从 WSL 调用 Windows 程序
[interop]
enabled=true
# 是否把 Windows PATH 追加进 Linux PATH
# 生产 / 严格环境建议 false，避免命令冲突
appendWindowsPath=true

# 启动时设置的默认用户
[user]
default=yourname

# 启动行为
[boot]
# 启用 systemd（Ubuntu 22.04+ 默认已开）
systemd=true
# 以 root 身份在启动时执行，可用 && 串多条
# 启用 systemd 后尽量用 systemd 管理服务，而不是塞在这里
# command=service docker start

# GPU 直通（默认已开）
[gpu]
enabled=true

# 时间：与 Windows 时区同步，避免时钟漂移
[time]
useWindowsTimezone=true

sudo tee -a /etc/wsl.conf <<'EOF'
[boot]
systemd=true
EOF

wsl --shutdown
wsl -d Ubuntu

systemctl list-unit-files --type=service | head
ps -p 1 -o comm=      # 应输出 systemd

sudo systemctl start docker && sudo systemctl enable docker
sudo systemctl status postgresql
journalctl -u docker -f        # 跟踪日志

wsl -d Ubuntu -u root loginctl enable-linger yourname

# 不要这样做：直接在 /mnt/c 下跑重活
cd /mnt/c/Users/你/BigDataset && python process.py

# 应该这样做：先复制进 Linux 侧，处理完再拷回
cp -r /mnt/c/Users/你/BigDataset ~/work
cd ~/work && python process.py
cp -r ~/work/output /mnt/c/Users/你/BigDataset/

wslpath "C:\Users\You\Pictures"     # → /mnt/c/Users/You/Pictures
wslpath -w /home/you/project        # → \\wsl.localhost\Ubuntu\home\you\project
wslpath -m /home/you/project        # → C:/... 风格（某些工具需要）

explorer.exe .          # 在当前目录打开资源管理器

notepad.exe file.txt
code.exe .              # 打开 VS Code
explorer.exe .
winget.exe install Git.Git

wsl ls -la
wsl grep "pattern" file.txt
wsl npm --version
wsl sudo apt-get update

# 甚至混用管道
dir | wsl grep git
wsl ls -la | findstr "git"
wsl ls -la > out.txt        # Linux 输出重定向到 Windows 文件

$env:WSLENV = "GOPATH/p"
$env:GOPATH = "C:\Users\you\go"
wsl echo $GOPATH        # 输出 /mnt/c/Users/you/go

wsl --mount \\.\PHYSICALDRIVE1 --partition 1

sudo mkdir -p /mnt/usb
sudo mount -t drvfs E: /mnt/usb

[wsl2]
memory=16GB
processors=8
swap=4GB
swapfile=D:\\WSL\\swap.vhdx
autoMemoryReclaim=gradual
localhostforwarding=true
nestedVirtualization=true
maxCrashDumpCount=5

[experimental]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
firewall=true
sparseVhd=true

[automount]
enabled=true
root=/mnt/
options="metadata,umask=22,fmask=11"
mountFsTab=true

[network]
hostname=devbox
generateHosts=true
generateResolvConf=true

[interop]
enabled=true
appendWindowsPath=true

[user]
default=yourname

[boot]
systemd=true

[gpu]
enabled=true

[time]
useWindowsTimezone=true

wsl --shutdown
# 等 8 秒以上
wsl -d Ubuntu

df -h /        # 在 WSL 内确认实际使用量

wsl --shutdown
# VHDX 通常在：
# C:\Users\<你>\AppData\Local\Packages\CanonicalGroupLimited.*\LocalState\ext4.vhdx
diskpart

wsl --export Ubuntu D:\backup\ubuntu.tar
wsl --unregister Ubuntu
wsl --import Ubuntu D:\WSL\Ubuntu D:\backup\ubuntu.tar --version 2
# 导入后默认用户会变回 root，需在 /etc/wsl.conf 中重新指定

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc      # 或 ~/.zshrc

nvm install --lts
nvm use --lts
node --version && npm --version && npx --version

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

uv python install 3.12
uv venv && source .venv/bin/activate
uv pip install numpy pandas

sudo apt update
sudo apt install -y git make build-essential curl wget unzip python3-pip

curl -fsSL https://claude.ai/install.sh | bash
source ~/.bashrc      # 或 source ~/.zshrc
claude --version

npm install -g @anthropic-ai/claude-code
claude doctor        # 健康检查

mkdir -p ~/projects/demo && cd ~/projects/demo
claude

claude --permission-mode acceptEdits    # 自动接受文件编辑
claude --permission-mode plan           # 只规划不执行

# 项目约定

## 语言与风格
- TypeScript strict 模式，禁止 any
- 缩进 2 空格，单引号

## 常用命令
- 测试：`npm test`
- 构建：`npm run build`
- 类型检查：`npm run typecheck`

## 目录结构
- src/ 源码，tests/ 测试，src/generated/ 自动生成勿手动改

## 禁止事项
- 不要修改 package-lock.json
- 不要在提交中包含 .env

mkdir -p .claude/skills/linux-review
nano .claude/skills/linux-review/SKILL.md

---
name: linux-review
description: 审查 Linux shell 脚本的可移植性、危险命令与错误处理。
---

## 检查项
1. 未加引号的变量、危险的文件操作（rm -rf、未校验的变量）
2. 未处理的命令失败（缺少 set -e / || 处理）
3. 在 Ubuntu 上不兼容的语法
4. 按严重程度汇总发现，并给出针对性修复建议

# 方式一：官方安装脚本
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 方式二：npm（需 Node 22+）
npm i -g @openai/codex

# 方式三：Homebrew
brew install codex

codex --version

cd ~/projects/demo
codex

codex --sandbox workspace-write      # 允许在工作区写文件
codex mcp --help                     # 查看 MCP 支持

npm install -g @google/gemini-cli
gemini

npx https://github.com/google-gemini/gemini-cli

# 示例：Playwright MCP —— 让 Agent 能操作浏览器
npx @playwright/mcp@latest

# 示例：文件系统 MCP
npx -y @modelcontextprotocol/server-filesystem ~/projects

nvidia-smi        # 应显示 GPU 型号与 CUDA 版本

curl -fsSL https://ollama.com/install.sh | sh
ollama run qwen2.5:7b

# 调用 API
curl http://localhost:11434/api/generate -d '{
  "model": "qwen2.5:7b",
  "prompt": "用一句话解释 WSL2 的内存回收机制"
}'

uv venv && source .venv/bin/activate
uv pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121

python -c "import torch; print(torch.cuda.is_available(), torch.cuda.get_device_name(0))"

#!/usr/bin/env bash
# WSL AI 开发环境健康检查

echo "=== 系统信息 ==="
echo "内核: $(uname -r)"
echo "发行版: $(lsb_release -ds 2>/dev/null || grep PRETTY_NAME /etc/os-release)"
echo "CPU 核心: $(nproc)"
echo "内存: $(free -h | awk '/^Mem:/ {print $2}')"
echo

echo "=== 基础工具 ==="
for cmd in git make curl wget unzip jq rg fzf; do
    if command -v $cmd &>/dev/null; then
        printf "  OK  %-12s %s\n" "$cmd" "$($cmd --version 2>/dev/null | head -1)"
    else
        printf "  --  %-12s 未安装\n" "$cmd"
    fi
done
echo

echo "=== 运行时 ==="
for cmd in node npm npx python3 uv; do
    if command -v $cmd &>/dev/null; then
        printf "  OK  %-12s %s\n" "$cmd" "$($cmd --version 2>/dev/null | head -1)"
    else
        printf "  --  %-12s 未安装\n" "$cmd"
    fi
done
echo

echo "=== AI 工具 ==="
for cmd in claude codex gemini; do
    if command -v $cmd &>/dev/null; then
        printf "  OK  %-12s %s\n" "$cmd" "$($cmd --version 2>/dev/null | head -1)"
    else
        printf "  --  %-12s 未安装\n" "$cmd"
    fi
done
echo

echo "=== GPU ==="
if command -v nvidia-smi &>/dev/null; then
    nvidia-smi --query-gpu=name,memory.total,driver_version --format=csv,noheader
else
    echo "  未检测到 NVIDIA GPU 工具"
fi
echo

echo "=== systemd ==="
if pidof systemd &>/dev/null; then
    echo "  OK  systemd 运行中"
else
    echo "  --  systemd 未启用（检查 /etc/wsl.conf 的 [boot] systemd=true）"
fi

chmod +x ~/check-env.sh && ~/check-env.sh

wsl --shutdown
netsh winsock reset
netsh int ip reset all
netsh winhttp reset proxy
ipconfig /flushdns
# 重启电脑

# 导出（可在另一台机器导入）
wsl --export Ubuntu D:\wsl-backups\ubuntu-2026-10-03.tar

# 新机器上导入
wsl --import Ubuntu D:\WSL\Ubuntu D:\wsl-backups\ubuntu-2026-10-03.tar --version 2

# 导入后默认用户是 root，需在发行版内创建 /etc/wsl.conf：
# [user]
# default=yourname

# ---- 管理 ----
wsl --install                          # 安装
wsl -l -v                              # 列出（含版本、状态）
wsl --list --online                    # 可安装的发行版
wsl -s Ubuntu                          # 设默认发行版
wsl --set-default-version 2            # 新发行版默认用 WSL2
wsl --set-version Ubuntu 2             # 转换已有发行版
wsl --terminate Ubuntu                 # 终止
wsl --shutdown                         # 全关
wsl --update                           # 更新组件
wsl --status                           # 状态
wsl --version                          # 版本

# ---- 执行 ----
wsl                                    # 进入默认发行版
wsl -d Debian                          # 进入指定发行版
wsl -d Ubuntu -u root                  # 以 root 进入
wsl -d Ubuntu bash -lc "npm -v"        # 执行命令
wsl -d Ubuntu bash -lc "cd ~/app && git pull"

# ---- 备份迁移 ----
wsl --export Ubuntu D:\u.tar
wsl --import MyUbuntu D:\WSL D:\u.tar --version 2
wsl --unregister Ubuntu                # 删除（危险）

# ---- 磁盘 ----
wsl --mount \\.\PHYSICALDRIVE1 --partition 1
wsl --unmount \\.\PHYSICALDRIVE1

# ---- WSL 内常用 ----
exit                        # 退出
cd /                        # 根目录
explorer.exe .              # 资源管理器打开当前目录
code .                      # VS Code 打开
notepad.exe file.txt        # 调用 Windows 程序
wslpath "C:\Users\me"       # 路径转换
echo hi | clip.exe          # 写入 Windows 剪贴板
cat /etc/resolv.conf        # 查看主机 IP（NAT 模式）
df -h /                     # 查看磁盘占用
free -h                     # 查看内存
nproc                       # CPU 核心数

# 1. 系统更新
sudo apt update && sudo apt upgrade -y

# 2. 基础工具
sudo apt install -y git make build-essential curl wget unzip jq \
                    ripgrep fd-find bat fzf eza tree ncdu zsh python3-pip

# 3. 别名
echo 'alias fd=fdfind'  >> ~/.zshrc
echo 'alias bat=batcat' >> ~/.zshrc

# 4. Git 身份
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --global core.autocrlf input

# 5. SSH 密钥
ssh-keygen -t ed25519 -C "you@example.com"
cat ~/.ssh/id_ed25519.pub     # 加到 GitHub

# 6. Node（nvm）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.zshrc && nvm install --lts

# 7. Python（uv）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 8. AI 工具
curl -fsSL https://claude.ai/install.sh | bash
npm i -g @openai/codex

# 9. 项目目录
mkdir -p ~/projects