182 lines
3.7 KiB
Markdown
182 lines
3.7 KiB
Markdown
# 版本说明 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 - 稳定版*
|