第22章 Metadata 抓取

Metadata 抓取

Stash 支持从多种外部源抓取 Metadata 数据。

Scraper 类型

| 类型 | 说明 | | :--- | :--- | | 片段 (Fragment) | 使用 Item 现有的 Metadata，并将其与 Metadata 源的结果进行匹配。 | | 搜索/按名称 (Search/By Name) | 使用提供的查询字符串在 Metadata 源中搜索，生成一个匹配列表供用户选择。 | | URL | 从指定的 URL 中提取 Metadata。 |

支持的 Scraper

| | 片段 | 搜索 | URL | | :--- | :--- | :--- | :--- | | gallery | ✔️ | | ✔️ | | image | ✔️ | | ✔️ | | group | | ✔️ | | | performer | | ✔️ | ✔️ | | scene | ✔️ | ✔️ | ✔️ |

内置 Scraper

Stash 提供以下内置 Scraper：

| Scraper | 说明 | | :--- | :--- | | Freeones | 针对 freeones.xxx 的 Performer 搜索 Scraper。 | | Auto Tag | Scene 片段 Scraper，通过文件名匹配现有的 Performer、Studio 和 Tags。 |

管理 Scraper

可在“设置 > Metadata Providers”页面安装和管理 Scraper。 Scraper 通过“Available Scrapers”部分进行安装。该部分允许配置用于安装 Scraper 的来源。默认配置了 Community (stable) 来源，其中包含适用于当前 Stash 稳定版的 Scraper。

以下是由 stashapp 组织维护的 Scraper 来源：

| 名称 | 来源 URL | 推荐本地路径 | 备注 | | :--- | :--- | :--- | :--- | | Community (stable) | https://stashapp.github.io/CommunityScrapers/stable/index.yml | stable | 适用于当前 Stash 稳定版。 | | Community (develop) | https://stashapp.github.io/CommunityScrapers/develop/index.yml | develop | 适用于 Stash 开发版。 |

已安装的 Scraper 可以在“Installed Scrapers”部分进行更新或卸载。

来源 URL

来源 URL 必须返回一个包含该来源所有可用包的 yaml 文件。来源 yaml 文件的示例如下： - id: name: version: date: requires: - <此包所需包的 ids (可选)> - ... path: <指向包 zip 文件的路径> sha256: metadata: <用于额外信息的可选键值对> - ...

Path 可以是相对于 zip 文件的路径，也可以是外部 URL。

手动添加 Scraper

默认情况下，Stash 在读取 stash config.yml 的目录下的 scrapers 子目录中查找 Scraper 配置。该目录通常是 $HOME/.stash 或当前工作目录。 通过将 yaml 配置文件（格式：scrapername.yml）放置在 scrapers 目录中来手动添加 Scraper。

⚠️ 注意：某些 Scraper 可能需要除了 yaml 文件以外的其他内容，请查阅单个 Scraper 的文档。

在 Stash 运行期间，添加、删除或编辑 yaml 文件后，可以通过前往“设置 > Metadata Providers > Scrapers”并点击“Reload Scrapers”来重新加载它们。

使用 Scraper

片段 Scraper 在 Item 的编辑选项卡中点击“Scrape With...”按钮，然后选择要使用的 Scraper。

搜索 Scraper 在 Item 的编辑选项卡中点击 🔍 按钮。将出现一个搜索对话框，其中预填了用于搜索的查询字符串，搜索后将展示结果列表供选择。

URL Scraper 在 Item 的编辑选项卡中输入 URL。如果安装了支持该 URL 的 Scraper，则会出现一个用于抓取 Metadata 的按钮。

Tagger 视图 Tagger 视图从 scenes 页面访问。它允许用户对当前页面上的所有 Item 运行 Scraper。如果支持，Tagger 会从选定的 stash-box 实例或 Metadata 源中展示 Item 的潜在匹配结果。用户需要选择正确的 Metadata 信息进行保存。

结合 stash-box 使用时，用户可以可选地提交 Scene 指纹以协助贡献到 stash-box 实例。Scene 指纹由生成的任何哈希值（phash、oshash、md5）和 Scene 时长组成。指纹提交与用户的 stash-box 账户关联。提交指纹有助于他人匹配他们的文件，因为 stash-box 在每个潜在匹配中都会返回匹配的用户提交指纹计数。

| | 是否有 Tagger | 来源选择 | | :--- | :--- | :--- | | gallery | | | | group | | | | performer | ✔️ | | | scene | ✔️ | ✔️ |

识别任务 此任务会遍历您的 Scenes 并尝试使用一组抓取来源识别 Scene。此任务可在“设置 -> 任务 -> “Identify...”（按钮）”中找到。更多信息请参见 任务 > 识别 页面。