我們在用的 tmux 設定

##### 終端機能力 #####

# 終端機類型 + 24 位真彩色：沒有 RGB，漸變會有色帶
set  -g default-terminal "tmux-256color"
set -as terminal-features ",*:RGB"

# 內嵌圖片（sixel、kitty、imgcat）：否則會被 tmux 丟掉
set  -g allow-passthrough on
set -as terminal-features ",*:sixel"

# 在 tmux 裏複製，直接進手機剪貼簿（OSC 52）
set  -g set-clipboard on

# ……走 mosh 時也一樣。tmux 發這條 OSC 52 時不填目標，發出來是 52;;，
# 而 mosh 只轉發 52;c;，所以沒有這一行，在 tmux 裏複製的內容只會進
# tmux 自己的貼上緩衝區，根本出不了伺服器。%p1 一定要留着：跳過它
# 直接寫 %p2 的寫法能正常載入，然後甚麼都不發
set -ag terminal-overrides ',*:Ms=\E]52;%p1%sc;%p2%s\a'

# 讓 Ctrl+Shift+…、Shift+Enter 之類以 CSI u 形式穿過 tmux
# （Claude Code 靠這個來實現 Shift+Enter 換行）
set  -s extended-keys on
set -as terminal-features ",*:extkeys"
set  -g extended-keys-format csi-u

# 別在 Esc 上等：預設那 500ms 會毀掉 Alt 組合鍵
set -sg escape-time 10

# 焦點事件和滑鼠（在終端機裏按住 Shift 可以本機選取）
set  -g focus-events on
set  -g mouse on

# 把視窗標題轉發出來，終端機 App 才能為分頁命名
set  -g set-titles on
set  -g set-titles-string "tmux · #{pane_title}"

# 捲動回看行數：程式助手輸出很多，給它留夠
set  -g history-limit 100000

##### 手機 / 同時掛著多個用戶端 #####

# 視窗大小跟著「最近活動」的用戶端走：手機和電腦同時掛著時，
# 誰在打字就按誰的螢幕來；小螢幕不會把版面鎖死
set  -g window-size latest
setw -g aggressive-resize on

# 視窗和窗格從 1 開始編號，關掉後自動補號：手機鍵盤上 1 比 0 好按
set  -g base-index 1
setw -g pane-base-index 1
set  -g renumber-windows on

# 關掉目前工作階段時跳到下一個，而不是直接 detach：
# 從手機上重新連線很麻煩
set  -g detach-on-destroy off

# 提示訊息多留一會兒，小螢幕上才來得及看
set  -g display-time 2000
set  -g display-panes-time 2000

##### 程式助手提醒 #####

# Claude Code 這類工具做完會響鈴：不要閃螢幕，
# 只在狀態列把那個視窗標紅
set  -g bell-action any
set  -g visual-bell off
setw -g monitor-bell on

# 背景視窗有新輸出 -> 狀態列亮黃色標記，
# 一眼就能看出哪個程式助手還在跑、哪個已經停了
setw -g monitor-activity on
set  -g visual-activity off

##### 配色：只用 ANSI 16 色 + 透明背景，自動跟隨終端機的 #####
##### 明暗主題 #####

# 訣竅：狀態列裏絕不寫死 RGB。bg=default 讓終端機背景透過來，
# colour0-15 取自終端機自己的調色盤，終端機在明暗之間切換時，
# tmux 會跟著一起換。

# 狀態列放在頂部，避開底部 Claude Code 的輸入框
set  -g status-position top
set  -g status-interval 5
set  -g status-style "bg=default,fg=default"

# 左邊顯示工作階段名稱；右邊只在按住前綴鍵時顯示 ^B 提示
set  -g status-left "#[fg=colour5,bold] #S #[default]"
set  -g status-left-length 20
set  -g status-right "#{?client_prefix,#[fg=colour3 bold]^B ,}"
set  -g status-right-length 20

# 視窗列表：目前視窗用藍底塊，其它灰色；響鈴(!)紅色，
# 有活動(#)黃色
# reverse 讓文字取終端機背景色，淺色主題下是深色字，
# 深色主題下是淺色字，自己會適應
setw -g window-status-format " #I #W#{?window_flags,#{window_flags}, } "
setw -g window-status-style "fg=colour8"
setw -g window-status-current-format " #I #W "
setw -g window-status-current-style "fg=colour4,bold,reverse"
setw -g window-status-bell-style "fg=colour1,bold"
setw -g window-status-activity-style "fg=colour3"

# 窗格邊框、訊息、複製模式的選取樣式
set  -g pane-border-style "fg=colour8"
set  -g pane-active-border-style "fg=colour4"
set  -g message-style "fg=colour4,bold,bg=default"
set  -g mode-style "bg=colour4,fg=colour0"
set  -g display-panes-colour colour8
set  -g display-panes-active-colour colour4
setw -g clock-mode-colour colour4

##### 快捷鍵 #####

setw -g mode-keys vi

# 分割和新增視窗都繼承目前目錄：不用再 cd 回程式助手做事的地方
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
bind c new-window   -c "#{pane_current_path}"

# Alt+數字直接跳視窗，不用按前綴鍵：手機上少按一次組合鍵
bind -n M-1 select-window -t 1
bind -n M-2 select-window -t 2
bind -n M-3 select-window -t 3
bind -n M-4 select-window -t 4
bind -n M-5 select-window -t 5

# 前綴鍵 + hjkl 在窗格之間移動
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

# 複製模式：v 開始選取，y 複製（經 OSC 52 送到手機/本機剪貼簿）
bind -T copy-mode-vi v send -X begin-selection
bind -T copy-mode-vi y send -X copy-selection-and-cancel

# 前綴鍵 + t：彈出一個小終端機跑一次性指令，不打亂程式助手的版面；
# exit 就關
bind t display-popup -E -w 80% -h 75% -d "#{pane_current_path}"

# 前綴鍵 + r：重新載入設定
bind r source-file ~/.tmux.conf \; display "已重新載入 ~/.tmux.conf"