重构：将 Code 文件夹内容移至仓库根目录
- 移除 Code 文件夹层级 - 源代码、文档、配置直接放在根目录 - 更新 .gitignore 排除 Releases/Test
This commit is contained in:
254
docs/部署检查清单_远程音量控制.md
Normal file
254
docs/部署检查清单_远程音量控制.md
Normal file
@@ -0,0 +1,254 @@
|
||||
# 远程音量控制 - 部署检查清单
|
||||
|
||||
## 📦 部署前准备
|
||||
|
||||
### 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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**部署完成后，请将此文档上传到飞书任务管理表！**
|
||||
Reference in New Issue
Block a user