@@ -0,0 +1,130 @@
+#!/bin/bash
+# ========================================================================
+# 文件: fzf-helpers.sh
+# 作用: 提供基于 fzf 的通用交互底座函数，供 tmux.sh / zellij.sh 等场景复用。
+#       本文件由 deploy.sh 软链接到 ~/.bashrc.d/，bash 与 zsh 都会 source，
+#       因此必须双 shell 兼容，禁用 zle / bind -x 等 shell 专属结构。
+#
+# 加载顺序说明:
+#   bash/zsh 函数定义为惰性——本文件定义 fzf_pick_action 时，
+#   领域文件 tmux.sh/zellij.sh 只需「定义」自己的函数，
+#   函数体内对 fzf_pick_action 的引用在「调用时」才解析。
+#   故无需保证 *.sh 的 glob 加载顺序，只要全部 source 完即可。
+# ========================================================================
+
+# ----------------------------------------------------------------------
+# 统一的颜色/提示输出（与 deploy.sh 风格一致，仅交互式场景使用）
+# 放在文件级，避免每次调用都重新定义。
+# ----------------------------------------------------------------------
+__fzf_helpers_color_setup() {
+  # 仅当终端支持颜色时启用 ANSI 转义，否则置空避免乱码。
+  if [ -t 1 ] && [ -n "$TERM" ] && [ "$TERM" != "dumb" ]; then
+    _FZF_HLP_RED=$'\033[0;31m'
+    _FZF_HLP_GREEN=$'\033[0;32m'
+    _FZF_HLP_YELLOW=$'\033[1;33m'
+    _FZF_HLP_CYAN=$'\033[0;36m'
+    _FZF_HLP_NC=$'\033[0m'
+  else
+    _FZF_HLP_RED=''
+    _FZF_HLP_GREEN=''
+    _FZF_HLP_YELLOW=''
+    _FZF_HLP_CYAN=''
+    _FZF_HLP_NC=''
+  fi
+}
+__fzf_helpers_color_setup
+
+# ----------------------------------------------------------------------
+# fzf_pick_action — fzf 通用「选条目 + 选动作」底座
+#
+# 设计意图:
+#   attach 这类操作必须在「当前 shell 进程」执行（要接管当前终端），
+#   若用 item=$(fzf_pick_action ...) 子 shell 回传，attach 会发生在子 shell、
+#   退出即丢终端。因此本函数通过「全局变量」回传两项结果，调用方在当前
+#   shell 读取后直接执行目标命令。此语义与 fzf-history 用 BUFFER/READLINE_LINE
+#   在当前 shell 写命令行同源。
+#
+# 入参:
+#   $1 - header: fzf 顶部提示文本（说明各按键含义）。
+#   $2 - expect_keys: --expect 的按键，逗号分隔，如 "ctrl-x,ctrl-d"。
+#        Enter 固定走 accept 语义（表示默认动作），不在 expect 列表中。
+#
+# 输入(stdin):
+#   候选条目，每行一个，已包含最终显示文本（调用方负责拼好显示格式）。
+#   调用方需自行从整行解析出真实值（如会话名），本函数保持中立。
+#
+# 回传(全局变量，调用方在函数返回后立即读取):
+#   FZF_PICK_ITEM   - 用户选中的整行原文；无选中时为空。
+#   FZF_PICK_ACTION - 用户按下的 expect 键名（如 "ctrl-x"）；按 Enter 时为空串。
+#
+# 返回码:
+#   0 - 用户正常选中条目。
+#   1 - fzf 不可用、stdin 为空、或用户未选中（Esc/Ctrl-c）。
+#
+# 用法示例:
+#   printf 'session-a\nsession-b\n' | fzf_pick_action "[Enter]:attach | [Ctrl-x]:kill" "ctrl-x"
+#   if [ $? -eq 0 ]; then
+#     case "$FZF_PICK_ACTION" in
+#       ctrl-x) tmux kill-session -t "$FZF_PICK_ITEM" ;;
+#       *)      tmux attach-session -t "$FZF_PICK_ITEM" ;;
+#     esac
+#   fi
+# ----------------------------------------------------------------------
+fzf_pick_action() {
+  # 每次调用前清空上一次的回传变量，避免脏数据。
+  FZF_PICK_ITEM=''
+  FZF_PICK_ACTION=''
+
+  # fzf 未安装则静默失败，交由调用方提示。
+  if ! command -v fzf >/dev/null 2>&1; then
+    return 1
+  fi
+
+  local header="${1:-}"
+  local expect_keys="${2:-}"
+  local selection input
+
+  # 缓存 stdin: fzf 对空输入行为不保证（非 tty 下可能挂起等待），
+  # 先用 cat 读入，空则直接返回 1，避免进入 fzf 卡住。
+  # 调用方通常已自行过滤空列表，此处为底座自身的防御。
+  input=$(cat)
+  [ -z "$input" ] && return 1
+
+  # 组装 fzf 参数：--expect 为空时不传该 flag（避免 fzf 报错）。
+  # --height=40% --reverse 与 fzf-history 保持一致观感。
+  if [ -n "$expect_keys" ]; then
+    selection=$(printf '%s\n' "$input" | fzf --height=40% --reverse \
+      --header="$header" \
+      --expect="$expect_keys")
+  else
+    selection=$(printf '%s\n' "$input" | fzf --height=40% --reverse \
+      --header="$header")
+  fi
+
+  # 用户按 Esc/Ctrl-c → fzf 返回非 0。
+  if [ $? -ne 0 ] || [ -z "$selection" ]; then
+    return 1
+  fi
+
+  # 解析 fzf --expect 输出：
+  #   第 1 行 = 按下的 expect 键（按 Enter 时为空行）
+  #   第 2 行起 = 选中的条目
+  # 用 read 配合「整体块」读取，避免管道子 shell 截断退出码。
+  local key line
+  {
+    read -r key
+    read -r line
+  } <<EOF
+$selection
+EOF
+
+  # 未按 expect 键时 fzf 第一行是空，第二行才是条目。
+  FZF_PICK_ACTION="$key"
+  FZF_PICK_ITEM="$line"
+
+  # 极端情况：解析后条目仍空（不应发生），视为未选中。
+  if [ -z "$FZF_PICK_ITEM" ]; then
+    return 1
+  fi
+  return 0
+}
@@ -0,0 +1,101 @@
+#!/bin/bash
+# ========================================================================
+# 文件: tmux.sh
+# 作用: 基于 fzf 的 tmux 会话交互管理。
+#       依赖 fzf-helpers.sh 提供的 fzf_pick_action 底座。
+#       本文件由 deploy.sh 软链接到 ~/.bashrc.d/，bash 与 zsh 都会 source。
+#
+# 加载顺序说明:
+#   函数定义为惰性，本文件只定义 tmux-sessions 函数；
+#   工具存在性检查放在「函数体内」运行时执行，而非文件顶层。
+#   这样即便 tmux 未安装，函数仍被定义，调用时得到友好提示而非
+#   'command not found'。详见下方函数注释。
+# ========================================================================
+
+# ----------------------------------------------------------------------
+# tmux-sessions — 列出 tmux 会话，交互式 attach 或 kill
+#
+# 设计意图:
+#   用 fzf 列出所有 tmux 会话，用户选中后:
+#     Enter   → 在当前 shell attach（接管当前终端，退出后回原 shell）
+#     Ctrl-x  → kill 选中的会话
+#   复用 fzf_pick_action 底座，与 fzf-history 的 --expect 多动作范式一致。
+#
+# 入参: 无。
+#
+# 返回码:
+#   0 - 正常结束（含无会话/工具缺失/用户取消，均为友好退出）。
+#
+# 健壮性（守护放在函数体内，而非文件顶层）:
+#   - tmux/fzf/底座缺失 → 提示并返回 0，而非函数未定义导致 command not found。
+#   - 无活动会话 → 提示并返回 0。
+#   - attach 在当前 shell 执行，保证退出 tmux 后回到原 shell（不用 exec 替换进程）。
+# ----------------------------------------------------------------------
+tmux-sessions() {
+  # 运行时检查 tmux（不放在文件顶层，确保函数恒被定义）。
+  if ! command -v tmux >/dev/null 2>&1; then
+    printf '%s[tmux]%s 未检测到 tmux，请先安装。\n' "$_FZF_HLP_RED" "$_FZF_HLP_NC"
+    return 0
+  fi
+  # fzf 与底座缺失给出明确提示。
+  if ! command -v fzf >/dev/null 2>&1; then
+    printf '%s[tmux]%s 请先安装 fzf。\n' "$_FZF_HLP_RED" "$_FZF_HLP_NC"
+    return 0
+  fi
+  if ! command -v fzf_pick_action >/dev/null 2>&1; then
+    printf '%s[tmux]%s 底座 fzf-helpers.sh 未加载，请检查部署。\n' "$_FZF_HLP_RED" "$_FZF_HLP_NC"
+    return 0
+  fi
+
+  # 读取会话列表。
+  #   无运行中的 server 时 tmux list-sessions 退出码非 0（输出 'no server running'），
+  #   此时视为「无活动会话」而非错误。
+  local sessions
+  sessions=$(tmux list-sessions 2>/dev/null)
+  if [ -z "$sessions" ]; then
+    printf '%s[tmux]%s 当前没有活动会话。\n' "$_FZF_HLP_YELLOW" "$_FZF_HLP_NC"
+    return 0
+  fi
+
+  # list-sessions 默认输出形如:
+  #   dev: 3 windows (created ...) (attached)
+  #   main: 1 windows (created ...) (detached)
+  # 整行作为显示行，按 : 前缀切出真实会话名。
+  printf '%s\n' "$sessions" | fzf_pick_action \
+    '[Enter]:attach | [Ctrl-x]:kill session'
+
+  if [ $? -ne 0 ]; then
+    # 用户按 Esc/Ctrl-c 取消。
+    return 0
+  fi
+
+  # 从显示行提取真实会话名：取首个 ':' 之前的部分。
+  # ${FZF_PICK_ITEM%%:*} 为参数扩展（非正则），bash/zsh 均支持。
+  local session_name
+  session_name="${FZF_PICK_ITEM%%:*}"
+
+  if [ -z "$session_name" ]; then
+    printf '%s[tmux]%s 无法解析会话名。\n' "$_FZF_HLP_RED" "$_FZF_HLP_NC"
+    return 0
+  fi
+
+  case "$FZF_PICK_ACTION" in
+    ctrl-x)
+      # kill 会话：-t 指定目标。
+      if tmux kill-session -t "$session_name" 2>/dev/null; then
+        printf '%s[tmux]%s 已删除会话: %s\n' "$_FZF_HLP_GREEN" "$_FZF_HLP_NC" "$session_name"
+      else
+        printf '%s[tmux]%s 删除会话失败: %s\n' "$_FZF_HLP_RED" "$_FZF_HLP_NC" "$session_name"
+      fi
+      ;;
+    *)
+      # 默认动作 = attach。在当前 shell 执行，不用 exec（退出 tmux 后回原 shell）。
+      # 若当前已在 tmux 内（$TMUX 非空），attach 会失败，改用 switch-client 切换。
+      if [ -n "$TMUX" ]; then
+        tmux switch-client -t "$session_name"
+      else
+        tmux attach-session -t "$session_name"
+      fi
+      ;;
+  esac
+}
@@ -0,0 +1,98 @@
+#!/bin/bash
+# ========================================================================
+# 文件: zellij.sh
+# 作用: 基于 fzf 的 zellij 会话交互管理。
+#       依赖 fzf-helpers.sh 提供的 fzf_pick_action 底座。
+#       本文件由 deploy.sh 软链接到 ~/.bashrc.d/，bash 与 zsh 都会 source。
+#
+# 加载顺序说明:
+#   函数定义为惰性，本文件只定义 zellij-sessions 函数；
+#   工具存在性检查放在「函数体内」运行时执行，而非文件顶层，
+#   确保函数恒被定义（与 tmux.sh 同理）。
+# ========================================================================
+
+# ----------------------------------------------------------------------
+# zellij-sessions — 列出 zellij 会话，交互式 attach 或 kill
+#
+# 设计意图:
+#   用 fzf 列出所有 zellij 会话，用户选中后:
+#     Enter   → attach 到选中会话
+#     Ctrl-x  → kill 选中的会话
+#   与 tmux-sessions 保持一致的交互范式（同一底座、同一按键语义）。
+#
+# 入参: 无。
+#
+# 返回码:
+#   0 - 正常结束（含无会话/工具缺失/用户取消，均为友好退出）。
+#
+# 健壮性:
+#   - zellij/fzf/底座缺失 → 提示并返回 0。
+#   - 无活动会话 → 提示并返回 0。
+#   - zellij 子命令版本差异: kill-session 为 zellij ≥0.40 命名；
+#     旧版可能用 delete-session，这里优先 kill-session，失败时降级提示。
+# ----------------------------------------------------------------------
+zellij-sessions() {
+  # 运行时检查 zellij（不放在文件顶层，确保函数恒被定义）。
+  if ! command -v zellij >/dev/null 2>&1; then
+    printf '%s[zellij]%s 未检测到 zellij，请先安装。\n' "$_FZF_HLP_RED" "$_FZF_HLP_NC"
+    return 0
+  fi
+  if ! command -v fzf >/dev/null 2>&1; then
+    printf '%s[zellij]%s 请先安装 fzf。\n' "$_FZF_HLP_RED" "$_FZF_HLP_NC"
+    return 0
+  fi
+  if ! command -v fzf_pick_action >/dev/null 2>&1; then
+    printf '%s[zellij]%s 底座 fzf-helpers.sh 未加载，请检查部署。\n' "$_FZF_HLP_RED" "$_FZF_HLP_NC"
+    return 0
+  fi
+
+  # 读取会话列表。
+  # zellij list-sessions 输出形如:
+  #   dev [ExitStatus: 0]
+  #   main (EXITED)
+  #   tmp [ExitStatus: 0] (current)
+  # 每行首个空白字段为真实会话名，后续为状态标记。
+  local sessions
+  sessions=$(zellij list-sessions 2>/dev/null)
+  if [ -z "$sessions" ]; then
+    printf '%s[zellij]%s 当前没有活动会话。\n' "$_FZF_HLP_YELLOW" "$_FZF_HLP_NC"
+    return 0
+  fi
+
+  # 整行作为显示行交给 fzf。
+  printf '%s\n' "$sessions" | fzf_pick_action \
+    '[Enter]:attach | [Ctrl-x]:kill session'
+
+  if [ $? -ne 0 ]; then
+    # 用户取消。
+    return 0
+  fi
+
+  # 提取真实会话名：取首个空白之前的部分。
+  # 用参数扩展 ${FZF_PICK_ITEM%% *} 切，兼容 bash/zsh。
+  local session_name
+  session_name="${FZF_PICK_ITEM%% *}"
+
+  if [ -z "$session_name" ]; then
+    printf '%s[zellij]%s 无法解析会话名。\n' "$_FZF_HLP_RED" "$_FZF_HLP_NC"
+    return 0
+  fi
+
+  case "$FZF_PICK_ACTION" in
+    ctrl-x)
+      # kill 会话：zellij ≥0.40 用 kill-session。
+      # 旧版可能无此子命令，失败时给出版本提示。
+      if zellij kill-session "$session_name" 2>/dev/null; then
+        printf '%s[zellij]%s 已删除会话: %s\n' "$_FZF_HLP_GREEN" "$_FZF_HLP_NC" "$session_name"
+      else
+        printf '%s[zellij]%s 删除失败，请检查 zellij 版本（需 ≥0.40 的 kill-session）: %s\n' \
+          "$_FZF_HLP_RED" "$_FZF_HLP_NC" "$session_name"
+      fi
+      ;;
+    *)
+      # 默认动作 = attach。zellij attach 不允许在已有 zellij 内嵌套 attach，
+      # 会自行报错；此处直接透传由 zellij 处理。
+      zellij attach "$session_name"
+      ;;
+  esac
+}