Files

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

- Code/: 源代码、配置文件、文档、工具
- Releases/: 发布包（v1.0）
- Test/: 测试用例和测试脚本

2026-03-20 06:54:40 +08:00

5.3 KiB

Raw Blame History

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

📦 部署前准备

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. 依赖安装

# 方法 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：

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

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

[behavior]
adjust_on_connect = true
adjust_on_disconnect = true

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

步骤 3: 功能测试

运行测试模式：

python remote_volume_monitor.py --test

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

步骤 4: 手动启动测试

python remote_volume_monitor.py --config config.ini

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

步骤 5: RDP 连接测试

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

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

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

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

以管理员身份运行 CMD:

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（程序运行目录）

服务管理

# 查看服务状态
nssm status RemoteVolumeMonitor

# 停止服务
nssm stop RemoteVolumeMonitor

# 启动服务
nssm start RemoteVolumeMonitor

# 删除服务
nssm remove RemoteVolumeMonitor

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

5.3 KiB Raw Blame History Unescape Escape