mirror of
https://github.com/YaoFANGUK/video-subtitle-remover.git
synced 2026-05-03 07:07:31 +08:00
添加管理员权限功能测试说明
- 详细的测试步骤和预期结果 - 技术验证方法 - 编译状态确认 - 常见问题解答 - 后续步骤说明 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
136
管理员权限测试说明.md
Normal file
136
管理员权限测试说明.md
Normal 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
|
||||
Reference in New Issue
Block a user