Initial commit - 按新规范整理目录结构
- Code/: 源代码、配置文件、文档、工具 - Releases/: 发布包（v1.0） - Test/: 测试用例和测试脚本
This commit is contained in:
181
Releases/remote-volume-monitor-v1.0/版本说明_V1.0.md
Normal file
181
Releases/remote-volume-monitor-v1.0/版本说明_V1.0.md
Normal file
@@ -0,0 +1,181 @@
|
||||
# 版本说明 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
|
||||
```
|
||||
|
||||
### 诊断工具
|
||||
```bash
|
||||
# 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
Block a user