高级功能 on 哪吒美式用户手册

文件管理

Wed, 11 Mar 2026 00:00:00 +0000

文件管理#

功能简介#

文件管理功能提供完整的文件系统浏览和管理能力，支持查看、创建、删除、重命名、复制和移动文件，以及修改文件权限和所有者，是进行文件系统维护的核心工具。

功能特性#

文件浏览和操作#

文件列表浏览：以列表形式显示目录中的所有文件和子目录
多选操作：支持同时选择多个文件进行批量操作
文件创建：在指定目录下创建新文件
文件删除：删除单个或多个文件
文件重命名：修改文件名称
文件复制/移动：复制或移动文件到其他位置

高级功能#

权限修改：使用 chmod 命令修改文件的读写执行权限
所有者修改：使用 chown 命令修改文件的所有者和所有组
软链接处理：正确处理符号链接，支持跟随链接和识别破损链接
APK 信息提取：显示 APK 文件的包名、版本、签名等详细信息
快速路径导航：快速跳转到常用目录（如 /data、/sdcard 等）
文件过滤和排序：按名称、大小、修改时间等排序，支持文件类型过滤

操作步骤#

进入"文件管理"选择目标目录或使用快速路径导航。
查看目录中的文件和子目录列表。
执行所需操作：
- 创建：点击"新建"填写文件名
- 删除：选择文件后点击"删除"确认
- 重命名：长按文件或点击"编辑"输入新名称
- 复制/移动：选择文件后指定目标目录
对于 APK 文件，点击可查看详细的包信息。
若需修改权限，选择文件后点击"权限设置"。
完成操作后刷新目录确认结果。

注意事项#

删除前先核对：删除前再次确认是否为关键数据或系统文件，避免误删导致功能异常。
不要删除系统目录：避免删除 /system、/data 等系统关键目录下的核心文件。
谨慎修改权限：不恰当的权限修改会导致应用无法访问文件或系统异常。
定期整理：建议定期整理乾坤守护录制、乾坤视界视频等大文件目录。
备份重要数据：对于重要文件的大规模操作前，建议先进行备份。
软链接处理：删除软链接时只会删除链接本身，不会删除目标文件。
权限修复：如果某应用突然无法读取文件，可能是权限被误修改，建议恢复权限。

Debug 区域

Wed, 11 Mar 2026 00:00:00 +0000

Debug 区域#

功能简介#

Debug 区域提供多个调试页面的聚合入口，用于查看系统诊断信息、调试车机属性、摄像头预览等，是定位系统异常和问题排查的必需工具。

功能特性#

车机属性调试（CarProp Debug）#

实时读取和修改：对车机属性进行实时读写操作
多区域支持：支持不同 AreaId 的属性查询和修改
值范围限制：显示属性值的有效范围和单位
枚举选项：对于枚举类属性显示所有可选值
属性搜索：快速搜索和定位特定属性

导航信息调试（Navi Debug）#

JSON 展示：以 JSON 格式显示实时导航信息
信息刷新：实时更新导航状态和路线信息

摄像头调试（Camera Debug）#

多摄像头预览：支持预览车上多个摄像头的实时画面
切换预览：在不同摄像头间快速切换
调试参数：显示摄像头分辨率、帧率等参数

悬浮窗测试（Custom Floating Window Test）#

窗口拖动：测试悬浮窗的拖动功能
尺寸调整：调整悬浮窗的宽度和高度

屏幕选择测试（Screen Picker）#

触点选择：用于测试屏幕各区域的触摸响应

操作步骤#

进入"Debug 区域"查看所有可用的调试工具。
根据需要进入相应的调试页面：
- 车机属性：搜索属性名称或 ID，查看当前值，必要时修改值后确认
- 导航调试：查看 JSON 格式的导航信息，了解当前导航状态
- 摄像头：选择摄像头进行预览，调整显示参数
- 悬浮窗：拖动窗口测试响应，调整窗口大小
记录调试过程中的关键信息（时间点、错误提示等）。
完成排查后恢复常用设置或退出 Debug 区域。

注意事项#

谨慎修改属性：不熟悉的属性修改可能导致系统异常，建议先只读查看。
备份配置：在进行批量属性修改前，建议先保存或截图当前配置。
一项一改：调试时每次只修改一个属性，便于定位问题根因。
恢复步骤：若修改后出现异常，立即恢复为修改前的值。
权限要求：某些属性修改可能需要特权权限，无权限时无法修改。
车型相关：不同车型支持的属性不同，某些属性可能在您的车型中不可用。
日志记录：重要的调试操作建议保存系统日志，便于后续分析。

Shell

Wed, 11 Mar 2026 00:00:00 +0000

Shell#

功能简介#

Shell 提供高级的命令行执行入口，支持执行系统命令和 ADB shell 命令，适合有经验的用户进行定向维护操作、系统诊断和问题排查。

功能特性#

命令执行：支持执行 ADB shell 命令和本地系统命令
输出捕获：捕获命令的标准输出（stdout）和标准错误输出（stderr）
超时控制：设置命令执行的最大超时时间（默认 30 秒）
命令历史记录：自动保存命令执行历史
快速调用：从历史记录中快速重新执行曾用过的命令
持久化存储：命令历史持久化保存，应用重启后仍可访问

常用命令示例#

系统信息查询#

# 查看系统版本
getprop ro.build.version.release

# 查看 Android SDK 版本
getprop ro.build.version.sdk

# 查看车型和 VIN
getprop ro.hozon.car.vin

文件和目录操作#

# 列出目录内容
ls -la /sdcard/

# 查看文件大小
du -sh /path/to/file

# 查看可用存储空间
df -h

进程和性能#

# 查看运行的进程
ps aux

# 查看内存使用情况
free -h

# 查看 CPU 信息
cat /proc/cpuinfo

日志查询#

# 查看实时日志
logcat -v time

# 查看特定应用日志
logcat -v time | grep io.github.netamade

操作步骤#

进入"Shell"。
点击输入框并输入要执行的命令。
点击"执行"或按 Enter 运行命令。
查看命令输出结果，理解执行是否成功。
若需要再次执行相同或相似命令，从历史记录中快速调用。
完成调试后，根据需要导出输出结果或截图保存。

注意事项#

谨慎执行：不确定含义的操作不要执行，特别是涉及删除、修改权限的命令。
单步变更：每次只执行一项变更命令，便于回退排查。
理解后执行：执行之前先查阅文档或手册理解命令的完整含义。
破坏性命令：避免执行 rm -rf、mkfs 等高风险命令，除非完全确定操作对象。
权限要求：某些命令需要 root 权限才能执行，无权限时请使用 su 切换。
超时设置：长时间运行的命令可能超时，建议设置合理的超时时间。
输出大小：大量输出的命令可能导致界面响应缓慢，建议使用 grep 进行过滤。
网络命令：网络相关的命令执行前请确保网络连接正常。

系统日志

Wed, 11 Mar 2026 00:00:00 +0000

系统日志#

功能简介#

系统日志功能用于查看和管理车机的实时日志，提供灵活的日志筛选、搜索、导出和分析功能，是诊断系统问题、定位崩溃、卡顿和连接异常的重要工具。

功能特性#

日志查看#

实时日志流：显示实时生成的系统日志（通过 logcat -T）
历史日志查看：查看已保存的历史日志文件
全部历史加载：一次性加载所有历史日志用于全局搜索

日志筛选和搜索#

日志过滤：按应用、模块或日志标签进行过滤
关键字搜索：快速搜索特定的错误信息或事件
日志级别标记：彩色标记不同级别的日志（DEBUG、INFO、WARN、ERROR）
时间范围筛选：按时间范围查看特定时段的日志

日志管理#

日志导出：将选中的日志片段导出到文件
日志清空：清除历史日志文件
多类别聚合：同时查看应用、特权进程和崩溃日志

操作步骤#

进入"系统日志"。
选择要查看的日志类型：
- 实时日志：查看当前生成的实时日志
- 历史日志：查看之前保存的日志文件
使用时间范围筛选或关键字搜索定位问题日志。
点击日志条目查看详细信息。
复制或导出需要的日志片段用于问题分析。
根据日志时间线复盘问题发生的全过程。
完成分析后，可清空历史日志释放存储空间。

常见日志分析场景#

应用崩溃#

搜索关键字"crash"、“exception"或"ANR”，定位崩溃时刻和栈跟踪信息。

连接异常#

查看"ADB"、“CONNECTION"等日志标签，排查网络连接问题。

卡顿问题#

搜索"ANR”（Application Not Responding）或"jank"，分析卡顿原因。

功能异常#

按功能模块搜索日志标签（如 WORKFLOW、GUARDIAN、DASHCAM 等），查看功能执行日志。

注意事项#

文件大小：日志文件可能较大（特别是长期运行的日志），建议按时间段筛选以提高效率。
隐私保护：日志中可能包含位置、电话号码等隐私信息，分享日志前先检查并脱敏。
日志保留期：旧的日志会被自动删除，重要的日志应及时导出和备份。
搜索技巧：使用正则表达式进行高级搜索，可更灵活地定位问题日志。
导出格式：导出的日志文件建议保存为文本格式，便于后续的文本编辑和共享。
日志级别：错误（ERROR）和警告（WARN）日志通常是问题诊断的重点。
时间同步：日志分析时请确保系统时间准确，时间错误会导致日志顺序混乱。

高级车辆控制

Wed, 11 Mar 2026 00:00:00 +0000

高级车辆控制#

功能简介#

高级车辆控制用于调整更细粒度的车辆配置参数，包括清空方向盘按键映射、NNP 考试模式绕过、编辑车辆配置文件等，适合需要深度定制的用户和技术人员。

功能特性#

方向盘控制#

长按功能清空：清除系统绑定的方向盘长按功能，恢复默认状态
映射重置：重置所有方向盘按键的功能映射

NNP 考试模式#

考试模式绕过：通过修改系统配置绕过 NNP 考试限制

注意：此功能已证实无效。即便绕过车机端的 NNP 考试模式检查，在完成车道线校准后仍然无法开启 NNP 模式，因为 NNP 限制来自云端校验，车机端修改无法突破云端限制。该功能保留但不建议使用。

~~权限修改~~：自动处理必要的文件系统权限变更
~~应用重启~~：自动重启应用使配置生效

车辆配置#

配置文件编辑：直接编辑车辆的系统配置文件（XML 格式）
配置项查看：浏览和理解所有可用的配置参数

操作步骤#

进入"高级车辆控制"。
进行操作前，先查看当前配置的快照或截图保存。
仅选择一个参数或功能进行调整，避免同时进行多项改动。
执行选定的操作：
- 清空方向盘功能：点击"重置"按钮
- ~~绕过 NNP 模式~~：此功能已无效，不建议使用
- 编辑配置：打开编辑器，修改配置参数后保存
保存修改并等待应用重启。
重启后在安全的静止场景下进行验证（如停车状态）。
如果效果不理想或出现异常，使用之前保存的配置快照进行恢复。

高级配置说明#

方向盘映射恢复#

清空方向盘长按功能后，所有按键会恢复到原厂配置。如需自定义按键功能，请通过普通设置界面重新配置。

NNP 考试模式（已废弃）#

此功能在早期版本中被认为可能有用，但实际测试证明无效：

仅能绕过车机端的检查
NNP 限制真正来自云端校验，无法通过本地修改突破
即使绕过车机端的 NNP 考试检查，完成车道线校准后仍然无法启用 NNP 模式
云端校验会拒绝接受任何非法的 NNP 授权请求

因此该功能已无实际用途，不建议使用。

注意事项#

停车状态操作：所有操作都建议在车辆停止且防止误操作的状态下完成。
单项调整：未确认影响范围前不要进行批量修改，每次只调整一个参数。
配置备份：对于重要的配置变更，建议先保存当前配置的备份。
恢复机制：所有修改都可以通过恢复之前的配置快照来回滚。
风险警告：不了解配置参数含义时，不要尝试修改，可能导致功能异常。
系统稳定性：某些配置参数修改会影响系统的整体稳定性和安全性。
技术支持：若对配置不确定，建议咨询厂商技术人员或专业人士后再进行修改。
测试验证：修改后一定要在不同场景下进行充分测试，确保功能正常。