diff --git a/管理员权限测试说明.md b/管理员权限测试说明.md new file mode 100644 index 0000000..14da4ae --- /dev/null +++ b/管理员权限测试说明.md @@ -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 清单,包含以下内容: +- `` + +这告诉 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