tmuxclihook 0.2.2 → 0.3.0

package/README.md

@@ -32,8 +32,8 @@ hooks 安装、tmux 集成写入的路径由「source」决定：环境变量 `T
 
 | 菜单项 | 说明 |
 |--------|------|
-| 环境检查 | 侦测 tmux(≥3.1) / jq / bash(任意版本) / node(≥18)，显示 `✓ ready`、`✗ missing`、`⚠ outdated`，并在确认后安全修复 |
-| 侦测 AI CLI | 扫描 Claude Code / Codex / opencode，显示版本、最低版本和 hooks 状态；不自动安装或升级 AI CLI |
+| 环境检查 | 侦测 tmux(≥3.1) / jq / bash(任意版本) / node(≥18)，显示 `✓ ready`、`✗ missing`、`⚠ outdated`，并在确认后安全修复。检测到 cc-switch（`~/.cc-switch/cc-switch.db`）时追加 sqlite3 项 |
+| 侦测 AI CLI | 扫描 Claude Code / Codex / opencode，显示版本、最低版本和 hooks 状态；不自动安装或升级 AI CLI。cc-switch 环境下 Claude Code 的 hooks 状态由 bash 侧 `install-claude-hooks.sh check`（sqlite 真源）判定 |
 | 安装 hooks | 选工具（claude/codex/opencode/全部）→ 调 `scripts/install-<tool>-hooks.sh`（路径随当前 source 解析） |
 | 卸载 hooks | 对称卸载本插件 hooks，保留其他工具注册的 hook |
 | 修复 hooks | 完整性检查 → 缺失则重装 |
@@ -41,6 +41,10 @@ hooks 安装、tmux 集成写入的路径由「source」决定：环境变量 `T
 | source 管理 | 查看当前生效 source（来源 + 失效警告）；设置本地仓库路径用于开发调试；清除持久化配置恢复默认 |
 | 完整卸载插件 | 停止 Codex monitor、清除聚合状态 `@ai_all_status`、清理历史遗留软链（不删仓库）；`.tmux.conf` 删声明与 `tmux kill-server` 因破坏性仅打印手动指引 |
 
+### 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。
+
 ## Source 管理（生产默认 / 本地调试切换）
 
 `npm i -g` 装完后，hooks 安装与 tmux 集成默认使用包内自带的 `scripts/`（由 `npm publish` 前的 `prepack` 步骤从仓库根复制打包进来，见「架构」一节），开箱即用，无需仓库 checkout。

package/bin/cli.js

@@ -6,7 +6,7 @@
 //
 // "source" 决定 scripts/ 与 tmux 入口来自哪里：环境变量 TMUXCLIHOOK_SOURCE >
 // 持久化配置 ~/.config/tmuxclihook/config.json > 包内自带（生产默认）> 仓库根
-// （开发回落）。见 src/source.js 与 docs/2026-07-15-npm-global-install-plan.md。
+// （开发回落）。见 src/source.js。
 
 import { homedir } from 'node:os';
 import * as p from '@clack/prompts';

package/package.json

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

package/scripts/adapters/claude.sh

@@ -25,7 +25,8 @@ ADAPTER_EVENTS="SessionStart SessionEnd UserPromptSubmit PreToolUse PostToolUse
 # 前台进程名（BFS pane 进程树匹配 basename）
 ADAPTER_PROCESS_NAMES="claude"
 
-# hooks 配置：~/.claude/settings.json（CLAUDE_CONFIG_DIR 可覆盖）
+# hooks 配置：~/.claude/settings.json（CLAUDE_CONFIG_DIR 可覆盖）。
+# 仅在非 cc-switch 环境作为写入目标；cc-switch 环境见 _ccswitch_active。
 ADAPTER_HOOKS_FILE="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/settings.json"
 
 # Claude Code 有 SessionEnd 事件，退出即发 hook → 状态可主动清。
@@ -38,34 +39,25 @@ ADAPTER_HOLD_UNMATCHED_PERMISSION="false"
 # 自修复/TUI 调用的安装脚本
 ADAPTER_INSTALLER="${_LIB_DIR}/install-claude-hooks.sh"
 
-# 完整性检查：settings.json 的 10 个事件是否都注册了本插件 hook。
-# 缺失（外部应用覆盖配置）→ 返回 1。
-adapter_check_integrity() {
-    [ -f "$ADAPTER_HOOKS_FILE" ] || return 1
-    local registered
-    registered=$(jq '
-        .hooks as $h |
-        ["SessionStart","SessionEnd","UserPromptSubmit","PreToolUse","PostToolUse",
-         "PostToolUseFailure","PermissionRequest","Notification","Stop","StopFailure"]
-        | map(select([$h[.][]?.hooks[]?.command // empty] | any(contains("tmux-ai-status"))))
-        | length
-    ' "$ADAPTER_HOOKS_FILE" 2>/dev/null)
-    [ "${registered:-0}" -ge 10 ]
-}
-
 # Claude 事件集合（含同步事件 PermissionRequest）。install/uninstall 用。
 _CLAUDE_EVENTS="SessionStart SessionEnd UserPromptSubmit PreToolUse PostToolUse PostToolUseFailure PermissionRequest Notification Stop StopFailure"
 
-# 安装：合并式更新 settings.json，保留他人（masko 等）注册的 hook。
-# 清理 legacy 名（tmux-claude-status / tmux-powerline-claude-status）+ 指向其他路径的
-# stale tmux-ai-status 条目，$TOOL_CMD 未注册则追加。PermissionRequest 为 sync（async=false）。
-adapter_install_hooks() {
-    _install_require_jq
-    [ -f "$ADAPTER_HOOKS_FILE" ] || _install_atomic_write '{}' "$ADAPTER_HOOKS_FILE"
-    local hook_script="${_LIB_DIR}/tmux-ai-status"
-    local tool_cmd="${hook_script} claude"
-    local updated
-    updated=$(jq --arg dev_script "$hook_script" --arg tool_cmd "$tool_cmd" '
+# ─── jq 程序常量：文件模式与 cc-switch 模式共用同一合并/剥离/计数核心 ───
+# 程序文本内无单引号，可安全放入单引号 shell 变量。
+
+# 完整性计数：10 个事件中注册了含 tmux-ai-status 的 command 的事件数。
+_CLAUDE_JQ_COUNT='
+    .hooks as $h |
+    ["SessionStart","SessionEnd","UserPromptSubmit","PreToolUse","PostToolUse",
+     "PostToolUseFailure","PermissionRequest","Notification","Stop","StopFailure"]
+    | map(select([$h[.][]?.hooks[]?.command // empty] | any(contains("tmux-ai-status"))))
+    | length
+'
+
+# 合并式安装：剥 legacy 名（tmux-claude-status / tmux-powerline-claude-status）+
+# 指向其他路径的 stale tmux-ai-status 条目，$tool_cmd 未注册则追加。
+# PermissionRequest 为 sync（async=false）。
+_CLAUDE_JQ_MERGE='
         ["SessionStart","SessionEnd","UserPromptSubmit","PreToolUse","PostToolUse",
          "PostToolUseFailure","PermissionRequest","Notification","Stop","StopFailure"] as $events |
         ["PermissionRequest"] as $sync_events |
@@ -99,19 +91,10 @@ adapter_install_hooks() {
                 }]
             else . end
         )
-    ' "$ADAPTER_HOOKS_FILE")
-    _install_atomic_write "$updated" "$ADAPTER_HOOKS_FILE"
-    echo "Claude hooks installed to $ADAPTER_HOOKS_FILE"
-    echo "Events: $_CLAUDE_EVENTS"
-}
+'
 
-# 卸载：单次 jq pipeline 移除所有指向本插件的 hooks，保留他人条目。
-adapter_uninstall_hooks() {
-    _install_require_jq
-    [ -f "$ADAPTER_HOOKS_FILE" ] || { echo "Claude hooks: nothing to uninstall"; return 0; }
-    local hook_script="${_LIB_DIR}/tmux-ai-status"
-    local updated
-    updated=$(jq --arg hook_script "$hook_script" '
+# 剥离：移除所有指向本插件的条目，保留他人 hook，空 group/事件删除。
+_CLAUDE_JQ_STRIP='
         .hooks |= if . then
             [. | to_entries[] |
                 .value |= [
@@ -121,7 +104,164 @@ adapter_uninstall_hooks() {
                 | select(.value | length > 0)
             ] | from_entries
         else . end
-    ' "$ADAPTER_HOOKS_FILE")
+'
+
+_claude_apply_merge() {  # $1=输入 JSON 文件 → stdout 变换后全文档
+    jq --arg dev_script "${_LIB_DIR}/tmux-ai-status" \
+       --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"
+}
+
+_claude_count_registered() {  # $1=输入 JSON 文件 → stdout 事件数（jq 失败时为空）
+    jq "$_CLAUDE_JQ_COUNT" "$1" 2>/dev/null
+}
+
+# ─── 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 缺失等一切门禁不过 → 整体回退传统文件模式。
+
+_ccswitch_db() { printf '%s\n' "${HOME}/.cc-switch/cc-switch.db"; }
+
+# 门禁：db 存在 && sqlite3 可用 && settings 表可查。不要求 key 存在
+# （从未编辑过通用配置的用户由 install 的 upsert 建行；若此处要求 key，
+# 会静默回退文件模式 → 实例永不含 hooks + 自修复空转）。
+_ccswitch_active() {
+    local db
+    db="$(_ccswitch_db)"
+    [ -f "$db" ] || return 1
+    command -v sqlite3 >/dev/null 2>&1 || return 1
+    sqlite3 -readonly "$db" \
+        "SELECT 1 FROM sqlite_master WHERE type='table' AND name='settings'" 2>/dev/null \
+        | grep -q 1
+}
+
+# cc-switch GUI 运行中会把内存缓存的通用配置全量写回 db（实测发生过），警告不阻塞。
+_ccswitch_warn_gui() {
+    if pgrep -ix "cc-switch" >/dev/null 2>&1 \
+       || pgrep -f "cc-switch.app/Contents/MacOS" >/dev/null 2>&1; then
+        echo "WARN: cc-switch GUI 正在运行，其内存缓存可能在退出时覆盖本次写入；" \
+             "建议退出 GUI 后重跑安装确认。tmux 会话活跃时自修复会在 60s 内重写。" >&2
+    fi
+}
+
+# 读通用配置 value → mktemp 文件，路径写入 $1 命名的变量。
+# 行缺失/空白 → "{}"；非空但非法 JSON → 明确报错 return 1（绝不覆盖用户数据）。
+# 注意：内部临时变量名不得与调用方常用名（tmp 等）同名——bash 动态作用域下
+# printf -v "$1" 会写到本函数的同名 local，函数返回即丢失。
+_ccswitch_dump_common() {  # $1=out var name
+    local _cc_out_file
+    _cc_out_file=$(mktemp "${TMPDIR:-/tmp}/ccswitch-common.XXXXXX") || return 1
+    sqlite3 -readonly "$(_ccswitch_db)" \
+        "SELECT value FROM settings WHERE key='common_config_claude'" > "$_cc_out_file" 2>/dev/null
+    if [ ! -s "$_cc_out_file" ] || [ -z "$(tr -d '[:space:]' < "$_cc_out_file")" ]; then
+        printf '{}\n' > "$_cc_out_file"
+    elif ! jq -e . "$_cc_out_file" >/dev/null 2>&1; then
+        rm -f "$_cc_out_file"
+        echo "ERROR: cc-switch 通用配置不是合法 JSON，拒绝操作。排查:" >&2
+        echo "  sqlite3 -readonly $(_ccswitch_db) \"SELECT value FROM settings WHERE key='common_config_claude'\"" >&2
+        return 1
+    fi
+    printf -v "$1" '%s' "$_cc_out_file"
+}
+
+# SQL 字符串字面量转义（' → ''），与 cc-launch 写回通用配置的 sqlQuote 同规则。
+_sqlquote() { printf "'%s'" "$(printf '%s' "$1" | sed "s/'/''/g")"; }
+
+# 单条 upsert 写库：行存在 → json_patch 深合并（RFC 7396，只动 patch 内的键）；
+# 行缺失 → 整文档插入。与 cc-launch 写回通用配置同款机制。
+_ccswitch_upsert_hooks() {  # $1=hooks patch JSON(紧凑)  $2=完整文档 JSON(行缺失时插入用)
+    local sql
+    sql="INSERT INTO settings(key, value) VALUES('common_config_claude', json($(_sqlquote "$2")))
+ON CONFLICT(key) DO UPDATE SET value = json_patch(settings.value, json($(_sqlquote "$1")))"
+    if ! sqlite3 -cmd ".timeout 5000" "$(_ccswitch_db)" "$sql" 2>/dev/null; then
+        echo "ERROR: 写入 cc-switch.db 失败（库可能被占用；tmux 会话活跃时自修复会重试）" >&2
+        return 1
+    fi
+}
+
+# 完整性检查：cc-switch 模式查通用配置；否则查 hooks 配置文件。
+# 10 个事件都注册了本插件 hook 才算完整；缺失（外部覆盖）→ 返回 1 触发自修复。
+adapter_check_integrity() {
+    local registered tmp
+    if _ccswitch_active; then
+        _ccswitch_dump_common tmp || return 1
+        registered=$(_claude_count_registered "$tmp")
+        rm -f "$tmp"
+    else
+        [ -f "$ADAPTER_HOOKS_FILE" ] || return 1
+        registered=$(_claude_count_registered "$ADAPTER_HOOKS_FILE")
+    fi
+    [ "${registered:-0}" -ge 10 ]
+}
+
+# 安装：合并式更新，保留他人（masko 等）注册的 hook。cc-switch 模式只写库
+# （~/.claude/settings.json 与实例文件都会被 cc-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"
+    echo "Events: $_CLAUDE_EVENTS"
+}
+
+# 卸载：单次 jq pipeline 移除所有指向本插件的 hooks，保留他人条目。
+# cc-switch 模式：剥离前后对照生成 patch（被清空的事件键置 null = RFC 7396 删键），
+# 顶层其他字段（model/env/…）由 json_patch 天然保留。
+adapter_uninstall_hooks() {
+    _install_require_jq
+    if _ccswitch_active; then
+        local tmp stripped cur_hooks final_hooks patch managed top_patch
+        _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"
+        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）
+        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"
 }

package/scripts/install-claude-hooks.sh

@@ -1,9 +1,11 @@
 #!/bin/bash
-# install-claude-hooks.sh — Claude Code hooks 安装/卸载 wrapper
-# 用法: install-claude-hooks.sh [uninstall]
+# install-claude-hooks.sh — Claude Code hooks 安装/卸载/检查 wrapper
+# 用法: install-claude-hooks.sh [uninstall|check]
 #
 # 薄 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 的文件判定共用同一真相。
 
 set -o errexit
 set -o pipefail
@@ -14,6 +16,13 @@ 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

package/src/adapters-meta.js

@@ -29,6 +29,10 @@ 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 环境仍走本地文件计数。
+      checkViaWrapper: true,
+      ccSwitchDb: join(HOME, '.cc-switch', 'cc-switch.db'),
     },
     {
       id: 'codex',

package/src/detect.js

@@ -1,6 +1,8 @@
 // detect.js — 环境依赖侦测 + AI CLI 侦测
 import { execa } from 'execa';
 import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 import { TOOLS, versionGte } from './adapters-meta.js';
 
 // 探测某命令是否存在 + 版本
@@ -80,6 +82,23 @@ export async function checkEnv({ probeCommand = probe } = {}) {
     pkg: 'node',
   }));
 
+  // sqlite3：仅 cc-switch 环境需要（hooks 真源在其 db 通用配置，装/卸/检查走 sqlite）
+  const ccSwitchDb = join(homedir(), '.cc-switch', 'cc-switch.db');
+  if (existsSync(ccSwitchDb)) {
+    const sqlite3 = await probeCommand('sqlite3', ['--version'], /(\d+\.\d+)/);
+    results.push(envResult({
+      name: 'sqlite3',
+      found: sqlite3.found,
+      meetsMinimum: sqlite3.found,
+      detail: sqlite3.found
+        ? `v${sqlite3.version}（cc-switch 模式）`
+        : '未安装（cc-switch 模式需要）',
+      min: '任意版本',
+      fixCmd: 'brew install sqlite3',
+      pkg: 'sqlite3',
+    }));
+  }
+
   return results;
 }
 
@@ -90,7 +109,7 @@ export function interactiveShell() {
   return { path: sh || '未知', name };
 }
 
-// 侦测某工具是否已装本插件 hooks
+// 侦测某工具是否已装本插件 hooks（同步文件版：非 cc-switch 路径/向后兼容）
 function hooksInstalled(tool) {
   try {
     if (!existsSync(tool.hooksFile)) return false;
@@ -102,6 +121,23 @@ function hooksInstalled(tool) {
   }
 }
 
+// 异步判定：声明 checkViaWrapper 且 cc-switch db 存在时，走 bash wrapper check
+// （bash 侧按 sqlite 通用配置判定真源）；否则回落本地文件计数。
+async function hooksInstalledAsync(tool) {
+  if (tool.checkViaWrapper && tool.ccSwitchDb && existsSync(tool.ccSwitchDb)) {
+    try {
+      const { stdout, exitCode } = await execa('bash', [tool.installer, 'check'], {
+        reject: false,
+        timeout: 15000,
+      });
+      return exitCode === 0 && String(stdout).trim() === 'ok';
+    } catch {
+      return false;
+    }
+  }
+  return hooksInstalled(tool);
+}
+
 // 侦测所有已装 AI CLI
 export async function detectClis() {
   const rows = [];
@@ -115,10 +151,10 @@ export async function detectClis() {
       version: p.version,
       meetsMin,
       minVersion: tool.minVersion,
-      hooksInstalled: p.found ? hooksInstalled(tool) : false,
+      hooksInstalled: p.found ? await hooksInstalledAsync(tool) : false,
     });
   }
   return rows;
 }
 
-export { hooksInstalled };
+export { hooksInstalled, hooksInstalledAsync };

package/src/hooks.js

@@ -2,7 +2,7 @@
 import { execa } from 'execa';
 import { existsSync } from 'node:fs';
 import { toolById } from './adapters-meta.js';
-import { hooksInstalled } from './detect.js';
+import { hooksInstalledAsync } from './detect.js';
 
 // 安装某工具 hooks（调薄 wrapper install-<tool>-hooks.sh）
 export async function installHooks(id) {
@@ -30,11 +30,12 @@ export async function uninstallHooks(id) {
   }
 }
 
-// 修复某工具 hooks：完整性检查（JS 侧 hooksInstalled）→ 缺失则重装
+// 修复某工具 hooks：完整性检查（cc-switch 模式走 bash wrapper check，否则文件计数）
+// → 缺失则重装
 export async function repairHooks(id) {
   const tool = toolById(id);
   if (!tool) return { ok: false, output: `未知工具: ${id}` };
-  if (hooksInstalled(tool)) {
+  if (await hooksInstalledAsync(tool)) {
     return { ok: true, output: `${tool.label} hooks 完整，无需修复`, repaired: false };
   }
   const r = await installHooks(id);

package/src/tmuxconf.js

@@ -3,8 +3,7 @@
 // 加载机制不再依赖 TPM 风格的 `@plugin` 声明与软链，而是直接一行
 // `run-shell '<当前 source 的 tmux 入口绝对路径>'`。TMUX_ENTRY 随 source.js
 // 的三级解析（env / 持久化配置 / 包内自带 / 开发回落）而变化，切换 source 后
-// 需要重新调用 ensureTmuxIntegration() 才会把 .tmux.conf 里的路径更新到位
-// （见 docs/2026-07-15-npm-global-install-plan.md 的残留风险第 4 条）。
+// 需要重新调用 ensureTmuxIntegration() 才会把 .tmux.conf 里的路径更新到位。
 import { execa } from 'execa';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';