跳转到内容
SpaceKnifeSpaceKnife 文档

数据位置与便携模式

扫描只读取磁盘。SpaceKnife 自己保存的东西都在几个用户目录里；便携版则全部在程序旁边的 data 文件夹里。

存在哪里

Section titled “存在哪里”
Windows Linux macOS
数据：快照、标签、日志 %LOCALAPPDATA%\SpaceKnife ~/.local/share/SpaceKnife ~/Library/Application Support/SpaceKnife
配置：设置、文件类别 %LOCALAPPDATA%\SpaceKnife ~/.config/SpaceKnife ~/Library/Application Support/SpaceKnife
缓存 %LOCALAPPDATA%\SpaceKnife\Cache ~/.cache/SpaceKnife ~/Library/Caches/SpaceKnife
界面配置（窗口的本地存储与缓存） %APPDATA%\SpaceKnife\electron ~/.config/SpaceKnife/electron ~/Library/Application Support/SpaceKnife/electron

Linux 上设置了 XDG_DATA_HOME、XDG_CONFIG_HOME、XDG_CACHE_HOME 时，这些目录跟着它们走。

不用自己去找，「设置 › 高级」里都有：

  • 「文件与诊断」：「设置文件」和「日志文件夹」，各带一个「打开」。
  • 「扫描助手与缓存」：「快照」（数量、总大小和文件夹，带「打开」）和「缓存」（大小和文件夹，带「清除缓存…」；正在使用的缓存会保留）。
  • 设置列表底部的「打开设置文件」，以及启动页「最近」的「…」菜单里的「打开快照文件夹」。

里面有什么

Section titled “里面有什么”
文件或文件夹 位于 内容
snapshots/ 数据 每个扫描位置一个文件夹，每份快照一个 .sks 文件
tags/ 数据 保存的标签，每个扫描位置一个文件
logs/spaceknife.log 数据 日志文件
update.json 数据 上一次更新检查、最近的版本和它们的发布说明，以及关掉过更新卡片的版本
updates/ 数据 下载好的新版本（直到它运行起来）；便携版替换时，还有新旧两份程序文件。下次启动时清空（不留残余）
palette_recent.json 数据 命令面板最近的路径跳转和过滤
settings.json 配置 你的设置
classes.json 配置 你的文件类别
columns/ 缓存 超大扫描时移出内存的扫描数据

SpaceKnife 自己的这些文件夹和它的安装目录都是受保护的：不能在 SpaceKnife 里删除或移动它们。

快照

Section titled “快照”

自动保存的快照是 snapshots/<位置>-<编号>/<日期>-<时间>.sks，例如 snapshots/Videos-3f2a9c41d0be/20261020-081530.sks。日期和时间是 UTC。

每个位置保留最近 10 份（「设置 › 高级 › 保留最近快照数」，1–100），更早的每周保留最新的一份；其余的在每次自动保存后删除。

设置

Section titled “设置”

settings.json 里是你的设置。SpaceKnife 运行时也可以直接手改：它每秒检查一次这个文件，改动随即生效。文件不合法时，设置页顶部会提示，并继续使用上一次的有效设置。要把设置搬到另一台电脑，用「设置 › 高级 › 导出设置」和「导入设置」：导入时先列出会改变的项，确认后才生效。见设置。

日志

Section titled “日志”

logs/spaceknife.log 写到 10 MB 后换一个新文件，旧文件保留最近 5 个。「设置 › 高级 › 日志文件级别」可选「信息」或「调试」。日志面板（Ctrl+J）显示本次会话的事件。

报告问题时，「设置 › 高级 › 复制诊断信息」把版本、平台、能力清单以及设置文件和日志文件夹的路径复制到剪贴板。它不会发送任何东西。

缓存

Section titled “缓存”

扫描数据超过「设置 › 高级 › 扫描数据内存上限」（默认是物理内存的 25%）后，新的部分存进缓存里的内存映射文件，不占私有内存。这些文件不再需要时会自己删除，崩溃后残留的会在下次启动时清掉。「清除缓存…」删除没有在用的部分。

SPACEKNIFE_HOME

Section titled “SPACEKNIFE_HOME”

把环境变量 SPACEKNIFE_HOME 设成一个文件夹，SpaceKnife 就把所有东西都存在那里，不再用用户目录：

文件夹 内容
SPACEKNIFE_HOME/data 快照、标签、日志、更新状态
SPACEKNIFE_HOME/config 设置、文件类别
SPACEKNIFE_HOME/cache 缓存
SPACEKNIFE_HOME/electron 界面配置

适合另开一套配置（试设置而不碰自己的那套）、把快照放到另一块盘上，或者做演示和测试。请用绝对路径。

Windows，在 PowerShell 里只对这一次启动生效：

终端窗口
$env:SPACEKNIFE_HOME = "D:\SpaceKnife-data"
& "<安装目录>\SpaceKnife.exe"

Windows，对之后启动的所有程序生效（要撤销，在 Windows 的环境变量设置里删掉它）：

终端窗口
setx SPACEKNIFE_HOME "D:\SpaceKnife-data"

Linux：

终端窗口
SPACEKNIFE_HOME=/home/lenny/spaceknife-data spaceknife

macOS：

终端窗口
SPACEKNIFE_HOME=/Users/lenny/spaceknife-data /Applications/SpaceKnife.app/Contents/MacOS/SpaceKnife

命令行也认这个变量：设了 SPACEKNIFE_HOME 后，spaceknife-backend snapshot list 列出的就是那个文件夹里的快照。

便携模式

Section titled “便携模式”

便携包（SpaceKnife-<版本>-win-x64-portable.zip 和 SpaceKnife-<版本>-linux-x64-portable.tar.gz）在程序旁边带一个空的 data 文件夹，里面只有一份简短说明。SpaceKnife 在 Windows 和 Linux 上每次启动都会找这个文件夹：可执行文件旁边有 data 文件夹，就把它当作 SPACEKNIFE_HOME。快照、设置、日志、缓存和界面配置都存在里面，不写进你的用户目录。

  • 手动设置的 SPACEKNIFE_HOME 优先于 data 文件夹。
  • 删掉或重命名 data，这份程序就改用正常的用户目录；放回去又是便携的。
  • 解压到自己能写入的位置：比如 Program Files 下面就不行。
  • 软件内的更新知道这是便携版：它下载便携包，「无缝更新」替换程序文件、留下 data；「自己替换」把压缩包显示出来，由你解压覆盖（见升级）。
  • macOS 应用和 AppImage 没有便携模式。macOS 上改用 SPACEKNIFE_HOME。
终端窗口
$env:SPACEKNIFE_HOME = "C:\Users\lenny\Apps\SpaceKnife-portable\data"
& "C:\Users\lenny\Apps\SpaceKnife-portable\resources\backend\spaceknife-backend.exe" snapshot list

搬移数据

Section titled “搬移数据”

要把设置带进便携版（或从便携版带出来），在一边导出、另一边导入（「设置 › 高级 › 导出设置」/「导入设置」）。快照就是普通文件：复制需要的 .sks 文件，用「打开快照文件…」打开；或者退出 SpaceKnife，把整个 snapshots 文件夹复制到另一份的数据文件夹里（便携版里是 data/data/snapshots）。

删除全部数据

Section titled “删除全部数据”

Windows 的卸载程序可以代劳：在它的第二页勾上「同时删除快照、设置和日志」（见卸载）。否则，想从头开始，或卸载后清理干净：退出 SpaceKnife，删除第一张表里的文件夹（Windows 上是 %LOCALAPPDATA%\SpaceKnife 和 %APPDATA%\SpaceKnife），或者你用的 SPACEKNIFE_HOME、data 文件夹。「设置 › 高级 › 全部恢复默认」只重置设置和文件类别。