# 版本说明 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 - 稳定版*