1. 为什么“没报错”在终端自动化里毫无意义?
直觉上看,给一个运行中的终端窗格定时送一条文本只需要:launchd 定个闹钟 + osascript 找到对应 Ghostty 终端输文字按回车。实际在真机排障一整天后,我们在 pitfalls.md 里记下了整整 11 个静默失灵的暗坑。
2. 现场实测踩出的高危静默坑位
坑 1:单次 osascript 连续发文本 + 回车直接吞掉
-- 看似正常且返回 exit 0,实测在 Ghostty + Claude TUI 下常直接丢弃回车
input text "continue" to tm
send key "enter" to tm
修复:拆成两次独立的 osascript 进程调用,中间强制保留 sleep 3(ENTER_DELAY >= 2)。
坑 2:读取 Claude JSONL 最后一条 cwd 会被子代理目录劫持
用文件末尾最近的 cwd 去反推哪个 .jsonl 属于当前项目?实测同一个会话日志文件里同时出现了 282 条主目录记录 和 121 条 sidechain 子代理子目录记录。取末尾一条直接漏掉了真正活跃的会话,反手把指令打进了 2.8 小时前同目录的闲置旧会话。
修复:在 awk 里遇到第一条含 cwd 的记录就立刻 exit 锁定主工作区;且若同目录在 120 秒内有两个活跃候选会话,直接 exit 2 报错绝不瞎猜。
坑 3:launchd 带 Year 的 StartCalendarInterval 安静地永不触发
我们亲眼见过 launchctl print 显示调度正常、pmset 持有 NoIdleSleepAssertion 防休眠锁,结果到点后 runs=0、系统日志零输出、零报错。同时如果 plist 的 ProgramArguments 直接填 .sh 脚本而非 ["/bin/sh", "/path/to/run-once.sh"],会以 xpcproxy exit(78) EX_CONFIG 挂掉,脚本第一行都不会跑。
修复:改用 StartInterval=300 轮询拉起 /bin/sh run-once.sh + 时间戳门槛自检(NOW >= DUE_EPOCH)+ 投递成功后自销毁(bootout + 删除 plist),同时天然兼容 Mac 合盖休眠唤醒。
坑 4:其它容易误判的底层细节
- AppleScript
tab关键字会被强转成字面量"tab":用od -c打出来真的就是t a b三个字母,必须改用|||拼接再用awk -F'\\|\\|\\|'拆分。 - 非交互测试窗格用
sleep 240掩盖通路:睡死的进程不读 stdin,字符全积在缓冲区里,测试窗格必须跑交互空转 shell(exec /bin/zsh -f -i)。 - TCC 自动化权限按父进程链隔离:你在终端里手动跑通
osascript,完全不代表launchd后台拉起能过授权,必须拿 20 秒一次性探针实际测一次权限。 - Ghostty 尚未暴露 AppleScript
tty属性(-1700):目前按working directory of tm匹配,如果用户中途在目标面板里cd到别的路径会报错停止(exit 2)。
3. 用字节偏移量做“真正送达”的硬证明
既然“命令退出码 0”不等于“模型真收到了指令”,tui-continue.sh 把送达证明做进了磁盘层面:
- 注入前先用 BSD
stat -f %z "$SESSION_FILE"记下字节偏移量SIZE_BEFORE; - 执行两段式
osascript投递后,在 60 秒窗口内每 1.5 秒从SIZE_BEFORE往后读取新增行; - 校验新增 JSONL 中确实落盘了
message.role == "user"且正文匹配发送内容(或--expect-user-regex),这才返回0;超时未见则返回退出码4(“已注入但未验真”),绝不伪报成功。
stat -f、osascript、launchd)、Ghostty 与 Claude Code JSONL 格式;同一工作目录下有多个 Claude 进程时脚本会报错拒绝,但如果同一目录下仅跑一个 Claude 却开了多个同路径普通 Ghostty 窗格,当前逻辑会记日志并取首个匹配窗格。