烟雨江湖 ADB 直连存档导出 v1.0.9

一、使用前准备
1. 仅支持 64 位 Windows 10/11，以及雷电或 MuMu 模拟器。
2. 在模拟器设置中开启 Root，启动烟雨江湖并进入已加载角色的主界面。
3. 双击“yanyu-export.exe”。多开时按提示选择正确设备。
4. 普通运行会读取同目录 localKey.cfg；文件不存在就生成 authorization_code="" 与 environment="product"。环境只允许 product 或 test，修改后分别连接对应授权环境；非法值会直接报错。旧配置会保留授权码并自动补齐 product。有 35 位授权码时直接显示并使用，否则找到游戏进程后等待明文输入，可用 Ctrl+V、Ctrl+Shift+V 或右键粘贴，输入完按回车并自动写回配置。
5. 维护者可运行 `yanyu-export.exe --diagnose`，只检查连接、Root 和进程，不读取配置、不请求授权；`--environment test` 可只覆盖本次普通运行而不修改配置。

二、输出位置
成功文件保存到 yanyu-export.exe 同目录的“yanyu-db”文件夹，可直接导入当前网页。
交互式运行结束后按任意键关闭窗口；脚本或重定向运行不会等待按键。

三、ADB 来源
工具优先使用同目录 adb.exe，其次使用 PATH 或雷电/MuMu 安装目录中的 adb.exe。MuMu 会优先使用管理器返回的真实设备号，并自动合并同一启动实例的重复 ADB 别名；真实多开仍会分别显示。
如果提示找不到 ADB，请安装官方 Android SDK Platform Tools，或确认模拟器安装完整。

四、隐私与扣次
存档数据库、解密 JSON、设备解析码和原始账号值只在本机及模拟器临时使用，不上传服务器。
服务端只接收授权任务信息；绑定型授权只上传带渠道上下文的 SHA-256 指纹。
只有最终 .yanyu 文件写入并校验成功后才确认任务和扣除一次；失败会尽力取消任务。

五、常见问题
- 没有设备：先启动模拟器，确认 ADB 调试可用。
- Root 失败：在模拟器设置中开启 Root 后重启模拟器。
- 没有游戏进程：进入角色主界面后等待工具重新检测。
- 数据库读取失败：工具会直接读取本地数据库副本中的存档记录并校验解密结果；目标记录确实无法读取或解密时，请保持角色主界面等待运行内存兜底。
- 完成回执失败：如果工具已经给出文件路径，请勿立即重复导出。
