Sam Helper 权限被拒绝或失效的排查清单

权限层级总览

Sam Helper 的功能依赖不同层级的权限，从基础到高级依次是：

普通权限（存储/应用列表）
    ↓
特殊权限（所有文件访问）
    ↓
系统权限（Shizuku/ADB 授权 WRITE_SECURE_SETTINGS）
    ↓
Root 权限（Magisk，触发 Knox 熔断）

当前一级权限失效，对应层级的功能就无法工作。

排查清单

第一层：普通权限

设置 → 应用程序 → Sam Helper → 权限

• [ ] 存储 → 允许
• [ ] 应用列表 → 允许所有应用
• [ ] 无障碍 → 可选但推荐

第二层：特殊权限

设置 → 应用程序 → Sam Helper → 特殊访问

• [ ] 所有文件访问权限 → 允许
• [ ] 忽略电池优化 → 允许（防止后台被杀）
• [ ] 显示在其他应用上层 → 部分版本需要

第三层：Shizuku / ADB 系统权限

这层是 Sam Helper 高级功能的关键：

检查 Shizuku 状态：

1. 下拉通知栏看 Shizuku 是否显示「正在运行」
2. Shizuku 应用 → 设置 → 确认 Sam Helper 在授权列表中
3. 删除授权重新授权（有时候会莫名其妙失效）

检查 ADB 权限（如果用 ADB 方案）：

adb shell dumpsys package com.litebyte.samhelper | findstr WRITE_SECURE

如果输出中 WRITE_SECURE_SETTINGS 出现在 granted=true 后面，说明权限还在。

第四层：Root 权限（可选）

如果设备已 Root 且 Sam Helper 需要：

• [ ] Magisk 已安装且正常运行
• [ ] Knox 融合位 = 1（已不可逆熔断）
• [ ] Sam Helper 在 Magisk 白名单中

权限修复优先级

建议按以下顺序排查修复：

1. 先确认普通权限（最简单）
2. 再检查特殊权限
3. Shizuku/ADB 重新授权（最常见的失效原因）
4. 最后考虑清理 Sam Helper 数据重来（最彻底）

权限修复后的验证

修复后，依次测试以下功能确认权限层级恢复：