Initial commit - 按新规范整理目录结构
- Code/: 源代码、配置文件、文档、工具 - Releases/: 发布包(v1.0) - Test/: 测试用例和测试脚本
This commit is contained in:
139
Releases/remote-volume-monitor-v1.0/快速开始.md
Normal file
139
Releases/remote-volume-monitor-v1.0/快速开始.md
Normal file
@@ -0,0 +1,139 @@
|
||||
# 快速开始指南
|
||||
|
||||
## 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 分钟)
|
||||
|
||||
打开命令提示符,进入程序目录:
|
||||
```bash
|
||||
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:命令行启动**
|
||||
```bash
|
||||
python src\remote_volume_monitor.py
|
||||
```
|
||||
|
||||
**完成!** 程序已在后台运行。
|
||||
|
||||
---
|
||||
|
||||
## 测试功能
|
||||
|
||||
### 测试 RDP 连接
|
||||
|
||||
1. 确保程序正在运行
|
||||
2. 用另一台电脑 RDP 连接到此电脑
|
||||
3. 观察音量是否自动降低到 30%
|
||||
4. 断开 RDP 连接
|
||||
5. 观察音量是否自动恢复到 80%
|
||||
|
||||
### 查看日志
|
||||
|
||||
打开日志文件查看运行状态:
|
||||
```
|
||||
logs\remote_volume.log
|
||||
```
|
||||
|
||||
日志会显示:
|
||||
- 每次检测的时间
|
||||
- RDP 连接/断开事件
|
||||
- 音量调整记录
|
||||
|
||||
---
|
||||
|
||||
## 自定义配置
|
||||
|
||||
编辑 `config\config.ini`:
|
||||
|
||||
```ini
|
||||
[volume]
|
||||
# 远程连接时音量(0-100)
|
||||
remote_volume = 30
|
||||
|
||||
# 本地使用音量(0-100)
|
||||
local_volume = 80
|
||||
|
||||
[monitor]
|
||||
# 检测间隔(秒)
|
||||
check_interval = 5
|
||||
```
|
||||
|
||||
修改后重启程序生效。
|
||||
|
||||
---
|
||||
|
||||
## 常用操作
|
||||
|
||||
### 停止程序
|
||||
|
||||
按 `Ctrl + C` 停止运行中的程序。
|
||||
|
||||
### 开机自启(可选)
|
||||
|
||||
**方式 1:使用任务计划程序**
|
||||
1. 打开任务计划程序
|
||||
2. 创建基本任务
|
||||
3. 触发器:登录时
|
||||
4. 操作:启动程序 `pythonw.exe`
|
||||
5. 参数:`src\remote_volume_monitor.py`
|
||||
|
||||
**方式 2:使用启动文件夹**
|
||||
1. 创建批处理文件
|
||||
2. 放到启动文件夹:`shell:startup`
|
||||
|
||||
---
|
||||
|
||||
## 遇到问题?
|
||||
|
||||
### 检查清单
|
||||
|
||||
- [ ] Python 3.8+ 已安装
|
||||
- [ ] nircmd.exe 已放到 `tools\` 文件夹
|
||||
- [ ] Windows Audio 服务正在运行
|
||||
- [ ] 以普通用户权限运行即可
|
||||
|
||||
### 查看帮助
|
||||
|
||||
- 详细文档:`docs\` 文件夹
|
||||
- 日志文件:`logs\remote_volume.log`
|
||||
- 测试工具:`python src\test_rdp_detection.py`
|
||||
|
||||
---
|
||||
|
||||
*3 分钟完成设置,享受自动音量调节!*
|
||||
Reference in New Issue
Block a user