tmuxclihook 0.5.3 → 0.5.5

package/README.md

@@ -88,6 +88,11 @@ clack 0.7 只把 ctrl+c 映射为取消（Esc 默认无效果），安装器在
 
 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。
 
+**codex / opencode 的 cc-switch 真源**
+
+- **codex**：`switch` 为每个 provider 创建独立 `CODEX_HOME`（`~/.cc-switch/instances/codex/<providerId>`），并把 `~/.codex/hooks.json` 符号链接进实例，因此插件写默认（或 `$CODEX_HOME`）下的 `hooks.json` 即被所有实例共享。但 `[hooks.state]` 信任记录在实例自己的 `config.toml` 里、cc-switch 不复制——**每个新 provider 实例首次启动需在 codex TUI 内 Trust all 一次**，否则 hooks 不执行（trusted_hash 无法在 bash 侧复现，插件不预写）。
+- **opencode**：cc-switch 对它是 additive live config（无 per-provider 实例目录），provider 条目直接写进配置目录的 `opencode.json(c)`。插件目录解析为 `OPENCODE_CONFIG_DIR` > cc-switch `settings.json` 的 `opencodeConfigDir` > `${XDG_CONFIG_HOME:-~/.config}/opencode`；旧版 cc-switch 无该键时自动回落默认目录。
+
 ## Source 管理（生产默认 / 本地调试切换）
 
 `npm i -g` 装完后，hooks 安装与 tmux 集成默认使用包内自带的 `scripts/`（由 `npm publish` 前的 `prepack` 步骤从仓库根复制打包进来，见「架构」一节），开箱即用，无需仓库 checkout。

package/package.json

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

package/scripts/adapters/opencode.sh

@@ -24,8 +24,37 @@ ADAPTER_EVENTS="SessionStart UserPromptSubmit PreToolUse PermissionRequest Permi
 # 前台进程名：opencode 二进制无 arch 后缀（区别于 codex 的 codex-aarch64-* 等）
 ADAPTER_PROCESS_NAMES="opencode"
 
-# plugin 文件路径（XDG 全局目录，OPENCODE_CONFIG_DIR 可覆盖）
-ADAPTER_HOOKS_FILE="${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/plugins/tmux-ai-status.ts"
+# 配置目录解析（与 opencode 原生规则 + cc-switch 4.0 的设备级目录覆盖一致）：
+#   1. OPENCODE_CONFIG_DIR 环境变量——opencode 原生支持；cc-switch GUI（模型探测/WSL
+#      启动）会注入该变量
+#   2. cc-switch `~/.cc-switch/settings.json` 的 `opencodeConfigDir`（cc-switch 的
+#      「目录覆盖」真源；旧版无此键 → 自动落到 3，向后兼容）
+#   3. XDG 默认：`$XDG_CONFIG_HOME/opencode`（通常 ~/.config/opencode）
+# 注意：opencode 不像 claude/codex 那样有 per-provider 实例目录——cc-switch 对它是
+# 「additive live config」，provider 条目直接写进该目录下的 opencode.json(c)；
+# 本插件的 plugin 文件与它同目录共存，互不覆盖。
+_opencode_config_dir() {
+    if [ -n "${OPENCODE_CONFIG_DIR:-}" ]; then
+        printf '%s\n' "$OPENCODE_CONFIG_DIR"
+        return 0
+    fi
+    local settings="$HOME/.cc-switch/settings.json" dir=""
+    if [ -f "$settings" ]; then
+        dir=$(sed -n 's/.*"opencodeConfigDir"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$settings" 2>/dev/null | head -n 1)
+        case "$dir" in
+            "~") dir="$HOME" ;;
+            "~/"*) dir="${HOME}/${dir:2}" ;;
+        esac
+    fi
+    if [ -n "$dir" ]; then
+        printf '%s\n' "$dir"
+    else
+        printf '%s\n' "${XDG_CONFIG_HOME:-$HOME/.config}/opencode"
+    fi
+}
+
+# plugin 文件路径（配置目录解析见 _opencode_config_dir）
+ADAPTER_HOOKS_FILE="$(_opencode_config_dir)/plugins/tmux-ai-status.ts"
 
 # opencode 无 SessionEnd → 退出由 tmux-ai-monitor 做进程检测
 ADAPTER_HAS_SESSION_END="false"

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

@@ -57,7 +57,9 @@ function buildTools(scriptsDir) {
       versionArgs: ['--version'],
       versionRe: /(\d+\.\d+\.\d+)/,
       minVersion: null,                        // plugin 系统本地文件跳过版本兼容检查
-      // hooksFile 实为 JS/TS plugin 文件（非 JSON hooks 配置），install/uninstall 整文件写入/删除
+      // hooksFile 实为 JS/TS plugin 文件（非 JSON hooks 配置），install/uninstall 整文件写入/删除。
+      // 权威路径由 bash adapter 解析（OPENCODE_CONFIG_DIR > cc-switch opencodeConfigDir > XDG），
+      // 此处仅静态近似，判定一律走 wrapper check，避免两处真源发散。
       hooksFile: join(
         process.env.OPENCODE_CONFIG_DIR || join(process.env.XDG_CONFIG_HOME || join(HOME, '.config'), 'opencode'),
         'plugins',