安装与首次启动

1. 设备要求

TN 不修改、不重打包游戏本体；它通过独立进程承载运行时，并按你的操作启动游戏进程。

2. 注册与登录（NexAuth 账号）

首次启动 TN 需要 NexAuth 账号（用户名 + 密码）。未注册或未登录时，管理器只显示登录/注册界面， 不能进入管理器，也不能启动游戏。

1. 打开 TN，在登录页切换到「注册」，设置用户名与密码（密码建议 8 位以上、包含字母与数字）；
2. 注册成功会自动登录，并绑定当前设备（用作设备指纹）；
3. 若登录页提示「该应用已关闭注册」：说明当前版本暂不开放自助注册，请联系管理员开通账号；
4. 忘记密码：请通过发布渠道联系管理员重置（客户端不提供邮箱找回）。

登录凭据仅用于 NexAuth 验证；退出登录后本机需要重新登录才能进入管理器。

3. 下载与校验

1. 打开官方下载页或版本与下载，选择通道（release 稳定 / test 测试）；
2. 下载对应版本的 APK（例如当前稳定版 0.11.7），并同时记录页面上的 SHA-256；
3. 在手机上校验（Android 上可用文件管理器的「校验」功能，或电脑端 sha256sum）：

sha256sum TerraNovaLoader-0.11.7.apk
class="c"># 与下载页显示的 sha256 对比，必须完全一致

测试构建可能带有 -test、-debug 后缀，功能更新但稳定性弱于 release。

4. 安装

1. 允许当前文件管理器「安装未知应用」；
2. 打开 APK 完成安装；
3. 首次启动会请求存储权限（用于模组、日志、运行时目录），必须允许。

覆盖安装会保留 tnl_mods/、logs/、runtime/ 等应用数据。

5. 第一次启动

TN 由两个进程组成：

材质包内存提示：0.11.4 起材质包按全量加载；替换贴图常驻内存 ≈ 包内 PNG 的 RGBA 总量 （例如 Polaris ≈326 MiB），低内存设备建议使用小包或减少同时启用的高纹理量内容。

首次启动后：管理器 → 启动游戏，等待游戏进程拉起。若启动失败，管理器会显示 错误卡片，同时写入 boot.log。

6. 日志在哪

两个进程写同一个日志文件（用 proc= 字段区分）：

• 外部（优先）：/sdcard/Android/data/com.terranova.loader/files/logs/boot.log
• 内部（外部存储不可用时回退）：/data/data/com.terranova.loader/files/logs/boot.log

Android 11+ 的系统文件管理器无法直接浏览 Android/data，可把日志复制到共享目录， 或使用电脑端 adb pull /sdcard/Android/data/com.terranova.loader/files/logs/boot.log。

排障时优先提供 boot.log 的最后 100 行。