tmuxclihook 0.5.5 → 0.5.7

package/README.md

@@ -43,6 +43,8 @@ hooks 安装、tmux 集成写入的路径由「source」决定：环境变量 `T
 
 升级成功，或版本已是最新且显式传入 `--prune` 时，update 会检查另一套安装（volta packages 镜像或当前 npm 全局 prefix）是否还留有副本。发现副本时：TTY 下询问是否删除（默认不删）；非交互环境只打印警告；`--prune` 跳过询问直接删除。删除前会校验该副本未被任何 hooks 与 `~/.tmux.conf` 引用——任一检查无法确认就保留并提示先重装 hooks。**生效入口永远不删**，清理失败不影响升级结果。也可以手动收敛：卸载不再使用的那份（`npm uninstall -g tmuxclihook` 或 `volta uninstall tmuxclihook`），再从生效入口重新安装 hooks。
 
+升级后无需手动重载 tmux 插件：运行中的 `tmux-ai-monitor` 每 60 tick 对比脚本目录内容指纹，发现文件被替换会自动 `exec` 自身重载新代码（保留同一 PID 与 generation）。`TMUX_AI_MONITOR_RELOAD_DISABLE=1` 可关闭该行为。
+
 ## 功能
 
 | 菜单项 | 说明 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tmuxclihook",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "交互式 TUI 安装器：环境侦测、AI CLI 侦测、tmux-ai-status hooks 装/卸/修、TPM 软链校验",
   "type": "module",
   "bin": {

package/scripts/adapters/codex.sh

@@ -113,6 +113,49 @@ EOF
     ' <<<"$rows"
 }
 
+# 可选：TMUX_PANE 无法由祖先链确定时，提示 thread 所在 pane（供核心收窄候选）。
+# 参数: $1=session_id $2=hook_cwd；只读、不调用 tmux（复用核心 _PANE_SNAPSHOT）。
+# codex 实例配置 terminal_title=["thread"]，pane title 形如 "✳ <thread_name>"；
+# ${CODEX_HOME}/session_index.jsonl 每行 {id, thread_name, updated_at}，
+# hook 输入的 session_id 与其中的 id 一致。用归一化后的精确标题匹配，
+# 不依赖 ✳/spinner 前缀；结果再与进程树候选取交集，降低误配。
+_codex_session_index_files() {
+    local f seen=""
+    if [ -n "${CODEX_HOME:-}" ] && [ -f "${CODEX_HOME}/session_index.jsonl" ]; then
+        printf '%s\n' "${CODEX_HOME}/session_index.jsonl"
+        seen="${CODEX_HOME}/session_index.jsonl"
+    fi
+    f="${HOME}/.codex/session_index.jsonl"
+    if [ -f "$f" ] && [ "$f" != "$seen" ]; then printf '%s\n' "$f"; fi
+    for f in "${HOME}"/.cc-switch/instances/codex/*/session_index.jsonl; do
+        [ -f "$f" ] || continue
+        [ "$f" = "$seen" ] || printf '%s\n' "$f"
+    done
+}
+
+adapter_pane_hints() {
+    local sid="${1:-}" name="" idx target pane path cmd pid server attached title out=""
+    [ -n "$sid" ] || return 1
+    while IFS= read -r idx; do
+        [ -f "$idx" ] || continue
+        name=$(jq -r --arg id "$sid" 'select(.id == $id) | .thread_name // empty' \
+            "$idx" 2>/dev/null | tail -n 1)
+        [ -n "$name" ] && break
+    done < <(_codex_session_index_files)
+    [ -n "$name" ] || return 1
+    target=$(_normalize_title "$name")
+    [ -n "$target" ] || return 1
+    [ "$_PANE_SNAPSHOT_OK" = "1" ] || return 1
+    while IFS='|' read -r pane path cmd pid server attached title; do
+        [ -n "$pane" ] || continue
+        [ "$(_normalize_title "$title")" = "$target" ] && out="$out $pane"
+    done <<EOF
+$_PANE_SNAPSHOT
+EOF
+    [ -n "$out" ] || return 1
+    printf '%s\n' "${out# }" | tr ' ' '\n'
+}
+
 # 从每个事件数组剔除本插件 group（command 含 tmux-ai-status），事件/hooks 清空后删键。
 _codex_strip_managed() {
     jq '

package/scripts/lib-tmux-ai-status.sh

@@ -61,55 +61,265 @@ _pane_sanitized() {
 }
 
 _pane_dir() {
+    [ -n "$TMUX_PANE" ] || return 1
     echo "${_STATUS_DIR}/$(_pane_sanitized)"
 }
 
 _ensure_pane_dir() {
-    local dir; dir=$(_pane_dir)
+    local dir; dir=$(_pane_dir) || return 1
     [ -d "$dir" ] || mkdir -p "$dir" 2>/dev/null
 }
 
-# --- TMUX_PANE 解析 ---
-# hook 子进程不继承 $TMUX_PANE，通过进程树向上查找所属 pane
+# --- Pane 解析 ---
+# 继承的 $TMUX_PANE 可能来自长期存活的进程（如 codex managed app-server daemon）。
+# 关键：daemon 的继承值甚至可能指向当前 server 中真实存在、但与本会话无关的 pane，
+# 所以「server pid 匹配 + pane 存在」不足以信任它。判定顺序：
+#   1) 祖先链：hook 进程向上能否命中某个 pane 的 pane_pid（权威）
+#   2) 祖先链不通 = daemon/脱离上下文 → 继承值一律丢弃
+#   3) session 映射（带 server/pane_pid/tool/cwd 元数据校验）
+#   4) 同工具进程树候选 → adapter 提示 → hook cwd 逐级收敛
+# 只有收敛到唯一候选才采用；多候选不猜（保持空，由 monitor 显示 idle `-`）。
+
+HOOK_CWD="${HOOK_CWD:-}"
+_PANE_SNAPSHOT=""
+_PANE_SNAPSHOT_OK=0
+_CURRENT_SERVER_PID=""
+_TMUX_PANE_SOURCE=""
+
+# 一次性快照：pane_id|path|current_command|pane_pid|server_pid|attached|title
+# title 放最后：read 会把剩余内容（含 '|'）并入最后一个变量。
+_load_pane_snapshot() {
+    _PANE_SNAPSHOT=""
+    _PANE_SNAPSHOT_OK=0
+    _CURRENT_SERVER_PID=""
+    command -v tmux >/dev/null 2>&1 || return 1
+    _PANE_SNAPSHOT=$(tmux list-panes -a -F \
+        '#{pane_id}|#{pane_current_path}|#{pane_current_command}|#{pane_pid}|#{pid}|#{session_attached}|#{pane_title}' \
+        2>/dev/null)
+    [ -n "$_PANE_SNAPSHOT" ] || return 1
+    _PANE_SNAPSHOT_OK=1
+    _CURRENT_SERVER_PID=$(printf '%s\n' "$_PANE_SNAPSHOT" | awk -F'|' 'NR==1{print $5}')
+    return 0
+}
+
+_snapshot_field() {  # $1=pane_id $2=字段号
+    [ "$_PANE_SNAPSHOT_OK" = "1" ] || return 1
+    printf '%s\n' "$_PANE_SNAPSHOT" | awk -F'|' -v id="$1" -v n="$2" '$1==id{print $n; exit}'
+}
+
+_snapshot_has_pane() {  # $1=pane_id
+    [ "$_PANE_SNAPSHOT_OK" = "1" ] || return 1
+    printf '%s\n' "$_PANE_SNAPSHOT" | awk -F'|' -v id="$1" '$1==id{found=1} END{exit !found}'
+}
+
+# 从当前进程沿父链向上匹配 pane_pid；命中即返回该 pane（权威信号）。
+_pane_from_ancestry() {
+    local pid=$$ depth=0 found
+    while [ "${pid:-0}" -gt 1 ] && [ "$depth" -lt 24 ]; do
+        found=$(printf '%s\n' "$_PANE_SNAPSHOT" | awk -F'|' -v p="$pid" '$4==p{print $1; exit}')
+        if [ -n "$found" ]; then printf '%s' "$found"; return 0; fi
+        pid=$(ps -o ppid= -p "$pid" 2>/dev/null | tr -d '[:space:]')
+        depth=$((depth + 1))
+    done
+    return 1
+}
+
+# 当前工具在 attached pane 中的候选集合（进程树含 ADAPTER_PROCESS_NAMES）。
+_pane_process_candidates() {
+    local names="${ADAPTER_PROCESS_NAMES:-}" id path cmd pid server attached title
+    [ -n "$names" ] || return 1
+    [ "$_PANE_SNAPSHOT_OK" = "1" ] || return 1
+    while IFS='|' read -r id path cmd pid server attached title; do
+        [ -n "$id" ] || continue
+        [ "${attached:-0}" -gt 0 ] || continue
+        if _pid_tree_has_names "$pid" "$names"; then printf '%s\n' "$id"; fi
+    done <<EOF
+$_PANE_SNAPSHOT
+EOF
+}
+
+# 取交集（按 $1 的顺序）；过滤结果为空时保持原集合。
+_intersect_panes() {
+    local base="$1" filter="$2" out="" p
+    [ -n "$filter" ] || { printf '%s\n' "$base"; return; }
+    filter=$(printf '%s' "$filter" | tr '\n' ' ')
+    for p in $base; do
+        case " $filter " in *" $p "*) out="$out $p" ;; esac
+    done
+    [ -n "$out" ] && printf '%s\n' "${out# }" || printf '%s\n' "$base"
+}
+
+_narrow_panes_by_adapter() {
+    local base="$1" hints=""
+    declare -f adapter_pane_hints >/dev/null 2>&1 || { printf '%s\n' "$base"; return; }
+    hints=$(adapter_pane_hints "${SESSION_ID:-}" "$HOOK_CWD" 2>/dev/null)
+    _intersect_panes "$base" "$hints"
+}
+
+_narrow_panes_by_cwd() {
+    local base="$1" want="" matches="" id path cmd pid server attached title
+    [ -n "${HOOK_CWD:-}" ] || { printf '%s\n' "$base"; return; }
+    want=$(_normalize_path "$HOOK_CWD") || want="${HOOK_CWD%/}"
+    while IFS='|' read -r id path cmd pid server attached title; do
+        [ -n "$id" ] || continue
+        [ "$(_normalize_path "$path")" = "$want" ] && matches="$matches $id"
+    done <<EOF
+$_PANE_SNAPSHOT
+EOF
+    _intersect_panes "$base" "$matches"
+}
+
+# 路径归一化：去尾斜杠 + 解析符号链接（解析失败时保留原路径）。
+_normalize_path() {
+    local p="$1" phys
+    [ -n "$p" ] || return 1
+    while [ "${p%/}" != "$p" ] && [ "$p" != "/" ]; do p="${p%/}"; done
+    phys=$(cd "$p" 2>/dev/null && pwd -P) && p="$phys"
+    printf '%s' "$p"
+}
+
+# 标题归一化：仅剥已知前缀（✳ / *）与首尾空白；不删非字母字符，避免破坏中文。
+_normalize_title() {
+    local t="$1"
+    t=$(printf '%s' "$t" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')
+    case "$t" in
+        "✳"*) t="${t#✳}" ;;
+        "*"*)  t="${t#\*}" ;;
+    esac
+    printf '%s' "$t" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//'
+}
+
+# 解析失败的负缓存：避免 daemon 高频事件反复枚举 pane + BFS。
+_resolve_negative_path() { printf '%s/.resolve-ts-%s' "$_STATUS_DIR" "${SESSION_ID:-unknown}"; }
+_resolve_recently_failed() {
+    local f ts age
+    f=$(_resolve_negative_path)
+    [ -f "$f" ] || return 1
+    ts=$(cat "$f" 2>/dev/null)
+    [ -n "$ts" ] || return 1
+    age=$(( $(date +%s) - ts ))
+    [ "$age" -ge 0 ] && [ "$age" -lt 5 ]
+}
+_mark_resolve_failed() {
+    mkdir -p "$_STATUS_DIR" 2>/dev/null || true
+    date +%s > "$(_resolve_negative_path)" 2>/dev/null || true
+}
+_clear_resolve_failed() { rm -f "$(_resolve_negative_path)" 2>/dev/null || true; }
+
 resolve_tmux_pane() {
-    if [ -z "$TMUX_PANE" ]; then
-        if [ -n "$TMUX" ]; then
-            :
-        elif command -v tmux &>/dev/null; then
-            :
-        else
-            return
+    local inherited="${TMUX_PANE:-}" pane candidates n
+
+    TMUX_PANE=""
+    _TMUX_PANE_SOURCE=""
+
+    # 1) 祖先链是权威信号（普通启动 / 旧 cc-switch / Claude 的 pane 内 hook）
+    _load_pane_snapshot || return 1
+    pane=$(_pane_from_ancestry)
+    if [ -n "$pane" ]; then
+        TMUX_PANE="$pane"
+        _TMUX_PANE_SOURCE="ancestry"
+        if [ -n "$inherited" ] && [ "$inherited" != "$pane" ]; then
+            _ai_log "PANE: inherited '$inherited' overridden by ancestry '$pane' (tool=$TOOL_ID)"
         fi
-        local check_pid=$$
-        while [ "${check_pid:-0}" -gt 1 ]; do
-            local found
-            found=$(tmux list-panes -a -F "#{pane_id} #{pane_pid}" 2>/dev/null \
-                    | awk -v pid="$check_pid" '$2==pid{print $1; exit}')
-            if [ -n "$found" ]; then TMUX_PANE="$found"; break; fi
-            check_pid=$(ps -o ppid= -p "$check_pid" 2>/dev/null | tr -d '[:space:]')
-        done
+        _clear_resolve_failed
+        return 0
+    fi
+
+    # 2) 祖先链没有 pane = daemon / 脱离上下文：继承值可能指向当前 server 中
+    #    真实存在但无关的 pane，一律丢弃，走映射与多信号收敛。
+    if [ -n "${SESSION_ID:-}" ] && _load_pane_id; then
+        _TMUX_PANE_SOURCE="mapping"
+        _clear_resolve_failed
+        return 0
     fi
+
+    if _resolve_recently_failed; then
+        return 1
+    fi
+
+    # 3) 同工具进程树候选 → adapter 提示 → hook cwd
+    candidates=$(_pane_process_candidates)
+    if [ -n "$candidates" ]; then
+        n=$(printf '%s\n' "$candidates" | grep -c .)
+        if [ "$n" -gt 1 ]; then
+            candidates=$(_narrow_panes_by_adapter "$candidates")
+            n=$(printf '%s\n' "$candidates" | grep -c .)
+        fi
+        if [ "$n" -gt 1 ] && [ -n "${HOOK_CWD:-}" ]; then
+            candidates=$(_narrow_panes_by_cwd "$candidates")
+            n=$(printf '%s\n' "$candidates" | grep -c .)
+        fi
+        if [ "$n" -eq 1 ]; then
+            TMUX_PANE="${candidates%%$'\n'*}"
+            _TMUX_PANE_SOURCE="process"
+            _clear_resolve_failed
+            _ai_log "PANE: '$inherited' → '$TMUX_PANE' (tool=$TOOL_ID, detached, resolved)"
+            return 0
+        fi
+    fi
+
+    _mark_resolve_failed
+    _ai_log "PANE: unresolved (inherited='${inherited}' tool=$TOOL_ID session=${SESSION_ID:-?} cwd=${HOOK_CWD:-?} candidates='${candidates:-}')"
+    return 1
 }
 
-# --- Pane ID 持久化（供 SessionEnd 回读）---
-# 注意: SessionStart/SessionEnd 事件不含 session_id，_save_pane_id 在这两事件中不会保存。
-# 映射由后续事件（PreToolUse、PermissionRequest 等）建立。
-# SessionEnd 回退链: resolve_tmux_pane → _load_pane_id → _cleanup_stale_panes。
-# 若 Claude 会话全程无工具调用，pane 状态可能残留最多 60s（直到下次 cleanup）。
+# --- Pane ID 持久化（供后续事件/SessionEnd 回读）---
+# 映射文件 pane-${SESSION_ID} 保持单行 pane id（既有清理逻辑依赖）；
+# 旁路 .pane-meta-${SESSION_ID} 记录 tool/server_pid/pane_pid/cwd，用于识别
+# 「server 重启后 pane id 被复用」等陈旧映射。只有成功解析（_TMUX_PANE_SOURCE
+# 非空）才落盘，避免把猜测持久化。
 _save_pane_id() {
-    [ -n "$TMUX_PANE" ] && [ -n "$SESSION_ID" ] && { _ensure_pane_dir; echo "$TMUX_PANE" > "$(_pane_dir)/pane-${SESSION_ID}"; }
+    [ -n "$TMUX_PANE" ] && [ -n "${SESSION_ID:-}" ] || return 0
+    [ -n "${_TMUX_PANE_SOURCE:-}" ] || return 0
+    _ensure_pane_dir || return 0
+    local dir
+    dir=$(_pane_dir) || return 0
+    printf '%s\n' "$TMUX_PANE" > "$dir/pane-${SESSION_ID}"
+    if [ "$_PANE_SNAPSHOT_OK" = "1" ]; then
+        printf '1\t%s\t%s\t%s\t%s\n' \
+            "${TOOL_ID:-}" "${_CURRENT_SERVER_PID:-}" \
+            "$(_snapshot_field "$TMUX_PANE" 4)" "$(_snapshot_field "$TMUX_PANE" 2)" \
+            > "$dir/.pane-meta-${SESSION_ID}" 2>/dev/null || true
+    fi
 }
 _load_pane_id() {
-    [ -z "$SESSION_ID" ] && return 1
-    local f
+    [ -n "${SESSION_ID:-}" ] || return 1
+    [ "$_PANE_SNAPSHOT_OK" = "1" ] || return 1
+    local f pane dir meta ver mtool mserver mpid mpath cpid
     for f in "${_STATUS_DIR}"/*/pane-${SESSION_ID}; do
         [ -f "$f" ] || continue
-        TMUX_PANE=$(cat "$f" 2>/dev/null) && [ -n "$TMUX_PANE" ] && return 0
+        pane=$(head -n 1 "$f" 2>/dev/null)
+        [ -n "$pane" ] || continue
+        dir="${f%/*}"
+        meta="$dir/.pane-meta-${SESSION_ID}"
+
+        # pane 已不存在：确定失效，连元数据一起删除
+        if ! _snapshot_has_pane "$pane"; then
+            rm -f "$f" "$meta" 2>/dev/null || true
+            continue
+        fi
+        # 旧版映射（无 meta）不可信：忽略，让本次重新解析覆盖
+        [ -f "$meta" ] || continue
+        IFS=$'\t' read -r ver mtool mserver mpid mpath < "$meta"
+        [ "$ver" = "1" ] || continue
+        [ "$mtool" = "${TOOL_ID:-}" ] || continue
+        [ -n "$_CURRENT_SERVER_PID" ] && [ "$mserver" = "$_CURRENT_SERVER_PID" ] || continue
+        cpid=$(_snapshot_field "$pane" 4)
+        [ "$mpid" = "$cpid" ] || continue
+        # hook cwd 与映射时的 pane 路径不一致 → 会话已迁移，不采用
+        if [ -n "${HOOK_CWD:-}" ] && [ -n "$mpath" ]; then
+            [ "$(_normalize_path "$mpath")" = "$(_normalize_path "$HOOK_CWD")" ] || continue
+        fi
+
+        TMUX_PANE="$pane"
+        return 0
     done
     return 1
 }
 _clear_pane_id() {
-    [ -n "$SESSION_ID" ] && rm -f "$(_pane_dir)/pane-${SESSION_ID}"
+    [ -n "$TMUX_PANE" ] && [ -n "${SESSION_ID:-}" ] || return 0
+    local dir; dir=$(_pane_dir) || return 0
+    rm -f "$dir/pane-${SESSION_ID}" "$dir/.pane-meta-${SESSION_ID}" 2>/dev/null
 }
 
 # --- cc-switch provider 标签 ---
@@ -453,29 +663,40 @@ _new_session_owns_pane() {
 # BFS 遍历 pane 的进程树，检查是否有 AI CLI 进程。
 # 进程名集合从所有 adapter 的 ADAPTER_PROCESS_NAMES 汇总（_collect_ai_process_names），
 # 前缀匹配（codex 二进制常为 codex-aarch64-* 等带后缀名）。
-_pane_has_ai_process() {
+# $1=basename 命令 $2=工具进程名（如 codex/opencode）→ 是否前缀匹配
+_is_tool_process_name() {
+    case "${1:-}" in
+        "$2"|"$2"-*|"$2"_*) return 0 ;;
+    esac
+    return 1
+}
+
+_pane_current_command() {  # $1=pane_id → 前台命令
     local pane_id="$1"
-    local pane_pid
-    # 注意：list-panes -t "%N" 会返回该 pane 所在 window 的全部 pane，
-    # 直接取 #{pane_pid} 会混入同 window 其他 pane 的 pid，导致 BFS 爬到
-    # 邻近 pane 的 AI 进程而误判。必须用 -a 全局列 + 精确匹配 pane_id。
-    pane_pid=$(tmux list-panes -a -F "#{pane_id} #{pane_pid}" 2>/dev/null \
-        | awk -v id="$pane_id" '$1==id{print $2; exit}')
-    [ -z "$pane_pid" ] && return 1
-    local ai_names
-    ai_names=$(_collect_ai_process_names)
-    local pids="$pane_pid" next="" depth=0
+    tmux list-panes -a -F "#{pane_id}|#{pane_current_command}" 2>/dev/null \
+        | awk -F'|' -v id="$pane_id" '$1==id{print $2; exit}'
+}
+
+_pane_command_is_tool() {  # $1=pane_id $2=工具名
+    local current_command
+    current_command=$(_pane_current_command "$1")
+    [ -n "$current_command" ] || return 1
+    _is_tool_process_name "$(basename "$current_command" 2>/dev/null)" "$2"
+}
+
+# 从给定 pid 出发 BFS，匹配进程名集合（空格分隔，前缀匹配）。
+_pid_tree_has_names() {  # $1=pane_pid $2=names
+    local pane_pid="$1" names="$2"
+    local pids next depth p cmd base name children
+    [ -n "$pane_pid" ] || return 1
+    pids="$pane_pid"; next=""; depth=0
     while [ $depth -lt 10 ] && [ -n "$pids" ]; do
         for p in $pids; do
-            local cmd base name
             cmd=$(ps -o comm= -p "$p" 2>/dev/null)
             base=$(basename "$cmd" 2>/dev/null)
-            for name in $ai_names; do
-                case "$base" in
-                    "$name"|"$name"-*|"$name"_*) return 0 ;;
-                esac
+            for name in $names; do
+                _is_tool_process_name "$base" "$name" && return 0
             done
-            local children
             children=$(pgrep -P "$p" 2>/dev/null)
             [ -n "$children" ] && next="$next $children"
         done
@@ -486,6 +707,29 @@ _pane_has_ai_process() {
     return 1
 }
 
+# BFS pane 进程树，匹配给定进程名集合（空格分隔，前缀匹配）。
+_pane_has_process_names() {  # $1=pane_id $2=names
+    local pane_id="$1" pane_pid
+    # 注意：list-panes -t "%N" 会返回该 pane 所在 window 的全部 pane，
+    # 直接取 #{pane_pid} 会混入同 window 其他 pane 的 pid，导致 BFS 爬到
+    # 邻近 pane 的 AI 进程而误判。必须用 -a 全局列 + 精确匹配 pane_id。
+    pane_pid=$(tmux list-panes -a -F "#{pane_id} #{pane_pid}" 2>/dev/null \
+        | awk -v id="$pane_id" '$1==id{print $2; exit}')
+    [ -z "$pane_pid" ] && return 1
+    _pid_tree_has_names "$pane_pid" "$2"
+}
+
+# 判定 pane 进程树内是否仍有该工具进程（前台命令优先，再 BFS 遍历进程树）
+_pane_has_tool_process() {  # $1=pane_id $2=工具名
+    _pane_command_is_tool "$1" "$2" && return 0
+    _pane_has_process_names "$1" "$2"
+}
+
+# 所有 adapter 汇总的 AI 进程名
+_pane_has_ai_process() {  # $1=pane_id
+    _pane_has_process_names "$1" "$(_collect_ai_process_names)"
+}
+
 # 检查 pane 的所有 pane-id 文件是否过期（> 5 min），再验证进程树
 _is_pane_session_dead() {
     local pane_id="$1"

package/scripts/tmux-ai-monitor

@@ -20,6 +20,8 @@ MONITOR_INTERVAL="${TMUX_AI_MONITOR_INTERVAL:-1}"
 # 进程树探测节流：launcher pane 每 N 个 tick 做一次 BFS（run 循环内 _TICK 持续累加）。
 _MONITOR_PROBE_EVERY=5
 _MONITOR_TICK=0
+# 升级自检：每 N tick 对比脚本内容指纹，变化则 exec 自身重载新代码。
+_MONITOR_RECHECK_EVERY=60
 
 # 常见 launcher：switch/volta/npm 系脚本在前台时，目标 CLI 位于其子进程树中，
 # pane_current_command 不会直接等于 codex/opencode（cc-switch 的 switch 启动即如此）。
@@ -34,10 +36,11 @@ _tmux_server_pid() {
     tmux display-message -p '#{pid}' 2>/dev/null
 }
 
-_pane_current_command() {
-    local pane_id="$1"
-    tmux list-panes -a -F "#{pane_id}|#{pane_current_command}" 2>/dev/null \
-        | awk -F'|' -v id="$pane_id" '$1==id{print $2; exit}'
+# 脚本内容指纹：npm 升级可能保留 tarball 旧 mtime，用内容而不是 mtime 判升级。
+# 文件顺序固定（显式文件 + 排序后的 adapters/*.sh），cksum 跨平台可用。
+_scripts_fingerprint() {
+    ( cd "$SCRIPT_DIR" 2>/dev/null || return 1
+      cat tmux-ai-monitor lib-tmux-ai-status.sh adapters/*.sh 2>/dev/null | cksum )
 }
 
 # 无 SessionEnd 的工具名集合（惰性求值缓存）。扫 adapters/*.sh 提取
@@ -57,48 +60,9 @@ _collect_no_session_end_tools() {
     echo "$_NO_SESSION_END_TOOLS"
 }
 
-# $1=basename 命令 $2=工具进程名（如 codex/opencode）→ 是否前缀匹配
-_is_tool_command() {
-    local base="$1" name="$2"
-    case "$base" in
-        "$name"|"$name"-*|"$name"_*) return 0 ;;
-    esac
-    return 1
-}
-
-# 判定 pane 前台命令是否属于给定工具名
-_pane_command_is_tool() {
-    local pane_id="$1" name="$2" current_command
-    current_command=$(_pane_current_command "$pane_id")
-    [ -n "$current_command" ] || return 1
-    _is_tool_command "$(basename "$current_command" 2>/dev/null)" "$name"
-}
-
-# 判定 pane 进程树内是否仍有该工具进程（前台命令优先，再 BFS 遍历进程树）
-_pane_has_tool_process() {
-    local pane_id="$1" name="$2"
-    _pane_command_is_tool "$pane_id" "$name" && return 0
-
-    local pane_pid
-    pane_pid=$(tmux list-panes -a -F "#{pane_id} #{pane_pid}" 2>/dev/null \
-        | awk -v id="$pane_id" '$1==id{print $2; exit}')
-    [ -n "$pane_pid" ] || return 1
-
-    local pids="$pane_pid" next="" depth=0 p cmd base children
-    while [ "$depth" -lt 10 ] && [ -n "$pids" ]; do
-        for p in $pids; do
-            cmd=$(ps -o comm= -p "$p" 2>/dev/null)
-            base=$(basename "$cmd" 2>/dev/null)
-            _is_tool_command "$base" "$name" && return 0
-            children=$(pgrep -P "$p" 2>/dev/null)
-            [ -n "$children" ] && next="$next $children"
-        done
-        pids="${next# }"
-        next=""
-        depth=$((depth + 1))
-    done
-    return 1
-}
+# 进程树 / 前台命令判定 helper（_is_tool_process_name、_pane_command_is_tool、
+# _pane_has_tool_process、_pane_current_command）已统一放在 lib-tmux-ai-status.sh，
+# run/tick 模式 source 后可直接使用，避免两份实现漂移。
 
 # 对每个无 SessionEnd 的工具名做生命周期检测：前台命令匹配或 launcher 进程树命中
 # → 标记见过；曾标记但前台已切走且进程树也无该工具 → 清空 pane 状态（该工具已退出）。
@@ -110,7 +74,7 @@ _monitor_no_session_end_lifecycle() {
     [ -n "$tools" ] || return 0
     for name in $tools; do
         while IFS='|' read -r pane_id current_command seen attached; do
-            if [ -n "$current_command" ] && _is_tool_command "$(basename "$current_command" 2>/dev/null)" "$name"; then
+            if [ -n "$current_command" ] && _is_tool_process_name "$(basename "$current_command" 2>/dev/null)" "$name"; then
                 [ "$seen" = "1" ] || tmux set-option -pt "$pane_id" "@ai_monitor_seen_${name}" 1 2>/dev/null || true
             elif [ "$seen" = "1" ] && ! _pane_has_tool_process "$pane_id" "$name"; then
                 tmux set-option -pt "$pane_id" @ai_pane_status "" 2>/dev/null || true
@@ -171,6 +135,10 @@ case "$MODE" in
         EVENT="_monitor"
         source "${SCRIPT_DIR}/lib-tmux-ai-status.sh"
 
+        # 升级自检基线；exec 失败时继续运行（execfail），避免 npm 替换文件瞬间导致 monitor 死亡。
+        _MONITOR_FP=$(_scripts_fingerprint)
+        shopt -s execfail 2>/dev/null || true
+
         cleanup_monitor_option() {
             local registered_pid
             registered_pid=$(tmux show-option -gv @ai_monitor_pid 2>/dev/null || true)
@@ -189,6 +157,17 @@ case "$MODE" in
             current_generation=$(tmux show-option -gv @ai_monitor_generation 2>/dev/null || true)
             [ "$current_generation" = "$generation" ] || break
 
+            # 脚本内容变化（npm 升级/重装）→ 同 PID exec 自重启，重载新代码。
+            # TMUX_AI_MONITOR_RELOAD_DISABLE=1 可关闭（运维逃生阀）。
+            if [ $((_MONITOR_TICK % _MONITOR_RECHECK_EVERY)) -eq 0 ] \
+               && [ "${TMUX_AI_MONITOR_RELOAD_DISABLE:-}" != "1" ]; then
+                _now_fp=$(_scripts_fingerprint)
+                if [ -n "$_now_fp" ] && [ "$_now_fp" != "$_MONITOR_FP" ] \
+                   && [ -x "$SCRIPT_DIR/tmux-ai-monitor" ]; then
+                    exec "$SCRIPT_DIR/tmux-ai-monitor" run "$expected_server_pid" "$generation"
+                fi
+            fi
+
             # 单次 tmux 查询失败不应永久杀死 monitor；server/generation 检查负责终止。
             _monitor_tick || true
             sleep "$MONITOR_INTERVAL"
@@ -208,8 +187,17 @@ case "$MODE" in
         _monitor_tick
         ;;
 
+    selfcheck)
+        # 诊断/测试用：当前脚本目录指纹与 $2 不同 → exit 0（需要重载）。
+        expected_fp="${2:-}"
+        [ -n "$expected_fp" ] || exit 1
+        current_fp=$(_scripts_fingerprint)
+        [ -n "$current_fp" ] && [ "$current_fp" != "$expected_fp" ] && exit 0
+        exit 1
+        ;;
+
     *)
-        echo "Usage: $0 [start|run|stop|tick]" >&2
+        echo "Usage: $0 [start|run|stop|tick|selfcheck <fingerprint>]" >&2
         exit 2
         ;;
 esac

package/scripts/tmux-ai-status

@@ -12,12 +12,20 @@ EVENT="$2"
 
 INPUT=$(cat)
 
-SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // ""' 2>/dev/null)
+# 一次 jq 提取：session_id + hook cwd（codex/claude 均提供 cwd；
+# TMUX_PANE 无法解析时 cwd 用于 pane 消歧）
+_hook_fields=$(printf '%s' "$INPUT" | jq -r '[(.session_id // ""), (.cwd // "")] | @tsv' 2>/dev/null)
+IFS=$'\t' read -r SESSION_ID HOOK_CWD <<< "$_hook_fields"
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "${SCRIPT_DIR}/lib-tmux-ai-status.sh"
 
-resolve_tmux_pane
+# tmux 生命周期伪事件（_refresh / _session-switched）只重建聚合，
+# 不写 per-pane 状态，无需解析 pane——避免每次 refresh 都做快照/候选 BFS。
+case "$EVENT" in
+    _refresh|_session-switched) ;;
+    *) resolve_tmux_pane ;;
+esac
 # 同 pane 的并发 hooks 必须完整串行化，否则一个事件可能用过期派生结果覆盖另一个
 # PermissionRequest 已写入的审批态。
 if [ -n "$TMUX_PANE" ]; then
@@ -252,7 +260,10 @@ case "$EVENT" in
     ;;
 esac
 
-tmux set-option -g @ai_status "$STATUS" 2>/dev/null || true
+# pane 解析失败时不写全局状态（避免把无归属事件当成有效状态）
+if [ -n "$TMUX_PANE" ]; then
+    tmux set-option -g @ai_status "$STATUS" 2>/dev/null || true
+fi
 
 # 构造事件块详情行：
 #   tool:  <tool_name>  id=<short tool_use_id>