OmX 修复 Ralph 活跃 Pane 锚点不变量防止 tmux 目标漂移的工程实践【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex导读本文围绕 OmXOh My codeX项目针对 Ralph 恢复resume/ 继续continue工作流的一次针对性修复展开核心解决的是tmux 托管会话中存储的 pane 锚点在恢复时发生重绑定漂移pane rebinding drift的问题。读完本文你将掌握 OmX 如何在多 pane 的 Codex 会话中区分宽松的TMUX_PANE检测与严格的存储锚点保留两类启发式理解resolveManagedPaneFromAnchor()的 fail-closed 语义并看到 Ralph continue watcher、auto-nudge 注入与 pre-guard 配置漂移处理背后的一致性约定。问题背景存储锚点的漂移如何悄悄发生该修复对应的 PR 草案见 docs/prs/dev-fix-ralph-live-pane-invariant.md其目标分支为dev。根据文档中的 Summary问题发生在 Ralph resume / continue 工作流的托管 tmux 恢复路径上一旦某个 Ralph pane 锚点已被验证属于正确的托管会话恢复过程仍可能重新扫描整个 tmux 会话并重绑定到当前获得焦点的 Codex pane或回退到某个仅在历史上以 Codex 启动的 shell 降级 pane。在多 pane 的 Codex 会话中这种漂移会导致后续的 watcher 或 auto-nudge 注入被静默投递到错误的 lane——表面上命令执行成功实际上已经脱离预期的会话上下文。这也是该 PR 被称为 Preserve verified Ralph pane anchors and avoid tmux-hook target drift 的原因。核心不变量已验证的锚点必须保持活跃修复的核心思路可以概括为两条互补的不变量锚点保留要严格只有当一个已存储的 pane 锚点当前仍然表现为活跃的 Codex 托管 pane时才继续使用它如果它已经退化成只是当初用 Codex 启动过的 shell则不再保留。锚点失效要收敛只有锚点已经消失、或不再看起来属于 agent 时才重新扫描 tmux 会话并且当会话中不存在任何活跃的托管兄弟 pane 时必须fail closed失败关闭而不是降级投递。这意味着检测当前 pane 是否属于托管会话宽松与决定是否继续保留存储锚点严格是两件不同的事——修复通过拆分启发式函数来实现这一区分。源码剖析宽松检测与严格保留的拆分所有托管 pane 判定逻辑集中在 src/scripts/notify-hook/managed-tmux.ts其中定义了三个层次分明的启发式函数。宽松检测paneLooksLikeManagedAgentmanaged-tmux.ts 中的paneLooksLikeManagedAgent用于回答这个 pane 是不是 Codex 托管 agent若 pane 的start_command匹配omx ... hud ... --watch直接判定不是HUD 观察 pane 不属于注入目标只要start_command包含codex即视为托管或者当前命令是codex、node、npx之一也视为托管。这个判断刻意保持宽松因为它服务于resolveManagedCurrentPane这类当前 pane 是否可用的场景允许 node/npx 包装进程存在。严格保留paneLooksLikeRetainableManagedAnchor而 managed-tmux.ts 的paneLooksLikeRetainableManagedAnchor则用于回答这个已存储锚点是否仍值得保留条件明显更严current_command必须是codex或者current_command是node/npx且start_command包含codex即确实是包装启动的 Codex而非恰好跑在 node 上的普通 shell。从源码结构看这一函数刻意排除了以 codex 启动但当前已退化为 shell的情形与 PR 文档中只保留看起来仍是活跃 Codex 托管 pane 的已验证锚点的表述完全对应。会话级选择selectManagedSessionPane当需要在整个托管会话中挑选 pane 时managed-tmux.ts 的selectManagedSessionPane会先过滤掉 HUD watch pane再按活跃的 canonical 锚点 → 任意 canonical 锚点 → wrapper 回退的优先级选择且 wrapper 回退默认关闭allowWrapperFallback为 false需要由调用方显式开启。修复落点resolveManagedPaneFromAnchor的保留语义resolveManagedPaneFromAnchor 是本次修复的核心函数其流程为通过verifyManagedPaneTarget验证锚点 pane 是否仍属于托管会话读取该 pane 的pane_current_command与pane_start_command若命令状态查找失败lookupFailed仍返回原始锚点——这是 PR 文档强调的在瞬时命令状态查找失败时保留已验证锚点避免一次瞬态探测失败就触发重绑定若该 pane 仍满足paneLooksLikeRetainableManagedAnchor直接返回原锚点不做任何重扫描否则才针对锚点所在会话执行list-panes重新选择且仅在原锚点属于 wrapper 启动形态时才允许 wrapper 回退找不到任何可选 pane 时返回空字符串fail closed。也就是说重扫描从每次恢复都做变成了锚点消失或不再 agent-owned 时才做的兜底路径这正对应 PR 中only rescan the tmux session when the anchor is gone or no longer looks agent-owned的变更点。下游行为对齐watcher 与 auto-nudgeRalph continue watcher 先重解析再发送Ralph 的持续运行由 notify-fallback-watcher.ts 中的runRalphContinueSteerTick驱动它以RALPH_CONTINUE_CADENCE_MS60 秒为节拍检查 Ralph 状态。修复要求 watcher 在发送 continue 提示前针对当前托管会话重新解析存储的 pane 锚点。从 parseRalphContinuePaneBinding 可以看到绑定解析的严格性tmux_pane_id必须匹配%[0-9]、必须存在合法的 pane pid、session/window id、owner id且isPaneRunningShell(paneCurrentCommand)的 pane 会被直接拒绝。随后 ralphInputAuthorityCondition 生成一个包含 pane_id、pane_pid、session、window、owner、当前/启动命令的全维度if-shell -F条件只有完全匹配时 emitRalphContinueSteer 才会通过send-keys -l注入 continue 文本与回车。auto-nudge 沿用同一锚点契约auto-nudge.ts 的resolveNudgePaneTarget采用三级解析顺序当前托管 paneresolveManagedCurrentPane/AtPromptContext变体扫描各 scoped 状态目录中的-state.json对其中active且带tmux_pane_id的状态调用resolveManagedPaneFromAnchor或对应的 prompt-context 变体做锚点重解析最后回退到托管会话级别的resolveManagedSessionPane。这样 auto-nudge 与 notify-hook、Ralph watcher 共享同一个活跃锚点契约避免了此前watcher 与 auto-nudge 各自猜测 pane导致的分叉。整个maybeAutoNudge流程中还包含 stall 检测、签名去重、TTL 冷却、deep-interview 输入锁拦截以及evaluatePaneInjectionReadiness的注入前就绪检查锚点解析只是其中一环。回归测试把不变量锁进测试PR 文档列出了四类回归覆盖均可在仓库测试中找到对应实现直接托管 pane 辅助函数notify-hook-managed-tmux.test.ts 通过伪造tmux可执行文件模拟 pane 状态。例如 rebinds a node shell anchor to the live codex pane in the managed sessionL529-L610构造了一个current_commandnode、start_commandbash的锚点 pane%42与活跃 codex pane%55断言resolveManagedPaneFromAnchor(%42, ...)返回%55而不是原锚点。失败关闭同文件 fails closed for anchorless managed-session recovery when only a wrapper-launched node pane existsL612 起验证当托管会话中只有 wrapper 启动的 node pane 时恢复返回空而非错误重绑定。pre-guard 配置漂移notify-hook-tmux-heal.test.ts 的 does not heal the repo-scoped target when a preGuard skip returns early 验证当配置指定target: { type: session, value: nonexistent-session }且 preGuard 提前跳过时repo-scoped 的会话目标不会被重写回 pane id 形态。验证方式与结论PR 文档给出的 Validation 均可在仓库复现npx biome lint检查上述源码与测试文件npm run build编译 TypeScriptnode --test运行notify-fallback-watcher、notify-hook-auto-nudge、notify-hook-managed-tmux、notify-hook-tmux-heal四个测试文件。综合来看这次修复通过宽松检测 / 严格保留的启发式拆分把 Ralph 继续、watcher 恢复与 auto-nudge 注入统一到同一个活跃锚点契约之下已验证锚点只有在仍呈现为活跃 Codex 托管 pane 时才被保留任何重扫描都被限制在锚点确实失效的场景并以失败关闭兜底。对于在 tmux 中运行多 pane Codex 会话的用户而言这意味着会话恢复与自动续推不会再因为焦点变化而悄悄投递到错误的 lane行为更可预测、可审计相关决策记录在.omx/logs的 JSONL 事件日志中。【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OmX 修复 Ralph 活跃 Pane 锚点不变量：防止 tmux 目标漂移的工程实践
OmX 修复 Ralph 活跃 Pane 锚点不变量防止 tmux 目标漂移的工程实践【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex导读本文围绕 OmXOh My codeX项目针对 Ralph 恢复resume/ 继续continue工作流的一次针对性修复展开核心解决的是tmux 托管会话中存储的 pane 锚点在恢复时发生重绑定漂移pane rebinding drift的问题。读完本文你将掌握 OmX 如何在多 pane 的 Codex 会话中区分宽松的TMUX_PANE检测与严格的存储锚点保留两类启发式理解resolveManagedPaneFromAnchor()的 fail-closed 语义并看到 Ralph continue watcher、auto-nudge 注入与 pre-guard 配置漂移处理背后的一致性约定。问题背景存储锚点的漂移如何悄悄发生该修复对应的 PR 草案见 docs/prs/dev-fix-ralph-live-pane-invariant.md其目标分支为dev。根据文档中的 Summary问题发生在 Ralph resume / continue 工作流的托管 tmux 恢复路径上一旦某个 Ralph pane 锚点已被验证属于正确的托管会话恢复过程仍可能重新扫描整个 tmux 会话并重绑定到当前获得焦点的 Codex pane或回退到某个仅在历史上以 Codex 启动的 shell 降级 pane。在多 pane 的 Codex 会话中这种漂移会导致后续的 watcher 或 auto-nudge 注入被静默投递到错误的 lane——表面上命令执行成功实际上已经脱离预期的会话上下文。这也是该 PR 被称为 Preserve verified Ralph pane anchors and avoid tmux-hook target drift 的原因。核心不变量已验证的锚点必须保持活跃修复的核心思路可以概括为两条互补的不变量锚点保留要严格只有当一个已存储的 pane 锚点当前仍然表现为活跃的 Codex 托管 pane时才继续使用它如果它已经退化成只是当初用 Codex 启动过的 shell则不再保留。锚点失效要收敛只有锚点已经消失、或不再看起来属于 agent 时才重新扫描 tmux 会话并且当会话中不存在任何活跃的托管兄弟 pane 时必须fail closed失败关闭而不是降级投递。这意味着检测当前 pane 是否属于托管会话宽松与决定是否继续保留存储锚点严格是两件不同的事——修复通过拆分启发式函数来实现这一区分。源码剖析宽松检测与严格保留的拆分所有托管 pane 判定逻辑集中在 src/scripts/notify-hook/managed-tmux.ts其中定义了三个层次分明的启发式函数。宽松检测paneLooksLikeManagedAgentmanaged-tmux.ts 中的paneLooksLikeManagedAgent用于回答这个 pane 是不是 Codex 托管 agent若 pane 的start_command匹配omx ... hud ... --watch直接判定不是HUD 观察 pane 不属于注入目标只要start_command包含codex即视为托管或者当前命令是codex、node、npx之一也视为托管。这个判断刻意保持宽松因为它服务于resolveManagedCurrentPane这类当前 pane 是否可用的场景允许 node/npx 包装进程存在。严格保留paneLooksLikeRetainableManagedAnchor而 managed-tmux.ts 的paneLooksLikeRetainableManagedAnchor则用于回答这个已存储锚点是否仍值得保留条件明显更严current_command必须是codex或者current_command是node/npx且start_command包含codex即确实是包装启动的 Codex而非恰好跑在 node 上的普通 shell。从源码结构看这一函数刻意排除了以 codex 启动但当前已退化为 shell的情形与 PR 文档中只保留看起来仍是活跃 Codex 托管 pane 的已验证锚点的表述完全对应。会话级选择selectManagedSessionPane当需要在整个托管会话中挑选 pane 时managed-tmux.ts 的selectManagedSessionPane会先过滤掉 HUD watch pane再按活跃的 canonical 锚点 → 任意 canonical 锚点 → wrapper 回退的优先级选择且 wrapper 回退默认关闭allowWrapperFallback为 false需要由调用方显式开启。修复落点resolveManagedPaneFromAnchor的保留语义resolveManagedPaneFromAnchor 是本次修复的核心函数其流程为通过verifyManagedPaneTarget验证锚点 pane 是否仍属于托管会话读取该 pane 的pane_current_command与pane_start_command若命令状态查找失败lookupFailed仍返回原始锚点——这是 PR 文档强调的在瞬时命令状态查找失败时保留已验证锚点避免一次瞬态探测失败就触发重绑定若该 pane 仍满足paneLooksLikeRetainableManagedAnchor直接返回原锚点不做任何重扫描否则才针对锚点所在会话执行list-panes重新选择且仅在原锚点属于 wrapper 启动形态时才允许 wrapper 回退找不到任何可选 pane 时返回空字符串fail closed。也就是说重扫描从每次恢复都做变成了锚点消失或不再 agent-owned 时才做的兜底路径这正对应 PR 中only rescan the tmux session when the anchor is gone or no longer looks agent-owned的变更点。下游行为对齐watcher 与 auto-nudgeRalph continue watcher 先重解析再发送Ralph 的持续运行由 notify-fallback-watcher.ts 中的runRalphContinueSteerTick驱动它以RALPH_CONTINUE_CADENCE_MS60 秒为节拍检查 Ralph 状态。修复要求 watcher 在发送 continue 提示前针对当前托管会话重新解析存储的 pane 锚点。从 parseRalphContinuePaneBinding 可以看到绑定解析的严格性tmux_pane_id必须匹配%[0-9]、必须存在合法的 pane pid、session/window id、owner id且isPaneRunningShell(paneCurrentCommand)的 pane 会被直接拒绝。随后 ralphInputAuthorityCondition 生成一个包含 pane_id、pane_pid、session、window、owner、当前/启动命令的全维度if-shell -F条件只有完全匹配时 emitRalphContinueSteer 才会通过send-keys -l注入 continue 文本与回车。auto-nudge 沿用同一锚点契约auto-nudge.ts 的resolveNudgePaneTarget采用三级解析顺序当前托管 paneresolveManagedCurrentPane/AtPromptContext变体扫描各 scoped 状态目录中的-state.json对其中active且带tmux_pane_id的状态调用resolveManagedPaneFromAnchor或对应的 prompt-context 变体做锚点重解析最后回退到托管会话级别的resolveManagedSessionPane。这样 auto-nudge 与 notify-hook、Ralph watcher 共享同一个活跃锚点契约避免了此前watcher 与 auto-nudge 各自猜测 pane导致的分叉。整个maybeAutoNudge流程中还包含 stall 检测、签名去重、TTL 冷却、deep-interview 输入锁拦截以及evaluatePaneInjectionReadiness的注入前就绪检查锚点解析只是其中一环。回归测试把不变量锁进测试PR 文档列出了四类回归覆盖均可在仓库测试中找到对应实现直接托管 pane 辅助函数notify-hook-managed-tmux.test.ts 通过伪造tmux可执行文件模拟 pane 状态。例如 rebinds a node shell anchor to the live codex pane in the managed sessionL529-L610构造了一个current_commandnode、start_commandbash的锚点 pane%42与活跃 codex pane%55断言resolveManagedPaneFromAnchor(%42, ...)返回%55而不是原锚点。失败关闭同文件 fails closed for anchorless managed-session recovery when only a wrapper-launched node pane existsL612 起验证当托管会话中只有 wrapper 启动的 node pane 时恢复返回空而非错误重绑定。pre-guard 配置漂移notify-hook-tmux-heal.test.ts 的 does not heal the repo-scoped target when a preGuard skip returns early 验证当配置指定target: { type: session, value: nonexistent-session }且 preGuard 提前跳过时repo-scoped 的会话目标不会被重写回 pane id 形态。验证方式与结论PR 文档给出的 Validation 均可在仓库复现npx biome lint检查上述源码与测试文件npm run build编译 TypeScriptnode --test运行notify-fallback-watcher、notify-hook-auto-nudge、notify-hook-managed-tmux、notify-hook-tmux-heal四个测试文件。综合来看这次修复通过宽松检测 / 严格保留的启发式拆分把 Ralph 继续、watcher 恢复与 auto-nudge 注入统一到同一个活跃锚点契约之下已验证锚点只有在仍呈现为活跃 Codex 托管 pane 时才被保留任何重扫描都被限制在锚点确实失效的场景并以失败关闭兜底。对于在 tmux 中运行多 pane Codex 会话的用户而言这意味着会话恢复与自动续推不会再因为焦点变化而悄悄投递到错误的 lane行为更可预测、可审计相关决策记录在.omx/logs的 JSONL 事件日志中。【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考