05 Advanced Debug

5.2 调试模式

SillyDroid 提供了一些调试功能，帮助开发者和高级用户排查问题。

---

Debug APK

Debug 版本 APK 包含更详细的日志输出，适合排查问题。

文件名格式：stai-sillytavern-android-vX.X.X-X.X.X-debug.apk

---

悬浮调试入口

悬浮日志面板

点击右下角 "日志" 悬浮按钮，可实时查看：

• 服务启动日志
• Webpack 编译信息
• 扩展加载列表
• 运行时错误和异常

详见 2.3 悬浮日志面板。

启用悬浮球

在酒馆 Web 界面 → 扩展 → 安卓宿主 → ✅ "启用悬浮球"

---

ADB 调试

如果应用出现严重问题，可通过 ADB 获取更详细的信息：

查看日志

adb logcat -s SillyDroid:* NodeJS:*

查看进程

adb shell ps -A | grep sillydroid

查看文件结构

adb shell ls -la /data/data/com.jm.sillydroid/files/

导出数据目录

adb pull /data/data/com.jm.sillydroid/files/config ./
adb pull /data/data/com.jm.sillydroid/files/data ./
adb pull /data/data/com.jm.sillydroid/files/logs ./

---

Chrome DevTools 远程调试

SillyDroid 使用 WebView 渲染酒馆界面，可通过 Chrome DevTools 进行远程调试：

1. 手机开启 USB 调试
2. 连接电脑
3. Chrome 打开 chrome://inspect
4. 找到 SillyDroid 的 WebView
5. 点击 "inspect" 进入调试面板

可在此检查 WebView 控制台错误、网络请求等。

---

常见调试场景

问题	调试方法
服务启动失败	查看悬浮日志 + ADB logcat
Web 界面白屏	Chrome DevTools 检查控制台错误
扩展加载失败	查看日志中的扩展加载列表
API 连接失败	检查 config.yaml + 日志