ChatGPT接入本地Agent-完整方案与实战记录

Linux DSH Guide

在 Linux 上，**nvm (Node Version Manager)** 是管理多个 Node.js 版本的主流工具，它允许你在同一台机器上安装、切换和隔离不同项目所需的 Node.js 版本。

### 📥 安装 nvm

推荐使用官方安装脚本。根据你的环境，选择 **curl** 或 **wget** 命令：

**使用 curl:**
```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
```

**使用 wget:**
```bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
```
> 安装脚本会自动将 nvm 仓库克隆到 `~/.nvm`，并尝试将环境变量配置添加到你的 shell 配置文件（如 `~/.bashrc` 或 `~/.zshrc`）中。

### ⚙️ 激活与验证

安装后，需要让配置生效：

```bash
# 如果使用 Bash
source ~/.bashrc
# 如果使用 Zsh
source ~/.zshrc
```

或者，直接**关闭当前终端并重新打开**一个即可。

**验证安装**：运行以下命令，如果显示版本号（如 `0.40.3`）即表示成功：
```bash
nvm --version
```

### 🎮 常用命令

掌握以下命令即可高效管理 Node.js 版本：

| 命令 | 说明 |
|---|---|
| `nvm install --lts` | 安装最新的 **LTS (长期支持)** 版本 |
| `nvm install 20.11.0` | 安装指定的 Node.js 版本 |
| `nvm ls` | 列出**已安装**的所有版本（当前使用版本前有 `->` 标记） |
| `nvm ls-remote` | 列出**远程所有可用**的版本 |
| `nvm use 20.11.0` | **临时切换**版本（仅对当前终端会话有效） |
| `nvm alias default 20.11.0` | 设置**默认版本**（新打开的终端都会使用） |
| `nvm uninstall 18.0.0` | 卸载指定的 Node.js 版本 |

### 📁 项目级版本控制 (`.nvmrc`)

在项目根目录创建 `.nvmrc` 文件，写入项目所需的 Node.js 版本号，例如：
```bash
echo "20.11.0" > .nvmrc
```
之后，进入该目录时执行 `nvm use`，nvm 就会自动读取并切换到对应版本。如果该版本尚未安装，它会给出提示。

### 🇨🇳 配置国内镜像（加速下载）

国内网络环境下，可以设置镜像环境变量来加速 Node.js 的下载。将以下内容添加到你的 shell 配置文件（如 `~/.bashrc`）中：

```bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
export NVM_IOJS_ORG_MIRROR=https://npmmirror.com/mirrors/iojs
```
保存后执行 `source ~/.bashrc` 使其生效。之后使用 `nvm install` 时便会从国内镜像下载。

### 🗑️ 卸载 nvm

如果你需要彻底移除 nvm：

1.  **移除 nvm 目录**：
    ```bash
    rm -rf ~/.nvm
    ```
2.  **清理 shell 配置**：编辑 `~/.bashrc`、`~/.zshrc` 或 `~/.profile`，删除其中所有与 `NVM_DIR` 相关的行。

### 🔧 常见问题排查

**问题1：安装后执行 `nvm` 提示 `command not found`**

这通常是因为 shell 配置文件未被正确加载。你可以尝试：
- **重启终端**：关闭所有终端窗口，重新打开一个再试。
- **手动加载**：在终端中手动执行 `source ~/.bashrc`（或你的 shell 对应文件）。
- **检查配置**：确认 `~/.bashrc`（或 `~/.zshrc`）中已包含安装脚本添加的 `export NVM_DIR...` 和 `[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"` 这两行配置。

**问题2：touch ~/.bashrc 创建了为啥看不到**

因为 ~/.bashrc 是隐藏文件——文件名以 . 开头。ls 默认不显示隐藏文件

列出主目录下所有文件，包括隐藏文件：
```bash 
ls -a ~
```
图形界面看不到
如果你是在 Finder 或文件管理器里看，隐藏文件默认也不显示：

macOS Finder：按 Cmd + Shift + . 显示隐藏文件。

Linux 文件管理器：一般按 Ctrl + H 显示隐藏文件。

### NPM 镜像查询与设置
```bash
npm config get registry

npm config set registry https://registry.npmmirror.com
```
### Vim操作
在 vim 里保存退出，记住这个核心操作：

按 O（大写字母 O），这会在当前行的上方插入一个新行，并进入插入模式

**先按 `Esc`，再输入 `:wq`，然后按回车。**

---

#### 常见场景

| 目的 | 操作 |
|---|---|
| 保存并退出 | `Esc` → `:wq` → 回车 |
| 保存并退出（等价） | `Esc` → `:x` → 回车 |
| 不保存，强制退出 | `Esc` → `:q!` → 回车 |
| 只保存，不退出 | `Esc` → `:w` → 回车 |
| 没修改，只想退出 | `Esc` → `:q` → 回车 |
| 保存退出（快捷键） | `Esc` → 按 `ZZ`（Shift+z 两次） |

---

### 注意

1. **先按 `Esc`**  
   如果你在插入模式（正在打字），要先按 `Esc` 回到普通模式，才能输入 `:` 命令。不确定时多按几次 `Esc` 也没关系。

2. **冒号是英文冒号**  
   输入 `:` 时要用英文输入法，不要用中文的 `：`。

3. **如果提示权限不够**  
   比如编辑系统文件时出现 `E45: 'readonly' option is set`，可以用：
   ```
   :w !sudo tee %
   ```
   回车后输入密码，再按 `:q!` 退出。不过编辑 `~/.bashrc`、`~/.zshrc` 一般不需要 sudo。

---

### 你正在编辑 .zshrc / .bashrc 的话

保存退出后，运行对应命令让配置生效：

- zsh：
  ```bash
  source ~/.zshrc
  ```
- bash：
  ```bash
  source ~/.bashrc
  ```

然后可以用 `echo $NVM_NODEJS_ORG_MIRROR` 验证是否生效。