文档 · 专题
常见问题排查
如果你卡在建立连接或登录阶段,请先看 连不上时怎么查。已经连上主机但遇到通知、状态或显示异常时,按下面逐项排查。
收不到锁屏推送
Section titled “收不到锁屏推送”- 检查系统权限与总开关:打开 Moshpit 里的 设置 › 通知。如果系统层面关掉了 Moshpit 的通知权限,页面顶部会直接提示。同时确认 有智能体在等你时提醒 处于开启状态。
- 核对主机配对并发测试通知:打开那条连接的 配置主机,确认主机已装有
openssl和curl且能正常访问外网 HTTPS,然后停留在当前页面点 发一条测试通知(不要切去后台,页面前台才能确认收到)。 - 留意 30 秒静默期:「在等你」会先等满 30 秒才发推送,你在电脑前随手答掉的问题不会响。停在提示符前待命的空闲智能体也不会发「在等你」。
Codex 一直不报状态也不发推送
Section titled “Codex 一直不报状态也不发推送”~/.codex/config.toml 里新写入的 hooks 需要你在 Codex 里亲手放行一次才会生效。在主机终端打开 codex,输入 /hooks,把 Moshpit 的四条记录设为信任即可,详见 配置主机。
首页不显示智能体状态
Section titled “首页不显示智能体状态”- 使用 tmux 时:首页状态读取的是
~/.moshpit/moshpit-stamp.sh写进窗格的@moshpit_*选项。先跑一次 配置主机 安装状态脚本,再给智能体发一句新提示词触发一次状态更新。同时确认你的会话跑在 tmux 默认 socket 上,没有用-L或-S另开私有 socket。 - 使用 herdr 时:状态由
herdr原生汇报。如果顶部横幅提示PATH里的herdr与正在运行的herdr server版本不一致,把偏旧的那一边升级对齐即可。
「已完成」推送里没有写它刚答了哪句话
Section titled “「已完成」推送里没有写它刚答了哪句话”在主机上安装 jq(sudo apt install jq、sudo dnf install jq 或 brew install jq)。没装 jq 时脚本照样会发送耗时与完成通知,只是跳过提示词提取。
电脑也连着同一个 tmux 会话时排版错乱或互相抢窗口
Section titled “电脑也连着同一个 tmux 会话时排版错乱或互相抢窗口”- 手机切窗口把电脑也带过去了:把服务器上的
tmux升到 3.8 及以上版本。tmux 3.8+ 下 Moshpit 会走独立会话组,手机切窗口不再惊动电脑终端。 - 两台移动设备同看一个窗口:界面提示
这个窗口按 … 的尺寸显示。时,点 改用这台设备的尺寸 即可把行列数切回当前手里的设备。 - 偶发画面残留:Mosh 会话下长按顶栏的
MOSH传输标签,点 重绘屏幕 即可全屏刷新。
Mosh 连上之后一直黑屏
Section titled “Mosh 连上之后一直黑屏”这说明前面的 SSH 握手已经成功拉起了 mosh-server,但 60000–61000 端口的 UDP 回包被拦在了路上。请在服务器防火墙和云安全组放行这段 UDP 端口,或者在当前网络限制 UDP 时打开 编辑连接 关掉 使用 mosh 改走 SSH,详见 Mosh。