GoudanLabs/remote-volume-monitor
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity
Files
45e7d9553abac1fdd7f1f9cd3c9545833c6d681b
remote-volume-monitor/Releases/remote-volume-monitor-v1.0/版本说明_V1.0.md
Agent 45e7d9553a Initial commit - 按新规范整理目录结构 
- Code/: 源代码、配置文件、文档、工具
- Releases/: 发布包（v1.0）
- Test/: 测试用例和测试脚本
2026-03-20 06:54:40 +08:00

3.7 KiB
Raw Blame History

版本说明 V1.0

📦 发布信息

  • 版本号： V1.0
  • 发布日期： 2026-03-07
  • 类型： 稳定版
  • 依赖： 零第三方 Python 依赖

✨ 核心功能

1. RDP 连接自动检测

  • 检测远程桌面连接建立
  • 检测远程桌面连接断开
  • 区分活跃连接和已断开会话
  • 检测间隔可配置（默认 5 秒）

2. 音量自动调节

  • 连接时自动降低音量（默认 30%）
  • 断开时自动恢复音量（默认 80%）
  • 支持 nircmd 精确控制
  • 支持 Core Audio API（备用）
  • 支持 PowerShell（备用）

3. 多方案音量控制

方案 精度 可靠性 依赖
nircmd ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ 需下载 35KB 工具
Core Audio ⭐⭐⭐⭐⭐ ⭐⭐⭐ 无
PowerShell ⭐⭐⭐ ⭐⭐⭐⭐ 无

🔧 技术特性

零依赖

  • 仅使用 Python 标准库
  • 无需 pip install
  • 开箱即用

智能降级

  • 优先使用 nircmd（最佳体验）
  • 自动降级到 Core Audio
  • 最后使用 PowerShell 备用

可靠检测

  • 基于 query user 命令
  • 区分 active/disc 状态
  • 避免误判断开会话

详细日志

  • DEBUG 级别日志输出
  • 实时记录检测状态
  • 便于故障排查

📁 发布包内容

必要文件

  • src/remote_volume_monitor.py - 主程序
  • config/config.ini - 配置文件
  • scripts/启动监控.bat - 启动脚本
  • tools/README.md - 工具说明
  • README.md - 项目说明
  • requirements.txt - 依赖说明

文档

  • docs/部署检查清单_远程音量控制.md
  • docs/音量控制方案说明.md
  • 快速开始.md
  • 版本说明_V1.0.md

空目录

  • logs/ - 日志目录（运行时自动创建）
  • tools/ - 工具目录（需放入 nircmd.exe）

🚀 使用场景

场景 1：办公室远程办公

  • 上班时 RDP 连接公司电脑
  • 音量自动降低，避免打扰同事
  • 下班断开 RDP，音量自动恢复

场景 2：家庭多媒体中心

  • 远程管理 HTPC 时自动降低音量
  • 本地观看视频时保持正常音量
  • 无需手动调节

场景 3：服务器管理

  • 远程管理服务器时静音
  • 避免意外音频输出
  • 本地使用时恢复正常

📊 性能指标

指标 数值
CPU 占用 < 0.1%
内存占用 ~20-30 MB
检测延迟 ≤ 5 秒（可配置）
启动时间 < 1 秒
安装包大小 ~50 KB（不含 nircmd）

🐛 已知限制

1. 音量获取

  • nircmd 方案不支持获取当前音量
  • Core Audio 方案支持获取音量
  • 不影响核心功能

2. Windows 版本

  • 仅支持 Windows 10/11
  • 不支持 Windows 7/8
  • 不支持 Linux/macOS

3. N 版本系统

  • Windows N 版本可能缺少媒体功能
  • 建议安装 nircmd 获得最佳体验

🔮 未来计划

V1.1（计划中）

  • 系统托盘图标
  • 图形化配置界面
  • 多显示器支持
  • 音量渐变过渡

V2.0（规划中）

  • 事件驱动检测（替代轮询）
  • 支持蓝牙耳机
  • 多用户配置
  • 音量曲线自定义

📞 反馈与支持

日志文件

logs\remote_volume.log

诊断工具

# RDP 连接检测
python src\test_rdp_detection.py

# RDP 断开检测
python src\test_rdp_disconnect.py

常见问题

详见 docs\ 文件夹中的文档

📝 更新历史

V1.0 (2026-03-07)

  • ✅ 初始稳定版发布
  • ✅ 零第三方依赖实现
  • ✅ nircmd/Core Audio/PowerShell 多方案支持
  • ✅ RDP 连接/断开自动检测
  • ✅ 音量自动调节
  • ✅ 详细日志输出
  • ✅ 配置可自定义

远程音量监控工具 V1.0 - 稳定版

Reference in New Issue View Git Blame Copy Permalink