WSL 搭配 Coding Agent：零基础写出一个博客

没有编程基础，从装 WSL 到博客上线花了两个晚上，全程和 AI 结对，一行代码没写。这篇是操作记录，所有命令都实际跑过。

本文由 AI（Pi Coding Agent）根据口述需求生成，人工审校后发布。

为什么用 WSL？#

AI 大模型训练语料以 Linux 命令为主，PowerShell 下生成的命令经常报错，WSL 里报错率低很多
博客这类项目最终部署在 Linux 环境，本地直接就是 Linux，不存在环境差异
子系统独立隔离，搞坏了 wsl --unregister 删掉重装，Windows 宿主机不受任何影响

前置：开启 CPU 虚拟化#

任务管理器 → 性能 → CPU，查看「虚拟化」是否已启用。

未启用则重启进 BIOS：Intel CPU 开 VMX，AMD CPU 开 SVM Mode。

安装 WSL#

管理员 PowerShell，国内网络推荐加速安装：

1
wsl --install --web-download

提示重启就重启，装完设置 Linux 用户名和密码（输入密码无回显，正常输完回车即可）。

开发环境：Git + Node#

Ubuntu 自带 git 和 python3，验证即可：

1
git -v

Node 用 nvm 装（别用 apt 的 nodejs，版本太老）：

1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
2
\. "$HOME/.nvm/nvm.sh"
3
nvm install --lts
4
node -v

部署 Pi Coding Agent#

Pi 是终端里的编程智能体，能读文件、跑命令、改代码，改完自己验证。安装：

1
npm install -g @earendil-works/pi-coding-agent

建项目目录并启动：

1
mkdir ~/blog && cd ~/blog
2
pi

模型配置：输入 /login，选择 API Key 方式，DeepSeek、Kimi、MiniMax 等都支持。

可能遇到的问题：Failed to download ripgrep

ripgrep 是 Pi 依赖的高速检索工具，启动时自动在线下载，国内网络容易拉取失败。直接用系统源装，绕过在线下载：

1
sudo apt update && sudo apt install ripgrep -y

实战：用它建博客#

建站过程里我说的话，原样摘几条：

“把 sample 里这个主题框架搬到 blog，示例内容全部清空”
“背景换了张图，一片红看不到海岸线，调一下”
“音乐接我的网易云歌单”

它接到的处理方式都一样：自己翻代码搞清结构，动手改，然后验证（改完 favicon 会 curl 检查状态码，改完配置会解析渲染出的 HTML）。

WSL 特色：端口自动转发。 dev 服务起在 WSL 里，Windows 浏览器直接开 localhost:4321，不用配置任何东西。

文件互通：

WSL 访问 Windows：C/D 盘挂载在 /mnt/c、/mnt/d，换头像直接从桌面拷
Windows 访问 WSL 文件：WSL 内执行 explorer.exe .
VS Code 联动：WSL 项目目录下 code .，直接调起 Windows 的 VS Code

调教 Agent：两个 skill#

Pi 的 skill 机制：一个文件夹加一份 SKILL.md，放进 ~/.pi/agent/skills/ 自动发现，按需加载。相当于给 AI 插外挂。

grill me —— 需求拷问

装了它，你说需求它先不动手，反过来把你问一遍。我说”换个好看的背景图”，它问：图从哪来？桌面和移动端分不分开？裁剪偏好是什么？横幅文字要不要跟着换？问完才发现一半的问题我没想过。几轮下来，“好看的图”变成”用这张图、海岸线必须露出来、文字保持不动”，然后一次做对。

awesome design —— 审美外挂

AI 做界面的通病是排版一股 AI 味：渐变、圆角卡片、居中大标题什么都来一点。这类 skill 是提前把一套设计规范喂给它：字号层级、留白节奏、配色克制。装上之后出的东西明显收敛。

一个管想清楚，一个管做得好看。

博客框架：Firefly#

框架用的开源主题 Firefly，基于 Astro 和 Fuwari。保留了 Fuwari 原版单侧栏布局，配置文件里一行切换；音乐、B 站追番页是现成的，填个 ID 就能用。

用别人主题记得留署名：页脚 “Powered by Astro & Firefly” 和 LICENSE 文件不要删。

补充#

项目务必放在 WSL 原生目录（如 ~/blog），不要放在 /mnt/c 挂载目录下，跨系统 IO 卡顿严重，装依赖、构建会慢一个数量级
子系统随时可删可重建：wsl --unregister Ubuntu，零成本
Windows 和 Linux 命令可以混用：Get-ChildItem | wsl grep video，前半段 Windows 命令，后半段 Linux 命令，无缝衔接