tmuxclihook 0.3.0 → 0.3.2

package/README.md

@@ -12,6 +12,10 @@ tmuxclihook
 # 检查 npm registry 并将全局安装更新到最新版
 tmuxclihook update
 
+# 查看版本 / 帮助（version、--version、-v 与 help、--help、-h 等价）
+tmuxclihook --version
+tmuxclihook --help
+
 # 插件已经载入 tmux 后
 prefix + I
 

package/bin/cli.js

@@ -27,7 +27,7 @@ import {
 } from '../src/adapters-meta.js';
 import { setSource, clearSource, getPersistedSource, originLabel } from '../src/source.js';
 import { note, padDisplay } from '../src/tui.js';
-import { updatePackage } from '../src/update.js';
+import { updatePackage, CURRENT_VERSION } from '../src/update.js';
 
 const OK = '✓';
 const NO = '✗';
@@ -365,13 +365,26 @@ async function main() {
   p.outro('完成');
 }
 
-if (process.argv[2] === 'update') {
+const arg = process.argv[2];
+if (arg === 'update') {
   updatePackage().then((ok) => {
     if (!ok) process.exitCode = 1;
   }).catch((err) => {
     console.error(err);
     process.exitCode = 1;
   });
+} else if (arg === '--version' || arg === '-v' || arg === 'version') {
+  console.log(`tmuxclihook v${CURRENT_VERSION}`);
+} else if (arg === '--help' || arg === '-h' || arg === 'help') {
+  console.log(
+    'tmuxclihook — tmux-ai-status 交互式安装器\n' +
+    '\n' +
+    '用法：\n' +
+    '  tmuxclihook              打开交互式 TUI 安装器\n' +
+    '  tmuxclihook update       检查并更新到 npm 最新版本\n' +
+    '  tmuxclihook version      显示版本（--version / -v 等价）\n' +
+    '  tmuxclihook help         显示本帮助（--help / -h 等价）',
+  );
 } else {
   main().catch((err) => {
     console.error(err);

package/package.json

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

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

@@ -122,7 +122,7 @@ build_all_status() {
     cur_sess=""
     local _ai_names
     _ai_names=$(_collect_ai_process_names)
-    while IFS='|' read -r pane_id session_name win_idx pane_idx claude_status _attached _last cur_cmd; do
+    while IFS='|' read -r pane_id session_name win_idx pane_idx claude_status _attached _created _entered cur_cmd; do
         local pane_status="$claude_status"
         if [ -z "$pane_status" ]; then
             # 无显式状态：若前台是 AI 进程（codex 首个 turn 前空窗期），补 idle。
@@ -153,7 +153,12 @@ build_all_status() {
         else
             ALL="${ALL}${seg}"
         fi
-    done < <(tmux list-panes -a -F "#{pane_id}|#{session_name}|#{window_index}|#{pane_index}|#{@ai_pane_status}|#{session_attached}|#{session_last_attached}|#{pane_current_command}" 2>/dev/null | awk -F'|' '$6>0' | sort -t'|' -k7,7n -k2,2 -k3,3n -k4,4n)
+    # 排序两级键：① @ai_entered_time（client-session-changed 时由 _session-switched
+    # 写入的「真进入」时间，刚进入的 session 排最后；attach 与 switch-client 都触发，
+    # 自指 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}" 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-status

@@ -39,6 +39,14 @@ _current_pane_status() {
     tmux display-message -pt "$TMUX_PANE" -p "#{@ai_pane_status}" 2>/dev/null
 }
 
+# 重建聚合状态（_refresh / _entered 共用）
+_run_refresh() {
+    _maybe_repair_hooks
+    _cleanup_stale_panes
+    build_all_status
+    tmux set-option -g @ai_all_status "$ALL" 2>/dev/null || true
+}
+
 # 事件块日志变量（各 case 分支按需赋值，脚本末尾统一出块）
 PREV_STATUS=$(_current_pane_status)
 TOOL=""
@@ -191,16 +199,32 @@ case "$EVENT" in
     fi
     ;;
   _refresh)
-    _maybe_repair_hooks
-    _cleanup_stale_panes
-    build_all_status
-    tmux set-option -g @ai_all_status "$ALL" 2>/dev/null || true
+    _run_refresh
     # 诊断日志：记录 pane 状态快照（纯文本，去掉 tmux 格式码）
     _refresh_snapshot=$(tmux list-panes -a -F "#{session_name}:#{window_index}.#{pane_index}=#{@ai_pane_status}|#{session_attached}" 2>/dev/null \
         | awk -F'|' '$2+0>0' | cut -d'|' -f1 | tr '\n' ' ')
     _ai_log "REFRESH: ${_refresh_snapshot:-<empty>}"
     exit 0
     ;;
+  _session-switched)
+    # client-session-changed hook（入口传 #{hook_client_name}）：attach 与 switch-client
+    # 的共同汇聚点（tmux server_client_set_session），两种「进入」都能捕获。
+    # 该 hook 自指 switch 也触发（源码无 old != s 守卫）→ 用 per-client 自维护的
+    # 上次 session 对比过滤：cur != prev 才算「真进入」，自指（cur == prev）跳过。
+    # 排序语义：刚进入的 session 排最后；无记录的 session 回退 session_created。
+    if [ -n "$3" ]; then
+        _sw_key=$(printf '%s' "$3" | tr -c 'A-Za-z0-9._-' '_')
+        _cur_sess=$(tmux display-message -p -c "$3" '#{session_name}' 2>/dev/null)
+        _prev_sess=$(tmux show-option -gv "@ai_prev_sess_${_sw_key}" 2>/dev/null || true)
+        if [ -n "$_cur_sess" ] && [ "$_cur_sess" != "$_prev_sess" ]; then
+            tmux set-option -g "@ai_prev_sess_${_sw_key}" "$_cur_sess" 2>/dev/null || true
+            tmux set-option -t "$_cur_sess" @ai_entered_time "$(date +%s)" 2>/dev/null || true
+            _ai_log "ENTERED: client=$3 session=$_cur_sess"
+        fi
+    fi
+    _run_refresh
+    exit 0
+    ;;
   *)
     exit 0
     ;;

package/tmux-ai-hooks-status.tmux

@@ -70,11 +70,14 @@ fi
 # --- 注册 tmux session/client 变化 hook，刷新聚合状态 ---
 # session-closed: session 被销毁时清除残留条目
 # client-detached: client 断开连接时排除已变为 detached 的 session
-# client-attached: client 重新连接时恢复该 session 的状态
+# client-session-changed: attach 与 switch-client 的共同汇聚点 = 「进入」→ 记
+# @ai_entered_time（排序用：刚进入的 session 排最后；handler 内以 per-client
+# 上次 session 对比过滤自指 switch）+ 刷新聚合
+tmux set-hook -g client-session-changed "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _session-switched #{hook_client_name}'" 2>/dev/null || true
 # 注：_refresh 与 TOOL_ID 无关（仅重建聚合 + 自修复 claude hooks），统一传 claude。
 tmux set-hook -g session-closed    "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _refresh'"
 tmux set-hook -g client-detached   "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _refresh'"
-tmux set-hook -g client-attached   "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _refresh'"
+# （client-attached 不再注册：attach 场景由 client-session-changed 覆盖）
 # pane-exited: 程序自然退出 → 触发孤儿清理（#{pane_id} 在此 hook 中不可靠）
 tmux set-hook -g pane-exited       "run-shell '${CURRENT_DIR}/scripts/tmux-ai-status claude _refresh'"
 # after-kill-pane: kill-pane 后触发孤儿清理