tmuxclihook 0.3.3 → 0.3.5

package/package.json

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

package/scripts/adapters/claude.sh

@@ -72,10 +72,7 @@ _CLAUDE_JQ_MERGE='
                         .hooks[]
                         | select(.command | contains("tmux-powerline-claude-status") | not)
                         | select(.command | contains("tmux-claude-status") | not)
-                        | select(
-                            (.command | contains("tmux-ai-status") | not)
-                            or (.command | startswith($dev_script))
-                        )
+                        | select(.command | contains("tmux-ai-status") | not)
                     ]
                     | select(.hooks | length > 0)
                 )
@@ -98,7 +95,7 @@ _CLAUDE_JQ_STRIP='
         .hooks |= if . then
             [. | to_entries[] |
                 .value |= [
-                    .[] | .hooks = [.hooks[] | select(.command | startswith($hook_script) | not)]
+                    .[] | .hooks = [.hooks[] | select(.command | contains("tmux-ai-status") | not)]
                     | select(.hooks | length > 0)
                 ]
                 | select(.value | length > 0)
@@ -107,13 +104,12 @@ _CLAUDE_JQ_STRIP='
 '
 
 _claude_apply_merge() {  # $1=输入 JSON 文件 → stdout 变换后全文档
-    jq --arg dev_script "${_LIB_DIR}/tmux-ai-status" \
-       --arg tool_cmd "${_LIB_DIR}/tmux-ai-status claude" \
+    jq --arg tool_cmd "${_LIB_DIR}/tmux-ai-status claude" \
        "$_CLAUDE_JQ_MERGE" "$1"
 }
 
 _claude_apply_strip() {  # $1=输入 JSON 文件 → stdout 变换后全文档
-    jq --arg hook_script "${_LIB_DIR}/tmux-ai-status" "$_CLAUDE_JQ_STRIP" "$1"
+    jq "$_CLAUDE_JQ_STRIP" "$1"
 }
 
 _claude_count_registered() {  # $1=输入 JSON 文件 → stdout 事件数（jq 失败时为空）
@@ -187,18 +183,41 @@ ON CONFLICT(key) DO UPDATE SET value = json_patch(settings.value, json($(_sqlquo
 }
 
 # 完整性检查：cc-switch 模式查通用配置；否则查 hooks 配置文件。
-# 10 个事件都注册了本插件 hook 才算完整；缺失（外部覆盖）→ 返回 1 触发自修复。
+# 三要素：10 事件计数 + 每个事件至少一条条目的脚本文件存活（test -x）。
+# 计数齐但脚本死（npm 包卸载/volta 升级换路径，含部分事件死）→ missing → 自修复重装收敛。
+# 存活提取内联在本函数（jq + test），不依赖 lib-install-hooks.sh——本函数同时被
+# 事件路径（lib-tmux-ai-status.sh）与 install wrapper（lib-install-hooks.sh）两个上下文调用。
 adapter_check_integrity() {
-    local registered tmp
+    local src registered ev p ok_events=""
     if _ccswitch_active; then
-        _ccswitch_dump_common tmp || return 1
-        registered=$(_claude_count_registered "$tmp")
-        rm -f "$tmp"
+        _ccswitch_dump_common src || return 1
     else
         [ -f "$ADAPTER_HOOKS_FILE" ] || return 1
-        registered=$(_claude_count_registered "$ADAPTER_HOOKS_FILE")
+        src="$ADAPTER_HOOKS_FILE"
+    fi
+    registered=$(_claude_count_registered "$src")
+    if [ "${registered:-0}" -ge 10 ]; then
+        while IFS=$'\t' read -r ev p; do
+            if [ -n "$ev" ] && [ -x "$p" ]; then
+                case ",$ok_events," in *",$ev,"*) ;; *) ok_events="$ok_events,$ev" ;; esac
+            fi
+        done < <(jq -r '.hooks as $h |
+            ["SessionStart","SessionEnd","UserPromptSubmit","PreToolUse","PostToolUse",
+             "PostToolUseFailure","PermissionRequest","Notification","Stop","StopFailure"] as $events |
+            $events[] as $e |
+            [$h[$e][]?.hooks[]?.command // empty
+             | select(contains("tmux-ai-status")) | split(" ")[0]] as $scripts |
+            select(($scripts | length) > 0) |
+            $scripts[] | "\($e)\t\(.)"' "$src" 2>/dev/null)
     fi
-    [ "${registered:-0}" -ge 10 ]
+    if [ "$src" != "$ADAPTER_HOOKS_FILE" ]; then
+        rm -f "$src"
+    fi
+    [ "${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
+    done
+    return 0
 }
 
 # 安装：合并式更新，保留他人（masko 等）注册的 hook。cc-switch 模式只写库
@@ -233,6 +252,7 @@ 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 重写一遍）

package/scripts/adapters/codex.sh

@@ -36,14 +36,38 @@ ADAPTER_PERMISSION_PRE_TOOL_NAMES="request_permissions"
 # 自修复/TUI 调用的安装脚本
 ADAPTER_INSTALLER="${_LIB_DIR}/install-codex-hooks.sh"
 
-# 完整性检查：hooks.json 是否含 6 个本插件 command（0.144+）。
+# 完整性计数：6 个事件中注册了含 tmux-ai-status codex 的 command 的事件数（按事件，
+# 非扁平总数——重复+缺失的组合在扁平计数下会假阳性）。
+_CODEX_JQ_COUNT='
+    .hooks as $h |
+    ["SessionStart","UserPromptSubmit","PreToolUse","PermissionRequest","PostToolUse","Stop"]
+    | map(select([$h[.][]?.hooks[]?.command // empty] | any(contains("tmux-ai-status codex"))))
+    | length
+'
+
+# 完整性检查：6 事件计数 + 每个事件至少一条条目的脚本文件存活（test -x）。
+# 跨安装源路径无关（contains）；脚本死路径（npm 包卸载/volta 换路径，含部分事件死）
+# → missing → install 收敛（no-op 门禁随之放行，接受一次 re-trust 代价换功能恢复）。
 adapter_check_integrity() {
     [ -f "$ADAPTER_HOOKS_FILE" ] || return 1
-    local n
-    n=$(jq '[.hooks[]?[]?.hooks[]?.command // empty
-             | select(contains("tmux-ai-status codex"))] | length' \
-        "$ADAPTER_HOOKS_FILE" 2>/dev/null)
-    [ "${n:-0}" -ge 6 ]
+    local n ev p ok_events=""
+    n=$(jq "$_CODEX_JQ_COUNT" "$ADAPTER_HOOKS_FILE" 2>/dev/null)
+    [ "${n:-0}" -ge 6 ] || return 1
+    while IFS=$'\t' read -r ev p; do
+        if [ -n "$ev" ] && [ -x "$p" ]; then
+            case ",$ok_events," in *",$ev,"*) ;; *) ok_events="$ok_events,$ev" ;; esac
+        fi
+    done < <(jq -r '.hooks as $h |
+        ["SessionStart","UserPromptSubmit","PreToolUse","PermissionRequest","PostToolUse","Stop"] as $events |
+        $events[] as $e |
+        [$h[$e][]?.hooks[]?.command // empty
+         | select(contains("tmux-ai-status codex")) | split(" ")[0]] as $scripts |
+        select(($scripts | length) > 0) |
+        $scripts[] | "\($e)\t\(.)"' "$ADAPTER_HOOKS_FILE" 2>/dev/null)
+    for ev in SessionStart UserPromptSubmit PreToolUse PermissionRequest PostToolUse Stop; do
+        case ",$ok_events," in *",$ev,"*) ;; *) return 1 ;; esac
+    done
+    return 0
 }
 
 # Codex 6 事件（全部同步——0.144 静默跳过 async=true 的 hook）
@@ -73,11 +97,17 @@ _codex_read_existing() {
 }
 
 # 安装：改写 hooks.json（剥离旧 managed group 后为每事件追加本插件 group），保留他人 hook。
+# no-op if valid：事件齐全且脚本存活时不改写——重写即 trusted_hash 失效（command 路径
+# 变化 → codex 启动要重新 Trust all），跨安装源重复安装因此保持既有授信。
 # 清理旧 hooks.toml（0.144 不再读取）。trust 无法在 bash 复现，靠用户首启 codex TUI 授信。
 adapter_install_hooks() {
     _install_require_jq
     mkdir -p "$(dirname "$ADAPTER_HOOKS_FILE")" 2>/dev/null || true
     [ -f "$_CODEX_LEGACY_TOML" ] && rm -f "$_CODEX_LEGACY_TOML" && echo "移除旧 hooks.toml（0.144 不再读取）"
+    if adapter_check_integrity; then
+        echo "Codex hooks already installed and valid at $ADAPTER_HOOKS_FILE (no-op, trust preserved)"
+        return 0
+    fi
     local hook_script="${_LIB_DIR}/tmux-ai-status"
     local new_json
     new_json=$(_codex_read_existing | _codex_strip_managed | jq \

package/scripts/adapters/opencode.sh

@@ -39,11 +39,17 @@ ADAPTER_INSTALLER="${_LIB_DIR}/install-opencode-hooks.sh"
 
 _OPENCODE_MARKER="tmux-ai-status (managed by tmux-ai-hooks-status)"
 
-# 完整性检查：plugin 文件存在且含本插件标记 + 指向当前仓库的 hook 脚本路径。
+# 完整性检查：plugin 文件存在 + 本插件标记 + 结构指纹 + HOOK_SCRIPT 指向的脚本存活。
+# 路径无关（不比对当前 _LIB_DIR——跨安装源的合法 plugin 同样有效）；
+# 脚本死路径（npm 包卸载/换路径）→ missing → 重装收敛。
 adapter_check_integrity() {
     [ -f "$ADAPTER_HOOKS_FILE" ] || return 1
     grep -q "$_OPENCODE_MARKER" "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
-    grep -q "${_LIB_DIR}/tmux-ai-status" "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
+    local script_path
+    script_path=$(sed -n 's/^const HOOK_SCRIPT = "\(.*\)"$/\1/p' "$ADAPTER_HOOKS_FILE" 2>/dev/null | head -n 1)
+    if [ -z "$script_path" ] || [ ! -x "$script_path" ]; then
+        return 1
+    fi
     grep -q 'case "permission.asked"' "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
     grep -q 'case "question.asked"' "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
     grep -q 'case "permission.replied"' "$ADAPTER_HOOKS_FILE" 2>/dev/null || return 1
@@ -142,7 +148,12 @@ EOF
 }
 
 # 安装：写出/覆盖 plugin 文件。整文件替换（非合并）——同目录下他人 plugin 文件不受影响。
+# no-op if valid：文件完整且 HOOK_SCRIPT 存活时不重写（避免跨安装源无谓覆盖）。
 adapter_install_hooks() {
+    if adapter_check_integrity; then
+        echo "opencode plugin already installed and valid at $ADAPTER_HOOKS_FILE (no-op)"
+        return 0
+    fi
     mkdir -p "$(dirname "$ADAPTER_HOOKS_FILE")" 2>/dev/null || true
     local hook_script="${_LIB_DIR}/tmux-ai-status"
     local content

package/scripts/install-claude-hooks.sh

@@ -1,11 +1,13 @@
 #!/bin/bash
 # install-claude-hooks.sh — Claude Code hooks 安装/卸载/检查 wrapper
-# 用法: install-claude-hooks.sh [uninstall|check]
+# 用法: install-claude-hooks.sh [install|uninstall|check|auto]
 #
 # 薄 wrapper：source 公共骨架 + claude adapter，dispatch 到 adapter_install_hooks /
 # adapter_uninstall_hooks。实际逻辑在 scripts/adapters/claude.sh。
 # check：输出 ok/missing（exit 0/1），供 TUI 侦测在 cc-switch 模式下走 bash 侧
 # 完整性判定（sqlite 真源），与非 cc-switch 的文件判定共用同一真相。
+# auto：tmux 入口加载时的自动安装——存在卸载意图标记（suppressed-claude）时不装。
+# 显式 uninstall 成功写标记、显式 install 成功清标记（见 lib-install-hooks.sh）。
 
 set -o errexit
 set -o pipefail
@@ -14,15 +16,28 @@ _LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
 source "${_LIB_DIR}/lib-install-hooks.sh"
 source "${_LIB_DIR}/adapters/claude.sh"
 
-if [ "${1:-install}" = "uninstall" ]; then
-    adapter_uninstall_hooks
-elif [ "${1:-}" = "check" ]; then
-    if adapter_check_integrity; then
-        echo ok
-    else
-        echo missing
-        exit 1
-    fi
-else
-    adapter_install_hooks
-fi
+case "${1:-install}" in
+    uninstall)
+        adapter_uninstall_hooks
+        _hooks_suppress_write claude
+        ;;
+    check)
+        if adapter_check_integrity; then
+            echo ok
+        else
+            echo missing
+            exit 1
+        fi
+        ;;
+    auto)
+        if [ -f "$(_hooks_suppress_file claude)" ]; then
+            exit 0
+        fi
+        adapter_install_hooks
+        _hooks_suppress_clear claude
+        ;;
+    *)
+        adapter_install_hooks
+        _hooks_suppress_clear claude
+        ;;
+esac

package/scripts/install-codex-hooks.sh

@@ -1,9 +1,11 @@
 #!/bin/bash
-# install-codex-hooks.sh — Codex CLI hooks 安装/卸载 wrapper（需 codex ≥ 0.144）
-# 用法: install-codex-hooks.sh [uninstall]
+# install-codex-hooks.sh — Codex CLI hooks 安装/卸载/检查 wrapper（需 codex ≥ 0.144）
+# 用法: install-codex-hooks.sh [install|uninstall|check]
 #
 # 薄 wrapper：source 公共骨架 + codex adapter，dispatch 到 adapter_install_hooks /
 # adapter_uninstall_hooks。实际逻辑在 scripts/adapters/codex.sh。
+# check：输出 ok/missing（exit 0/1），供 TUI 侦测走 bash 侧完整性判定。
+# 显式 uninstall 成功写标记、显式 install 成功清标记（见 lib-install-hooks.sh）。
 
 set -o errexit
 set -o pipefail
@@ -12,8 +14,21 @@ _LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
 source "${_LIB_DIR}/lib-install-hooks.sh"
 source "${_LIB_DIR}/adapters/codex.sh"
 
-if [ "${1:-install}" = "uninstall" ]; then
-    adapter_uninstall_hooks
-else
-    adapter_install_hooks
-fi
+case "${1:-install}" in
+    uninstall)
+        adapter_uninstall_hooks
+        _hooks_suppress_write codex
+        ;;
+    check)
+        if adapter_check_integrity; then
+            echo ok
+        else
+            echo missing
+            exit 1
+        fi
+        ;;
+    *)
+        adapter_install_hooks
+        _hooks_suppress_clear codex
+        ;;
+esac

package/scripts/install-opencode-hooks.sh

@@ -1,9 +1,11 @@
 #!/bin/bash
-# install-opencode-hooks.sh — opencode plugin 安装/卸载 wrapper
-# 用法: install-opencode-hooks.sh [uninstall]
+# install-opencode-hooks.sh — opencode plugin 安装/卸载/检查 wrapper
+# 用法: install-opencode-hooks.sh [install|uninstall|check]
 #
 # 薄 wrapper：source 公共骨架 + opencode adapter，dispatch 到 adapter_install_hooks /
 # adapter_uninstall_hooks。实际逻辑在 scripts/adapters/opencode.sh。
+# check：输出 ok/missing（exit 0/1），供 TUI 侦测走 bash 侧完整性判定。
+# 显式 uninstall 成功写标记、显式 install 成功清标记（见 lib-install-hooks.sh）。
 
 set -o errexit
 set -o pipefail
@@ -12,8 +14,21 @@ _LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
 source "${_LIB_DIR}/lib-install-hooks.sh"
 source "${_LIB_DIR}/adapters/opencode.sh"
 
-if [ "${1:-install}" = "uninstall" ]; then
-    adapter_uninstall_hooks
-else
-    adapter_install_hooks
-fi
+case "${1:-install}" in
+    uninstall)
+        adapter_uninstall_hooks
+        _hooks_suppress_write opencode
+        ;;
+    check)
+        if adapter_check_integrity; then
+            echo ok
+        else
+            echo missing
+            exit 1
+        fi
+        ;;
+    *)
+        adapter_install_hooks
+        _hooks_suppress_clear opencode
+        ;;
+esac

package/scripts/lib-install-hooks.sh

@@ -24,3 +24,16 @@ _install_atomic_write() {
     printf '%s\n' "$content" > "$tmp"
     mv -f "$tmp" "$target"
 }
+
+# --- 卸载意图标记（suppression marker）---
+# 显式 uninstall 成功 → 写 suppressed-<tool>；显式 install 成功 → 清。
+# 自动修复路径（_maybe_repair_hooks / 入口 auto / SessionStart 重装）见标记一律不装。
+# ⚠️ _SUPPRESS_DIR 与 lib-tmux-ai-status.sh 中的定义保持一致（两处同步改）。
+_SUPPRESS_DIR="${TMUX_AI_SUPPRESS_DIR:-${XDG_CONFIG_HOME:-${HOME}/.config}/tmuxclihook}"
+
+_hooks_suppress_file() { printf '%s/suppressed-%s' "$_SUPPRESS_DIR" "$1"; }
+_hooks_suppress_write() {
+    mkdir -p "$_SUPPRESS_DIR" 2>/dev/null || true
+    date +%s > "$(_hooks_suppress_file "$1")" 2>/dev/null || true
+}
+_hooks_suppress_clear() { rm -f "$(_hooks_suppress_file "$1")" 2>/dev/null || true; }

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

@@ -6,6 +6,8 @@
 _LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 _STATUS_DIR="${TMUX_AI_STATUS_DIR:-/tmp/ai-status}"
+# 卸载意图标记目录（suppressed-<tool>）。⚠️ 与 lib-install-hooks.sh 中的定义保持一致（两处同步改）。
+_SUPPRESS_DIR="${TMUX_AI_SUPPRESS_DIR:-${XDG_CONFIG_HOME:-${HOME}/.config}/tmuxclihook}"
 STATUS_COLOR="#F1FA8C"
 
 # --- 日志模块 ---
@@ -533,6 +535,10 @@ _check_hooks_integrity() {
 # 不依赖 SESSION_ID/EVENT，可被 _refresh 触发。60s 节流。
 # 安装器由 adapter 声明（ADAPTER_INSTALLER）。
 _maybe_repair_hooks() {
+    # 用户显式卸载意图（suppressed-<tool>）→ 不自动修复，尊重到显式安装为止。
+    if [ -f "${_SUPPRESS_DIR}/suppressed-${TOOL_ID:-claude}" ]; then
+        return 0
+    fi
     local marker="${_STATUS_DIR}/.hooks-repair-${TOOL_ID:-claude}-ts"
     local now
     now=$(date +%s)

package/scripts/tmux-ai-status

@@ -178,8 +178,12 @@ case "$EVENT" in
     STATUS="-"
     _clear_pending
     if ! _check_hooks_integrity; then
-        "${ADAPTER_INSTALLER}" >/dev/null 2>&1
-        tmux display-message "⚠ ${TOOL_ID} hooks 已自动修复（检测到缺失）" 2>/dev/null || true
+        if [ -f "${_SUPPRESS_DIR}/suppressed-${TOOL_ID}" ]; then
+            _ai_log "REPAIR: suppressed by uninstall marker, skip (${TOOL_ID})"
+        else
+            "${ADAPTER_INSTALLER}" >/dev/null 2>&1
+            tmux display-message "⚠ ${TOOL_ID} hooks 已自动修复（检测到缺失）" 2>/dev/null || true
+        fi
     fi
     ;;
   SessionEnd)

package/src/adapters-meta.js

@@ -45,6 +45,9 @@ function buildTools(scriptsDir) {
       installer: join(scriptsDir, 'install-codex-hooks.sh'),
       hookMarker: 'tmux-ai-status codex',
       minHookCount: 6,
+      // 无 cc-switch 真源（hooks.json 即文件真源），但统一走 wrapper check 以获得
+      // 脚本存活校验（死路径 → missing → repair 收敛），与 bash 侧同一份真相。
+      checkViaWrapper: true,
     },
     {
       id: 'opencode',
@@ -62,6 +65,9 @@ function buildTools(scriptsDir) {
       installer: join(scriptsDir, 'install-opencode-hooks.sh'),
       hookMarker: 'tmux-ai-status (managed by tmux-ai-hooks-status)',
       minHookCount: 1,
+      // 统一走 wrapper check：bash 侧含 HOOK_SCRIPT 存活校验（死路径 → missing →
+      // repair 收敛），JS 文件计数判不出死路径。
+      checkViaWrapper: true,
     },
   ];
 }

package/src/detect.js

@@ -121,10 +121,11 @@ function hooksInstalled(tool) {
   }
 }
 
-// 异步判定：声明 checkViaWrapper 且 cc-switch db 存在时，走 bash wrapper check
-// （bash 侧按 sqlite 通用配置判定真源）；否则回落本地文件计数。
+// 异步判定：声明 checkViaWrapper 时走 bash wrapper check（cc-switch 模式在 bash 侧
+// 按 sqlite 通用配置判定真源；所有 adapter check 均含脚本存活校验）；未声明的工具
+// 回落本地文件计数。
 async function hooksInstalledAsync(tool) {
-  if (tool.checkViaWrapper && tool.ccSwitchDb && existsSync(tool.ccSwitchDb)) {
+  if (tool.checkViaWrapper && (!tool.ccSwitchDb || existsSync(tool.ccSwitchDb))) {
     try {
       const { stdout, exitCode } = await execa('bash', [tool.installer, 'check'], {
         reject: false,

package/src/update.js

@@ -12,8 +12,9 @@ export const CURRENT_VERSION = packageJson.version;
 // `npm install -g` 在版本管理器（volta 等）环境下不会更新其管理的 shim：
 // volta 的 `~/.volta/bin` shim 指向 packages/ 镜像，而 npm -g 只写 node
 // 工具链目录，两者互不感知（实测 0.3.0 → 0.3.2 升级时用户命令仍解析到
-// 旧版）。install 成功后按 PATH 解析「用户实际会运行的那份」，尽力读取
-// 真实版本并与 registry latest 比对，无法确认或版本不符时打警告。
+// 旧版）。生效收敛由 repairWithVolta 无条件完成（见下）；本节自检只是
+// 事后确认：按 update 进程的 PATH 解析一份，尽力读取真实版本并与
+// registry latest 比对，无法确认或版本不符时打警告。
 // 验证是尽力而为的提示，不改变 update 的返回值（install 本身已成功）。
 
 function findOnPath(name, env) {
@@ -95,9 +96,12 @@ function warnNotEffective(log, result) {
 
 // volta 生效修正：`npm install -g` 只写 node 工具链目录，不更新 volta 的
 // shim 镜像（实测 volta 2.0.2：shim npm 的全局 prefix 就是工具链目录），
-// 用户的命令经 ~/.volta/bin shim 解析时仍是旧版。检测到 volta 可用时自动
-// 补一次 volta install 使更新生效。npm install -g 始终是安装语义本身，
-// volta 只在自检发现未生效时被自动调用，用户无需改变安装习惯。
+// 用户的命令经 ~/.volta/bin shim 解析时仍是旧版。因此只要检测到 volta
+// 就无条件补一次 volta install 完成生效（幂等，已是最新时秒回）。不走
+// 「自检失败才修」的条件路径：自检按 update 进程自己的 PATH 找第一份，
+// 可能恰好命中 npm -g 刚写的那份而误判 ok（实测 0.3.3 → 0.3.4：verify
+// 判 ok，修复从未触发，用户命令仍是旧版）。npm install -g 是安装语义，
+// volta install 是生效语义，两者都执行；用户无需改变安装习惯。
 export async function repairWithVolta(run, log, env = process.env) {
   const voltaHome = env.VOLTA_HOME || join(env.HOME || '', '.volta');
   const voltaBin = findOnPath('volta', env) || join(voltaHome, 'bin', 'volta');
@@ -149,19 +153,20 @@ export async function updatePackage(options = {}) {
 
   log.log(`Done. Updated to v${latestVersion}`);
 
+  // 生效收敛：有 volta 就无条件跑（幂等；无 volta 时静默跳过，纯 npm 场景
+  // npm -g 本身已生效）。任何命令行执行 update 都能升级生效的关键。
+  if (repairVolta) {
+    await repairVolta(run, log);
+  }
+
   if (verify) {
-    let result = await verify(latestVersion);
-    if (result.status !== 'ok') {
-      // PATH 命中的副本未反映新版本（典型：volta shim 镜像未更新）——
-      // 自动走 volta 完成生效步骤，然后复检。
-      if (repairVolta && await repairVolta(run, log)) {
-        result = await verify(latestVersion);
-      }
-      if (result.status === 'ok') {
-        log.log(`Verified: tmuxclihook on your PATH now resolves to v${latestVersion}.`);
-      } else {
-        warnNotEffective(log, result);
-      }
+    // 事后确认（尽力而为）：两处落点都应已是新版，命中哪份都该 ok；
+    // 不 ok（如 PATH 上另有第三份旧安装）只警告，不影响返回值。
+    const result = await verify(latestVersion);
+    if (result.status === 'ok') {
+      log.log(`Verified: tmuxclihook on your PATH now resolves to v${latestVersion}.`);
+    } else {
+      warnNotEffective(log, result);
     }
   }
 

package/tmux-ai-hooks-status.tmux

@@ -58,8 +58,10 @@ if [ -z "$(tmux show-option -gv @claude_hooks_reload_registered 2>/dev/null)" ];
 fi
 
 # --- 自动注册 Claude hooks（幂等，每次插件加载时确保 hooks 存在）---
+# auto 模式：用户显式卸载过（suppressed-claude 标记在）时静默跳过，尊重卸载意图；
+# 显式安装（prefix+C-h / TUI）才会清除标记恢复自动守护。
 # 注：codex/opencode hooks 不自动安装（非人人安装），用 prefix+M-h / prefix+C-p 手动装。
-"${CURRENT_DIR}/scripts/install-claude-hooks.sh" >/dev/null 2>&1 || true
+"${CURRENT_DIR}/scripts/install-claude-hooks.sh" auto >/dev/null 2>&1 || true
 
 # --- 启动 tmux server 级状态监控器 ---
 # Codex/opencode 均无 SessionEnd（codex 的 SessionStart 还延迟到首个 turn）；