Files

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

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

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

2.3 KiB

Raw Blame History

快速开始指南

3 分钟快速上手

步骤 1：下载 nircmd（1 分钟）

64 位 Windows：

https://www.nirsoft.net/utils/nircmd-x64.zip

32 位 Windows：

https://www.nirsoft.net/utils/nircmd.zip

下载后解压，将 nircmd.exe 放到 tools\ 文件夹。

步骤 2：测试程序（1 分钟）

打开命令提示符，进入程序目录：

cd D:\Software\remote-volume-monitor-v1.0

# 测试运行
python src\remote_volume_monitor.py --test

预期输出：

✓ 音量控制器：nircmd (.\tools\nircmd.exe)
✓ RDP 监控器初始化成功
音量控制器：✓ 就绪

步骤 3：启动监控（1 分钟）

方式 1：双击启动脚本

双击 scripts\启动监控.bat

方式 2：命令行启动

python src\remote_volume_monitor.py

完成！ 程序已在后台运行。

测试功能

测试 RDP 连接

确保程序正在运行
用另一台电脑 RDP 连接到此电脑
观察音量是否自动降低到 30%
断开 RDP 连接
观察音量是否自动恢复到 80%

查看日志

打开日志文件查看运行状态：

logs\remote_volume.log

日志会显示：

每次检测的时间
RDP 连接/断开事件
音量调整记录

自定义配置

编辑 config\config.ini：

[volume]
# 远程连接时音量（0-100）
remote_volume = 30

# 本地使用音量（0-100）
local_volume = 80

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

修改后重启程序生效。

常用操作

停止程序

按 Ctrl + C 停止运行中的程序。

开机自启（可选）

方式 1：使用任务计划程序

打开任务计划程序
创建基本任务
触发器：登录时
操作：启动程序 pythonw.exe
参数：src\remote_volume_monitor.py

方式 2：使用启动文件夹

创建批处理文件
放到启动文件夹：shell:startup

遇到问题？

检查清单

Python 3.8+ 已安装
nircmd.exe 已放到 tools\ 文件夹
Windows Audio 服务正在运行
以普通用户权限运行即可

查看帮助

详细文档：docs\ 文件夹
日志文件：logs\remote_volume.log
测试工具：python src\test_rdp_detection.py

3 分钟完成设置，享受自动音量调节！

2.3 KiB Raw Blame History Unescape Escape