第15章 任务管理
Tasks¶
该页面允许你指导 stash 服务器执行多种任务。
Scanning¶
扫描功能会遍历你配置的 stash 目录，查找新文件和移动后的文件。Stash 目前通过快速文件哈希来识别文件。这意味着如果文件在配置的 stash 目录内被重命名或移动，扫描会检测到这些变更并相应更新数据库。Stash 目前会忽略重复文件。如果两个文件内容完全相同，只有第一个被处理。
Ignoring Files with .stashignore¶
你可以创建 .stashignore 文件，将特定文件或目录排除在扫描范围之外。这些文件使用 gitignore 风格的模式匹配语法。
在库内的任意目录放置 .stashignore 文件。该文件中的模式将应用于该目录内所有文件和子目录。你可以在目录层级的不同层级拥有多个 .stashignore 文件——父目录的模式会向下级联到子目录。.stashignore 文件不会在 zip 文件内部读取。
支持的模式：
| Pattern | Description |
|---|---|
| filename.mp4 | 忽略特定文件。 |
| *.tmp | 忽略所有具有特定扩展名的文件。 |
| temp/ | 忽略目录及其所有内容。 |
| /cache/ | 忽略任意层级中名为 "cache" 的目录。 |
| !important.mp4 | 取反——即使匹配之前的模式，也不忽略此文件。 |
| # comment | 以 # 开头的行是注释。 |
| \#filename | 使用反斜杠匹配字面 # 字符。 |
示例 .stashignore 文件：
# Ignore temporary files *.tmp *.log # Ignore specific directories temp/ .thumbnails/ # But keep this specific file !important.tmp
扫描任务接受以下选项：
| Option | Description |
|---|---|
| Generate scene covers | 为视频文件生成场景封面。 |
| Generate previews | 生成视频预览（mp4），在悬停在场景上时播放。 |
| Generate animated image previews | 在高级模式中可用 - 生成动画（webp）预览，仅当场景/标记墙预览类型设置为动画图像时才需要。浏览时比视频预览消耗更少的 CPU，但作为额外生成且文件更大。 |
| Generate scrubber sprites | 在视频播放器下方显示的一组图像，便于导航。 |
| Generate video perceptual hashes | 生成用于场景去重和识别的感知哈希。 |
| Generate thumbnails for images | 为图像文件生成缩略图。 |
| Generate image perceptual hashes | 生成用于图像去重和识别的感知哈希。 |
| Generate previews for image clips | 为图像片段/GIF 生成 GIF/循环视频作为缩略图。 |
| Rescan | 默认情况下，只有当文件的修改日期自上次扫描后更新时，Stash 才会重新扫描现有文件。启用此选项时，Stash 将重新扫描路径中的文件，无论文件修改时间如何。仅当 Stash 需要重新计算视频/图像元数据，或重新扫描画廊 zip 时才需要。 |
Auto Tagging¶
参见 Auto Tagging 页面。
Scene Filename Parser¶
参见 Scene Filename Parser 页面。
Generated Content¶
生成的内容提供以下功能：
- 场景封面 - 用作封面图像的场景截图
- 鼠标悬停在场景卡片上时播放的视频或图像预览
- 视频感知哈希 - 帮助匹配 StashDB，并为重复查找器提供数据
- Sprites（场景各部分的静止画面）在场景 scrubber 中显示
- 在标记页显示的标记视频预览
- 场景的转码版本。详见下文
- 画廊的图像缩略图
- 图像感知哈希 - 可用于识别和去重
生成任务接受以下选项：
| Option | Description |
|---|---|
| Scene covers | 为视频文件生成场景封面。 |
| Previews | 生成视频预览（mp4），在悬停在场景上时播放。 |
| Animated image previews | 在高级模式中可用 - 生成动画预览（webp）。仅当预览类型设置为动画图像时才需要。要求启用 Generate previews。 |
| Scene scrubber sprites | 在视频播放器下方显示的一组图像，便于导航。 |
| Marker previews | 生成 20 秒视频预览（mp4），从标记时间码开始。 |
| Marker animated image previews | 在高级模式中可用 - 生成动画（webp）预览，仅当场景/标记墙预览类型设置为动画图像时才需要。浏览时比视频预览消耗更少的 CPU，但作为额外生成且文件更大。 |
| Marker screenshots | 为标记生成静态 JPG 图像。仅当预览类型设置为静态图像时才需要。要求启用 marker previews。 |
| Transcodes | 在高级模式中可用 - 不支持的视频格式的 MP4 转换。允许直接流媒体播放而非实时转码。 |
| Video Perceptual hashes (for deduplication) | 生成用于场景去重和识别的感知哈希。 |
| Generate heatmaps and speeds for interactive scenes | 为交互式场景生成热图和速度。 |
| Image clip previews | 为图像片段/GIF 生成 GIF/循环视频作为缩略图。 |
| Image thumbnails | 为图像文件生成缩略图。 |
| Image Perceptual hashes (for deduplication) | 生成用于图像去重和识别的感知哈希。 |
| Overwrite existing generated files | 默认情况下，如果已存在生成文件，则不会重新生成。启用此标志后，将重新生成文件。 |
Transcodes¶
Web 浏览器支持有限数量的视频和音频编解码器及容器。如果浏览器支持特定的编解码器和容器，Stash 将直接流媒体播放视频文件。最初，Stash 不支持在浏览器不支持编解码器/容器时查看场景视频，生成转码是查看这些文件的一种方式。Stash 此后已实现实时转码，因此转码现在基本不再必要。此外，转码占用大量磁盘空间，且不能保证无损。
Image gallery thumbnails¶
这些在首次查看画廊时生成，因此提前生成并无必要。
Cleaning¶
此任务将遍历你配置的媒体目录，并从数据库中删除任何无法再找到的场景。它还会删除随后不再存在的场景的生成文件。
使用此任务时应小心，特别是当配置的媒体目录可能由于网络问题而无法访问时。
Exporting and Importing¶
导入和导出任务在配置的元数据目录中读取和写入 JSON 文件。从文件导入会将你的数据库与文件合并。
⚠️ 注意：完整的导入任务在导入前会完全清除当前数据库。
有关导出 JSON 格式的详细信息，参见 JSON Specification 页面。
Backing up¶
备份任务创建 stash 数据库的备份（可选地）blob 文件。备份可以下载或输出到备份目录（在 Settings > Paths 下）或数据库目录（如果未配置备份目录）。
对于完整备份，必须复制数据库文件和所有 blob 文件。备份存储为 zip 文件，数据库文件位于 zip 的根目录，blob 文件位于 blobs 目录中。
⚠️ 注意：生成文件不包含在备份中，因此从空系统恢复时需要重新生成这些文件。
对于仅数据库备份，仅将数据库文件复制到目标位置。这在执行高风险操作前进行快速备份，或对不使用文件系统 blob 存储的用户很有用。
Restoring from backup¶
从备份恢复目前是手动过程。必须解压数据库备份 zip 文件，并将数据库文件和 blob 文件（如适用）分别复制到数据库目录和 blob 目录。然后应重启 Stash 以加载恢复的数据库。
⚠️ 注意：仅数据库备份的文件名与原数据库文件名不同，因此必须在将备份中的数据库文件复制到数据库目录之前，将其重命名为与原数据库文件名匹配。原数据库文件名可以在 Settings > Paths > Database path 中找到。
