从 TagSpaces 导入标签

从 TagSpaces 导入标签（Import Tags from TagSpaces） 将 TagSpaces 的文件和文件夹标签读入 tessoa。导入前可以核对扫描结果，导入后可以撤销。

此功能从 tessoa 0.26.0 起提供，Windows、macOS 和 Linux 均可使用。开始前，请确认 TagSpaces 管理的文件夹可以从当前电脑访问。如果 TagSpaces 将标签保存在 .ts 隐藏目录中，请一并保留这些目录。

导入范围

tessoa 扫描你选择的根目录及其子目录。导入是单向、手动的操作：它只读取 TagSpaces 的数据，不会修改源文件、文件名或 .ts 目录，也不会将 tessoa 中的标签写回 TagSpaces。

标签来源	导入方式
文件的标签	读取文件所在目录下 `.ts/<文件名>.json` 中的标签
文件夹的标签	读取该文件夹下 `.ts/tsm.json` 中的标签
文件名方括号中的标签	默认不导入；在摘要中开启后，可以逐项取消不需要的标签
TagSpaces 的标签分组和未应用到文件或文件夹的标签	不导入；新标签放在 tessoa 标签列表的顶层

tessoa 不读取 TagSpaces 的位置列表。你需要分别选择要导入的根目录；S3 等云位置不在扫描范围内。扫描不会沿符号链接进入其他目录。

扫描期间，导入按钮不可用。单击 取消（Cancel） 可以关闭对话框，当前标签保持不变。在设置顶部搜索框中输入 TagSpaces，也可以直接找到导入入口。

如果 TagSpaces 的标签记录所对应的文件已经不存在，摘要会显示跳过的数量。这通常发生在文件被其他程序重命名或删除之后；tessoa 不会根据旧记录猜测文件的新位置。

TagSpaces 也可以将标签写进文件名，例如 photo[holiday mountains].jpg。tessoa 读取第一对方括号中的内容，并按空格分成 holiday 和 mountains 两个标签。

在扫描摘要中勾选 也读文件名里的 [标签]（不是标签的请取消）（Also read [tags] from file names (untick anything that is not a tag)）。
核对展开列表中的每个标签名称及其来源文件数量。
取消勾选不需要导入的标签。例如，Movie [1080p].mkv 中的 1080p 可能只是视频规格。
核对随勾选变化更新的新建和合并数量，再单击导入。

列表按标签名称汇总。取消勾选一个名称，会排除所有文件名中的这个标签；不会排除 .ts 中同名的标签。每次打开导入对话框时，文件名标签都默认关闭。

情况	导入结果
tessoa 已有同名标签	合并到该标签，保留它现有的颜色和层级
不同层级有多个同名标签	使用标签树中第一个匹配的标签
tessoa 没有同名标签	新建顶层标签，使用来源中可识别的颜色
导入文件名中的标签	新建时使用无色标签；如果 `.ts` 中也有同名标签，则采用其中的颜色
再次导入相同数据	已有标签和文件标签关联不会重复创建
TagSpaces 删除了某个标签	已导入 tessoa 的标签仍然保留

来源中的颜色无法识别时，新标签使用无色样式，可以在导入后自行换色。导入只增加标签及其与文件的关联，不会移除你已经在 tessoa 中设置的标签。如果没有任何新增内容，tessoa 会提示 这个文件夹里没有新的标签（No new tags found in that folder）。

导入完成后，单击成功提示条中的 撤销（Undo），可以恢复到导入前的标签状态。

警告

撤销导入会恢复整份标签库。导入之后进行的其他标签改动也会被撤回。tessoa 只保留最近一次标签导入前的状态；从 TagSpaces 导入与 macOS 上从访达导入共用这一次撤销，退出 tessoa 后即失效。需要撤销时，请在继续整理标签或开始下一次导入前使用提示条中的按钮。

如果提示条已经消失，或已经退出 tessoa，需要在彩色标签中手动取消文件的标签、删除不需要的标签，或者按照备份与迁移标签恢复导入前的 tags.ini 备份。恢复备份同样会覆盖备份之后的标签改动。

参见