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

- 移除 Code 文件夹层级 - 源代码、文档、配置直接放在根目录 - 更新 .gitignore 排除 Releases/Test
2026-03-20 07:08:05 +08:00
parent 4012458bcf
commit e4a53c6064
15 changed files with 0 additions and 0 deletions
--- a/docs/README_零依赖版本说明.md
+++ b/docs/README_零依赖版本说明.md
@@ -0,0 +1,218 @@
+# 零依赖版本说明
+
+## 🎯 版本特性
+
+本版本已完全移除所有第三方 Python 依赖，仅使用 Python 标准库实现全部功能。
+
+---
+
+## 📦 依赖对比
+
+### 原版本（已废弃）
+```
+pycaw>=20181226      # Windows 音频控制
+comtypes>=1.1.10     # COM 接口支持
+wmi>=1.5.1           # WMI 会话检测
+pywin32>=305         # Windows API
+```
+
+### 零依赖版本（当前）
+```
+无 Python 第三方依赖！仅使用标准库：
+- ctypes           # Windows API 调用
+- os               # 环境变量检测
+- subprocess       # 系统命令执行
+- winreg           # 注册表访问
+- configparser     # 配置文件解析
+```
+
+---
+
+## 🔧 技术实现
+
+### 1. RDP 远程连接检测
+
+使用三种标准库方法，按优先级：
+
+| 方法 | 实现 | 可靠性 |
+|------|------|--------|
+| 环境变量 `SESSIONNAME` | `os.environ.get('SESSIONNAME')` | ⭐⭐⭐⭐⭐ |
+| 系统命令 `query user` | `subprocess.run(['query', 'user'])` | ⭐⭐⭐⭐ |
+| 注册表检查 | `winreg` 模块 | ⭐⭐⭐ |
+
+### 2. Windows 音量控制
+
+**主方案：Windows Core Audio API（ctypes 调用）**
+- 直接调用 `IMMDeviceEnumerator` 和 `IAudioEndpointVolume` COM 接口
+- 无需 pycaw/comtypes，纯 ctypes 实现
+- 支持精确设置和获取音量（0-100%）
+
+**备用方案 1：nircmd 工具**
+- 如果系统有 nircmd.exe，自动使用
+- 命令：`nircmd setsysvolume <0-65535>`
+- 可靠性高，但需要额外下载
+
+**备用方案 2：PowerShell**
+- 当 Core Audio API 失败时使用
+- 功能受限，仅支持设置音量
+
+---
+
+## 📋 部署步骤
+
+### 步骤 1：确认环境
+```bash
+# 检查 Python 版本（需要 3.8+）
+python --version
+
+# 检查是否在 Windows 上
+ver
+```
+
+### 步骤 2：复制文件
+```
+remote-volume-monitor/
+├── src/remote_volume_monitor.py    # 主程序
+├── config/config.ini                # 配置文件
+├── scripts/启动监控.bat             # 启动脚本
+└── logs/                            # 日志目录（自动创建）
+```
+
+### 步骤 3：运行测试
+```bash
+# 测试模式（检测一次后退出）
+python src/remote_volume_monitor.py --test
+
+# 获取当前音量
+python src/remote_volume_monitor.py --get-volume
+
+# 设置音量测试
+python src/remote_volume_monitor.py --set-volume 50
+```
+
+### 步骤 4：正式运行
+```bash
+# 使用默认配置
+python src/remote_volume_monitor.py
+
+# 使用启动脚本（Windows）
+scripts\启动监控.bat
+
+# 指定配置文件
+python src/remote_volume_monitor.py --config config/config.ini
+```
+
+---
+
+## ⚠️ 注意事项
+
+### Windows 系统要求
+- ✅ Windows 10/11（推荐）
+- ⚠️ Windows 8/8.1（可能部分功能受限）
+- ❌ Windows 7（不支持 Core Audio API）
+- ❌ Linux/macOS（仅支持 Windows）
+
+### 权限要求
+- 普通用户权限即可运行
+- 安装 Windows 服务需要管理员权限
+
+### 音频设备要求
+- 必须有活跃的音频输出设备
+- 蓝牙/USB 音频设备可能需要在连接后重新初始化
+
+---
+
+## 🐛 故障排查
+
+### 问题 1：音量控制器初始化失败
+**症状：** 日志显示 `✗ 音量控制器初始化失败`
+
+**原因：**
+- 非 Windows 系统
+- 没有音频设备
+- 音频服务未运行
+
+**解决：**
+1. 确认在 Windows 上运行
+2. 检查音频设备是否正常
+3. 重启 Windows Audio 服务
+
+### 问题 2：无法检测 RDP 连接
+**症状：** 远程连接后音量不变化
+
+**检查：**
+```bash
+# 查看当前会话名
+echo %SESSIONNAME%
+
+# 查看活跃会话
+query user
+```
+
+**解决：**
+- 确保是 RDP 连接（不是本地登录）
+- 检查远程桌面服务是否运行
+
+### 问题 3：日志文件找不到
+**症状：** 找不到 `remote_volume.log`
+
+**说明：** 日志现在保存在 `logs/` 目录
+```
+remote-volume-monitor/logs/remote_volume.log
+```
+
+---
+
+## 📊 性能对比
+
+| 指标 | 原版本 | 零依赖版本 |
+|------|--------|-----------|
+| Python 依赖 | 4 个第三方库 | 0 个 |
+| 安装包大小 | ~5MB | ~30KB |
+| 启动时间 | ~2 秒 | ~0.5 秒 |
+| 内存占用 | ~40MB | ~15MB |
+| 功能完整性 | 100% | 100% |
+
+---
+
+## 🔄 升级说明
+
+从原版本升级：
+
+1. **备份配置文件**
+   ```bash
+   copy config\config.ini config\config.ini.bak
+   ```
+
+2. **替换主程序**
+   ```bash
+   # 删除旧版本
+   del src\remote_volume_monitor.py
+   
+   # 复制新版本
+   copy remote_volume_monitor_v2.py src\remote_volume_monitor.py
+   ```
+
+3. **卸载第三方库（可选）**
+   ```bash
+   pip uninstall pycaw comtypes wmi pywin32
+   ```
+
+4. **测试运行**
+   ```bash
+   python src\remote_volume_monitor.py --test
+   ```
+
+---
+
+## 📞 技术支持
+
+如遇到问题，请查看：
+- 日志文件：`logs/remote_volume.log`
+- 部署检查清单：`部署检查清单_远程音量控制.md`
+- 测试用例：`tests/测试用例_远程音量控制.md`
+
+---
+
+*文档版本：v2.0（零依赖版本）*
+*最后更新：2026-03-07*