添加管理员权限功能测试说明

- 详细的测试步骤和预期结果
- 技术验证方法
- 编译状态确认
- 常见问题解答
- 后续步骤说明
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
yaofanguk
2026-04-10 22:21:09 +08:00
parent 7a812dbd69
commit 0073ec80cb

View File

@@ -0,0 +1,136 @@
# 管理员权限功能测试说明
## 编译完成 ✅
**编译时间**: 2026-04-10 21:59
**文件位置**: `dist/VideoSubtitleRemover/VideoSubtitleRemover.exe`
**文件大小**: ~77 MB
**配置状态**: uac_admin=True 已启用
## 测试步骤
### 1. 直接启动测试
```bash
cd dist/VideoSubtitleRemover
./VideoSubtitleRemover.exe
```
**预期结果**:
- Windows 会弹出 UAC用户账户控制提示
- 提示内容: "您要允许此应用对您的设备进行更改吗?"
- 显示程序名称: "视频字幕去除器"
- 显示发布者: "YaoFANGUK"
- 点击"是"后程序正常启动
### 2. 图标检查
检查 `VideoSubtitleRemover.exe` 文件图标:
- 图标上应该有一个小的"盾牌"图标
- 这表示程序需要管理员权限
### 3. 快捷方式测试
创建桌面快捷方式:
```
右键点击 VideoSubtitleRemover.exe → 发送到 → 桌面快捷方式
```
双击桌面快捷方式,应该也会触发 UAC 提示。
### 4. 右键菜单测试
```
右键点击 VideoSubtitleRemover.exe
```
应该看到:
- ✓ "以管理员身份运行" 选项(正常情况)
- ✓ "运行" 选项(会自动请求管理员权限)
## 技术验证
### PyInstaller 配置
`VideoSubtitleRemover_vsr.spec` 文件中的关键配置:
```python
exe = EXE(
# ... 其他配置
uac_admin=True, # 以管理员身份运行
)
```
### Windows 清单
程序会嵌入 UAC 清单,包含以下内容:
- `<requestedExecutionLevel level="requireAdministrator" uiAccess="false"/>`
这告诉 Windows 此程序必须以管理员身份运行。
## 编译状态
**已完成**:
- PyInstaller 配置更新
- 程序重新编译
- Git 提交和推送
**文件状态**:
- VideoSubtitleRemover.exe 已更新
- 包含 UAC 清单
- 大小: ~77 MB
**文档状态**:
- 管理员权限说明.md 已创建
- 管理员权限测试说明.md 已创建
## 后续步骤
1. **用户测试**
- 请用户在不同 Windows 版本上测试
- 验证 UAC 提示是否正常显示
- 确认程序功能是否正常
2. **安装程序更新**
- 更新 VideoSubtitleRemover.iss
- 确保安装程序也请求管理员权限
- 重新编译安装程序
3. **用户文档更新**
- 更新用户手册
- 在 GitHub README 中说明权限要求
- 提供故障排除指南
## 常见问题
**Q: 程序编译成功但没有 UAC 提示?**
A: 检查以下内容:
1. 确认 VideoSubtitleRemover_vsr.spec 中有 `uac_admin=True`
2. 确认使用的是最新编译的 exe 文件
3. 检查 Windows UAC 设置是否被禁用
**Q: 如何验证 UAC 清单已嵌入?**
A: 可以使用以下工具:
- Resource Hacker
- PE Explorer
- 或使用 Windows SDK 的 mt.exe
**Q: 如果不想请求管理员权限怎么办?**
A:
1. 修改 VideoSubtitleRemover_vsr.spec
2.`uac_admin=True` 改为 `uac_admin=False`
3. 重新编译程序
## 提交记录
```
7a812db 添加管理员权限请求和详细说明文档
```
**远程分支**: `origin/packaging-windows` 已更新
---
**测试状态**: ✅ 编译完成,等待用户测试
**文件位置**: `dist/VideoSubtitleRemover/VideoSubtitleRemover.exe`
**最后更新**: 2026-04-10 22:02