进阶排查指南
一份带日志的反馈，顶十份截图。这一页给会用 adb、或者愿意折腾一下的人。
一、游戏自己的日志（首选）
客户端补丁层的日志（CNLog）写在应用私有目录：
/data/data/io.kamihama.totentanz/log/下载失败、热更回滚、换线过程、崩溃前最后的动作，都在这里。 报问题时把这个目录整个打包附上，基本能回答九成的「当时发生了什么」。
导出方式（客户端是 release 包，未开 android:debuggable——run-as 对 非 debuggable 应用会拒绝。只有 root / su 或模拟器等能直写应用私有目录的 环境才能拿到）：
# root 设备：直接打整个私有目录
adb shell "su -c 'tar czf /sdcard/cnlog.tgz -C /data/data/io.kamihama.totentanz log'"
adb pull /sdcard/cnlog.tgz没有 root？优先用浮层自带的 LOG 导出（见下面 tip），或把日志截图发来； 再不行，反馈时说明情况，我们给你可用的采集办法。
下载阶段的浮层自带日志
资源下载 / 热更新浮层左上角有个 LOG 胶囊，点进去就是当前日志， 截图发来也行——适合不想开 adb 的情况。
二、logcat（崩溃/闪退必备）
闪退、黑屏、卡死类问题，logcat 里有堆栈：
# 崩溃发生后立刻抓（别重启游戏，日志会被冲掉）
adb logcat -d > logcat.txt
# 只要补丁层与引擎相关的（噪音小很多）
adb logcat -d -s MagiaCN_Legacy:V AndroidRuntime:E > logcat.txt抓完把 logcat.txt 附到 Issue。
三、调试开关目录（协助二分定位）
/data/data/io.kamihama.totentanz/debug/ 下建一个同名空文件 = 打开开关， 删掉 = 关闭，重启游戏生效（release 包未开 debuggable，需 root / su 才能写 这个目录，与上面的日志导出同权限要求）。开关一律只做一件事： 把客户端退回更接近原包的行为，用来回答「是哪一步把游戏搞挂的」。
常用的几个：
| 开关 | 效果 | 用来定位 |
|---|---|---|
logI18nMiss | 把「流经 native 文本 hook 但没翻到」的日文打进 logcat | 收集漏翻（方法见仓库 i18n/README） |
logI18nMissAll | 同上但不筛字符集（噪音大） | 确认英文/纯汉字串走不走 native 层 |
skipOverlay | 不出现下载浮层 | 浮层本身导致的卡死 |
failDownload | 注入下载失败 | 协助复现换线/重试问题 |
完整开关表与边界规则见仓库 README 的「调试开关目录」一节。
用完记得删
开关是为排查设计的退化行为，开着某些开关游戏本来就不会正常。 排查完把 debug/ 里自己建的文件删掉，免得下次把「自己开的开关」当成新 bug 报上来。
四、报漏翻的快速方法
（需要 root / su 能写应用私有目录，与上面调试开关同权限要求）
# root 设备：打开 logI18nMiss 开关
adb shell "su -c 'touch /data/data/io.kamihama.totentanz/debug/logI18nMiss'"
# 重启游戏，把漏翻的画面走一遍，然后：
adb logcat -d -s MagiaCN_Legacy | sed -n 's/.*\[i18n-miss\]\[[^]]*\] //p' | sort -u > miss.tsvmiss.tsv 就是现成的「日文原文清单」，直接附到 误译/漏翻 Issue。
没有 root 也能报漏翻
不进游戏也能报：直接把看到的日文句子 + 截图发到 误译/漏翻 Issue， 标注大致出处（哪章哪话/哪个按钮），我们定位后仍会修。
五、信息 checklist
进阶反馈请带齐：
- [ ] 构建号（
1.0.xx）与设备/ROM/Android 版本 - [ ]
log/目录打包 - [ ] logcat（崩溃类必带）
- [ ] 复现步骤 + 必现/偶发
- [ ] 截图或录屏（有的话）