设置参考

SpaceKnife 的设置都在一个「设置」标签页里。改动立即保存，没有「应用」按钮。这一页先讲设置页本身的用法，再按页列出每一项设置。

打开设置

按 Ctrl+,（macOS 上 ⌘+,），点标题栏的「设置」按钮，或在命令面板里运行「设置」。
设置标签页只有一个，已经打开时再按 Ctrl+, 会切回它。打开时显示上次看的那一页。
右下角的「完成」关闭设置，回到打开设置之前的标签。

左侧按三组列出各页：常规、外观、可视化；扫描与性能、文件类别、标签；快捷键、高级。Backspace 或 Alt+← 回到上一个看过的页，Alt+→ 前进。

搜索设置

按 / 或 Ctrl+F 进入工具栏上的「搜索设置」。输入的文字在这些地方查找（不区分大小写，按包含匹配）：

设置的名称和说明；
所在的分组名和页名；
每个选项的名字和取值，例如搜 1024 找到「大小单位」；
每项设置的同义词，多是英文，例如 mft、tooltip、uac、inotify。英文界面里，设置的中文名也能搜到。

结果按「页 › 分组」列出，命中的文字高亮；左侧每页旁边显示命中数，没有命中的页变淡。在结果里可以直接修改。按 Esc 清空搜索，再按一次离开搜索框。

什么时候生效

大多数设置改了就生效。有两类例外，在设置下方用小字提示：

提示	含义
将在下一次扫描生效	扫描方式、扫描范围、硬链接计算这类设置，只在扫描进行中显示这条提示：正在进行的扫描不受影响
只影响之后新开的视图	「新视图…」「默认配色」这类设置：已经打开的视图保持原样

显示为灰色、带一个说明徽章的设置，在当前平台或当前版本不能修改，徽章写着原因。
依赖另一项的设置，在那一项满足条件前是灰色的，例如「手动并发数」只在「最大并发」选「手动」时能改。
与后端的连接断开时，页面顶部显示「与后端的连接已断开，设置暂不可修改」。
底部左侧显示保存状态：「更改已自动保存」「正在保存…」或「保存失败：…」。
数字框只接受范围内的整数，输错时提示「请输入 … 的整数」并恢复原值；滑块松开时保存；文字框按 Enter 或离开时保存，首尾空白去掉。

恢复默认

当前页：底部的「恢复默认」把这一页所有能修改的设置恢复为默认值。鼠标停在按钮上会显示有几项会被恢复；这一页已经全是默认值时按钮不可用，搜索时也不可用。恢复后底部出现「已恢复「…」的默认值 · 撤销」，5 秒内点「撤销」可以还原。
全部：「高级 › 导入与导出 › 全部恢复默认…」把所有设置和文件类别恢复为初始值，要再确认一次，不能撤销。

导入与导出

都在「高级 › 导入与导出」里。

导出设置… 把所有改过的设置和自定义的文件类别存成一个 JSON 文件，默认文件名带当天日期，例如 SpaceKnife-设置-20261020.json。只存与默认值不同的项。

导入设置… 读取这样一个文件，先列出会发生的变化，确认后才生效：

「将改变 N 项设置」：每一项的旧值 → 新值；
「文件类别将变为」：导入后的文件类别；
「不导入」：跳过的项和原因，例如来自其他版本的未知设置、不合法的值、当前版本不可修改的设置。

点「导入」生效，点「取消」什么都不改。注意导出文件只记录改过的项，所以导入时，文件里没有写的设置会恢复为默认值，预览里也会列出这些变化。更新版本 SpaceKnife 导出的文件（格式版本更高）不能导入。

从 SpaceSniffer 导入 读取 SpaceSnifferConfig.xml，把几何、动画、行为、外观和文件类别换算成对应的设置，同样先预览再确认。没有对应设置的部分（例如配色）列在「不导入」里，并写明原因。

直接编辑设置文件

设置保存在配置目录的 settings.json 里。左侧底部的「打开设置文件」用系统默认程序打开它，「高级 › 文件与诊断」显示它的完整路径。各个目录在哪里见数据位置。

文件里只有与默认值不同的项，键就是下面参考表里的「设置键」：

{
  "version": 1,
  "values": {
    "general.language": "en",
    "scan.load_manual": "quiet",
    "scan.unit_base": "1000",
    "treemap.initial_detail": 7,
    "tags.name_red": "待删除"
  }
}

类型要完全对上：开关写 true / false；滑块和数字框写范围内的整数（7，不是 7.0 或 "7"）；选项写参考表里列出的字符串，"1024" 和 "60" 也是字符串；文字最多 64 个字符。
SpaceKnife 运行时也会读取对文件的修改，大约一秒内生效，打开着的设置页随之更新。
文件写错（不是合法的 JSON，或某个值不合法）时，设置页顶部显示「设置文件不合法，继续使用上一次的有效设置：…」，SpaceKnife 继续用上一次的有效设置，直到文件改对。
不认识的键被忽略。在设置页里再改任何一项时，文件会按当前设置重写，只留下与默认值不同的项。

「界面语言」也决定命令行输出的语言，见命令行。

各页的其他内容

有些页除了下面参考表里的设置，还有别的东西：

文件类别：文件类别的编辑器，见标签与文件类别。
标签：「已保存的标签 › 清除所有已保存的标签」显示有多少个扫描位置保存了标签，确认后全部清除。
快捷键：「键位表」列出全部命令和它们的按键（没有按键的显示「未绑定」），键位表上方的「搜索命令或按键」可以按命令名或按键过滤，例如输入 ctrl+ 列出所有带 Ctrl 的键。键位暂时不能修改，按键的完整说明见快捷键。
高级 › 扫描助手与缓存：「扫描助手」显示它是否在运行、是否有管理员权限（MFT 快速扫描与 USN 日志由它读取），可以「停止扫描助手」；「快照」显示快照的个数、总大小和所在文件夹，可以打开它；「缓存」显示缓存的大小和位置，「清除缓存…」清除时保留正在使用的缓存。
高级 › 文件与诊断：设置文件和日志文件夹的路径与「打开」按钮；「复制诊断信息」把版本、平台和后端信息复制到剪贴板，反馈问题时附上。

全部设置

下面按设置页的顺序列出每一项设置。「默认值」和「可选值」用界面上的文字；可选值后面的代码是写在 settings.json 里的值。「仅 Windows 可用」这类说明表示在其他平台上这项显示为灰色。

两处「跟随系统」的具体含义：

界面语言：系统语言是任何一种中文时用简体中文，否则用英文。
大小单位：Windows 按 1024；macOS 按 1000；Linux 在 GNOME 桌面上按 1000，其他桌面按 1024。

常规

语言、悬停提示、窗口提醒与日志。

语言

设置	默认值	可选值	说明	设置键
界面语言	跟随系统	跟随系统 `"system"` · 简体中文 `"zh-CN"` · English `"en"`	切换后全部文字、日期与数字格式立即更换。	`general.language`

悬停提示

设置	默认值	可选值	说明	设置键
切换元素时保持打开	开	开 `true` · 关 `false`	鼠标从一个块移到另一个块时，提示卡直接换成新内容。	`general.hover_keep_open`
显示日期与时间	开	开 `true` · 关 `false`	提示卡显示创建、修改、访问时间。	`general.hover_dates`
显示文件年龄	开	开 `true` · 关 `false`	用「2 个月前」这样的相对时间显示。	`general.hover_age`

窗口

设置	默认值	可选值	说明	设置键
扫描结束时若窗口在后台则闪烁提醒	开	开 `true` · 关 `false`	Windows 任务栏闪烁、macOS 程序坞图标弹跳、Linux 窗口紧急提示。	`general.flash_on_done`

日志

设置	默认值	可选值	说明	设置键
有新事件时自动打开日志面板	开	开 `true` · 关 `false`	收到警告或错误时自动展开日志面板；与日志面板里的开关是同一个设置。	`general.log_auto_open`
记录扫描警告	开	开 `true` · 关 `false`	例如「无法访问 …：拒绝访问」。	`general.log_scan_warnings`

外观

主题、强调色、动画与可视化外观；更改立即生效。

主题

设置	默认值	可选值	说明	设置键
主题	跟随系统	跟随系统 `"system"` · 浅色 `"light"`（暂不可用） · 深色 `"dark"`	深色为石墨色调，对比度较高。	`appearance.theme`
强调色	`"#8B9CFF"`	`"#8B9CFF"` · `"#D4FF3A"` · `"#5EC8B8"` · `"#F2A65A"`	主要按钮、当前导航项、开关、滑块和焦点环。	`appearance.accent`

动画

设置	默认值	可选值	说明	设置键
减少动画	跟随系统	跟随系统 `"system"` · 开 `"on"` · 关 `"off"`	开启后缩放改为瞬时切换，扫描中的条纹不滚动。	`appearance.reduce_motion`

树图视觉

设置	默认值	可选值	说明	设置键
层级对比	10	0 至 50	相邻层级底色的差别（平 ↔ 深）。	`appearance.level_contrast`
边框对比	10	0 至 50	块边框的强弱（柔和 ↔ 锐利）。	`appearance.border_contrast`
高亮光晕层数	3	0 至 10	悬停或选中时点亮几层祖先标题栏（克制 ↔ 绚烂）。	`appearance.halo_levels`
悬停高亮	开	开 `true` · 关 `false`	鼠标下的元素加白色内描边。	`appearance.hover_highlight`
鼠标拖尾	关	开 `true` · 关 `false`	鼠标划过的元素渐隐。	`appearance.mouse_trail`
回收站特效	动态	动态 `"animated"` · 静态 `"static"` · 关 `"off"`	回收站 / 废纸篓里的东西蒙上一层暗纹、围上虚线，回收站本身标出清空后能释放多少；「动态」时虚线流动、偶尔扫过一道光（「减少动画」时不动）。	`appearance.trash_effect`
选中投影	开	开 `true` · 关 `false`	选中元素带投影，更容易追踪。	`appearance.selection_shadow`

配色样式

设置	默认值	可选值	说明	设置键
树图默认配色	文件类别	文件类别 `"class"` · 扁平 `"flat"` · 修改时间 `"time"` · 顶层分支 `"branch"`	与工具栏的「类别｜扁平｜时间｜分支」对应。只影响之后新开的视图。	`appearance.default_color_mode`

可视化

设置	默认值	可选值	说明	设置键
新视图默认可视化	树图	树图 `"treemap"` · 火焰图 `"flame"` · 火焰-极坐标图 `"flame_polar"`	与工具栏的「树图｜火焰图｜火焰-极坐标图」对应。只影响之后新开的视图。	`appearance.default_visual`
火焰图和火焰-极坐标图默认配色	顶层分支	文件类别 `"class"` · 扁平 `"flat"` · 修改时间 `"time"` · 顶层分支 `"branch"`	新视图切到火焰图或火焰-极坐标图时使用。只影响之后新开的视图。	`appearance.partition_color_mode`

可视化

几何、火焰图方向与动画；修改后已打开的视图立即重排，「新视图…」类只影响之后新开的视图。

几何

设置	默认值	可选值	说明	设置键
元素字号	100 %	80 至 140 %，步长 5	标题栏、条和环的高度以及标签显示阈值随字号等比缩放。	`treemap.font_scale`
最小元素尺寸	10 px	3 至 20 px	小于这个尺寸的元素并入「N 个小项」聚合块。	`treemap.min_element`
元素比例	0	-60 至 60，步长 5	只影响树图：偏高 ↔ 偏宽；0 表示尽量接近正方形。	`treemap.aspect`
初始细节层级	5	1 至 15	新视图的细节层级，与工具栏「层级」一致。只影响之后新开的视图。	`treemap.initial_detail`
新视图显示可用空间	开	开 `true` · 关 `false`	整卷视图里显示可用空间块。只影响之后新开的视图。	`treemap.show_free`
新视图显示未知空间	开	开 `true` · 关 `false`	整卷视图里显示未知空间块。只影响之后新开的视图。	`treemap.show_unknown`
新视图显示回收站	开	开 `true` · 关 `false`	扫描里有回收站 / 废纸篓时显示它；关掉后回收站不占画面，其余的块放大填满。只影响之后新开的视图。	`treemap.show_trash`
按大小排序	开	开 `true` · 关 `false`	同一文件夹内大块排在左上。	`treemap.sort_by_size`

火焰图

设置	默认值	可选值	说明	设置键
火焰图方向	根在下	根在上 `"top"` · 根在下 `"bottom"`	根所在的一侧。	`treemap.flame_origin`

动画

设置	默认值	可选值	说明	设置键
缩放动画时长	250 ms	0 至 600 ms，步长 25	双击放大或返回时的过渡时长；0 表示无动画。	`treemap.zoom_ms`
动画帧率	跟随显示器	跟随显示器 `"display"` · 60 fps `"60"` · 30 fps `"30"`	动画重绘的频率。	`treemap.fps`
缩放时实时重排（DynaZoom）	关	开 `true` · 关 `false`	缩放过程中元素实时重新排列。暂不可用（界面上显示为灰色）。	`treemap.dynazoom`
按交互调节帧率（DynaSmooth）	开	开 `true` · 关 `false`	只在操作时使用高帧率，更省电。	`treemap.dynasmooth`

变化提示

设置	默认值	可选值	说明	设置键
元素变化闪烁	开	开 `true` · 关 `false`	扫描中或文件变化时元素闪烁提示。	`treemap.flash_changes`

扫描与性能

扫描方式、扫描范围与硬链接计算从下一次扫描起生效，其余更改立即生效。

扫描方式

设置	默认值	可选值	说明	设置键
默认扫描方式	自动	自动 `"auto"` · 快速 MFT `"mft"`（仅 Windows） · 硬扫描 `"hard"`	自动与快速 MFT：整个 NTFS 卷用 MFT 快速扫描（需要时请求一次管理员授权，拒绝则改用硬扫描），其他位置硬扫描。从下一次扫描起生效。	`scan.method`
需要时请求管理员权限	开	开 `true` · 关 `false`	仅启动只读扫描助手，主程序不提权；关闭后没有管理员权限时直接改用硬扫描。仅 Windows 可用。	`scan.elevate`

磁盘负载上限与并发

限制扫描造成的磁盘读取占用。

设置	默认值	可选值	说明	设置键
手动扫描默认	均衡 70%	极速 `"max"` · 均衡 70% `"balanced"` · 安静 35% `"quiet"` · 空闲 `"idle"` · 自定义 `"custom"`	从启动页开始的扫描与重新扫描。从下一次扫描起生效。	`scan.load_manual`
增量重扫默认	安静 35%	极速 `"max"` · 均衡 70% `"balanced"` · 安静 35% `"quiet"` · 空闲 `"idle"` · 自定义 `"custom"`	实时监控发现变化后的定点重扫。暂不可用（界面上显示为灰色）。	`scan.load_incremental`
自定义上限	70 %	5 至 100 %，步长 5	选择「自定义」档位时使用。从下一次扫描起生效。	`scan.custom_limit`
空闲时使用系统低 I/O 优先级	开	开 `true` · 关 `false`	「空闲」档位使用系统低 I/O 优先级，不与前台程序抢磁盘。从下一次扫描起生效。	`scan.idle_low_io`
整盘繁忙时让路	开	开 `true` · 关 `false`	其他程序让整块磁盘超过上限时，扫描降到最低进度。从下一次扫描起生效。	`scan.yield_when_busy`
最大并发	自动	自动 `"auto"` · 手动 `"manual"`	自动：按处理器核数选择；手动：按下面的数值。从下一次扫描起生效。	`scan.concurrency`
手动并发数	4	1 至 64	手动时同时扫描的工作进程数。从下一次扫描起生效。「最大并发」选「手动」时才能修改。	`scan.workers`

扫描范围

设置	默认值	可选值	说明	设置键
扫描 NTFS 备用数据流	关	开 `true` · 关 `false`	MFT 快速扫描时把附加在文件上的隐藏数据流计入大小（硬扫描不读取数据流）。从下一次扫描起生效。仅 Windows 可用。	`scan.ads`
跨越挂载点	关	开 `true` · 关 `false`	进入挂载在文件夹下的其他卷；关闭时只统计当前卷。从下一次扫描起生效。	`scan.cross_mounts`
受保护的位置	扫描前询问	扫描前询问 `"ask"` · 跳过，不弹窗 `"skip"` · 照常访问 `"allow"`	没有「完全磁盘访问权限」时，macOS 会为桌面、文稿、下载、云盘、照片图库和其他应用的数据逐个弹窗询问。从下一次扫描起生效。仅 macOS 可用。	`scan.protected_places`

统计口径

设置	默认值	可选值	说明	设置键
硬链接计算	只计一次	只计一次 `"once"` · 每个链接都计 `"each"`	只计一次时，合计与磁盘实际占用一致。从下一次扫描起生效。	`scan.hardlinks`
大小单位	跟随系统	跟随系统 `"system"` · `"1024"` · `"1000"`	按 1000 计时，778.6 GB 显示为 836.0 GB。	`scan.unit_base`

实时监控

设置	默认值	可选值	说明	设置键
实时监控	开	开 `true` · 关 `false`	Windows：使用 USN 日志 + ReadDirectoryChangesEx，变化的文件会闪烁提示。macOS：使用 FSEvents，变化的文件会闪烁提示。Linux：使用 inotify，变化的文件会闪烁提示。	`scan.monitor`
事件合并间隔	150 ms	50 至 5000 ms，步长 10	此时间内的连续变化合并为一次刷新。「实时监控」打开时才能修改。	`scan.coalesce_ms`

文件类别

按扩展名归类，用于树图着色、:class: 过滤和类别统计。

这一页没有开关类设置，是文件类别的编辑器，见标签与文件类别。

设置	默认值	可选值	说明	设置键
红色标签 ▲	空	文字，最多 64 个字符	显示名出现在详情面板和悬停卡里；过滤语法仍写 :red。	`tags.name_red`
黄色标签 ■	空	文字，最多 64 个字符	过滤语法仍写 :yellow。	`tags.name_yellow`
绿色标签 ●	空	文字，最多 64 个字符	过滤语法仍写 :green。	`tags.name_green`
蓝色标签 ◆	空	文字，最多 64 个字符	过滤语法仍写 :blue。	`tags.name_blue`

快捷键

设置	默认值	可选值	说明	设置键
树图有焦点时可省略 Ctrl	开	开 `true` · 关 `false`	直接按 1–4 打标签、按 0 清除。	`tags.omit_ctrl`

保存

设置	默认值	可选值	说明	设置键
记住标签	开	开 `true` · 关 `false`	按扫描根路径保存标签，重新扫描或打开快照后恢复。	`tags.remember`

快捷键

全部命令与当前快捷键，与命令面板同一份命令清单。

键位预设

设置	默认值	可选值	说明	设置键
键位预设	现代	现代 `"modern"` · SpaceSniffer 经典 `"classic"`	改了任意一个键后显示为「自定义」。暂不可用（界面上显示为灰色）。	`keys.preset`

高级

设置文件、日志、缓存与快照。

日志

设置	默认值	可选值	说明	设置键
日志文件级别	信息	信息 `"INFO"` · 调试 `"DEBUG"`	写入日志文件的最低级别。	`advanced.log_level`

缓存与快照

设置	默认值	可选值	说明	设置键
扫描后自动保存快照	开	开 `true` · 关 `false`	供启动页的最近记录和快照对比使用。从下一次扫描起生效。	`advanced.auto_snapshot`
保留最近快照数	10	1 至 100	更早的快照每周只保留一份。	`advanced.snapshot_keep`

内存

设置	默认值	可选值	说明	设置键
扫描数据内存上限	25 %	5 至 90 %，步长 5	扫描数据超过物理内存的这个比例后，新的节点表存进磁盘映射文件：不占私有提交，常用部分仍由系统留在内存里。从下一次扫描起生效。	`advanced.memory_budget`

关于与更新

版本信息、更新与发布时间线。

更新

设置	默认值	可选值	说明	设置键
自动检查更新	开	开 `true` · 关 `false`	每天最多一次，只读取 GitHub 上本项目的发布列表，不发送任何使用数据；小版本只在右上角提示。	`general.update_check`
自动下载更新	开	开 `true` · 关 `false`	发现新版本后在后台下载并校验；只有你在更新卡片里点了「无缝更新」或安装方式才会安装，从不自己安装。「自动检查更新」打开时才能修改。	`general.update_download`
提示哪些版本	包括预览版	包括预览版 `"preview"` · 只要正式版 `"stable"`	预览版是 GitHub 上标为预发布（Pre-release）的版本。	`general.update_channel`