进阶 docs.stashapp.cc 2026-10-20 02:59:21 · 15 阅读

第32章通过 stash-box 刮削场景

通过 stash-box 刮削场景

什么是 stash-box？

stash-box 是 Stash 团队开发的开源色情视频索引与元数据 API 服务器，提供由社区共建的成人演员、片商和场景元数据库。

Stash 有多种从 stash-box 实例刮削数据的方式，从自动到手动各有不同，各有优缺点：

- Tagger（推荐）—— 半自动，准确度高 - Identify —— 全自动，准确度一般 - Scrape with... —— 全手动，准确度高

前置条件

启用感知哈希

1. 进入设置 > 任务。 2. 在 Library 标题下可以找到 Scan 任务和 Generate 任务的配置项。 3. 在 Scan 标题下启用 Generate perceptual hashes。 4. 在 Generate 标题下启用 Perceptual hashes。

Scan 任务及其选项在内容首次入库时生效；Generate 任务及其选项用于为已入库的内容生成额外数据。

配置 stash-box 端点

已知实例公开的 stash-box 实例列表见这里。

1. 进入设置 > 元数据提供方。 2. 在 Stash-box Endpoints 标题下点击 Add，填入要添加的 stash-box 实例信息。 3. 点击 Test Credentials 确认一切正常。

Tagger

适合最看重准确度的人。它可以基于感知哈希自动遍历场景并匹配，但对象的创建和确认由你完成，不点击 Save 就不会保存任何内容。

1. 打开场景页面。 2. 进入工具栏中的 Tagger。 3. 在 Source 选择要使用的 stash-box 实例。

在 Source 旁边点击图标可打开配置：

- 如果想让演员性别信息也刮削到本地，可配置 Performer genders。 - 如果想保留现有封面，可关闭 Set scene cover image。 - 如果想看到场景在该 stash-box 实例上的全部社区标签，可开启 Set tags。 - 如果对场景匹配方式有特殊需求，可修改 Query Mode。

开启 Mark as Organized on save 后，保存时会自动打上 Organized 标志。

Organized 标志除了用于筛选之外，Organized 标志还有技术用途：所有标记为已整理的对象都会被 Identify 和 Auto Tag 等自动任务忽略。

4. 点击 Scrape All，浏览结果，补充缺失的对象后点击 Save。

如果返回 No results found，可以改用查询方式：输入标题、演员、发布日期或片商后点击 Search。注意，有时候信息越少效果越好。

如果你确定该场景存在于这个 stash-box 实例上但没被匹配到，可以在 Query 字段输入精确的 StashID 再点击 Search，即可返回那个场景。

对于已点击 Save 的场景，可以把文件指纹提交回实例以提高匹配准确度：滚动到页面顶部，点击 Submit x fingerprints。

指纹所有指纹都绑定用户 API key，不会向 stash-box 实例发送其他任何信息。隐私是第一位的。

Identify

适合想要全自动、且能接受可能出现误差的人。任务会基于感知哈希自动遍历所有场景进行匹配，还可以自动创建所有缺失的对象，但无法人工确认。

警告此任务不可逆，运行前最好先备份。

1. 进入设置，启用 Advanced Mode。 2. 进入设置 > 任务。 3. 在 Library 标题下点击 Identify...。 4. 在 Sources 选择要匹配的一个或多个 stash-box 实例。

提示 Identify 任务会依次遍历各个来源，找到匹配后就会忽略该场景的其他所有来源。

5. 配置适用于所有来源的默认选项（每个来源旁边的图标可单独覆盖）。

- 如果不想把男演员刮削到本地，可关闭 Show male performers。 - 如果想保留现有封面，可关闭 Set scene cover image。 - 如果想打上 Organized 标志，可开启 Set organized flag。 - 如果不介意可能匹配到更多错误结果，可关闭 Skip matches that have more than one result。开启时还可以自定义标签标记被跳过的场景。 - 如果不介意可能匹配到更多错误结果，可关闭 Skip single name performers with no disambiguation。开启时同样可以自定义标签标记被跳过的场景。

6. 点击 Set as default 保存配置。 7. 配置适用于所有来源的默认字段选项（同样可通过每个来源旁的图标单独覆盖）。 8. 点击 Set as default 保存配置。 9. 点击 Identify 启动任务。