重构:将 Code 文件夹内容移至仓库根目录

- 移除 Code 文件夹层级
- 源代码、文档、配置直接放在根目录
- 更新 .gitignore 排除 Releases/Test
This commit is contained in:
2026-03-20 07:08:05 +08:00
parent 4012458bcf
commit e4a53c6064
15 changed files with 0 additions and 0 deletions

124
安装 nircmd 工具.md Normal file
View File

@@ -0,0 +1,124 @@
# 安装 nircmd 工具指南
## 📥 快速安装3 步完成)
### 步骤 1下载 nircmd
**64 位 Windows推荐**
```
https://www.nirsoft.net/utils/nircmd-x64.zip
```
**32 位 Windows**
```
https://www.nirsoft.net/utils/nircmd.zip
```
**官方页面:**
```
https://www.nirsoft.net/utils/nircmd.html
```
---
### 步骤 2解压并复制
1. 解压下载的 ZIP 文件
2. 找到 `nircmd.exe` 文件
3. 复制到项目的 `tools` 文件夹:
```
D:\Software\remote-volume-monitor\tools\nircmd.exe
```
---
### 步骤 3验证安装
在项目根目录运行:
```bash
python src\remote_volume_monitor.py --test
```
**看到以下输出表示成功:**
```
✓ 音量控制器nircmd (D:\Software\remote-volume-monitor\tools\nircmd.exe)
✓ RDP 监控器初始化成功
音量控制器:✓ 就绪
使用方法nircmd
```
---
## 🧪 手动测试 nircmd
```bash
# 设置音量为 50%
.\tools\nircmd.exe setsysvolume 32767
# 设置音量为 30%
.\tools\nircmd.exe setsysvolume 19660
# 设置音量为 80%
.\tools\nircmd.exe setsysvolume 52428
# 静音
.\tools\nircmd.exe mutesysvolume 1
# 取消静音
.\tools\nircmd.exe mutesysvolume 0
```
---
## 📁 最终文件结构
```
remote-volume-monitor/
├── tools/
│ ├── README.md
│ └── nircmd.exe ← 你放入的文件
├── src/
│ ├── remote_volume_monitor.py
│ └── volume_control.py
├── config/
│ └── config.ini
├── docs/
├── logs/
├── scripts/
├── tests/
├── README.md
└── requirements.txt
```
---
## 💡 常见问题
### Q: 下载后是 .zip 文件怎么办?
A: 右键 → 解压到当前文件夹,然后提取 nircmd.exe
### Q: 需要安装吗?
A: 不需要nircmd 是绿色软件,直接运行即可
### Q: 杀毒软件报警怎么办?
A: 这是误报。nircmd 是知名免费工具,可以添加信任
### Q: 可以放到其他位置吗?
A: 可以,但需要放到系统 PATH 或 tools 文件夹才能被自动检测
---
## 📞 完成安装后
运行测试模式确认一切正常:
```bash
cd D:\Software\remote-volume-monitor
python src\remote_volume_monitor.py --test
```
然后就可以正常使用远程音量监控功能了!
---
*nircmd 是 NirSoft 的免费工具,更多信息请访问 https://www.nirsoft.net/*