# 远程音量控制 - 测试用例

## 📋 测试环境要求

| 项目 | 要求 |
|------|------|
| 操作系统 | Windows 10/11 |
| Python 版本 | 3.8 或更高 |
| 远程桌面 | Windows RDP 或兼容工具 |
| 网络 | 局域网或互联网连接 |

---

## 🧪 测试用例列表

### TC-001: 依赖安装测试

**目的**: 验证 Python 依赖库能正常安装

**步骤**:
```bash
pip install -r requirements.txt
```

**预期结果**:
- ✅ pycaw 安装成功
- ✅ comtypes 安装成功
- ✅ wmi 安装成功
- ✅ pywin32 安装成功

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

### TC-002: 程序启动测试

**目的**: 验证程序能正常启动

**步骤**:
```bash
python remote_volume_monitor.py --test
```

**预期结果**:
- ✅ 程序无报错启动
- ✅ 显示当前会话状态
- ✅ 音量控制器初始化成功
- ✅ WMI 监控器初始化成功

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

### TC-003: 音量调节功能测试

**目的**: 验证音量调节功能正常

**步骤**:
```bash
# 获取当前音量
python remote_volume_monitor.py --get-volume

# 设置音量为 50%
python remote_volume_monitor.py --set-volume 50

# 再次获取音量确认
python remote_volume_monitor.py --get-volume
```

**预期结果**:
- ✅ 能正确读取当前音量
- ✅ 音量成功设置为 50%
- ✅ 系统音量与实际设置一致

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

### TC-004: 远程连接检测测试

**目的**: 验证能正确检测远程连接

**步骤**:
1. 本地状态下运行测试模式
2. 使用另一台电脑 RDP 连接到目标电脑
3. 再次运行测试模式
4. 断开 RDP 连接
5. 再次运行测试模式

**预期结果**:
- ✅ 本地状态显示"本地会话"
- ✅ RDP 连接后显示"远程连接"
- ✅ 断开后恢复"本地会话"
- ✅ 检测延迟 < 5 秒

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

### TC-005: 自动音量调节测试（核心功能）

**目的**: 验证远程连接时自动调节音量

**步骤**:
1. 设置配置文件中 `remote_volume = 30`
2. 启动监控程序：`python remote_volume_monitor.py --config config.ini`
3. 记录当前音量：____%
4. 使用 RDP 连接到此电脑
5. 观察日志和音量变化
6. 断开 RDP 连接
7. 观察音量是否恢复（如果配置了 local_volume）

**预期结果**:
- ✅ RDP 连接后 5 秒内音量降至 30%
- ✅ 日志记录"检测到远程连接建立"
- ✅ 日志记录"音量已设置为 30%"
- ✅ 断开连接后音量恢复（如果配置了）

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

### TC-006: 配置文件测试

**目的**: 验证配置文件功能正常

**步骤**:
1. 编辑 config.ini，修改 `remote_volume = 60`
2. 重启监控程序
3. RDP 连接电脑
4. 检查音量是否设置为 60%

**预期结果**:
- ✅ 配置文件修改生效
- ✅ 音量按新配置设置
- ✅ 无需修改代码即可调整参数

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

### TC-007: 后台持续监控测试

**目的**: 验证程序能持续稳定运行

**步骤**:
1. 启动监控程序
2. 运行 30 分钟
3. 检查 CPU 占用率
4. 检查内存占用
5. 多次连接/断开 RDP

**预期结果**:
- ✅ CPU 占用 < 1%
- ✅ 内存占用 < 50MB
- ✅ 程序无崩溃
- ✅ 多次连接断开均正常响应

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

### TC-008: 日志记录测试

**目的**: 验证日志功能正常

**步骤**:
1. 启动监控程序
2. 执行连接/断开操作
3. 查看 remote_volume.log 文件

**预期结果**:
- ✅ 日志文件正常创建
- ✅ 记录连接建立事件
- ✅ 记录连接断开事件
- ✅ 记录音量调整操作
- ✅ 时间戳准确

**日志示例**:
```
2026-03-07 17:30:00,123 - INFO - ✓ 音量控制器初始化成功
2026-03-07 17:35:22,012 - INFO - 🔔 检测到远程连接建立
2026-03-07 17:35:22,345 - INFO - ✓ 音量已设置为 30%
2026-03-07 17:40:15,678 - INFO - 🔔 检测到远程连接断开
```

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

### TC-009: Windows 服务安装测试（可选）

**目的**: 验证能安装为 Windows 服务

**前提**: 已下载 NSSM 工具

**步骤**:
```bash
# 以管理员身份运行
nssm install RemoteVolumeMonitor "C:\Python39\python.exe" "C:\path\to\remote_volume_monitor.py" "--config" "C:\path\to\config.ini"
nssm set RemoteVolumeMonitor DisplayName "Remote Volume Monitor"
nssm set RemoteVolumeMonitor Start SERVICE_AUTO_START
nssm start RemoteVolumeMonitor
```

**预期结果**:
- ✅ 服务安装成功
- ✅ 服务能正常启动
- ✅ 开机自动启动
- ✅ 服务状态可查询

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

### TC-010: 边界条件测试

**目的**: 验证极端条件下的稳定性

**测试项**:
1. 音量设置为 0%
2. 音量设置为 100%
3. 快速多次连接/断开
4. 网络不稳定时 RDP 连接
5. 多用户同时远程连接

**预期结果**:
- ✅ 0% 音量正常设置
- ✅ 100% 音量正常设置
- ✅ 快速切换无异常
- ✅ 网络波动不影响程序稳定性
- ✅ 多用户场景正常处理

**实际结果**: _______________

**测试人**: _______________

**日期**: _______________

---

## 📊 测试结果汇总

| 用例编号 | 测试项 | 结果 | 备注 |
|---------|--------|------|------|
| TC-001 | 依赖安装测试 | ⬜ 通过 ⬜ 失败 | |
| TC-002 | 程序启动测试 | ⬜ 通过 ⬜ 失败 | |
| TC-003 | 音量调节功能测试 | ⬜ 通过 ⬜ 失败 | |
| TC-004 | 远程连接检测测试 | ⬜ 通过 ⬜ 失败 | |
| TC-005 | 自动音量调节测试 | ⬜ 通过 ⬜ 失败 | |
| TC-006 | 配置文件测试 | ⬜ 通过 ⬜ 失败 | |
| TC-007 | 后台持续监控测试 | ⬜ 通过 ⬜ 失败 | |
| TC-008 | 日志记录测试 | ⬜ 通过 ⬜ 失败 | |
| TC-009 | Windows 服务安装测试 | ⬜ 通过 ⬜ 失败 ⬜ 跳过 | |
| TC-010 | 边界条件测试 | ⬜ 通过 ⬜ 失败 | |

**总体结论**: ⬜ 通过 ⬜ 有条件通过 ⬜ 失败

**测试负责人**: _______________

**测试日期**: _______________

**审批人**: _______________

---

## 🐛 问题记录

### 问题 1
**描述**: _______________

**严重程度**: ⬜ 严重 ⬜ 中 ⬜ 轻

**复现步骤**: _______________

**解决方案**: _______________

**状态**: ⬜ 待修复 ⬜ 修复中 ⬜ 已修复 ⬜ 已验证

---

### 问题 2
**描述**: _______________

**严重程度**: ⬜ 严重 ⬜ 中 ⬜ 轻

**复现步骤**: _______________

**解决方案**: _______________

**状态**: ⬜ 待修复 ⬜ 修复中 ⬜ 已修复 ⬜ 已验证

---

## ✅ 验收标准

所有测试用例必须满足以下条件才能验收：

- [ ] TC-001 ~ TC-008 全部通过
- [ ] 无严重级别 Bug
- [ ] 中等级别 Bug < 3 个
- [ ] 程序能稳定运行 24 小时
- [ ] 文档完整可用

---

**测试完成后，请将此文档上传到飞书任务管理表的"交付物"字段！**