mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-06-06 08:10:48 +08:00
feat: 拆分 environment-setup 为 Python/Node.js 运行时双核心 + 父级路由
新增双核心 skill(深度集成 DesireCore Hatch/Volta + HTTP API + Socket.IO): - python-runtime v1.0.1:Python 运行时管理 · 四级降级:HTTP API → Hatch CLI 绝对路径 → 系统包管理器 → pyenv · references:hatch-desirecore / pyenv-fallback / virtualenv / troubleshooting · scripts/probe-python.sh:输出 JSON 快照供 Claude 解析决策 - nodejs-runtime v1.0.1:Node.js 运行时管理 · 四级降级:HTTP API → Volta CLI → 系统包管理器/NodeSource → nvm/fnm · references:volta-desirecore / nvm-fallback / package-managers / troubleshooting · scripts/probe-node.sh:输出 JSON 快照(含 volta_tools / package_json_volta 等) environment-setup → dev-environment-setup v2.0.1(重命名 + 重写为 router): - 从 1380 行手册瘦身为 ~150 行索引 - 仅负责容器(Docker/Podman)/ WSL2 / 办公依赖速查 / 系统工具 - references/desirecore-runtime.md 沉淀 Hatch/Volta 路径表 + HTTP API 速查 + Socket.IO 事件契约,作为两个核心 skill 的共享底座 - references/decision-tree.md 定义四级降级决策树 - scripts/probe.sh + probe.ps1 系统级 JSON 探测 三个 SKILL.md 的 L0 改为场景驱动结构(何时使用 / 何时不要用 / 怎么做), 让 AI 凭名字与 L0 即可判断匹配场景。 注册更新: - builtin-skills.json:新增 python-runtime / nodejs-runtime / dev-environment-setup (原 environment-setup 移除),按字母序,共 21 个 skill - manifest.json:totalSkills 19→21,lastUpdated 2026-05-02 下游同步: - docx / pdf / xlsx / pptx 中的环境引用从 environment-setup 拆分为 python-runtime / nodejs-runtime / dev-environment-setup 三向指引 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
138
skills/dev-environment-setup/references/wsl.md
Normal file
138
skills/dev-environment-setup/references/wsl.md
Normal file
@@ -0,0 +1,138 @@
|
||||
# WSL2 安装与配置(Windows)
|
||||
|
||||
WSL2(Windows Subsystem for Linux 2)让 Windows 用户原生运行 Linux 环境,是运行 Python 脚本、Docker、各种开发工具的最佳方式。
|
||||
|
||||
## 检测
|
||||
|
||||
```powershell
|
||||
wsl --status # 已安装时显示版本与默认发行版
|
||||
wsl --list --verbose # 已安装的发行版及版本
|
||||
```
|
||||
|
||||
## 系统要求
|
||||
|
||||
- Windows 11(21H2+)或 Windows 10(版本 2004,Build 19041+)
|
||||
- BIOS 启用 CPU 虚拟化(Intel VT-x / AMD-V)
|
||||
|
||||
## 安装
|
||||
|
||||
```powershell
|
||||
# 以管理员身份打开 PowerShell
|
||||
|
||||
# 一键安装(含 WSL2 内核 + 默认 Ubuntu)
|
||||
wsl --install
|
||||
|
||||
# 重启计算机后 Ubuntu 窗口自动打开,提示设置用户名密码
|
||||
```
|
||||
|
||||
## 安装指定发行版
|
||||
|
||||
```powershell
|
||||
wsl --list --online # 可选发行版
|
||||
wsl --install -d Ubuntu-24.04
|
||||
wsl --install -d Debian
|
||||
wsl --set-default Ubuntu-24.04
|
||||
```
|
||||
|
||||
## 确保使用 WSL2
|
||||
|
||||
```powershell
|
||||
wsl --list --verbose
|
||||
# VERSION 列应为 2
|
||||
|
||||
# 升级到 WSL2
|
||||
wsl --set-version Ubuntu 2
|
||||
|
||||
# 默认 WSL2
|
||||
wsl --set-default-version 2
|
||||
```
|
||||
|
||||
## 进入 WSL2 后配置开发环境
|
||||
|
||||
按 Linux 方式配置即可:
|
||||
|
||||
```bash
|
||||
# 进入
|
||||
wsl
|
||||
|
||||
# 系统更新
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
|
||||
# Python(推荐用 python-runtime skill 走完整决策树)
|
||||
sudo apt install python3 python3-pip python3-venv
|
||||
|
||||
# Node.js(推荐用 nodejs-runtime skill)
|
||||
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
|
||||
sudo apt install nodejs
|
||||
|
||||
# Docker(推荐 Docker Desktop 的 WSL2 后端,而非在 WSL2 内独立装)
|
||||
```
|
||||
|
||||
## 文件互访
|
||||
|
||||
```bash
|
||||
# WSL2 → Windows
|
||||
ls /mnt/c/Users/<用户名>/Desktop/
|
||||
|
||||
# Windows → WSL2(资源管理器地址栏)
|
||||
\\wsl$\Ubuntu\home\<用户名>\
|
||||
|
||||
# Windows Terminal 打开 WSL2
|
||||
wsl ~
|
||||
```
|
||||
|
||||
## 常见问题
|
||||
|
||||
### "WslRegisterDistribution failed with error: 0x80370102"
|
||||
|
||||
CPU 虚拟化未启用。重启进 BIOS,启用 Intel VT-x / AMD-V。
|
||||
|
||||
### 网络无法访问互联网
|
||||
|
||||
```bash
|
||||
# 在 WSL2 内
|
||||
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf
|
||||
|
||||
# 或 Windows 端关闭 Hyper-V 网卡的 DNS 自动管理
|
||||
```
|
||||
|
||||
如果是公司 VPN 干扰,在 Windows 端 `wsl --shutdown` 后重启 VPN。
|
||||
|
||||
### 磁盘空间不足
|
||||
|
||||
```powershell
|
||||
# 压缩 WSL2 虚拟磁盘
|
||||
wsl --shutdown
|
||||
# 然后用 diskpart 压缩 ext4.vhdx(高级操作,备份后再做)
|
||||
```
|
||||
|
||||
或在 `~/.wslconfig` 限制大小:
|
||||
|
||||
```ini
|
||||
[wsl2]
|
||||
memory=4GB
|
||||
processors=2
|
||||
swap=2GB
|
||||
```
|
||||
|
||||
### Windows 与 WSL2 时间不同步
|
||||
|
||||
```bash
|
||||
sudo hwclock -s
|
||||
```
|
||||
|
||||
或:
|
||||
```bash
|
||||
sudo apt install ntpdate
|
||||
sudo ntpdate -s time.windows.com
|
||||
```
|
||||
|
||||
### DesireCore 在 WSL2 中使用
|
||||
|
||||
DesireCore 是 Windows 桌面应用,运行在 Windows 端而非 WSL2 内。但 DesireCore 的环境检查(设置 → 环境检查)可以自动检测 Windows 版本、CPU 虚拟化、WSL2 状态,并提供一键修复入口。
|
||||
|
||||
## 性能建议
|
||||
|
||||
- 项目文件放在 WSL2 的 Linux 文件系统(`/home/<user>/`),不要放 `/mnt/c/`——后者跨文件系统 IO 极慢
|
||||
- 编辑器:VS Code + Remote-WSL 扩展,自动跨边界
|
||||
- Docker:使用 Docker Desktop 的 WSL2 后端,避免 WSL2 内独立 Docker 守护进程
|
||||
Reference in New Issue
Block a user