# 安装 nircmd 工具指南

## 📥 快速安装（3 步完成）

### 步骤 1：下载 nircmd

**64 位 Windows（推荐）：**
```
https://www.nirsoft.net/utils/nircmd-x64.zip
```

**32 位 Windows：**
```
https://www.nirsoft.net/utils/nircmd.zip
```

**官方页面：**
```
https://www.nirsoft.net/utils/nircmd.html
```

---

### 步骤 2：解压并复制

1. 解压下载的 ZIP 文件
2. 找到 `nircmd.exe` 文件
3. 复制到项目的 `tools` 文件夹：
   ```
   D:\Software\remote-volume-monitor\tools\nircmd.exe
   ```

---

### 步骤 3：验证安装

在项目根目录运行：
```bash
python src\remote_volume_monitor.py --test
```

**看到以下输出表示成功：**
```
✓ 音量控制器：nircmd (D:\Software\remote-volume-monitor\tools\nircmd.exe)
✓ RDP 监控器初始化成功

音量控制器：✓ 就绪
使用方法：nircmd
```

---

## 🧪 手动测试 nircmd

```bash
# 设置音量为 50%
.\tools\nircmd.exe setsysvolume 32767

# 设置音量为 30%
.\tools\nircmd.exe setsysvolume 19660

# 设置音量为 80%
.\tools\nircmd.exe setsysvolume 52428

# 静音
.\tools\nircmd.exe mutesysvolume 1

# 取消静音
.\tools\nircmd.exe mutesysvolume 0
```

---

## 📁 最终文件结构

```
remote-volume-monitor/
├── tools/
│   ├── README.md
│   └── nircmd.exe         ← 你放入的文件
├── src/
│   ├── remote_volume_monitor.py
│   └── volume_control.py
├── config/
│   └── config.ini
├── docs/
├── logs/
├── scripts/
├── tests/
├── README.md
└── requirements.txt
```

---

## 💡 常见问题

### Q: 下载后是 .zip 文件怎么办？
A: 右键 → 解压到当前文件夹，然后提取 nircmd.exe

### Q: 需要安装吗？
A: 不需要！nircmd 是绿色软件，直接运行即可

### Q: 杀毒软件报警怎么办？
A: 这是误报。nircmd 是知名免费工具，可以添加信任

### Q: 可以放到其他位置吗？
A: 可以，但需要放到系统 PATH 或 tools 文件夹才能被自动检测

---

## 📞 完成安装后

运行测试模式确认一切正常：
```bash
cd D:\Software\remote-volume-monitor
python src\remote_volume_monitor.py --test
```

然后就可以正常使用远程音量监控功能了！

---

*nircmd 是 NirSoft 的免费工具，更多信息请访问 https://www.nirsoft.net/*