常见问题
安装相关
安装时提示「未检测到 Zygisk 实现」
Device Faker 不支持 Magisk 自带的 Zygisk。必须先安装第三方 Zygisk 实现（推荐 ZygiskNext），重启后再安装本模块。
支持 Magisk 自带的 Zygisk 吗？
不支持。Magisk 内置 Zygisk 的隐藏性不能满足本模块的运行要求。
安装后模块不生效
- 是否已安装并启用 Zygisk 实现？
- 安装完成后是否重启了设备？
- 配置文件路径是否正确：
/data/adb/device_faker/config/config.toml - 目标应用的包名是否写对？
更新模块后配置会丢吗？
覆盖安装时，默认会保留现有配置（除非在安装选择窗口按了音量 + 使用默认配置）。
卸载会删除配置
卸载模块时会执行 rm -rf /data/adb/device_faker，配置目录会被一并删除。需要保留配置请先手动备份。
配置相关
配置改了没生效
- 配置是热加载，修改后需要重启目标应用，不是重启系统
- 检查
config.toml是否有语法错误：TOML 对引号、缩进敏感，一个缺失的引号会导致整份配置解析失败 - 检查目标应用是否命中了
[[apps]]或模板的packages
/data/adb/device_faker/config/config.toml 找不到
首次安装时如果按了音量 + 选择使用默认配置，配置路径就是上述路径。如果目录不存在，说明安装后未重启或安装被中止。
优先级到底怎么算？
[[apps]] 直接配置 > 模板 packages 列表 > 全局默认值一旦命中 [[apps]]，该记录整体取代模板，未设置的字段不会回落到模板。
怎么只对某个用户（工作资料 / 多开）生效？
在包名后追加 @userId：
toml
[[apps]]
package = "com.example.app@999"
model = "FakeModel"匹配顺序：先匹配 @999，找不到再回退匹配无后缀的包名。
配置写错了会怎样？
- 单条
[[apps]]缺少package：整份配置解析失败，所有应用都不伪装 - 某个字段值无效：该字段会被静默忽略（如未知字段）
- 某条模板写错：只影响命中该模板的应用
属性与性能
DELETE 和留空有什么区别？
| 写法 | 行为 |
|---|---|
结构化字段省略或 "" | 不修改该字段 |
custom_props 里 "key" = "" | 把该属性设为空字符串 |
custom_props 里 "key" = "__EMPTY__" | 把该属性设为空字符串 |
custom_props 里 "key" = "__DELETE__" | 删除该属性 |
WebUI 相关
在线模板库加载失败
- 检查设备网络连接
- 模板源地址：https://github.com/Seyud/device_faker_config
- 部分地区访问 GitHub 需要网络工具