配置

English

文件与查找顺序

SonicTerm 在所有平台使用同一个配置文件：

~/.sonicterm/sonicterm.toml

首次启动会创建这个文件，并在 ~/.sonicterm/themes/ 和 ~/.sonicterm/keymaps/ 中写入可编辑示例。

把 SONICTERM_CONFIG_DIR 设为一个绝对路径，SonicTerm 就会用该目录代替 ~/.sonicterm 存放配置文件、主题和键位表；空值会被忽略。它用于针对配置的临时 副本做诊断运行：HOME 保持不变，所以终端里的 shell 行为照常。日志有单独的覆盖 变量 SONICTERM_LOG_DIR（见日志）。

theme 和 keymap 可以写名称，也可以写 TOML 路径。使用名称时，SonicTerm 先查找用户目录，再查找内置 assets/ 目录。看起来像路径的值会直接使用。

未实现的 TOML key 不影响行为。运行时保存会保留它们、注释和格式；Rust Config serializer 则只保留顶层未知 key，不保留注释、格式或嵌套未知 key。

支持的 key 与默认值

顶层

Key	默认值	行为
theme	"wezterm"	选择主题。参见 主题。
keymap	"sonicterm-macos"、"sonicterm-windows" 或 "sonicterm-linux"	选择当前平台的 keymap。参见 快捷键。
locale	""	选择 en、zh-CN 或 ja。空值依次使用 SONIC_LOCALE、系统 locale、en。
quit_on_last_window_close	true	为兼容而接受，但会被忽略。无论取值如何，在所有平台上，最后一个窗口关闭时 SonicTerm 都会退出。
tab_min_width	240	单个标签页的最小逻辑像素宽度，让 A 这样的短标题在标签栏有空间时也有舒适的标签页。它优先于更小的 tab_max_width，由字体/缩放推导的可读最小宽度又优先于它。标签页放不下时，会先收缩到它以下、直到可读最小宽度，标签栏才显示溢出选择器，因此它不会改变溢出阈值。非有限值或非正值会被忽略。
tab_max_width	320	单个标签页的最大逻辑像素宽度。每个标签页按其内容定宽，内容用标签字体测量：#N 序号和进程图标、权限标记、标题，以及显示期间的命令状态徽章。该宽度限制在 tab_min_width 与此最大值之间；更大的 tab_min_width 优先于更小的最大值，由字体/缩放推导的可读最小宽度又优先于两者。只有当标签页达到此最大宽度或标签栏已满时，标题才会在字素边界处截断并加上 …。标签页放不下时，最宽的标签页先收缩到同一宽度，这个宽度可以低于 tab_min_width、直到可读最小宽度，短标题保持完整；连可读最小宽度都放不下时，显示包含活动标签页的区段和溢出选择器，极窄窗口会放宽最小宽度以保留两个点击区域。标签页被按下或拖动、或指针停留在标签栏上时，标题、徽章或权限标记的变化会保持当前的标签宽度；没有标签页被按下或拖动且指针离开标签栏后才会更新。早期版本生成的配置仍写有 tab_max_width = 240 并保留这一上限，因此标签栏有空间时每个标签页都是 240 宽；删除这一行或调大它即可使用新的默认值。非有限值或非正值会被忽略。即使终端内容空闲，宽度策略变化也会使保留的标签界面失效并重绘。

[font]

Key	默认值	行为
family	"Rec Mono St.Helens"	主字体族。缺失的字符使用回退字体。
size	13	字号，单位为 point。
line_height	1.3	行高倍率。
weight_scale	1.0	选定字体后统一调整所有单色字形的粗细，包括粗体、斜体和回退字体。有效范围是 0.5..=5.0；其它值会变成 1.0。固定字号和 DPI 时，单元格度量、位图尺寸、bearing 与推进量不变。彩色图像内容不变。
subpixel_aa	"off"	LCD 覆盖率顺序：off、rgb 或 bgr。生效条件见下文。

字体设置会同时用于终端文字和普通应用文字。修改 family、size 或 line_height 时，每个可见 pane 的 grid 与 PTY 都会重新调整大小。只修改 weight_scale 不会改变 metrics。subpixel_aa 仅在 Windows 上满足以下条件时 生效：配置的 backdrop 是 opaque、实际 opacity 为 1，并且 Windows 软件 presenter 正在使用或 GPU 支持 dual-source blending。其它所有组合都会确定性回退 到灰度，包括 Mica、Acrylic、Tabbed、opacity 小于 1、不支持的 GPU 和非 Windows 主机。off 保留 alpha 最大值灰度输出；rgb 把逻辑红、绿、蓝覆盖率映射到对应 显示通道；bgr 交换红、蓝通道。字体 shaping 与 fallback 的详细说明见 渲染与字体。

[window]

Key	默认值	行为
cols	100	新窗口的初始列数。
rows	30	新窗口的初始行数。
padding_left	12	内容左侧 padding，单位为逻辑像素。
padding_right	12	内容右侧 padding，单位为逻辑像素。
padding_top	8	内容上方 padding，单位为逻辑像素。
padding_bottom	4	内容下方 padding，单位为逻辑像素。
decorations	true	为新窗口启用原生标题栏装饰。
warm_window_pool	1	为快速拖出标签页预留的隐藏子窗口数量。0 关闭预热池。硬件渲染最多保留 5 个；软件渲染会把任何非零值限制为 1。

cols 与 rows 设置启动尺寸，以及没有可用来源窗口时的默认尺寸。新建和拖出窗口继承发起窗口 的逻辑客户区尺寸，预热窗口也相同。尺寸在延迟创建之前记录，后续焦点变化不会替换它；不继承 最大化或全屏状态。来源缺失、最小化或尺寸为零时采用配置默认值。目标屏幕 DPI、原生最小尺寸 和实际接受的 resize 仍生效；把标签页移入已有窗口不会改变该窗口尺寸。每个原生终端窗口都有不可配置的硬最小内区大小： 30 列 × 10 行。像素下限会按当前字体、DPI、padding、标题栏和标签栏 geometry 重新计算， 包括实时重载字体/padding 以及切换标签栏可见性之后。

Grid 尺寸始终有上限。每个轴最多是 4096，可见 grid 最多包含 524288 个 cell，包含历史记录的完整 grid 最多包含 1048576 个 cell。

[terminal]

Key	默认值	行为
shell	省略	新 pane 使用的 shell。Windows 依次尝试 PATH 中的 pwsh.exe、已注册的 PowerShell 7、Microsoft Store 中的真实程序、Windows PowerShell、cmd.exe。Unix 依次尝试可执行的 $SHELL、当前用户 passwd 中的可执行 shell、/bin/sh。非空显式值优先。
term_program	"SonicTerm"	新子 PTY 的 TERM_PROGRAM。TERM_PROGRAM_VERSION 通常是 SonicTerm 版本；term_program = "WezTerm" 时为 20230712-072601。
scrollback	1000	每个 pane 请求保留的历史行数。0 关闭历史记录。Grid 和内存字节预算可能进一步降低实际值。
keypad_mode	"auto"	auto 保留协商的旧式小键盘映射及操作系统解析出的数字文本。显式选择 numeric 后，运算符和 Enter 不受 DECKPAM 影响，使用普通文本/Return 规则，导航遵循逻辑按键。Kitty 输入不变。参见快捷键。
clickable_local_targets	true	所有平台都打开经过验证的本地目录，或在所在文件夹中选中文件。包括本地 file URI 和本机路径 OSC 8 链接；网页和邮件链接不受控制。
clickable_bare_names	true	允许按准确 pane 的可信本机 OSC 7 工作目录解析上下文名称。带分隔符的相对路径也要求同一可信 pane CWD。在备用屏幕上两者都不会解析，因为全屏程序可能显示多个窗格。只有 clickable_local_targets 同时为 true 时才生效。
clickable_path_max_chars	1024	考虑的自动检测路径候选的最大长度，按显示候选的 Unicode 字符数计算；更长的候选会被忽略。取值钳制在 1–1024，因此默认值即最大值。16 KiB 逻辑文字上限、8 个空格分隔部分和 32 行上限仍然适用，扫描器对每个目标的 4 KiB 上限也仍然适用。OSC 8 和 file URI 目标不受其限制。重载后值发生变化时，会撤销当前路径结果。
cursor_blink	false	让光标闪烁。
cursor_shape	"block"	可选 block、bar 或 underline。

Scrollback 行数与内存预算会同时限制历史记录。包含丰富属性的行可能先达到 字节预算。参见 内存。

[appearance]

Key	默认值	行为
backdrop	"opaque"	可选 opaque、mica、acrylic、tabbed。Windows 会尽力应用对应 DWM 材质。Linux 在每次启动和显式重载时都会收敛为 opaque，请求其它值时记录一次 warning。macOS 只把非 opaque 值当作需要 alpha 的窗口；这些 Windows 材质名称不会选择 macOS 材质。
opacity	1.0	终端背景透明度，会限制在 0.0..=1.0。
scrollbar	"auto"	可选 auto、always、never。没有可滚动历史时，always 也不会显示。
panel_padding	2.0	浮动面板内部 padding，单位为逻辑像素。负值按 0 处理。
software_render_mode	"auto"	auto 在检测到软件 adapter 时降级；force 始终降级；off 从不降级。

软件降级会降低帧率与动画成本。Windows 中，software_render_mode = "force" 还会让新窗口变为不透明，因为软件 presenter 不能合成透明效果。如果配置了非 opaque backdrop，SonicTerm 会记录包含配置值与实际值的 warning。auto 不会覆盖 backdrop。

滚动条 thumb 可以拖动。点击 track 会滚动一个 viewport。auto 会在滚动、 拖动或鼠标靠近 pane 右边缘时显示。

[accessibility]

Key	默认值	行为
high_contrast	false	把当前主题的前景色和背景色改为 #ffffff 与 #000000。
reduced_motion	false	可以解析和保留，但目前不会改变界面。
strong_focus	false	可以解析和保留，但目前不会改变界面。

[notifications]

Key	默认值	行为
long_command	false	在 Windows 上启用长命令桌面通知。macOS 和 Linux 目前不发送此通知。
threshold_secs	10	命令报告的耗时必须大于此值。

[status_line]

状态栏是窗格与标签栏之间的一条窄栏，显示 SonicTerm 自身的状态：指针下检测到的目标、哪些输入模式已开启、当前窗格向上滚动了多少、SonicTerm 自身的问题，以及它自己的内存。它只显示 SonicTerm 知道而 shell 提示符、tmux 或程序本身无法报告的信息。默认关闭。

Key	默认值	行为
enabled	false	显示状态栏。切换状态栏显示（toggle_status_line，也在“视图”菜单中）在本次会话中切换它。
preset	"developer"	起始的列表和段默认值："minimal"、"developer" 或 "diagnostics"。
left、center、right	预设的列表	存在时替换预设中的对应列表。目录之外的 id、出现两次的 id，或本版本未实现的 id 都会导致加载失败。
icons	"unicode"	只改变符号："unicode"、"ascii" 或 "nerd"。本版本没有为这些段定义 Nerd Font 符号，因此 nerd 整体使用 Unicode 符号集，不做逐字形回退。段没有工具提示；每个段都有供辅助技术使用的纯文字朗读名称和值。
hide_sensitive	false	隐藏所有敏感段（例如指针下的链接），用于屏幕共享。切换状态栏敏感内容（toggle_status_line_sensitive）在本次会话中切换它。
update_interval_ms	2000	采样段（内存）的采样间隔，500 到 60000。

重载只在文件中 enabled 或 hide_sensitive 的值本身改变时才应用它们，因此会话中的切换在无关的重载后仍然保留。

本版本的预设：

预设	left	center	right	段默认值
developer	mode、scroll、input、paste	link、sel	alerts、clip、health、glyphs、history、mem	—
minimal	—	—	alerts、clip、health、mem	—
diagnostics	同 developer	同 developer	alerts、clip、health、glyphs、history、cpu、frame、out、path_check、tab_mem、mem	mem.sparkline = true

除 mem 外，每个段只在有内容时显示，因此空闲窗口只显示 内存: 412 MB。

段	显示	默认优先级	默认点击
alerts	提醒: #2 #3：本窗口中需要你处理的标签页编号，按标签页顺序：标签页不在前台时响过铃，或有运行至少 min_secs 的命令结束（需要 OSC 133 shell 集成）。超过四个时显示 #2 #3 #5 #6 +2；其他窗口有标记时追加 +1 个窗口。被标记的标签页在标签栏的标题前还会显示 ●。访问该标签页会清除标记；你正看着该标签页时发生的响铃或命令结束，之后也不会标记它。朗读值写明每个来源（"响铃"、"2m14s 后完成"），从不声称程序在等待输入。notify 来源可以配置，但在 SonicTerm 解析程序通知之前不标记任何内容；9;4 进度等 ConEmu OSC 9 子命令永远不算通知。窗口变窄时保留。	990	跳到当前标签页之后的下一个被标记的标签页，循环，然后跳到下一个有标记的窗口。
clip	程序发送 OSC 52 剪贴板请求后，在 hold_secs 内显示 SonicTerm 对最后一个请求的处理以及发送它的标签页：剪贴板: 2.10 KB 来自 #2（已写入）、剪贴板: ✗ 失败 来自 #2（系统剪贴板拒绝写入）、剪贴板: ⚠ 已拒绝读取 来自 #2（读取从不应答），或暗色的 已拒绝（选区 p）、已拒绝（过大）（解码后超过 512 KiB）、已拒绝（无效）（为空、Base64 格式错误或不是 UTF-8）。×N 表示保留期内的请求数。标签页不在本窗口时显示 来自另一个窗口 或 来自已关闭的标签页。它从不显示剪贴板文本，也不声称剪贴板仍保存着写入的内容。在 tmux 中，来源是运行 tmux 的标签页。拒绝以 debug 级别记录，每个窗格每秒最多一行。	760	跳到来源所在窗口中的来源标签页。
cpu	CPU: 14%：SonicTerm 自身在最近一个 update_interval_ms 内的 CPU 占用（所有线程的用户态加内核态时间，不含子进程）。core 以一个满载核心为 100%，与活动监视器的 % CPU 和 top 的 %CPU 一致；total 以全部逻辑核心为 100%，与任务管理器的 CPU 列一致。达到 min_percent 时出现，连续 hold_samples 次采样低于 min_percent × hide_ratio 后才隐藏。启用或唤醒后的第一次采样不显示。状态栏自身的重绘也计入其中。只在 diagnostics 中。	380	打开内存占用报告。
frame	帧: 4.1 ms · GPU：本窗口最近一个间隔内呈现的内容帧的平均 CPU 侧耗时（从开始收集到结算），以及呈现方式（GPU、CPU 适配器上的 wgpu 显示 GPU（软件），或只在 Windows 上出现的 GDI）。它不是 GPU 完成时间。只有结算了状态栏和光标闪烁以外变化的帧才计入，因此空闲 shell 中闪烁的光标读作空闲；需要重试的纯状态栏尝试不计入，重试的内容尝试只计一次。帧率在朗读值中。它从不为测量请求帧。使用 always 时空闲窗口显示 空闲 · GPU。只在 diagnostics 中。	360	无。
out	输出: 14.0 MB/s：最近一个间隔内解析前收到的 PTY 输出字节，统计焦点窗格（scope = "pane"）或窗口的全部窗格。只在显示中的状态栏列出 out 时计数。移到另一个窗口的窗格保留其计数，因此移动不会重复计算。滞后规则与 cpu 相同。只在 diagnostics 中。	340	无。
path_check	路径检查: 3s：运行超过 show_after_ms 的最早一次路径探测或路径打开，从工作线程开始执行时计时（不计排队等待），仍有检查排队时附加 · 2 个排队。有检查排队时，每隔 show_after_ms 重新检查，直到队列清空。所有检查结束且没有排队时保持 hold_ms；保持期间开始的检查延续同一显示。超过 warn_after_secs 后变为琥珀色并带 ⚠，因此失效的网络卷会显示不断增长的时间。提交给已停止工作线程的检查不计入，已停止的工作线程也没有运行中的检查。只在 diagnostics 中。	700	无。
tab_mem	标签页内存: 38 MB：SonicTerm 为活动标签页的窗格保存的终端状态（网格、历史、超链接、内联媒体），取自 30 秒保留量记账最近一次的计费。它不是程序的内存。 它从不自行测量窗格。某个窗格的计费早于两次记账时显示 84 MB · 40s 前；有窗格从未计费时隐藏，因为没有覆盖整个标签页的总和。只在 diagnostics 中。	330	无。
glyphs	暗色的 字形: ⚠ 缺少 3 个：本窗口已呈现的终端行中，因 SonicTerm 能找到的字体都不覆盖而画成方框的不同字符数（配置的字体族、font_dirs、内置字体和平台系统回退都已运行且都未覆盖）。仍在等待回退的字符、查找失败的字符、光栅化为空的字形、大到无法放置的图块、空白、界面文字和不在屏幕上的行都不计入；它计的是字符而不是单元格。超过上限（每行 64 个、每窗口 1,000 个）时显示 缺少 ≥ 1,000 个；未解析集合本身溢出时显示 计数已截断。安装覆盖这些字符的字体或选择另一个 [font].family；见渲染与字体。	320	显示一条通知，以 U+0378 形式列出最多 16 个码位并附字体提示；从不写入剪贴板。
health	只在出问题时显示：每个文件最近一次失败的加载（启动时或重载时），如 配置: ✗ 第 12 行（以及 主题:、键位:），保留到该文件成功重载为止；渲染: ⚠ 软件 (GDI)、软件适配器 或 软件 (强制)；GPU: ⚠ 恢复中。	950	有重载错误时打开配置文件，否则无。
mem	SonicTerm 自身进程的内存，如 内存: 412 MB，使用二进制单位和三位有效数字；与上一次采样相比变化至少 1% 时显示 ↑ 或 ↓。达到 warn_mib 时为琥珀色并带 ⚠，达到 critical_mib 时为红色并带 ✗。	900	打开内存占用报告。
mode	标记：广播输入 ⇶ 3（含接收窗格数）、复制模式 复制、程序捕获鼠标时的 鼠标。	800	无。
input	在 hold_secs 内显示 SonicTerm 为本窗口中某个窗格拒绝或阻止的输入：输入: ✗ 未发送（忙）（窗格的输入队列已满）、未发送（已关闭）（其写入端已停止）、未发送（过大）（超过 16 MiB）、输入: ✗ 写入失败（3 条未发送）（写入端因系统错误停止，有这么多已接受的写入未送达）、输入: ⚠ 粘贴被拒绝（广播时为 粘贴被拒绝（2/5）：拒绝的窗格数和尝试的窗格数）、暗色的 输入: ⊘ 已阻止（只读）（READONLY 消耗了一次粘贴、拖放或写入；跳过广播接收窗格时为 已阻止 2 个窗格），或在 Windows 上的 输入: ✗ 按键未发送。当发往某个窗格的最早一次已接受写入未完成达到 held_after_ms 时，输入: ⚠ 已等待 4s 显示其时长，排队达到 1 MiB 时附加 · 排队 12.0 MB；写入完成后隐藏。已等待 只说明一次已接受的写入尚未完成，从不声称程序卡住或在等待；在 tmux 中，写入端写给的是 tmux。写入失败 取代 已等待，已等待 优先于其它记录。通知不变；不保留、绘制、记录或朗读任何输入字节。键入时每个窗格每 held_after_ms 最多安排一次检查，检查发现没有未完成的写入，不会重绘。	780	无。
link	指针下检测到的目标：链接: github.com/…；OSC 8 链接的显示文本写的是另一个主机，或文本或目标带有 userinfo 时显示 链接: ⚠ evil.example ≠ bank.example（启发式警告，不是防欺骗保护）；显示文本触到视图的首行或末行、超过 32 个片段或 2 KiB 时显示 链接: … · 未检查显示文本，此时文本未被完整读取，绝不会被判定为一致；路径: ~/proj/src · 显示 或 · 打开文件夹、300 ms 后的 · 检查中、✗ … · 未找到，或带原因的 ⚠ … · 已阻止。	600	无。
sel	复制窗口选区（或复制模式范围）时会放到剪贴板上的内容大小：选区: 3 行，单行时为 选区: 142 个字符，按复制本身的规则计数（自动换行的行相连，去掉行尾填充和独立的右侧边框）。超过 50,000 行的选区，或遍历会超过 200,000 个单元格的选区，改为显示精确的行数：选区: 12,345 行 · 计数已截断。执行 copy_to_clipboard 或复制模式的 y/Enter 后，在 copied_secs 内显示 选区: ✓ 已复制，或红色的 选区: ✗ 复制失败，即使复制清除了选区也是如此。程序通过 OSC 52 进行的复制不在此显示。计数在帧处理中进行，并在选区的窗格、端点、屏幕或回滚淘汰不变时复用；对复制模式的范围，范围内任一行变化时也会重新计数。	520	复制窗口的选区；显示复制结果时无效。
paste	粘贴到当前窗格不会被括起时，以琥珀色显示 粘贴: ⚠ 未括起：括号粘贴模式关闭、窗格处于主屏幕，且其 shell 已通过 OSC 133 报告提示符（见 终端 IO 与 VT）。没有 OSC 133 的窗格或正在运行命令的窗格从不显示。朗读值为"粘贴未使用括号模式，可能逐行执行"：SonicTerm 无法知道 shell 会如何处理换行。cmd.exe 不发送 OSC 133，因此从不显示该警告，尽管它的粘贴总是逐行执行；PowerShell 只有在提示符发送 OSC 133 时才显示。	560	无。
ime	只显示输入法问题：复制模式丢弃一次提交后，在 hold_secs 内显示 输入法: ⚠ 已丢弃（复制模式）；或在组字的提交将进入搜索框或命令面板而不是窗格时显示 输入法: → 搜索 / 输入法: → 命令面板。正常向窗格组字时不显示。平台不报告组字事件时（部分 Wayland 环境），只会出现复制模式警告。不在任何预设中。	500	无。
scroll	当前窗格向上滚动时显示 滚动: ↑ 340。	400	让窗格回到底部。
history	SonicTerm 因当前窗格的历史超过网格内存预算而丢弃回滚行后，以琥珀色显示 历史: 已截断；朗读值给出行数。超过 [terminal] scrollback 上限的滚动、清除、调整大小或降低上限都不会显示。点击它或程序清除回滚（CSI 3 J，大多数 shell 中的 clear 会发送）前一直显示，之后再次截断时重新显示。SonicTerm 没有清除回滚的动作，因此只有这两种确认方式。	300	确认截断。
font	需手动加入。实时字号与配置字号不同时显示 字体: 16pt (+2) 或 字体: 13.5pt (−0.5)；相同时隐藏。字号对整个应用生效，因此每个窗口显示相同的值。	280	重置字号（reset_font_size）。
zoom	需手动加入。活动标签页中有分屏窗格被放大填满时显示 缩放 标记，不带名称。	260	切换窗格放大（toggle_pane_zoom）。
size	需手动加入。当前窗格的网格调整大小后（调整窗口大小、分屏、改变字号或显示缩放），在 hold_ms 内显示 尺寸: 120×40，即列数和行数。窗格的第一帧、新标签页、恢复的会话、拆出的窗口以及焦点切换到另一个窗格都不会显示。	80	无。

内存数字与内存占用报告相同：macOS 上是物理内存占用（活动监视器的“内存”列），Windows 上是私有提交字节（任务管理器的 提交大小 列），Linux 上是常驻集（top 的 RES）。不计入子进程。查询失败时显示 不可用。

每个 [status_line.segment.<id>] 表接受：

Key	取值	行为
show	"always" 或 "active"	always 保留位置并显示空闲文本（不可用、底部、正常、无）；active 在段没有内容时隐藏它。alerts、clip、glyphs、input、path_check、tab_mem、link、paste、ime、history、font、zoom 和 size 只接受 active。
priority	0 到 1000	窗口变窄时，值越高保留越久。
click	"default"、"none" 或动作名	default 执行该段自己的点击；none 让它不响应指针；不带参数的键位动作（如 "show_memory_usage"）在被点击的窗口中执行。paste、ime 和 size 只接受 default 或 none，二者都不响应。

[status_line.segment.mem] 还接受 show_trend（true）、sparkline（false，diagnostics 中为 true：数字后面八个暗色单元，表示最近两分钟，每个单元是一个按墙钟对齐的 15 秒区间中的最大采样，在绘制单元的最小值和最大值之间缩放；只绘制已结束的区间，因此只在区间结束时变化；没有采样的时间段，例如窗口被遮挡或机器休眠，保持空白）、warn_mib（1024）和 critical_mib（2048，不小于 warn_mib），取值均为 1 到 1048576。[status_line.segment.sel] 还接受 copied_secs（2，1 到 10），即复制结果显示多久。[status_line.segment.paste] 接受 paste（"when_off"，默认，或 "never"）。[status_line.segment.ime] 接受 hold_secs（8，1 到 60），即复制模式警告显示多久。[status_line.segment.size] 接受 hold_ms（1500，250 到 10000）。[status_line.segment.clip] 接受 hold_secs（10，1 到 600）。[status_line.segment.path_check] 接受 show_after_ms（300，100 到 5000）、hold_ms（1000，0 到 10000）和 warn_after_secs（10，1 到 600）。[status_line.segment.cpu] 接受 scale（"auto"：Windows 上为 "total"，其它平台为 "core"）、min_percent（5，0 到 1000）、hide_ratio（0.7，0.1 到 1.0）和 hold_samples（2，0 到 10）。[status_line.segment.out] 接受 scope（"pane" 为焦点窗格，或 "window"）、min_bytes_per_sec（1048576，1024 到 1073741824），以及与 cpu 相同的 hide_ratio 和 hold_samples。[status_line.segment.glyphs] 接受 min_count（1，1 到 1000），低于此数时隐藏，以及 ignore_private_use（false；true 时不计入 Nerd Font 图标等私用区码位）。[status_line.segment.input] 接受 hold_secs（8，1 到 600），即拒绝或失败显示多久，以及 held_after_ms（1500，250 到 60000），即已接受的写入未完成多久后显示 已等待。[status_line.segment.alerts] 接受 min_secs（10，0 到 86400）和 sources（["bell", "notify", "finished"]；列出的来源较少时，其余来源关闭）。[status_line] 下和段表内的未知 key 会被忽略，并在每次加载时以一条列出全部未知 key 的 sonicterm-cfg 警告记录一次。

窗口过窄时，状态栏先使用紧凑形式（内存去掉箭头和迷你图，mode 去掉 鼠标），再从中间缩短链接的路径，然后按优先级从低到高整段移除。健康错误、广播标记和链接的目标主机最后移除。

状态栏高度为标签栏的 0.6 倍，至少 20 个逻辑像素，并随字体缩放和显示缩放变化。它与标签栏共用背景，只在靠近终端的一侧有一条细线；标签栏隐藏时它位于窗口底部。打开或关闭它会调整窗格大小；用 [window] rows 打开的窗口保持该行数。在状态栏上的按下和滚轮不会传给窗格或程序。它只出现在终端窗口中，不出现在内存占用报告中。

状态栏不会让事件循环保持唤醒：只有在能绘制帧的终端窗口显示 mem 时才采样内存，并且只有状态栏像素改变时窗口才会重绘。在硬件路径上，这样的帧只损伤状态栏所在的带区，因为状态栏的字形和缺字方框都被裁剪在其中；软件渲染（包括每个 GDI 帧）和有覆盖层打开的帧仍像以前一样重绘整个窗口。

[logging]

Key	默认值
level	"warn"
max_file_size_mb	10
max_rotated_files	3
max_age_days	2
max_crash_dumps	10
max_crash_age_days	2
max_crash_bytes	10485760
max_breadcrumb_files	10
max_breadcrumb_age_days	2
max_breadcrumb_bytes	1048576

level 可选 error、warn、info、debug。Logging 在启动时初始化， 所以修改这些值后需要重启。文件位置、清理规则和诊断方法见 日志。

编辑与重载

在命令面板中执行 Edit sonicterm.toml 可以打开标准配置文件。SonicTerm 只在启动和执行 Reload Config 时读取它，没有文件 watcher。

每次重载都会重新读取所选主题与 keymap 文件，即使名称没有变化。以下设置会 应用到现有窗口：

• 主题、keymap 与 locale；
• 字体族、字号、行高、字重与 LCD 次像素模式；
• 内容 padding、opacity、滚动条和 panel padding；
• 光标形状与闪烁；
• scrollback、小键盘模式与本地目标策略，包括路径长度上限；
• 标签页宽度、预热窗口目标、软件降级、无障碍与通知设置。

有些设置只影响重载后新建的对象：

• cols、rows、decorations 和原生 backdrop 只影响新窗口；
• shell 与 term_program 只影响新 pane；
• logging 设置需要重启。

平台能力收敛会在启动或重载配置成为会话基线前执行。因此 Linux 永远不会存储不支持的 backdrop：现有状态和之后所有预热、新建或拆出窗口都会从已收敛配置读取 opaque。warning 只在该次收敛真正修改值时写一次；再次处理已经为 opaque 的结果不会重复 warning。

修改 backdrop 或 software_render_mode 可能涉及原生窗口初始化。如果需要完整 应用原生窗口变化，而不只是更新 renderer 策略，请重启 SonicTerm。实时修改 subpixel_aa 只会使已呈现帧失效并重绘，不会重建字体、光栅图块或任一图集。

保存当前字体设置

Save Current Settings 只修改 ~/.sonicterm/sonicterm.toml 中的两个值：

[font]
size = 13
weight_scale = 1.0

保存写入当前字号和有效 weight_scale，保留注释、顺序、换行及其它所有 key。 它不保存主题或其它运行状态，也不重载已经生效的数值。

如果文件不存在，SonicTerm 会先创建初始文件。进程内锁和持久的 sonicterm.toml.save.lock sidecar 会阻止两个 SonicTerm 同时保存。替换文件前， 程序还会再次比较精确字节。编辑器并发修改、TOML 格式错误、字体值无效或锁冲突 都会拒绝写入。现有文件和 reset 基线保持不变，并显示 Error 通知。

保存成功时，SonicTerm 会先在配置目录写入临时文件，再原子替换配置，并显示 Info 通知。读取者只会看到完整旧文件或完整新文件；突然断电时的持久性不在此保证内。

错误与恢复

启动时，如果配置不可读或 TOML 格式错误，SonicTerm 会记录 warning 并使用默认值， 保证应用仍可打开。所选主题无效时回退到内置 wezterm。所选 keymap 无效时回退到 当前平台的内置 keymap。

执行 Reload Config 时，如果已有的 sonicterm.toml 不可读或格式错误，当前整套配置 保持不变；文件不存在时则加载默认值。如果配置本身有效，但主题或 keymap 读取失败， SonicTerm 会保留当前主题或 keymap、记录错误，并应用其它有效设置。结构正确的 keymap 中，如果只有某个 binding 的 action 无法解析，SonicTerm 只跳过该 binding，其它 binding 仍会生效。