# 快速开始指南

## 3 分钟快速上手

### 步骤 1：下载 nircmd（1 分钟）

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

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

下载后解压，将 `nircmd.exe` 放到 `tools\` 文件夹。

---

### 步骤 2：测试程序（1 分钟）

打开命令提示符，进入程序目录：
```bash
cd D:\Software\remote-volume-monitor-v1.0

# 测试运行
python src\remote_volume_monitor.py --test
```

**预期输出：**
```
✓ 音量控制器：nircmd (.\tools\nircmd.exe)
✓ RDP 监控器初始化成功
音量控制器：✓ 就绪
```

---

### 步骤 3：启动监控（1 分钟）

**方式 1：双击启动脚本**
```
双击 scripts\启动监控.bat
```

**方式 2：命令行启动**
```bash
python src\remote_volume_monitor.py
```

**完成！** 程序已在后台运行。

---

## 测试功能

### 测试 RDP 连接

1. 确保程序正在运行
2. 用另一台电脑 RDP 连接到此电脑
3. 观察音量是否自动降低到 30%
4. 断开 RDP 连接
5. 观察音量是否自动恢复到 80%

### 查看日志

打开日志文件查看运行状态：
```
logs\remote_volume.log
```

日志会显示：
- 每次检测的时间
- RDP 连接/断开事件
- 音量调整记录

---

## 自定义配置

编辑 `config\config.ini`：

```ini
[volume]
# 远程连接时音量（0-100）
remote_volume = 30

# 本地使用音量（0-100）
local_volume = 80

[monitor]
# 检测间隔（秒）
check_interval = 5
```

修改后重启程序生效。

---

## 常用操作

### 停止程序

按 `Ctrl + C` 停止运行中的程序。

### 开机自启（可选）

**方式 1：使用任务计划程序**
1. 打开任务计划程序
2. 创建基本任务
3. 触发器：登录时
4. 操作：启动程序 `pythonw.exe`
5. 参数：`src\remote_volume_monitor.py`

**方式 2：使用启动文件夹**
1. 创建批处理文件
2. 放到启动文件夹：`shell:startup`

---

## 遇到问题？

### 检查清单

- [ ] Python 3.8+ 已安装
- [ ] nircmd.exe 已放到 `tools\` 文件夹
- [ ] Windows Audio 服务正在运行
- [ ] 以普通用户权限运行即可

### 查看帮助

- 详细文档：`docs\` 文件夹
- 日志文件：`logs\remote_volume.log`
- 测试工具：`python src\test_rdp_detection.py`

---

*3 分钟完成设置，享受自动音量调节！*