我們在用的 tmux 設定

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

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

# RGB 告訴的是 tmux：外層終端機支援真彩色；裏面的程式（nvim、bat、fzf、
# delta）要不要送 24 位色，看的是 COLORTERM。tmux 自己從不把這個變數
# 傳進去，所以把它釘死
set-environment -g COLORTERM truecolor

# 內嵌圖片（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

##### 配色 #####

# bg=default 讓終端機自己的背景透過來，點綴色（工作階段名稱、前綴提示、
# 活動標記）取自終端機的調色盤。凡是必須在每個掛著的用戶端上都看得清的
# 部分，改用固定的 256 色，它們在任何主題下都長一個樣

# 狀態列放在頂部，避開底部 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

# 視窗列表：目前視窗是一塊自帶白字的藍底（任何主題下對比度都是 5.8:1），
# 其它視窗用中灰；響鈴(!)紅色，有活動(#)黃色
setw -g window-status-format " #I #W#{?window_flags,#{window_flags}, } "
setw -g window-status-style "fg=colour245"
setw -g window-status-current-format " #I #W "
setw -g window-status-current-style "bg=colour26,fg=colour231,bold"
setw -g window-status-bell-style "fg=colour203,bold"
setw -g window-status-activity-style "fg=colour3"

# 窗格邊框、訊息、複製模式的選取樣式：一種灰，一種藍
set  -g pane-border-style "fg=colour243"
set  -g pane-active-border-style "fg=colour32"
set  -g message-style "fg=colour32,bold,bg=default"
# tmux 自己的指令提示符是一條不透明的黑條：讓它和訊息一個樣
set  -g message-command-style "fg=colour32,bold,bg=default"
set  -g mode-style "bg=colour26,fg=colour231"
set  -g display-panes-colour colour243
set  -g display-panes-active-colour colour32
setw -g clock-mode-colour colour32

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

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 也能進複製模式（比 [ 好記）
bind v copy-mode

# 複製模式：v 開始選取，y 複製（經 OSC 52 送到手機/本機剪貼簿），
# Y 複製整行，Ctrl+v 切換矩形選取
bind -T copy-mode-vi v send -X begin-selection
bind -T copy-mode-vi y send -X copy-selection-and-cancel
bind -T copy-mode-vi Y send -X copy-line-and-cancel
bind -T copy-mode-vi C-v send -X rectangle-toggle

# 滑鼠拖選即複製，但留在複製模式的原位：不會跳回底部，
# 可以接著看程式助手的捲動輸出；按 q 退出
bind -T copy-mode-vi MouseDragEnd1Pane send -X copy-selection

# 雙擊複製一個詞，三擊複製一整行。詞的邊界只算空格，
# 所以雙擊就能從程式助手的輸出裏一次拿到完整的檔案路徑或 URL
set -g word-separators " "
# 那個 `run -d0.3` 要留着：進複製模式和複製放在同一條指令裏，
# tmux 的緩衝區有了內容，卻不送 OSC 52，剪貼簿裏甚麼都沒有。
# 用 -H 而不是 -M：-M 會把這次點擊繼續傳下去，選取範圍會越過這個詞
bind -n DoubleClick1Pane copy-mode -H \; send -X select-word \; run -d0.3 \; send -X copy-selection-and-cancel
bind -n TripleClick1Pane copy-mode -H \; send -X select-line \; run -d0.3 \; send -X copy-selection-and-cancel
bind -T copy-mode-vi DoubleClick1Pane send -X select-word \; send -X copy-selection-and-cancel
bind -T copy-mode-vi TripleClick1Pane send -X select-line \; send -X copy-selection-and-cancel

# 前綴鍵 + ] 貼上最近一次複製（tmux 預設）；前綴鍵 + P 打開緩衝區清單，
# 貼上更早複製的內容
bind P choose-buffer

# 前綴鍵 + 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"