设置一览

设置（Settings） 包含语言、外观、快捷键、视图和系统集成等选项。以下按界面中的分类列出各项设置。

打开设置

Windows / LinuxCtrl+Shift+PmacOS⌘+,

默认以对话框打开设置；如果本窗口已有设置标签页，则切换到该页。单击左侧分类可查看对应选项，也可以在顶部的 搜索设置… 中输入关键词。没有结果时显示 没有匹配的设置。

设置搜索覆盖全部分类，并可定位快捷键表中的动作名和当前按键。搜索到子页设置时，按 Enter 进入对应页面。右键菜单顺序、自定义命令、打开方式和 Vim 键位使用各自页面的筛选框。

设置自动保存，下次启动时仍会保留。

支持恢复默认的设置页会在恢复后提供 撤销；已经处于默认状态时不会产生记录。见 活动记录。

部分选项只在特定条件下显示。例如，主题 选择 跟随系统 后，才会显示浅色和深色主题的设置。

在标签页中打开设置

1. 单击窗口左上角的菜单按钮。
2. 选择 在标签页中打开设置（Open Settings in a Tab）。

每个窗口最多有一个设置标签页；再次选择此项会切换到已有页面。设置标签页打开期间，菜单中的 设置 和打开设置的快捷键也会切换到该页。

设置标签页可以在本窗口内参与分屏，但不能拖出为其他窗口。切换到其他标签页不会关闭它，重启后可以随会话恢复。按 Esc 不会关闭设置标签页；使用标签页的关闭按钮或设置中的 × 关闭。关闭后，再次打开设置会恢复对话框形式。页面过窄时，可以使用横向滚动条查看右侧内容。

外观（Appearance）

缩放与语言

设置项	作用
缩放（UI Scale）	调整 tessoa 的界面缩放，范围 50%–300%。每块屏幕分别保存。
语言 (Language)	界面语言。列表里每种语言先写它自己的名字，括号里跟一个英文名（中文 (Simplified Chinese)、Deutsch (German)）

语言 的标题和选项带有英文名称，便于在不熟悉的界面语言下识别。在设置搜索框中输入 language 也能找到此项。

未手动选择语言时，tessoa 按系统的语言偏好顺序选择第一个支持的语言；没有匹配项时使用英文。手动选择后，使用所选语言。

缩放值按屏幕分别保存。没有手动调整过的屏幕使用系统缩放；调整过的屏幕使用保存的值。切换屏幕时，tessoa 会应用对应的缩放。

手动调整当前屏幕的缩放后，缩放 下方会显示 恢复为屏幕默认。单击后恢复当前屏幕的系统缩放，其他屏幕的设置不变。

从 0.23 之前的版本升级时，原缩放值会保存到升级后首次启动所在的屏幕，其他屏幕使用系统缩放。如果原值不适合当前屏幕，可单击 恢复为屏幕默认。

添加界面语言

可以通过 TOML 语言文件添加界面语言。

1. 打开设置，在 系统 分类中单击 导出语言模板。tessoa 会把当前版本的全部文案写成 TOML 文件，并弹出提示，单击提示上的 打开文件夹 就能到达那个目录。
2. 把模板复制一份，改名成这门语言的标签加 .toml，例如韩语是 ko.toml。
3. 用文本编辑器翻译等号右边的内容，等号左边的名字和大括号里的 {name} 这类占位符保持原样。
4. 保存到同一个目录，重启 tessoa。语言 的列表里就多出了这门语言。

未翻译的条目显示英文。使用已有语言的文件名（如 zh.toml）时，文件中的译文会覆盖该语言的对应条目。

TOML 语法错误的文件会被忽略；没有可识别文案的文件不会加入语言列表。删除自定义语言文件后，界面恢复默认语言。

配色

设置项	作用
主题（Theme）	选择内置主题、自定义配色或 跟随系统；单击 新建配色… 创建配色。
系统为浅色时（When system is light）	系统处于浅色模式时使用的主题；仅在选择 跟随系统 后显示。
系统为深色时（When system is dark）	系统处于深色模式时使用的主题；仅在选择 跟随系统 后显示。
窗口材质（Window Material）	在支持的 Windows 系统上，为标题栏、标签栏和侧栏显示系统材质；默认 无（None），见 窗口材质
内容区透明（Translucent Content Area）	将窗口材质延伸到文件列表，默认关闭；仅在选择了非 无 的材质后出现

内置主题共五套：深色 1（Dark 1）、深色 2（Dark 2）、灰色（Gray）、浅色 1（Light 1）、浅色 2（Light 2）。跟随系统 默认在 深色 1 和 浅色 1 之间切换。

0.24.0 更新了内置配色。原来的青铜雪和海盐蓝分别改为 深色 1、浅色 1；曜黑映射到 灰色，暖砂映射到 浅色 2，晴空映射到 浅色 1，其余退役内置配色映射到 深色 1。升级后内置主题的观感会改变，自行保存的配色不会被此次更新改写。部分 组件风格 会调整配色在界面上的显示效果。

自定义配色

单击 主题 下拉菜单中的 新建配色…，会复制当前主题并打开配色编辑页。自定义配色各占一个菜单项，最多保存 32 套。

在编辑页里：

• 单击顶部标题可重命名，修改自动保存。
• 单击 删除配色 可删除当前配色，随后选中相邻配色。删除最后一套时恢复内置主题。
• 跟随系统 可为浅色和深色模式分别选择自定义配色。两侧选择同一套时会提示颜色不会随系统模式变化，但仍可保存。

单击编辑页顶部的 导出主题，可将配色复制到剪贴板。在另一台机器上复制这段配置后，打开配色编辑页并单击 导入。

窗口材质

窗口材质 使用 Windows 提供的云母或亚克力效果。此选项要求 Windows 11 22H2（内部版本 22621）或更高版本，并且当前图形环境能够使用 DirectComposition 进行半透明合成；不满足条件时，设置中不显示此选项。macOS 和 Linux 不提供这一设置。

1. 打开 设置 → 外观。
2. 在 配色（Colors） 组中单击 窗口材质，选择需要的效果。
3. 如果还需要让文件列表透出背景，开启 内容区透明。此项默认关闭，开启后可能降低列表文字的可读性。

取值	效果
无	使用主题的实色背景，默认值
云母（Mica）	使用取自桌面壁纸色调的云母效果
云母 Alt（Mica Alt）	使用另一种云母效果，同样取自桌面壁纸色调
亚克力（Acrylic）	透出窗口后方内容的模糊效果
轻薄亚克力（Thin Acrylic）	使用亚克力效果，界面底色更淡

Windows 的透明效果关闭时，所选材质不会显示。单击材质下方的 开启 Windows 透明效果（Turn on Windows transparency effects），会开启当前 Windows 用户的系统透明效果；若系统不允许直接修改，tessoa 会打开 Windows 的颜色设置页。窗口失去焦点时，Windows 可能将材质改为实色背景。

窗口材质仅在 扁平（Flat）、线框（Wireframe） 和 原生（Native） 组件风格下使用。选择其他风格后，材质设置会隐藏并暂停生效；原值仍保留，切回支持的风格后恢复。

组件风格

组件风格（Component Style） 决定按钮、输入框、菜单和标签页等控件的形状与表面效果，可与主题分别选择。七种风格的对照图和适用设置见 组件风格。

设置项	作用
组件风格	默认使用 扁平，也可选择 新拟态（Neumorphic）、玻璃（Glass）、线框、原生、色调（Tonal） 或 硬朗（Brutalist）。
色调浓度（Tint Strength）	仅新拟态显示，调整底色保留的主题色调，范围 0%–150%，默认 100%。
明度跟随（Follow Theme Lightness）	仅新拟态显示，调整底色的明暗向主题靠近的程度，范围 0%–100%，默认 0%。
染色浓度（Surface Tint）	仅色调风格显示，调整强调色对界面底色的影响，范围 0%–15%，默认 5%。

字体

设置项	作用
字体（Font）	界面字体，默认是 系统默认；上方输入框可以过滤字体名
字重（Font Weight）	界面文字的粗细，见下
字体大小（Font Size）	界面字号，10–20 px

字重

字重档位取自当前字体，因此可选档位会随字体变化。例如，微软雅黑提供 290 Light、400 Regular 和 700 Bold 三档，思源黑体可提供九档。滑块刻度对应可用的字重。

只使用字体自带的字重，可以避免选择不存在的字重时回退到其他字体。

字体只有一个字重时，滑块不可调整，但仍显示当前值。

文本阅读

文本预览和文本编辑标签页共用以下设置，不受界面密度影响。操作步骤与分区密度的关系见 界面密度与文本阅读。

设置项	作用
阅读字体（Reading Font）	默认 跟随界面字体（Same as UI Font），也可选择独立字体。
阅读字体大小（Reading Font Size）	默认跟随界面字号；关闭 跟随（Follow） 后可设置为 10–20 px。
阅读行距（Reading Line Spacing）	行高相对于字号的倍数，1.00–2.00，默认 1.30。

间距、边框与动画

设置项	作用
界面密度（UI Density）	调整全局留白，50%–200%，默认 100%；不改变文字大小。
文件列表（File List）	调整文件行、表头与列间距；默认跟随全局密度。
图标与缩略图（Icons & Thumbnails）	调整图标、缩略图与名称周围的留白；默认跟随全局密度。
侧边栏（Sidebar）	调整侧栏条目与标签条的留白；默认跟随全局密度。
按钮与标签（Buttons & Tabs）	调整标签、导航按钮和底栏等控件的留白；默认跟随全局密度。
圆角（Corner Roundness）	各种控件和窗格四角的圆角大小；线框风格固定直角，不显示此项。
标签页边框（Tab Outline）	未选中标签页的描边不透明度，0%–100%，默认 45%；调到 0% 关闭描边。仅扁平、线框和硬朗风格显示。
标签页边框粗细（Tab Outline Width）	未选中标签页的描边宽度，1–3 px，默认 1 px。仅扁平、线框和硬朗风格显示。
标签组边框（Tab Group Outline）	为每个分屏窗格的标签栏和内容区绘制一圈外框，默认关闭；不用于单独描边标签栏内的命名分组
动画（Animations）	动效的强弱，也可以完全关掉

文字渲染

设置项	作用
文字 Gamma（Text Gamma）	文字边缘的深浅，0.60–1.60，见下
亚像素定位（Subpixel Positioning）	每个字按亚像素精度落位，默认开
LCD 亚像素抗锯齿（LCD Subpixel Antialiasing）	使用屏幕子像素提高文字边缘清晰度，默认关闭，见下文。
字体微调（Glyph Hinting）	将笔画对齐到整像素边界，提供三档，默认 关。
经典文字渲染引擎（Classic Text Engine）	仅 Windows。用 v0.21.0 之前那套内置的文字渲染，默认开，见下
恢复默认外观（Reset to Defaults）	恢复外观设置的默认值

文字渲染设置

以下选项调整文字的渲染方式，不改变排版。

选项	调整建议
亚像素定位	字距不均匀时可开启，默认开启。
文字 Gamma	笔画过重时调低，过细时调高；1.00 不调整。
LCD 亚像素抗锯齿	低分辨率屏幕上可尝试开启；出现彩色边缘时关闭。
字体微调（Hinting）	高缩放下文字边缘模糊时，可尝试 强制。
经典文字渲染引擎	对比两种引擎的显示效果，默认开启。

LCD 亚像素抗锯齿 默认关闭。它适用于水平 RGB 子像素排列的屏幕，在 OLED、竖屏或 BGR 面板上可能出现彩色边缘。开启后若出现此问题，应关闭该选项。显卡不支持时，tessoa 使用普通抗锯齿。

字体微调（Hinting） 将笔画对齐到整像素边界，可使边缘更清晰，但也可能改变字形。提供以下三档：

档位	含义
关	不做对齐，字形最忠实。出厂默认
跟随字体	按字体自己的规定办。字体通常在字号大到一定程度之后就不再要求对齐
强制	无视字体的规定，任何字号都对齐

高缩放下，字号可能超过字体的微调阈值，跟随字体 此时可能不再对齐笔画。强制 会继续执行对齐。字号低于该阈值时，两档的效果相同。

经典文字渲染引擎 仅限 Windows，默认开启，使用 v0.21.0 之前的内置引擎。关闭后使用 v0.21.0 引入的渲染引擎。经典引擎的边缘过渡较柔和，新引擎的边缘较硬，可根据显示效果选择。

调整这些选项时，tessoa 会重新渲染全部文字，可能短暂停顿。

经典文字渲染引擎 只在 Windows 上显示。macOS 不显示 LCD 亚像素抗锯齿 和 字体微调（Hinting），因为这些选项无法在该平台产生预期效果。其他平台保存的值会保留。

布局（Layout）

快捷栏

设置项	作用
快捷栏（Quick Bar）	设置快捷栏的显示方式、按钮和收藏，见 快捷栏。

标签栏

设置项	作用
标签栏位置（Tab Bar Position）	顶部（Top）、左侧（Left） 或 右侧（Right）；默认 顶部。标签栏右键菜单可为当前窗格单独指定位置
自动收起标签栏（Auto-Hide Tab Bar）	默认关闭。开启后，标签栏收起为仅显示标题首字的方块列，悬停时展开并覆盖内容区
鼠标划过标签页即切换（Switch Tabs on Hover）	默认关闭。开启后，光标经过标签页即切换，拖动期间不生效
标签页上显示关闭按钮（Show Close Button on Tabs）	默认开启。关闭后移除按钮及其占用的空间，仍可通过右键菜单、鼠标中键或关闭快捷键关闭标签页
标签页宽度（Tab Width）	缩窄（Shrink）：空间不足时缩窄标签；完整名称（Full Name）：按各自内容决定宽度，默认值
标签页过多时	标签放不下一行时，选择 换行 或 横向滚动。
标签组编号	设置编号徽章的形状：圆徽章（默认）、键帽 或 角标。
新标签页插入位置	新标签页插入 末尾 或 当前标签页之后。
在新标签页中打开时切换过去	打开目录为新标签页时切换到新页；默认关闭，新页在后台加载。

标签栏的位置、显示方式和交互选项位于 设置 → 布局（Layout）。标签页的重命名、固定、分组，以及竖排标签栏的操作见 管理标签页。

0.24.0 首次读取旧配置时，会把 标签页宽度 从 缩窄 改为 完整名称，包括此前手动选过 缩窄 的配置。要沿用旧选择，在 设置 → 布局 → 标签页宽度 中重新选 缩窄；后续启动会保留这个选择。完整名称 下，长短不同的名称使用不同宽度，标签较多时由 标签页过多时 决定换行或滚动。

标签组编号 设置徽章形状。窗口包含两个以上标签组，或存在预览标签页时，徽章才会显示。见 标签页与分屏。

新标签页插入位置 适用于所有新标签页。在新标签页中打开时切换过去 适用于右键菜单、中键、Ctrl+Enter 和从侧栏搜索结果打开新页等操作。Ctrl+T 始终切换到新页。见 在新标签页中打开。

地址栏

设置项	作用
新标签页打开的文件夹	使用新建标签页操作时打开的目录，取值见下文。
指定目录	仅在选择 指定目录 后显示。输入路径并按 Enter 保存，或单击 浏览…。
历史列表去除重复	导航栏 ▾ 的历史列表里，同一个目录只留离当前位置最近的那一次
地址栏只显示当前地址	打开之后，跳回上层时地址栏不再保留更深那一截灰色路径段

新标签页打开的文件夹 三个取值：

取值	新页停在哪
跟随当前标签页	你正看着的那个目录
主目录	你的主目录
指定目录	你自己填的那个路径

此设置适用于 Ctrl+T 和标签栏的 + 按钮。在新标签页中打开 等已指定目标目录的操作不受影响。

路径支持 ~ 和 %变量名%。目录不存在时，tessoa 显示 这个目录不存在，未保存。已保存的目录被删除后，新标签页使用默认位置。

也可以单击 浏览…，在 选择起始目录 对话框中选择文件夹。见 目录选择器。

历史列表去除重复 只影响导航栏 ▾ 菜单的显示。后退和前进仍按完整历史逐步导航。

地址栏只显示当前地址 默认关闭。例如，从 D:\照片\2026\夏天 返回 D:\照片 后，地址栏会保留灰色的 2026 › 夏天 路径段，可单击返回。开启此项后，仅显示当前目录的路径。

侧边栏

设置项	作用
最近 / 书签 / 存储 / 位置 / 标签 / 布局	各自决定这一页在侧栏里是否显示，默认显示
目录总览（Open Tabs）	默认显示。列出本窗口各窗格的全部标签页，单击一行即可切换过去
目录树跟随当前文件夹	默认开。导航时侧栏自动展开到当前目录并滚到它；关掉之后侧栏不再跟着动，见 界面导览
侧边栏失去焦点时自动收起（Sidebar: Auto-Collapse When Unfocused）	失去焦点时自动收起侧边栏。
收藏夹中的文件夹可展开（Favorites expand as a folder tree）	允许展开收藏文件夹，浏览其子目录。
清除最近记录	立刻清空「最近」的访问统计

这一组决定侧栏显示哪些页，以及目录树是否跟随当前目录。各页通过标签切换，也可以分到不同栏同时显示，见 侧栏。

隐藏一页不会删除它的数据。隐藏 标签 后，标签库与文件上的标签保留；隐藏 最近 后，访问记录继续累积。要清空最近访问统计，使用 清除最近记录。

隐藏的页保留在侧栏布局中的顺序，重新显示后恢复原来的位置。分栏、折叠与标签顺序的调整见 侧栏。

启动

设置项	作用
启动时还原的布局（Layout to Restore at Startup）	选择启动时还原的布局，见 布局。

批量重命名

设置项	作用
规则面板位置（Rule Panel Position）	批量重命名规则面板的位置，见 批量重命名。

隐藏项目（Visibility）

隐藏项目 包含显示模式、隐藏规则和存储项开关：

这一节	管什么
显示隐藏项	三档：不显示 / 显示 / 显示全部。Ctrl+H 在前两档之间切，第三档只能在这里选
规则	你自己的名单：按通配符或正则匹配名字，可以隐藏也可以放行，还能限定只在某个文件夹里生效
存储项	本机全部磁盘、WSL 发行版和便携设备，每项一枚开关，决定它出不出现在侧栏和「此电脑」里

0.19 及更早版本里的 显示隐藏项 开关和 隐藏规则 整页已经合并成这一页。逐项讲解见 隐藏项目。

Windows 文件和文件夹的系统隐藏属性也可用于隐藏项目。

从 v0.27.0 起，名称以点开头和系统隐藏属性分别由独立开关控制，默认均开启。系统隐藏属性只在 Windows 生效。

列表（List）

视图与列

设置项	作用
视图范围与缩放档位（View Configuration）	设置 视图和排序应用于（View Settings Belong To） 的范围、五种视图各自的缩放档位，以及图标档位的原图解码
新标签页视图（New Tab View）	按 Ctrl+T 新开的标签页使用的视图，跟随当前 表示沿用当前视图
新标签页图标大小（New Tab Icon Size）	只在上一项选了 图标 时出现，设置新标签页的默认图标大小
详细列表的列	整页设置：详细列表显示哪几列、各排第几，见 按你的习惯排列界面

视图范围与缩放档位 中的 视图和排序应用于 设置视图切换、排序和滚轮缩放的作用范围：

取值	影响范围
当前文件夹	保存当前目录的视图，下次访问时恢复。见 视图模式。
当前标签页	只改你正在看的这一页（默认）
当前标签组	同一个窗格里的全部标签页
所有标签组	全部窗格的全部标签页

存在文件夹视图记录时，页面会显示 清除文件夹视图记忆，可一次清除全部记录。

缩放档位决定每次滚动滚轮时使用的尺寸。百分比范围为 50%–300%，图标尺寸范围为 16–512 px。可继续添加档位，直到范围内没有可用值；单击 恢复默认挡表 可还原。

图标 的每个档位可单独勾选原图解码。勾选后按原图解码；未勾选时，放大 256 px 缩略图。显示尺寸不变，原图解码更清晰，也占用更多显存。默认只勾选最大档位。

低于 24 px 的档位使用固定的 16 px 缩略图区域，不需要原图解码，因此勾选框不可用，并显示 小图标挡用不上。

系统图标最大为 256 px。更大的档位仍会放大图标，原图解码开关不影响它们。

列表外观

设置项	作用
斑马纹（隔行交错色）（Zebra Striping）	列表隔行加一层浅底，长列表更容易横向对齐着看
长名称省略中间（Ellipsis in the Middle）	文字装不下时保留头尾、省略中间（abc…xyz）。默认关，也就是从末尾省略
扁平文件夹图标（Flat Folder Icons）	文件夹图标改用扁平画法。新装默认关闭，使用系统原生图标；升级保留原有选择
整行高亮（Highlight Full Row）	详细列表中高亮整行；关闭后只高亮名称。
显示序号（Show Row Numbers）	显示行号；分组时每组重新从 1 开始。
显示文件扩展名（Show File Extensions）	显示文件扩展名。关闭时重命名只修改名称主体，保留扩展名。
目录悬浮展开	设置悬停时文件夹缩略图的排列方式：弧线、抽牌、横排、阶梯 或 关闭。
分组时保留文件夹展开	允许在分组列表中展开文件夹，默认开启。见 视图模式。

扁平文件夹图标使用自定义配色中的 目录图标（Folder icon） 颜色，修改 强调色（Accent） 不会改变它。原生文件夹图标保留系统颜色；文件夹缩略图卡片仍使用 目录图标 颜色。

长名称省略中间 在文字装不下时保留头尾（abc…xyz），适用于文件名、路径、标签页标题和菜单项，不影响输入框，见 文件操作：重命名。需要通过名称末尾区分项目时，可开启此项；关闭时从末尾省略。

分栏

设置项	作用
展开当前列（Expand the Active Column）	展开当前列以显示更多信息。
按列宽显示更多信息（More Info in Wider Columns）	列越宽，显示的信息越多。
窄列双行显示（Two-Line Details）	窄列在名称下方显示一行信息。

文件名换行

设置项	作用
文件名最多行数（Max Lines per File Name）	设置图标视图与图库中文件名的最大行数。
图标行高（Icon Row Height）	选择自动行高或固定两行。
换行位置（Wrap At）	设置名称可以在哪些位置换行。
分隔符（Separators）	设置允许换行的分隔符。

距今列

设置项	作用
距今配色（Age Badge Colors）	光谱（Spectrum）、光谱·平（Spectrum, Flat）、绿→蓝（Green to Blue）、饱和度（Saturation）、降噪（Quiet），默认 光谱
距今样式（Age Badge Style）	实心（Solid）、淡底（Tinted）、仅文字（Text Only），默认 实心
距今颜色过渡（Age Color Mapping）	连续（Continuous） 或 分档（Stepped），默认 连续
距今颜色浓度（Age Badge Chroma）	40%、70%、100%、130%，默认 100%
距今日期类型图标（Age Badge Marker）	在距今列中显示日期类型图标。

五项 距今 设置调整详细列表中的年龄徽章，见 距今徽章。这一列的显隐、顺序和宽度仍在列头菜单或 详细列表的列 中调整。

文件夹大小

设置项	作用
自动计算文件夹大小（Calculate Folder Sizes Automatically）	进入一个目录时，是否在后台递归扫描子项、算出每个文件夹的总大小

按存储介质决定要不要自动统计

统计文件夹大小需要读取全部子项，机械硬盘和网络位置的扫描可能较慢。Windows 开启 自动计算文件夹大小 后，可按存储介质分别设置：

子开关	建议
固态硬盘	自动统计的开销通常较低。
机械硬盘	扫描大型目录可能影响磁盘性能，可按需关闭自动统计。
可移动介质	包括 U 盘、SD 卡和光驱。扫描速度因设备而异，断开设备会中断扫描。
网络位置	包括映射的网络驱动器和共享目录。扫描速度受网络影响，较慢时可关闭自动统计。

介质分组按读取成本划分：内存盘归入固态硬盘，光驱归入可移动介质。

Windows 无法识别存储介质的卷不参与自动扫描，也不受上述四个开关影响。

其余介质用 Everything 统计（Count Other Media with Everything） 默认开启，仅在 Windows 开启 自动计算文件夹大小 后显示。未开启自动扫描的介质，以及无法识别介质的卷，可从 Everything 索引读取文件夹的子文件夹数、文件数和总大小，不扫描磁盘。

此功能需要安装并运行 Everything，并在 Everything 中开启 索引属性（Index attributes）。Everything 不可用、未开启索引属性或目录未被索引时，统计列仍显示 尚未统计（Not calculated）。悬停索引统计数字时，提示显示 来自 Everything 索引（From the Everything index）。

索引统计遵循 tessoa 的隐藏规则，但硬链接、当前账户无法访问的文件夹、Everything 的排除项，以及挂载到文件夹的卷，可能使结果与直接扫描不同。单击统计数字或 尚未统计，也可按 Ctrl+K，由 tessoa 直接扫描并重新统计，不受自动统计开关限制。关闭自动统计不会清除已有结果。

macOS 和 Linux 只有总开关，不区分介质。开启后自动统计所有位置，关闭后停止自动统计。

预览（Preview）

文本预览

设置项	作用
文本预览自动换行（Wrap Long Lines in Text Preview）	决定文本预览是否自动换行，见 文本预览。

文本编辑

设置项	作用
编辑标签页自动换行（Wrap Long Lines in Editor Tabs）	决定编辑标签页中的长行是否自动换行，不改变文件中的换行。

预览标签页

设置项	作用
跟随焦点时只显示最近选中的文件（Show Only the Last Selected File When Following Focus）	跟随焦点时只更新最近选中的文件；切换标签组或选择文件夹时保留预览。

终端标签页

设置项	作用
终端配色（Terminal Color Scheme）	选择 跟随主题 或四套终端配色之一，见 终端标签页。
自动提高文字对比度（Increase Text Contrast Automatically）	自动调整与背景过于接近的文字颜色。
将 Option 键用作 Meta 键（Use Option as Meta Key）	仅 macOS，默认关闭。开启后 Option 加字母发送 Esc 加该字母，见 终端标签页。

缓存与内存

设置项	作用
预览缓存（Preview cache）	选择省内存、均衡、性能或自定义缓存预算。
预览显存上限（Preview VRAM Budget）	自定义预算时设置预览显存上限。
文本缓存上限（Text Cache Budget）	自定义预算时设置文本缓存上限。
缓存接近上限时提示（Notify when a cache is nearly full）	用量达到预算 90% 时提示一次；降到 75% 以下后可再次触发。

调低预算后，tessoa 会释放可淘汰的缓存，保留正在显示的内容。缓存提示中的 打开设置 可定位到 预览缓存，提示也会保存到活动记录。内存读数可在 系统 → 图形与性能 → 显示内存占用 中开启。

空格键预览

设置项	作用
空格键用 QuickLook 预览（Space opens Quick Look）	仅 Windows：按 Space 使用 QuickLook 预览。见 快速查看。
QuickLook 运行状态（QuickLook status）	只读行，右端写着 tessoa 此刻检测到的状态；单击这一行重新检测一次
空格键用 Seer 预览（Space opens Seer）	仅 Windows：按 Space 使用 Seer 预览。与 QuickLook 开关互斥。
Seer 运行状态（Seer status）	与 QuickLook 运行状态 一样，报的是 Seer

操作（Operations）

拖放

设置项	作用
直接拖放（Drag）	窗口内拖放的默认操作：复制、移动 或 二次确认。
按住 Ctrl 拖放（Ctrl + drag）	按住 Ctrl 拖放时使用的操作。
遇到同名项时（Name conflicts）	设置粘贴、移动和解压时的同名冲突处理方式，见下文。
拖放落点名称显示（Show Drop Target Name）	设置拖放提示中目标目录名称的显示方式。
保留两者时的编号（Keep-both numbering）	选择 文件 (2)、文件-1、文件_01 或自定义编号；自定义时另设 编号格式。

同名冲突的默认处置

粘贴、移动或解压时，如果目标位置已有同名文件或文件夹，按以下设置处理：

取值	效果
每次询问	默认。停下来弹一张卡片让你选，见 文件操作
总是替换	直接覆盖，不问
总是跳过	保留现有的，这一项不处理
总是保留两者	来源那一份自动加编号放进去

0.16 及更早版本默认使用 总是保留两者。

每批操作开始时读取一次此设置。传输过程中修改设置，不会影响已开始的任务。

删除

设置项	作用
删除前先确认（Confirm Before Deleting）	普通删除前是否询问；永久删除始终询问，见 文件操作。

活动面板

设置项	作用
提示条时长（Toast duration）	屏幕上那条提示留多久：短、标准、长、很长
活动记录保留条数（Activity History）	活动记录 留多少条：关闭、50 条、200 条（默认）、1000 条
活动面板失去焦点时自动收起（Activity Panel: Auto-Collapse When Unfocused）	单击面板外或窗口失去焦点时收起活动面板，默认开启。

关闭 活动面板失去焦点时自动收起，可在操作文件列表时保持活动面板打开。

警告

将 活动记录保留条数 设为 关闭，会清除已有记录并停止记录。若只需清除一次，使用活动面板底部的 清空历史。

键盘鼠标（Keyboard & Mouse）

键盘

设置项	作用
快捷键（Keyboard Shortcuts）	整页设置，逐条改键；鼠标按钮和滚轮手势也在这一页，见 快捷键
打字即过滤（Type to Filter）	默认开。在文件区直接敲字母或数字就开始过滤，不必先按 Ctrl+F，见 文件操作
Vim 模式（j/k 键盘导航）（Vim Mode (j/k navigation)）	打开之后可以全键盘操作，见 Vim 模式
Vim 键位（Vim Keys）	整页设置：逐条改 Vim 模式的键位，分 文件区 / 侧栏 / 命令面板 三张表，见 修改 Vim 键位。Vim 模式关着时也能改

鼠标

设置项	作用
单击打开文件夹（Single-Click to Open Folders）	打开之后，单击文件夹一次就进去，不用双击
行内空白处右键显示空白处菜单（Right-Click Blank Areas Inside Rows for Folder Menu）	默认开，仅详细列表。在行上没压着字的地方右键单击，弹的是 新建 / 粘贴 / 排序方式 那张菜单，见下
双击空白处返回上一级（Double-Click Empty Space to Go Up）	打开之后，在文件区的空白处双击一下就回到上一层。分栏视图不受影响
双击名称以外的位置返回上一级（Double-Click Non-Name Columns to Go Up）	详细列表中双击名称以外的位置返回上一级；双击名称仍打开文件。

行内空白处右键显示空白处菜单 只影响详细列表中未选中行的空白部分。已选中或勾选的行始终打开文件菜单。单击打开文件夹 不改变文件的双击行为，也不改变分栏视图的导航方式。

搜索

设置项	作用
记住搜索记录（Remember Search History）	保留底栏与侧栏搜索最近 10 条记录；关闭会清除已有记录。
输入大写字母时区分大小写（Match Case When Typing Uppercase）	含大写字母的查询区分大小写；拼音首字母匹配始终不区分。
清除搜索记录（Clear Search History）	清空已有搜索记录。

右键菜单（Context Menu）

菜单内容

设置项	作用
右键菜单顺序（Context Menu Order）	整页设置：拖动调整右键菜单里各项的先后、逐项决定出不出现，并配置菜单加速键，见 按你的习惯排列界面
自定义命令（Custom Commands）	整页设置：往右键菜单里加你自己的条目，见 自定义右键命令
文件类型（File Types）	按扩展名设置类型群组、命令和信息提示，见下。
打开方式（Open With）	整页设置：右键 打开方式 子菜单里固定哪些程序，见 打开方式
第三方右键菜单项（Shell Extensions）	整页设置，只在 Windows 上出现：逐个决定别的软件装的右键项加载不加载，见 第三方右键菜单项

右键菜单顺序 还提供菜单加速键、大小写和菜单内拖动设置，见 排列界面。

文件类型

文件类型（File Types） 按扩展名组织类型与群组，用于为同类文件配置命令、事件和信息提示。

1. 打开 设置（Settings），搜索并单击 文件类型。
2. 选择一个群组，例如 图片（Images）。
3. 在群组编辑页中选择需要调整的页签。

设置项	作用
文件类型（File types）	添加或移除扩展名。一个扩展名只能属于一个群组；将它加入新群组时，会从原群组移出
命令（Commands）	配置双击或拖放事件，以及右键菜单和拖放菜单中的命令
信息提示（Info tip）	用文件名、大小、日期、标签等占位符定义悬停提示的内容

图片 群组通过扩展名确定成员。切换到 命令 或 信息提示，可以为这一组文件设置共同的操作或提示。

Windows 上还会列出 系统文件类型（System file types）。这些类型的名称和扩展名由系统提供，不能在此修改。命令的程序、参数与适用条件见 自定义右键命令。

系统（System）

系统权限

设置项	作用
桌面文件夹（Desktop folder）	仅 macOS：检查桌面访问权限。
文稿文件夹（Documents folder）	仅 macOS：检查文稿访问权限。
下载文件夹（Downloads folder）	仅 macOS：检查下载访问权限。
完全磁盘访问权限（Full Disk Access）	仅 macOS：查看废纸篓等受保护位置需要完全磁盘访问权限。

搜索加速

设置项	作用
用 Everything 加速搜索（Speed up search with Everything） / 用 Spotlight 加速搜索（Speed up search with Spotlight）	Windows 显示前者，macOS 显示后者；默认开，只加速侧栏搜索。Linux 不显示，见 搜索与过滤
搜索整个电脑（Search the whole PC）	默认关，只在索引加速开启时出现。开启后，索引器可以返回已打开目录之外的结果；索引不可用时不会改为全盘扫描
Everything 运行状态（Everything status） / Spotlight 运行状态（Spotlight status）	显示当前平台索引器的检测结果；单击重新检测。关闭加速后仍显示

图形与性能

设置项	作用
显卡	用哪块显卡渲染。列表里标着 集显、独显 或 虚拟；换了之后窗口会重开一次
图形接口（Graphics API）	仅 Windows。可选 自动（Auto）、DirectX 12、Direct3D 11 和 OpenGL；更改后重启生效。
帧率上限	跟随显示器（后面括号里是实测刷新率）、30 FPS、60 FPS、120 FPS 或 自定义
自定义帧率	只在上一项选了 自定义 时出现，可调范围 10–360 FPS
窗口尺寸	把窗口客户区设成一个准确的像素尺寸：1280×720、1600×900、1920×1080、2560×1440。用于录屏和出图
显示渲染帧率	左下角显示一个半透明的帧率浮层，用来排查卡顿
显示内存占用	在窗口左下角显示 预览显存 和 文本缓存；Windows 与 Linux 还显示 进程 占用。

自动 优先使用 DirectX 12，显卡不支持时改用 OpenGL，不会自动选择 Direct3D 11。Direct3D 11 可降低空载内存占用，目前仍在验证中；如遇画面异常，可改回 自动 或 DirectX 12，再重启 tessoa。

备注

帧率上限用于降低持续渲染时的功耗。垂直同步已开启，实际帧率不会超过屏幕刷新率，因此在 60 Hz 屏幕上选择 120 FPS 不会提高帧率。画面静止时停止渲染，帧率读数显示 空闲。

插件

设置项	作用
启用插件（Enable plugins）	加载已安装的预览插件。关闭后插件不生效。见 预览插件。
无法预览时提示安装插件（Suggest installable plugins）	遇到装了插件才能预览的格式时，要不要在预览栏里提一句
管理插件（Plugins）	查看可用及已安装插件，并安装、更新或卸载插件。见 预览插件。

维护与安装

设置项	作用
安装 / 集成到系统	仅 Windows。整页设置：安装位置、桌面快捷方式、右键菜单等，见 安装与下载
关闭时保持后台运行	仅 Windows：关闭最后一个窗口后保留托盘进程，默认关闭。
清理失效的标签记录	清掉指向已不存在文件的标签记录，见 彩色标签
从访达导入标签	仅 macOS。把访达里的标签读进 tessoa，只读一遍，不往访达写回
从 TagSpaces 导入标签…（Import Tags from TagSpaces…）	位于 设置 → 系统（System） → 维护与安装（Maintenance & Setup），三平台均可使用。选择目录并核对摘要后导入，见 从 TagSpaces 导入标签
导出语言模板	导出一份当前版本的全部文案，给自己加语言或改文案用

关闭时保持后台运行 仅限 Windows。开启后，关闭最后一个窗口会将程序留在系统托盘中，再次打开时恢复窗口。托盘菜单的 显示 打开窗口，退出 结束程序。进入后台前，tessoa 会保存设置和会话。

备份

设置项	作用
导出设置…（Export Settings…）	将偏好导出为单个文件，不包含打开的标签页、授权和插件。
导入设置…（Import Settings…）	先备份现有设置，再导入并重启；重启前保存编辑内容。

关于（About）

版本与更新

设置项	作用
版本	只读，显示当前版本号
自动检查更新（每天一次）	是否每天在后台检查一次新版本
自动安装更新（下次启动生效）	上一项的下位开关，默认开启：在后台下载并安装，等待单击 重启 后生效
检查更新	立刻检查一次

在 设置（Settings） → 关于（About） 中检查更新并按提示安装。已运行 v0.27.1 或更高版本时，无论后台自动安装还是手动开始更新，安装完成后都会等待你单击 重启（Restart）。重启前会检查编辑标签页未保存的改动，你可以保存、不保存或取消重启。下载时入口显示进度，随后显示 安装中…（Installing…），完成后显示 重启；安装失败后恢复为 更新（Update），可再次重试。

自动安装更新（下次启动生效） 默认开启。开启时在后台下载并安装，等待重启后生效；关闭后，仅在你手动开始更新时下载。不能在应用内更新的运行方式会打开下载页，见 安装与下载。

从 v0.27.0 升级到 v0.27.1 前，请先保存编辑标签页中的改动。本次升级仍由旧更新程序执行，安装完成后可能直接重启。等待手动重启及未保存改动检查，从运行 v0.27.1 后发起的更新开始生效。

隐私与授权

设置项	作用
发送匿名使用统计	是否每天发一条匿名的运行统计，见下
授权	整页：查看授权状态、激活授权码、解绑设备
第三方开源许可	用浏览器打开完整的第三方许可清单
用户协议与隐私政策	整页，可滚动阅读全文

开启 发送匿名使用统计 后，每天最多发送一条报告，包含随机安装编号、版本、内测状态、操作系统及版本、CPU 架构、界面语言和上次报告的版本。报告不包含路径、文件名、用户名、授权码或打开记录。接受 用户协议与隐私政策 前不会发送；关闭此项或设置 DO_NOT_TRACK 环境变量后也不会发送。

从 v0.27.0 起，正式版不再采用内测构建的统一到期限制。免费版无需激活码。购买付费方案后，可在 设置 → 关于 → 授权 中输入随购买提供的激活码。该页面显示方案名称、授权人和授权状态，并可释放设备。付费方案的功能相同，设备数及更新权益不同；当前方案和更新期结束后的规则请见官网价格说明。旧内测版本请查阅其对应版本说明。

帮助

设置项	作用
帮助文档	用默认浏览器打开本站
反馈问卷（Feedback Survey）	在默认浏览器中打开反馈问卷。

配置文件与会话保存

偏好设置、彩色标签和布局在修改后自动保存。打开的目录、标签页和分屏属于会话，在正常退出时保存。

程序崩溃或被强制结束时，当前会话可能尚未保存。下次启动会恢复上次正常退出时的会话。彩色标签和布局在修改后自动保存，通常不受影响。

参见

快捷键 · 活动记录 · Vim 模式 · 安装与下载 · 视图模式