连接诊断

遇到问题时，盲目重试浪费时间。按以下顺序逐步定位。

步骤 1：判断症状类型

步骤 2：检查服务器

在 Mac 上确认服务器正在监听：

lsof -nP -iTCP:8765 -sTCP:LISTEN

应该看到一个 node 进程。如果没有，说明服务器未运行。

使用 Cloudflare Tunnel 时还需检查：

ps aux | grep cloudflared

步骤 3：测试网络可达性

从同网络的另一台设备（或 Mac 本机）：

# 测试端口是否可达
nc -zv <mac-ip> 8765
 
# 使用隧道时
curl -I https://your-tunnel-url.trycloudflare.com

如果端口不可达，检查：

• Mac 防火墙设置
• 正确的网络接口（WiFi 为 en0，以太网为 en1）
• 设备是否在同一子网

步骤 4：检查 Mac 性能

如果连接正常但感觉慢：

# CPU 和内存
top -l 1 -s 0 | head -10
 
# 检查 tmux 会话（是否太多？）
tmux list-sessions

Mac 负载过高时会延迟终端输出，看起来像网络问题。

步骤 5：刷新会话

如果输出过时或终端空白：

1. 在 iPhone App 中打开会话选择器。
2. 重新选择该会话。
3. 这会重新附加到 tmux 会话并刷新输出。

如果会话不存在了（被删除或服务器重启），创建新会话。

步骤 6：检查通知传递

如果推送通知无法正常工作：

1. iOS 权限： 设置 > Tactic Remote > 通知 > 允许。
2. Hook 事件： Claude Code 触发的 hook 事件由服务器转发。确认服务器能接收到：

   curl -X POST http://localhost:8765/hook -d '{"type":"test"}'

3. 应用版本： 确保 Mac App 和 iOS App 都是最新版本。

何时提交支持请求

如果以上步骤都无法解决问题，联系支持 并附上：

• 应用版本（Mac 和 iOS）
• 连接模式（局域网或隧道）
• 你尝试的步骤
• 截图或错误信息（隐去 API Key）