Initial commit - 按新规范整理目录结构

- Code/: 源代码、配置文件、文档、工具
- Releases/: 发布包(v1.0)
- Test/: 测试用例和测试脚本
This commit is contained in:
2026-03-20 06:54:40 +08:00
commit 45e7d9553a
29 changed files with 5068 additions and 0 deletions

View File

@@ -0,0 +1,343 @@
# 远程音量控制 - 测试用例
## 📋 测试环境要求
| 项目 | 要求 |
|------|------|
| 操作系统 | 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 小时
- [ ] 文档完整可用
---
**测试完成后,请将此文档上传到飞书任务管理表的"交付物"字段!**