进阶
排错
安装卡住、ta 不醒、被系统杀掉、重启后离线、安全模式、模型报错、飞书与灵魂同步的常见问题。
#安装阶段
| 现象 | 原因与处理 |
|---|---|
| 「Termux 还没有回应」 | 那一行还没执行成功，或 Termux 第一次打开还在初始化。打开 Termux 等它完成，重新粘贴回车，再点「我已执行，检测」 |
| 「更新软件源失败」 | 手机网络不通，或软件源不可用。换网络重试；大陆网络下向导会按系统语言自动选用镜像源 |
| 「取不到运行基座版本」 | 安装期间 Windler 被切到后台。保持它在前台重试 |
| 「新版本 40 秒内没有响应，已切回上一版」 | 新版本启动失败，已自动回退。日志在 Termux 的 $PREFIX/var/log/sv/windler/current，可以到 GitHub 提 issue |
| 三件套互相不认 | 三个应用不是同一来源（签名不同）。全部卸载，从同一来源重装 |
#ta 一直不醒
按顺序检查：
- 控制 → 模型：至少一个供应商、一把 Key、一个已启用的模型，且测试连通成功。没有模型时醒来率为 0。
- 控制 → 自主性：没有暂停自主；活跃度不是 0。
- 顶栏没有急停。
- 控制 → 预算：今日预算没有用尽；电量高于最低电量且在充电；温度正常。
- 刚装好的前一两个小时，驱动力还在积累，安静是正常的。可以戳一下。
#离线 / 被系统杀掉
- 「此刻」页出现离线横幅时，点点火：App 通过 Termux 重新执行开机脚本。
- 反复被杀：确认 Termux、Termux:Boot、Termux:API 与 Windler 都在电池优化忽略名单里，并在厂商的自启动 / 后台管理里放行。个别厂商系统有独立的"省电精灵"类组件会无视白名单，需要在系统设置里关闭或禁用它（Project.Honor9 记录了一台旧手机上的做法）。
- 重启后离线：有锁屏密码的手机要先解锁一次；Termux:Boot 要被打开过一次才会收到开机广播。
#安全模式
ta 主动告诉你"进入了安全模式"：10 分钟内启动超过 5 次。此时只开网关与飞书，不醒来、不调用模型。原因通常是配置损坏或模型层异常。看日志（Termux 里 $PREFIX/var/log/sv/windler/current），修复后在 控制 → 服务 重启。
#模型相关
| 现象 | 处理 |
|---|---|
| 测试连通失败 | 检查 API 地址是否含版本路径（如 /v1）、协议是否选对、Key 是否有效 |
| 回复中途失败并换了模型 | 正常：流式 90 秒无数据块即判定失败并故障转移 |
| 图片被去掉了 | 没有能看图的模型。给某个模型手动打上 vision 标记，或启用目录里支持图片输入的模型 |
| 保存被拒绝「配置已过期」 | 其他地方先改过。重新加载后再改 |
#飞书
- 显示未连接：检查 控制 → 飞书 的错误信息；一键创建的应用需要在飞书中确认才会下发凭据。
- 收不到「此刻」卡片：打开与机器人（以 agent 显示名命名）的单聊，发一句话。
- 卡片按钮无反应：机器人需要开启长连接事件订阅；一键接入已自动完成，手动接入请检查应用后台的事件订阅方式。
#灵魂同步
| 现象 | 处理 |
|---|---|
| 接入失败「地址必须是 SSH」 | 用 git@github.com:你/仓库.git，不能用 https |
| 推送被拒 | Deploy key 没勾 Allow write access；或公钥没加到这个仓库 |
| 「身份不同，拒绝合并」 | 仓库里住着另一个 agent。给这个 agent 新建一个仓库 |
| 两边记忆看起来不一致 | 同步是事件驱动的：等 ta 下一次醒来 / 对话，或在 灵魂同步 页点立即同步 |
#还是不行
到 GitHub Issues 描述现象，附上 控制 → 服务 显示的版本与相关日志（请先去掉日志里的个人信息）。