tmuxclihook 0.5.2 → 0.5.4

package/README.md

@@ -79,7 +79,14 @@ clack 0.7 只把 ctrl+c 映射为取消（Esc 默认无效果），安装器在
 
 ### cc-switch 模式（Claude Code）
 
-检测到 `~/.cc-switch/cc-switch.db` 时，Claude Code hooks 的装/卸/修/状态检查全部指向其通用配置（db `settings` 表 `common_config_claude`）——`switch` 命令启动 claude 时会把通用配置合并进实例配置，`~/.claude/settings.json` 与实例文件都会被 cc-switch 覆盖，直接写它们不持久。写入用与 cc-switch 自身一致的 `json_patch` 原子更新，他人 hook 与配置其他字段保留。注意：cc-switch GUI 运行中会把内存缓存写回 db，安装前建议先退出 GUI（脚本会警告）；不经 `switch` 直接运行的 `claude` 读不到 db 里的 hooks。
+检测到 `~/.cc-switch/cc-switch.db` 时，Claude Code hooks 的装/卸/修/状态检查改走 cc-switch 的共享配置。真源位置随 cc-switch 版本自动切换（判定规则与 cc-switch CLI 的 `detectSharedConfigMode` 一致，`CC_SWITCH_SHARED_SOURCE=live|legacy` 可显式覆盖）：
+
+| cc-switch 版本 | 判定 | hooks 真源 / 写入目标 |
+|---|---|---|
+| 4.0.2+（live） | `PRAGMA user_version >= 20` | `~/.claude/settings.json` |
+| 旧版（legacy） | `user_version < 20` 或读不到 | db `settings` 表 `common_config_claude` |
+
+live 模式以 `~/.claude/settings.json` 为共享配置真源（cc-switch 4.0.2 起不再读库里的 `common_config_claude`），写入用与文件模式相同的原子合并，他人 hook 与配置其他字段保留；legacy 模式用与 cc-switch 自身一致的 `json_patch` 更新 db。注意：cc-switch GUI 运行中会把内存缓存写回真源，安装前建议先退出 GUI（脚本会警告）；legacy 模式下不经 `switch` 直接运行的 `claude` 读不到 db 里的 hooks。
 
 ## Source 管理（生产默认 / 本地调试切换）
 

package/package.json

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

package/scripts/adapters/claude.sh

@@ -119,28 +119,54 @@ _claude_count_registered() {  # $1=输入 JSON 文件 → stdout 事件数（jq
 }
 
 # ─── cc-switch 通用配置支持 ───
-# `switch` 命令启动 claude 时把 ~/.cc-switch/cc-switch.db 的通用配置（settings 表
-# common_config_claude，JSON）深合并进实例 settings.json（provider meta 均
-# commonConfigEnabled=true）。~/.claude/settings.json 与实例文件都会被 cc-switch
-# 覆盖，通用配置是 hooks 的唯一持久真源。检测到 cc-switch 时装/卸/完整性只操作
-# 该库；sqlite3 缺失等一切门禁不过 → 整体回退传统文件模式。
+# `switch` 命令启动 claude 时把「共享配置」深合并进实例 settings.json
+# （provider meta 均 commonConfigEnabled=true）。~/.claude/settings.json 与实例
+# 文件都会被 cc-switch 覆盖，共享配置才是 hooks 的唯一持久真源。
+#
+# 共享配置的真源位置随 cc-switch 版本变化（规则与 cc-switch CLI 的
+# detectSharedConfigMode 保持一致）：
+#   - legacy（< 4.0.2 / db PRAGMA user_version < 20）：
+#       真源 = db settings 表的 common_config_claude（JSON）
+#   - live（4.0.2+ / user_version >= 20）：
+#       真源 = ~/.claude/settings.json —— 4.0.2 起 cc-switch 不再读库里的
+#       common_config_claude（仅作迁移快照），所以新机器上写库等于写进死信。
+#   - CC_SWITCH_SHARED_SOURCE=live|legacy 可显式覆盖（cc-switch 同款逃生阀）
+# 门禁不过（db/表/sqlite3 缺失）→ none，整体回退传统文件模式。
 
 _ccswitch_db() { printf '%s\n' "${HOME}/.cc-switch/cc-switch.db"; }
 
-# 门禁：db 存在 && sqlite3 可用 && settings 表可查。不要求 key 存在
-# （从未编辑过通用配置的用户由 install 的 upsert 建行；若此处要求 key，
-# 会静默回退文件模式 → 实例永不含 hooks + 自修复空转）。
-_ccswitch_active() {
-    local db
+# live 模式真源：cc-switch 硬编码 $HOME/.claude/settings.json，
+# 不随 CLAUDE_CONFIG_DIR 变化（后者指向的是 switch 实例目录）。
+_ccswitch_live_file() { printf '%s\n' "${HOME}/.claude/settings.json"; }
+
+# 输出 live|legacy|none；恒返回 0（调用方无需容忍失败分支）。
+_ccswitch_mode() {
+    local db override version
     db="$(_ccswitch_db)"
-    [ -f "$db" ] || return 1
-    command -v sqlite3 >/dev/null 2>&1 || return 1
-    sqlite3 -readonly "$db" \
+    if [ ! -f "$db" ] || ! command -v sqlite3 >/dev/null 2>&1; then
+        printf 'none\n'
+        return 0
+    fi
+    if ! sqlite3 -readonly "$db" \
         "SELECT 1 FROM sqlite_master WHERE type='table' AND name='settings'" 2>/dev/null \
-        | grep -q 1
+        | grep -q 1; then
+        printf 'none\n'
+        return 0
+    fi
+    override=$(printf '%s' "${CC_SWITCH_SHARED_SOURCE:-}" | tr '[:upper:]' '[:lower:]')
+    case "$override" in
+        live|legacy) printf '%s\n' "$override"; return 0 ;;
+    esac
+    # 读不到版本（空/非数字）按 legacy——与 cc-switch CLI 的 null → legacy 一致
+    version=$(sqlite3 -readonly "$db" "PRAGMA user_version" 2>/dev/null | tr -cd '0-9')
+    if [ -n "$version" ] && [ "$version" -ge 20 ]; then
+        printf 'live\n'
+    else
+        printf 'legacy\n'
+    fi
 }
 
-# cc-switch GUI 运行中会把内存缓存的通用配置全量写回 db（实测发生过），警告不阻塞。
+# cc-switch GUI 运行中会把内存缓存的共享配置全量写回真源（实测发生过），警告不阻塞。
 _ccswitch_warn_gui() {
     if pgrep -ix "cc-switch" >/dev/null 2>&1 \
        || pgrep -f "cc-switch.app/Contents/MacOS" >/dev/null 2>&1; then
@@ -190,13 +216,22 @@ ON CONFLICT(key) DO UPDATE SET value = json_patch(settings.value, json($(_sqlquo
 # 存活提取内联在本函数（jq + test），不依赖 lib-install-hooks.sh——本函数同时被
 # 事件路径（lib-tmux-ai-status.sh）与 install wrapper（lib-install-hooks.sh）两个上下文调用。
 adapter_check_integrity() {
-    local src registered ev p ok_events=""
-    if _ccswitch_active; then
-        _ccswitch_dump_common src || return 1
-    else
-        [ -f "$ADAPTER_HOOKS_FILE" ] || return 1
-        src="$ADAPTER_HOOKS_FILE"
-    fi
+    local mode src="" tmp="" registered ev p ok_events=""
+    mode=$(_ccswitch_mode)
+    case "$mode" in
+        live)
+            src=$(_ccswitch_live_file)
+            [ -f "$src" ] || return 1
+            ;;
+        legacy)
+            _ccswitch_dump_common tmp || return 1
+            src="$tmp"
+            ;;
+        *)
+            [ -f "$ADAPTER_HOOKS_FILE" ] || return 1
+            src="$ADAPTER_HOOKS_FILE"
+            ;;
+    esac
     registered=$(_claude_count_registered "$src")
     if [ "${registered:-0}" -ge 10 ]; then
         while IFS=$'\t' read -r ev p; do
@@ -212,9 +247,7 @@ adapter_check_integrity() {
             select(($scripts | length) > 0) |
             $scripts[] | "\($e)\t\(.)"' "$src" 2>/dev/null)
     fi
-    if [ "$src" != "$ADAPTER_HOOKS_FILE" ]; then
-        rm -f "$src"
-    fi
+    [ -z "$tmp" ] || rm -f "$tmp"
     [ "${registered:-0}" -ge 10 ] || return 1
     for ev in SessionStart SessionEnd UserPromptSubmit PreToolUse PostToolUse PostToolUseFailure PermissionRequest Notification Stop StopFailure; do
         case ",$ok_events," in *",$ev,"*) ;; *) return 1 ;; esac
@@ -229,20 +262,38 @@ adapter_check_integrity() {
 # status 判定仍由 integrity 本体独立给出，两者永不发散。
 # 任何失败（jq 失败/配置缺失）输出空 events 的降级片段，不 exit 非 0。
 adapter_check_detail() {
-    local mode="file" src="" pairs rows line ev p a
-    if _ccswitch_active; then
-        mode="ccswitch"
-        if ! _ccswitch_dump_common src; then
-            printf '{"mode":"ccswitch","events":{},"plugin":null,"registeredPaths":[]}\n'
-            return 0
-        fi
-    elif [ -f "$ADAPTER_HOOKS_FILE" ]; then
-        src="$ADAPTER_HOOKS_FILE"
-    fi
+    local source_mode src="" tmp="" pairs rows line ev p a
+    source_mode=$(_ccswitch_mode)
+    case "$source_mode" in
+        live)
+            src=$(_ccswitch_live_file)
+            [ -f "$src" ] || src=""
+            ;;
+        legacy)
+            if ! _ccswitch_dump_common tmp; then
+                printf '{"mode":"ccswitch","events":{},"plugin":null,"registeredPaths":[]}\n'
+                return 0
+            fi
+            src="$tmp"
+            ;;
+        *)
+            if [ -f "$ADAPTER_HOOKS_FILE" ]; then src="$ADAPTER_HOOKS_FILE"; fi
+            ;;
+    esac
     if [ -z "$src" ]; then
-        printf '{"mode":"%s","events":{},"plugin":null,"registeredPaths":[]}\n' "$mode"
+        case "$source_mode" in
+            live) source_mode="ccswitch-live" ;;
+            legacy) source_mode="ccswitch" ;;
+            *) source_mode="file" ;;
+        esac
+        printf '{"mode":"%s","events":{},"plugin":null,"registeredPaths":[]}\n' "$source_mode"
         return 0
     fi
+    case "$source_mode" in
+        live) source_mode="ccswitch-live" ;;
+        legacy) source_mode="ccswitch" ;;
+        *) source_mode="file" ;;
+    esac
     # TSV：event\tscript（不去重、保留零事件——计数与去重交给下游 jq 聚合）
     pairs=$(jq -r '.hooks as $h |
         ["SessionStart","SessionEnd","UserPromptSubmit","PreToolUse","PostToolUse",
@@ -250,9 +301,7 @@ adapter_check_detail() {
         $events[] as $e |
         $h[$e][]?.hooks[]?.command // empty |
         select(contains("tmux-ai-status")) | split(" ")[0] | "\($e)\t\(.)"' "$src" 2>/dev/null)
-    if [ "$src" != "$ADAPTER_HOOKS_FILE" ]; then
-        rm -f "$src"
-    fi
+    [ -z "$tmp" ] || rm -f "$tmp"
     # TSV：event\tscript\talive(0|1)。bash 3.2 无关联数组，逐行展开后由 jq 一次聚合。
     rows=""
     while IFS= read -r line; do
@@ -264,7 +313,7 @@ adapter_check_detail() {
     done <<EOF
 $pairs
 EOF
-    jq -R -s --arg mode "$mode" --arg events "$_CLAUDE_EVENTS" '
+    jq -R -s --arg mode "$source_mode" --arg events "$_CLAUDE_EVENTS" '
         (reduce ($events | split(" ")[]) as $e
             ({}; .[$e] = {registered: 0, alive: 0, scriptPaths: []})) as $base
         | reduce (split("\n") | .[] | select(length > 0) | split("\t")) as $r (
@@ -279,68 +328,90 @@ EOF
     ' <<<"$rows"
 }
 
-# 安装：合并式更新，保留他人（masko 等）注册的 hook。cc-switch 模式只写库
-# （~/.claude/settings.json 与实例文件都会被 cc-switch 覆盖，写了也不持久）。
+# 安装：合并式更新，保留他人（masko 等）注册的 hook。
+# legacy 模式只写库（~/.claude/settings.json 与实例文件都会被旧版 cc-switch 覆盖）；
+# live 模式（4.0.2+）写 ~/.claude/settings.json —— 新版 cc-switch 以它为共享真源，
+# 实例 settings 在 switch/漂移收敛时从该文件重新派生。
 adapter_install_hooks() {
     _install_require_jq
-    if _ccswitch_active; then
-        local tmp merged hooks_patch full_doc
-        _ccswitch_warn_gui
-        _ccswitch_dump_common tmp || return 1
-        merged=$(_claude_apply_merge "$tmp")
-        rm -f "$tmp"
-        hooks_patch=$(jq -c '{hooks: (.hooks // {})}' <<<"$merged")
-        full_doc=$(jq -c . <<<"$merged")
-        _ccswitch_upsert_hooks "$hooks_patch" "$full_doc" || return 1
-        echo "Claude hooks installed to cc-switch common config: $(_ccswitch_db)"
-        echo "Events: $_CLAUDE_EVENTS"
-        return 0
-    fi
-    [ -f "$ADAPTER_HOOKS_FILE" ] || _install_atomic_write '{}' "$ADAPTER_HOOKS_FILE"
-    local updated
-    updated=$(_claude_apply_merge "$ADAPTER_HOOKS_FILE")
-    _install_atomic_write "$updated" "$ADAPTER_HOOKS_FILE"
-    echo "Claude hooks installed to $ADAPTER_HOOKS_FILE"
+    local mode target updated
+    mode=$(_ccswitch_mode)
+    case "$mode" in
+        legacy)
+            local tmp merged hooks_patch full_doc
+            _ccswitch_warn_gui
+            _ccswitch_dump_common tmp || return 1
+            merged=$(_claude_apply_merge "$tmp")
+            rm -f "$tmp"
+            hooks_patch=$(jq -c '{hooks: (.hooks // {})}' <<<"$merged")
+            full_doc=$(jq -c . <<<"$merged")
+            _ccswitch_upsert_hooks "$hooks_patch" "$full_doc" || return 1
+            echo "Claude hooks installed to cc-switch common config (legacy): $(_ccswitch_db)"
+            echo "Events: $_CLAUDE_EVENTS"
+            return 0
+            ;;
+        live)
+            _ccswitch_warn_gui
+            target=$(_ccswitch_live_file)
+            ;;
+        *)
+            target="$ADAPTER_HOOKS_FILE"
+            ;;
+    esac
+    [ -f "$target" ] || _install_atomic_write '{}' "$target"
+    updated=$(_claude_apply_merge "$target")
+    _install_atomic_write "$updated" "$target"
+    echo "Claude hooks installed to $target"
     echo "Events: $_CLAUDE_EVENTS"
 }
 
 # 卸载：单次 jq pipeline 移除所有指向本插件的 hooks，保留他人条目。
-# cc-switch 模式：剥离前后对照生成 patch（被清空的事件键置 null = RFC 7396 删键），
+# legacy 模式：剥离前后对照生成 patch（被清空的事件键置 null = RFC 7396 删键），
 # 顶层其他字段（model/env/…）由 json_patch 天然保留。
+# live 模式：与文件模式同一套原子写（真源就是 ~/.claude/settings.json）。
 adapter_uninstall_hooks() {
     _install_require_jq
-    if _ccswitch_active; then
-        local tmp stripped cur_hooks final_hooks patch managed top_patch
-        _ccswitch_warn_gui
-        _ccswitch_dump_common tmp || return 1
-        cur_hooks=$(jq -c '.hooks // {}' "$tmp")
-        # 已无本插件条目 → no-op（否则会把保留的他人 hook 重写一遍）
-        managed=$(jq '[to_entries[] | select(.value | any(.hooks[]?.command | contains("tmux-ai-status")))] | length' <<<"$cur_hooks")
-        if [ "${managed:-0}" -eq 0 ]; then
+    local mode target updated
+    mode=$(_ccswitch_mode)
+    case "$mode" in
+        legacy)
+            local tmp stripped cur_hooks final_hooks patch managed top_patch
+            _ccswitch_warn_gui
+            _ccswitch_dump_common tmp || return 1
+            cur_hooks=$(jq -c '.hooks // {}' "$tmp")
+            # 已无本插件条目 → no-op（否则会把保留的他人 hook 重写一遍）
+            managed=$(jq '[to_entries[] | select(.value | any(.hooks[]?.command | contains("tmux-ai-status")))] | length' <<<"$cur_hooks")
+            if [ "${managed:-0}" -eq 0 ]; then
+                rm -f "$tmp"
+                echo "Claude hooks: nothing to uninstall (cc-switch common config)"
+                return 0
+            fi
+            stripped=$(_claude_apply_strip "$tmp")
+            final_hooks=$(jq -c '.hooks // {}' <<<"$stripped")
             rm -f "$tmp"
-            echo "Claude hooks: nothing to uninstall (cc-switch common config)"
-            return 0
-        fi
-        stripped=$(_claude_apply_strip "$tmp")
-        final_hooks=$(jq -c '.hooks // {}' <<<"$stripped")
-        rm -f "$tmp"
-        patch=$(jq -cn --argjson cur "$cur_hooks" --argjson fin "$final_hooks" '
-            reduce ($cur | keys[]) as $k ({};
-                if ($fin | has($k)) then .[$k] = $fin[$k] else .[$k] = null end)')
-        if [ "$patch" = "{}" ]; then
-            echo "Claude hooks: nothing to uninstall (cc-switch common config)"
+            patch=$(jq -cn --argjson cur "$cur_hooks" --argjson fin "$final_hooks" '
+                reduce ($cur | keys[]) as $k ({};
+                    if ($fin | has($k)) then .[$k] = $fin[$k] else .[$k] = null end)')
+            if [ "$patch" = "{}" ]; then
+                echo "Claude hooks: nothing to uninstall (cc-switch common config)"
+                return 0
+            fi
+            # patch 是事件级键，需包一层 {hooks: …} 才是顶层 patch（json_patch 只动 hooks）
+            top_patch=$(jq -cn --argjson p "$patch" '{hooks: $p}')
+            _ccswitch_upsert_hooks "$top_patch" "$top_patch" || return 1
+            echo "Claude hooks uninstalled from cc-switch common config (legacy)"
             return 0
-        fi
-        # patch 是事件级键，需包一层 {hooks: …} 才是顶层 patch（json_patch 只动 hooks）
-        local top_patch
-        top_patch=$(jq -cn --argjson p "$patch" '{hooks: $p}')
-        _ccswitch_upsert_hooks "$top_patch" "$top_patch" || return 1
-        echo "Claude hooks uninstalled from cc-switch common config"
-        return 0
-    fi
-    [ -f "$ADAPTER_HOOKS_FILE" ] || { echo "Claude hooks: nothing to uninstall"; return 0; }
-    local updated
-    updated=$(_claude_apply_strip "$ADAPTER_HOOKS_FILE")
-    _install_atomic_write "$updated" "$ADAPTER_HOOKS_FILE"
-    echo "Claude hooks uninstalled from $ADAPTER_HOOKS_FILE"
+            ;;
+        live)
+            _ccswitch_warn_gui
+            target=$(_ccswitch_live_file)
+            ;;
+        *)
+            target="$ADAPTER_HOOKS_FILE"
+            ;;
+    esac
+    [ -f "$target" ] || { echo "Claude hooks: nothing to uninstall"; return 0; }
+    updated=$(_claude_apply_strip "$target")
+    _install_atomic_write "$updated" "$target"
+    echo "Claude hooks uninstalled from $target"
 }

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

@@ -168,13 +168,20 @@ _provider_tag_colour() {
 build_all_status() {
     ALL=""
     cur_sess=""
-    local _ai_names
+    local _ai_names _fmt _n
     _ai_names=$(_collect_ai_process_names)
-    while IFS='|' read -r pane_id session_name win_idx pane_idx claude_status _attached _created _entered cur_cmd prov_name prov_id; do
+    # 动态追加上 monitor 的 seen 标记（无 SessionEnd 工具的进程树探测结果）。
+    # switch/volta-shim 启动的 pane 前台命令不是 codex，必须靠该标记补 idle `-`。
+    _fmt="#{pane_id}|#{session_name}|#{window_index}|#{pane_index}|#{@ai_pane_status}|#{session_attached}|#{session_created}|#{@ai_entered_time}|#{pane_current_command}|#{@ai_provider}|#{@ai_provider_id}"
+    for _n in $_ai_names; do
+        _fmt="$_fmt|#{@ai_monitor_seen_$_n}"
+    done
+    while IFS='|' read -r pane_id session_name win_idx pane_idx claude_status _attached _created _entered cur_cmd prov_name prov_id _seen_flags; do
         local pane_status="$claude_status"
         if [ -z "$pane_status" ]; then
             # 无显式状态：若前台是 AI 进程（codex 首个 turn 前空窗期），补 idle。
             # 进程名集合从所有 adapter 汇总，前缀匹配（codex-aarch64-* 等）。
+            # 前台命令是 switch/volta-shim 时改为读 monitor 的进程树标记。
             local _cmd_base _n _is_ai=0
             _cmd_base=$(basename "$cur_cmd" 2>/dev/null)
             for _n in $_ai_names; do
@@ -182,6 +189,9 @@ build_all_status() {
                     "$_n"|"$_n"-*|"$_n"_*) _is_ai=1; break ;;
                 esac
             done
+            if [ "$_is_ai" = "0" ]; then
+                case "$_seen_flags" in *1*) _is_ai=1 ;; esac
+            fi
             [ "$_is_ai" = "1" ] && pane_status="-" || continue
         fi
         local session_block="#[bg=#6272A4,fg=#F8F8F2] ${session_name} #[bg=default,fg=default]"
@@ -212,7 +222,7 @@ build_all_status() {
     # 自指 switch 由 handler 的 per-client prev 对比滤除）
     # ② session_created（无进入记录时回退创建序）。不用 session_last_attached——
     # tmux 的 server_client_set_session 无条件刷新该时间戳（自指 switch 也算），污染排序。
-    done < <(tmux list-panes -a -F "#{pane_id}|#{session_name}|#{window_index}|#{pane_index}|#{@ai_pane_status}|#{session_attached}|#{session_created}|#{@ai_entered_time}|#{pane_current_command}|#{@ai_provider}|#{@ai_provider_id}" 2>/dev/null | awk -F'|' -v OFS='|' '$6>0{if($8=="")$8=$7; print}' | sort -t'|' -k8,8n -k7,7n -k2,2 -k3,3n -k4,4n)
+    done < <(tmux list-panes -a -F "$_fmt" 2>/dev/null | awk -F'|' -v OFS='|' '$6>0{if($8=="")$8=$7; print}' | sort -t'|' -k8,8n -k7,7n -k2,2 -k3,3n -k4,4n)
 }
 
 # --- Pending 集合管理（PreToolUse / PermissionRequest 配对）---

package/scripts/tmux-ai-monitor

@@ -2,9 +2,11 @@
 # tmux-ai-monitor — tmux server 级单例监控器
 #
 # 部分 AI CLI（codex、opencode）没有 SessionEnd hook，退出无法主动清空状态；codex 的
-# SessionStart 还会延迟到首个 turn。本监控器每秒根据 pane_current_command / 进程树刷新：
+# SessionStart 还会延迟到首个 turn。本监控器每秒刷新：
 #   - 前台启动此类工具、尚无 hook 状态时，显示 idle `-`
-#   - 退出返回 shell 后，清除残留 pane 状态
+#   - cc-switch 的 `switch` 启动时前台命令是 volta-shim/node 而非工具名，改为
+#     （每 N 个 tick）探测 launcher pane 的进程树来识别，并写 seen 标记供聚合补 `-`
+#   - 退出返回 shell（或进程树已无该工具）后，清除残留 pane 状态
 # 泛化实现：扫描 adapters/*.sh 找出 ADAPTER_HAS_SESSION_END="false" 的工具及其
 # ADAPTER_PROCESS_NAMES，逐个工具做生命周期检测——新增同类工具的 adapter 无需改本文件。
 # `/new`（codex）等同工具内会话切换不改变前台进程，因此不会改写已有 `✓`。
@@ -15,6 +17,18 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 _ADAPTER_DIR="${SCRIPT_DIR}/adapters"
 MODE="${1:-start}"
 MONITOR_INTERVAL="${TMUX_AI_MONITOR_INTERVAL:-1}"
+# 进程树探测节流：launcher pane 每 N 个 tick 做一次 BFS（run 循环内 _TICK 持续累加）。
+_MONITOR_PROBE_EVERY=5
+_MONITOR_TICK=0
+
+# 常见 launcher：switch/volta/npm 系脚本在前台时，目标 CLI 位于其子进程树中，
+# pane_current_command 不会直接等于 codex/opencode（cc-switch 的 switch 启动即如此）。
+_is_launcher_command() {
+    case "$(basename "${1:-}" 2>/dev/null)" in
+        switch|volta|volta-shim|node|npx|pnpx|pnpm|yarn|bun|bunx|deno) return 0 ;;
+    esac
+    return 1
+}
 
 _tmux_server_pid() {
     tmux display-message -p '#{pid}' 2>/dev/null
@@ -86,15 +100,16 @@ _pane_has_tool_process() {
     return 1
 }
 
-# 对每个无 SessionEnd 的工具名做生命周期检测：前台命令匹配 → 标记见过；
-# 曾标记但前台已切走且进程树也无该工具 → 清空 pane 状态（该工具已退出）。
-# seen 标记按工具名区分（@ai_monitor_seen_<name>），避免多工具互相踩踏清理语义。
+# 对每个无 SessionEnd 的工具名做生命周期检测：前台命令匹配或 launcher 进程树命中
+# → 标记见过；曾标记但前台已切走且进程树也无该工具 → 清空 pane 状态（该工具已退出）。
+# seen 标记按工具名区分（@ai_monitor_seen_<name>），避免多工具互相踩踏清理语义；
+# 该标记同时是 build_all_status 给 launcher pane 补 idle `-` 的依据。
 _monitor_no_session_end_lifecycle() {
     local tools name pane_id current_command sanitized pane_dir
     tools=$(_collect_no_session_end_tools)
     [ -n "$tools" ] || return 0
     for name in $tools; do
-        while IFS='|' read -r pane_id current_command seen; 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
                 [ "$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
@@ -103,8 +118,17 @@ _monitor_no_session_end_lifecycle() {
                 sanitized="${pane_id//[^a-zA-Z0-9]/_}"
                 pane_dir="${_STATUS_DIR}/${sanitized}"
                 rm -rf "$pane_dir" 2>/dev/null
+            elif [ "$seen" != "1" ] \
+                 && [ "${attached:-0}" -gt 0 ] \
+                 && [ $((_MONITOR_TICK % _MONITOR_PROBE_EVERY)) -eq 0 ] \
+                 && _is_launcher_command "$current_command" \
+                 && _pane_has_tool_process "$pane_id" "$name"; then
+                # launcher（switch/volta-shim/node）启动：前台命令不是工具名，
+                # 但进程树里有。标记 seen 后 build_all_status 才会补 idle `-`，
+                # 工具退出时也才会走上面的清理分支（否则残留状态永不清）。
+                tmux set-option -pt "$pane_id" "@ai_monitor_seen_${name}" 1 2>/dev/null || true
             fi
-        done < <(tmux list-panes -a -F "#{pane_id}|#{pane_current_command}|#{@ai_monitor_seen_${name}}" 2>/dev/null)
+        done < <(tmux list-panes -a -F "#{pane_id}|#{pane_current_command}|#{@ai_monitor_seen_${name}}|#{session_attached}" 2>/dev/null)
     done
 }
 
@@ -118,6 +142,7 @@ _monitor_tick() {
         tmux set-option -g @ai_all_status "$ALL" 2>/dev/null || return 1
         tmux refresh-client -S 2>/dev/null || true
     fi
+    _MONITOR_TICK=$((_MONITOR_TICK + 1))
     return 0
 }
 

package/src/adapters-meta.js

@@ -29,8 +29,9 @@ function buildTools(scriptsDir) {
       installer: join(scriptsDir, 'install-claude-hooks.sh'),
       hookMarker: 'tmux-ai-status',
       minHookCount: 10,
-      // cc-switch 存在时 hooks 真源在其 db（通用配置），文件判定失效 → 由 bash 侧
-      // wrapper check 判定（内部走 sqlite）；非 cc-switch 环境仍走本地文件计数。
+      // cc-switch 存在时 hooks 真源随版本变化（4.0.2+ live = ~/.claude/settings.json，
+      // 旧版 legacy = db 通用配置），文件判定失效 → 由 bash 侧 wrapper check 判定
+      // （内部按 db user_version 选真源）；非 cc-switch 环境仍走本地文件计数。
       checkViaWrapper: true,
       ccSwitchDb: join(HOME, '.cc-switch', 'cc-switch.db'),
     },

package/src/check-detail.js

@@ -11,7 +11,8 @@ const WARN = '⚠';
 
 const MODE_LABEL = {
   file: '配置文件',
-  ccswitch: 'cc-switch db（通用配置）',
+  'ccswitch-live': 'cc-switch 4.0+（~/.claude/settings.json）',
+  ccswitch: 'cc-switch 旧版 db（通用配置）',
   plugin: 'opencode plugin 文件',
   unknown: '未知',
 };

package/src/detect.js

@@ -82,7 +82,8 @@ export async function checkEnv({ probeCommand = probe } = {}) {
     pkg: 'node',
   }));
 
-  // sqlite3：仅 cc-switch 环境需要（hooks 真源在其 db 通用配置，装/卸/检查走 sqlite）
+  // sqlite3：cc-switch 环境用于读 db PRAGMA user_version 判定 live/legacy 真源；
+  // legacy 模式（真源在 db 通用配置）的装/卸/检查还依赖它写入。
   const ccSwitchDb = join(homedir(), '.cc-switch', 'cc-switch.db');
   if (existsSync(ccSwitchDb)) {
     const sqlite3 = await probeCommand('sqlite3', ['--version'], /(\d+\.\d+)/);