remote-volume-monitor/docs/部署检查清单_远程音量控制.md

# 远程音量控制 - 部署检查清单

## 📦 部署前准备

### 1. 环境检查

- [ ] 目标电脑已安装 Windows 10/11
- [ ] 已安装 Python 3.8 或更高版本
- [ ] 确认 Python 已添加到系统 PATH
- [ ] 确认有管理员权限（用于安装服务）
- [ ] 确认 Windows Audio 服务正在运行

### 2. 文件准备

- [ ] remote_volume_monitor.py（主程序）
- [ ] config.ini（配置文件）
- [ ] 启动监控.bat（启动脚本）
- [ ] requirements.txt（依赖列表）
- [ ] README_远程音量控制.md（使用文档）
- [ ] 测试用例_远程音量控制.md（测试文档）
- [ ] 部署检查清单.md（本文档）

### 3. 依赖安装

```bash
# 方法 1: 使用 requirements.txt
pip install -r requirements.txt

# 方法 2: 手动安装
pip install pycaw comtypes wmi pywin32
```

- [ ] pycaw 安装成功
- [ ] comtypes 安装成功
- [ ] wmi 安装成功
- [ ] pywin32 安装成功

---

## 🚀 部署步骤

### 步骤 1: 文件部署

将以下文件复制到目标电脑（建议路径：`C:\Program Files\RemoteVolumeMonitor\`）

- [ ] 复制所有项目文件到目标目录
- [ ] 确认文件权限正确
- [ ] 创建日志目录（可选）

### 步骤 2: 配置调整

编辑 `config.ini`：

```ini
[volume]
remote_volume = 30      # 根据实际需求调整
local_volume = 80       # 可选，断开时恢复

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

[behavior]
adjust_on_connect = true
adjust_on_disconnect = true
```

- [ ] 设置目标音量
- [ ] 设置检测间隔
- [ ] 配置行为选项

### 步骤 3: 功能测试

运行测试模式：

```bash
python remote_volume_monitor.py --test
```

- [ ] 程序无报错
- [ ] 能正确检测当前会话状态
- [ ] 音量控制器初始化成功

### 步骤 4: 手动启动测试

```bash
python remote_volume_monitor.py --config config.ini
```

- [ ] 程序正常启动
- [ ] 日志文件开始记录
- [ ] 无异常错误

### 步骤 5: RDP 连接测试

1. 使用另一台电脑 RDP 连接到目标电脑
2. 观察音量变化
3. 查看日志记录
4. 断开 RDP 连接
5. 观察音量恢复（如果配置了）

- [ ] 连接时音量自动降低
- [ ] 断开时音量自动恢复
- [ ] 日志记录完整
- [ ] 响应时间 < 5 秒

### 步骤 6: 安装为服务（可选，推荐）

**下载 NSSM**: https://nssm.cc/download

**以管理员身份运行 CMD**:

```bash
cd C:\Program Files\RemoteVolumeMonitor
nssm install RemoteVolumeMonitor "C:\Python39\python.exe" "C:\Program Files\RemoteVolumeMonitor\remote_volume_monitor.py" "--config" "C:\Program Files\RemoteVolumeMonitor\config.ini"
nssm set RemoteVolumeMonitor DisplayName "Remote Volume Monitor"
nssm set RemoteVolumeMonitor Description "自动检测远程连接并调整系统音量"
nssm set RemoteVolumeMonitor Start SERVICE_AUTO_START
nssm set RemoteVolumeMonitor ObjectName LocalSystem
nssm start RemoteVolumeMonitor
```

- [ ] NSSM 已下载
- [ ] 服务安装成功
- [ ] 服务启动成功
- [ ] 设置开机自启
- [ ] 重启电脑验证服务自动启动

---

## ✅ 验收检查

### 功能验收

- [ ] 能准确检测 RDP 连接建立
- [ ] 能准确检测 RDP 连接断开
- [ ] 连接时音量自动调整到设定值
- [ ] 断开时音量自动恢复（如果配置）
- [ ] 配置修改后生效
- [ ] 日志记录完整准确

### 性能验收

- [ ] CPU 占用 < 1%
- [ ] 内存占用 < 50MB
- [ ] 检测延迟 < 5 秒
- [ ] 能稳定运行 24 小时
- [ ] 无内存泄漏

### 稳定性验收

- [ ] 多次连接/断开无异常
- [ ] 网络波动不影响程序
- [ ] 系统重启后自动恢复（服务模式）
- [ ] 无崩溃现象

---

## 📝 部署记录

| 项目 | 内容 |
|------|------|
| 部署日期 | _______________ |
| 部署人员 | _______________ |
| 目标电脑 | _______________ |
| 电脑名称 | _______________ |
| IP 地址 | _______________ |
| 部署方式 | ⬜ 手动启动 ⬜ Windows 服务 |
| 配置音量 | 远程：____%  本地：____% |
| 检测间隔 | ____ 秒 |

---

## 🐛 问题记录

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

**解决方案**: _______________

**状态**: ⬜ 已解决 ⬜ 待解决

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

**解决方案**: _______________

**状态**: ⬜ 已解决 ⬜ 待解决

---

## ✅ 部署完成确认

- [ ] 所有部署步骤已完成
- [ ] 功能测试全部通过
- [ ] 性能指标达标
- [ ] 用户已培训
- [ ] 文档已交付
- [ ] 问题已记录

**部署负责人**: _______________

**验收人**: _______________

**日期**: _______________

---

## 📞 运维支持

### 常见问题

**Q1: 程序无法启动**
- 检查 Python 是否安装
- 检查依赖是否完整
- 查看日志文件错误信息

**Q2: 音量无法调节**
- 检查音频设备是否正常
- 以管理员身份运行
- 检查 Windows Audio 服务

**Q3: 无法检测远程连接**
- 检查 WMI 服务是否运行
- 检查防火墙设置
- 查看日志诊断信息

**Q4: 服务无法启动**
- 确认以管理员权限安装
- 检查 NSSM 配置
- 查看 Windows 事件查看器

### 日志位置

默认日志文件：`remote_volume.log`（程序运行目录）

### 服务管理

```bash
# 查看服务状态
nssm status RemoteVolumeMonitor

# 停止服务
nssm stop RemoteVolumeMonitor

# 启动服务
nssm start RemoteVolumeMonitor

# 删除服务
nssm remove RemoteVolumeMonitor
```

---

**部署完成后，请将此文档上传到飞书任务管理表！**