Luker 中文文档 下载 App

Termux 酒馆搬进 APK:首次启动导入向导

三条路怎么选

你的情况走哪条
刚装 APK,还没怎么用首次启动导入向导(推荐,最省事)
源端和目标端都已是本平台实例局域网迁移,连 ZIP 都不用打
向导错过了 / 特殊目录需求手动复制兜底

全程不需要文件管理器钻进应用私有目录——向导方案完全绕开它。

路线一:首次启动导入向导

  1. Termux 里打 ZIP——把原版数据目录打包(没装 zip 工具先 pkg install zip)
  2. 装 APK 并启动——首次启动弹出导入向导
  3. 按引导选 ZIP 导入——填用户名(用作默认人设名),等待导入完成
  4. 验证——角色卡列表、聊天记录、世界书、预设、API 密钥应该全部在位

错过了向导?用户管理面板里可以再次发起同样的导入,不用重装。

路线二:局域网迁移

源端是 Termux 里跑的本平台服务端(或另一台 APK),目标端是新 APK 时:两端连同一 Wi-Fi,直接走局域网同步的配对流程,比打 ZIP 更轻松。

路线三:手动复制兜底

只有向导和局域网都走不通时才需要:

  1. Termux 里把数据导出到共享存储
  2. 先打开一次 APK 让它创建数据目录(这步不能省,否则目标目录不存在)
  3. 系统设置里强制停止应用——迁移期间绝不能让它在后台运行
  4. 用文件管理器把数据搬进应用数据目录(具体路径以官方迁移文档的目录速查表为准)
  5. 重启验证

Android 11 及以上对应用私有目录有访问限制,不同厂商放行方式不同(文件管理器授权、或借助电脑 USB 复制)。手动路线里漏了"先启动一次"或"先强制停止"是数据出问题的两大主因。

双向兼容的退路

搬进来之后,它只往数据目录里追加自己的状态文件,不改原版格式。哪天想回 Termux 老酒馆,把应用数据目录的内容拷回去就能跑,角色卡和聊天原样保留。