WezTerm 配置调优: TUI 渲染成本与实测取舍

local wezterm = require 'wezterm'
local act = wezterm.action
local config = {}

config.line_height = 1.2
config.font_size = 13
config.harfbuzz_features = { 'calt=1', 'clig=1', 'liga=1' }
config.window_padding = { left = 8, right = 8, top = 8, bottom = 8 }
config.window_background_opacity = 1.0
config.window_close_confirmation = 'NeverPrompt'
config.initial_rows = 30
config.initial_cols = 100
config.audible_bell = 'Disabled'
config.switch_to_last_active_tab_when_closing_tab = true
config.use_ime = true
config.ime_preedit_rendering = 'Builtin'
config.use_dead_keys = false
config.enable_csi_u_key_encoding = true
config.canonicalize_pasted_newlines = "LineFeed"
config.unicode_version = 15
config.scrollback_lines = 10000
-- 保留 fancy tab bar：retro tab bar 的标题只能用终端字体（本机 JetBrains Mono 缺失，回退内置字体）与终端字号，观感明显变差
-- 代价可接受：标题高频动画场景实测 14.1% -> 8.8/10.7%（±20% 噪声），流式输出场景无差异
config.use_fancy_tab_bar = true

config.hide_tab_bar_if_only_one_tab = false
-- codex 流式输出时按 30fps 渲染，GPU 与续航收益
config.max_fps = 30
config.animation_fps = 10
config.integrated_title_button_color = 'Auto'
-- 滚动条同样每帧参与绘制，TUI 场景收益低
config.enable_scroll_bar = false
config.hide_mouse_cursor_when_typing = false
-- 启用 GPU 加速
config.webgpu_power_preference = 'HighPerformance'
config.front_end = "WebGpu"
-- 禁用光标闪烁
config.cursor_blink_rate = 0
-- 配色方案
config.color_scheme = 'Dracula'
config.default_prog = { 'pwsh.exe', '-NoLogo' }

config.set_environment_variables = {
  HOME = [[C:\Users\Administrator]],
}

config.mouse_bindings = {
  { event = { Up = { streak = 1, button = 'Left' } }, mods = 'NONE',
    action = wezterm.action_callback(function(window, pane)
      local sel = window:get_selection_text_for_pane(pane) or ''
      if sel ~= '' then
        window:perform_action(act.CopyTo('Clipboard'), pane)
        window:perform_action(act.ClearSelection, pane)
      end
    end),
  },
  { event = { Down = { streak = 1, button = 'Right' } }, mods = 'NONE',
    action = wezterm.action_callback(function(window, pane)
      local sel = window:get_selection_text_for_pane(pane) or ''
      if sel ~= '' then
        window:perform_action(act.CopyTo('Clipboard'), pane)
        window:perform_action(act.ClearSelection, pane)
      else
        window:perform_action(act.PasteFrom('Clipboard'), pane)
      end
    end),
  },
  { event = { Down = { streak = 1, button = 'Middle' } }, mods = 'NONE',
    action = act.PasteFrom('Clipboard') },
}

config.keys = {
  { key = 'V', mods = 'CTRL|SHIFT', action = act.PasteFrom('Clipboard') },
  { key = 'c', mods = 'CTRL',
    action = wezterm.action_callback(function(window, pane)
      local sel = window:get_selection_text_for_pane(pane) or ''
      if sel ~= '' then
        window:perform_action(act.CopyTo('Clipboard'), pane)
        window:perform_action(act.ClearSelection, pane)
      else
        window:perform_action(act.SendKey { key = 'c', mods = 'CTRL' }, pane)
      end
    end),
  },
  { key = 'F8', mods = 'CTRL',
    action = act.SpawnCommandInNewTab {
      args = { 'powershell.exe', '-NoProfile', '-ExecutionPolicy', 'Bypass',
               '-File', [[C:\Users\Administrator\bin\ssh-keepalive.ps1]],
               '-MaxDurationSec', '300',
               '-MaxBackoff',     '60',
               'xxx@172.16.40.193' },
    },
  },
  { key = 'F9', mods = 'CTRL',
    action = act.SpawnCommandInNewTab {
      args = { 'tssh.exe', 'dgliu@172.16.48.122' },
    },
  },
  { key = 'F10', mods = 'CTRL',
    action = act.SpawnCommandInNewTab {
      args = { 'powershell.exe', '-NoProfile', '-ExecutionPolicy', 'Bypass',
               '-File', [[C:\Users\Administrator\bin\ssh-keepalive.ps1]],
               '-MaxDurationSec', '300',
               '-MaxBackoff',     '60',
               'xxx@172.16.48.122' },
    },
  }
}

config.default_cursor_style = 'SteadyBar'

for i = 1, 9 do
  table.insert(config.keys, {
    key = tostring(i),
    mods = 'ALT',
    action = act.ActivateTab(i - 1),
  })
end

----------------------------

-- color scheme colors for easy access
local scheme_colors = {
    catppuccin = {
        macchiato = {
            rosewater = "f4dbd6",
            flamingo = "f0c6c6",
            pink = "f5bde6",
            mauve = "c6a0f6",
            red = "ed8796",
            maroon = "ee99a0",
            peach = "#f5a97f",
            yellow = "#eed49f",
            green = "#a6da95",
            teal = "#8bd5ca",
            sky = "#91d7e3",
            sapphire = "#7dc4e4",
            blue = "#8aadf4",
            lavender = "#b7bdf8",
            text = "#cad3f5",
            crust = "#181926",
        }
    }
}

local colors = {
    border = scheme_colors.catppuccin.macchiato.lavender,
    tab_bar_active_tab_fg = scheme_colors.catppuccin.macchiato.mauve,
    tab_bar_active_tab_bg = scheme_colors.catppuccin.macchiato.crust,
    tab_bar_text = scheme_colors.catppuccin.macchiato.crust
}

-- tab bar

local function tab_title(tab_info)
    local title = tab_info.tab_title
    -- if the tab title is explicitly set, take that
    if title and #title > 0 then
        return title
    end
    -- Otherwise, use the title from the active pane
    -- in that tab
    return tab_info.active_pane.title
end

wezterm.on(
    "format-tab-title",
    function(tab, tabs, panes, config, hover, max_width)
        local title = " " .. tab.tab_index .. ": " .. tab_title(tab) .. " "
        local left_edge_text = ""
        local right_edge_text = ""

        -- ensure that the titles fit in the available space,
        -- and that we have room for the edges.
        -- title = wezterm.truncate_right(title, max_width - 2)

        if tab.is_active then
            return {
                { Background = { Color = colors.tab_bar_active_tab_bg } },
                { Foreground = { Color = colors.tab_bar_active_tab_fg } },
                { Text = left_edge_text },
                { Background = { Color = colors.tab_bar_active_tab_fg } },
                { Foreground = { Color = colors.tab_bar_text } },
                { Text = title },
                { Background = { Color = colors.tab_bar_active_tab_bg } },
                { Foreground = { Color = colors.tab_bar_active_tab_fg } },
                { Text = right_edge_text },
            }
        end
    end
)

return config