旅行青蛙·中国之旅

1. 从 源码仓库下载源码 ZIP 并解压，在该目录打开 CMD。安装 Python 和 Android Platform Tools，让 python 与 adb 命令可用；连接多个设备时，每条 ADB 命令在 adb 后加 -s 设备序列号。
2. 确认官服进度能正常加载，随后彻底退出官服应用。不要清理应用数据、卸载或删除缓存。
3. 先打开安卓 shell，再取得 root，查找热更新脚本：

   adb shell
   su
   find /data/data/com.aligames.lxqw.hhb/files -type f -path '*/main.min.js#/*'

   记下当前已运行版本的完整文件路径。如果有多个结果，对照最近运行的资源版本，不要随便选第一个；如果没有此路径，当前客户端结构不适用本教程。
4. 在仍打开的 root shell 中，将占位路径替换为上一步的精确路径，备份原文件：

   cat "实际完整路径" > /sdcard/Download/main.original.js
   exit
   exit
   adb pull /sdcard/Download/main.original.js main.original.js

   保留原脚本，后面恢复时使用同一份文件。

1. 在源码根目录执行：

   python tools\capture\prepare_capture_client.py --input main.original.js --output main.capture.js

   工具只打开协议分块日志，不改服务器地址。若提示补丁目标不匹配，停止操作，说明当前客户端版本尚未适配。
2. 上传脚本，并在独立 root shell 中覆盖已确认的精确文件，不要删除文件或缓存目录：

   adb push main.capture.js /sdcard/Download/main.capture.js
   adb shell
   su
   cat /sdcard/Download/main.capture.js > "实际完整路径"
   exit
   exit

3. 打开一个单独的 CMD 窗口开始记录，再启动官服应用：

   adb logcat -v threadtime > official_raw_logcat_LOCAL_ONLY.txt

   保持窗口运行，不要在它里面输入其他命令。正常登录自己的账号，等待庭院与室内数据加载完成。

1. 保持日志记录，在官服逐页打开相册、礼品盒和回收站；需要保留准确构图的照片，逐张打开大图。再打开动态相册、旅行日记、笔记、友情绘本、故事、图鉴、百科、家具、手工品、花圃与当前活动页面，等待加载完成。
2. 登录初始化通常只有照片索引；未加载的历史照片不保证能还原原有图层位置。尽量在一次登录中完成浏览，不要为采集而领取、删除或消耗不想改变的内容。
3. 退出官服，在采集窗口按 Ctrl+C 停止。回到源码目录的 CMD 执行：

   python tools\capture\parse_warehouse_capture.py --src official_raw_logcat_LOCAL_ONLY.txt --out official-backup

4. 查看输出的 warehouse_summary_SHARE_SAFE.txt 与 album_coverage_SHARE_SAFE.txt。分块缺失或 JSON 解析失败应重新采集；相册缺失详情应补采对应照片。不是完整登录初始化的日志，导入会提示缺少必要数据。
5. 将 official-backup\protocol_full_LOCAL_ONLY.jsonl 复制到目标设备，在普通版中“导入存档”。核对青蛙、库存、照片与日记后，导出一份 .frogsave 长期保存。
6. 关闭官服应用，恢复同一精确路径的原脚本：

   adb push main.original.js /sdcard/Download/main.original.js
   adb shell
   su
   cat /sdcard/Download/main.original.js > "实际完整路径"
   exit
   exit

原始日志和 LOCAL_ONLY 文件可能含账号凭据、设备标识与玩家互动数据，只留在自己设备上。用于恢复的是完整 LOCAL_ONLY 文件，不是脱敏的 SHARE_SAFE 文件。采集结束后恢复原脚本，避免持续记录账号信息。

文件托管于 GitHub Releases，部分网络环境下访问较慢。检查下载是否完整、设备空间与安装权限。若已安装旧的电脑连接型 APK，先导出进度；遇到签名不兼容时，不要直接卸载丢失存档。也可以先使用网页版本。

确认在同一桌面图标 / 浏览器中打开同一版本，而且完整离线资源已下载。Safari 页面与主屏幕应用可能使用不同存储，换入口时重新导入备份。不要用无痕浏览；设备空间不足时，系统可能回收网站数据。清理前先导出。

游戏逻辑与存档在当前设备运行，网站只提供静态程序和资源；导入文件不发送到网站服务器。网页不会替你云端备份，请将导出的文件保存到自己设备或自己选择的网盘。

两版存档独立，可同时安装。离线版保留原客户端交互，无法从现有资料确定的服务端概率与时长使用本地规则；其他玩家互动不连接真人。图鉴版用于查看与体验收藏，不能将其资源规则同步回官服。