Peach: Local-first video metadata scraper and media manager.
自定义元数据来源
采集页的「自定义元数据来源」用于接入公开 JSON 元数据接口。每个来源保存名称、固定 HTTPS 接口地址、番号格式、字段路径、适用内容类型和连接方式。保存后可编辑、试查、启用、停用或删除。
接口地址必须包含一个 {code}。字段路径用点连接对象键或数组下标,例如 data.title、
items.0.title。番号字段必填;标题、厂牌、系列、发行日期是文本,演员和标签是文本数组。
番号格式可选原样、小写、去掉连字符或转为下划线。试查番号输入后按回车,结果显示在当前表单。
这套配置只适用于单次 GET 返回的 JSON,不解析 HTML、CSS selector、JSON-LD、YAML 规则, 也不执行脚本。需要 Cookie、站点 API key、多次查询或浏览器验证的来源使用已有专用适配器。
接口示例
一本道公开接口的配置:
| 字段 | 值 |
|---|---|
| 接口地址 | https://www.1pondo.tv/dyn/phpauto/movie_details/movie_id/{code}.json |
| 番号格式 | 连字符转下划线 |
| 番号字段 | MovieID |
| 标题字段 | Title |
| 演员字段 | ActressesJa |
| 适用类型 | 无码 |
Peach 已内置一本道适配器,此例用于说明接口配置,不需要重复添加。自定义来源的适用内容类型 由用户选择;对于发行体系同形的番号,需要选择确实覆盖目标作品的接口。
采集与复核
启用的来源追加到适用类型的内建来源链末尾,前面的来源资料足够时按既有规则停止查询。 响应中的番号字段必须与查询番号匹配,查询 URL 不能代替响应提供身份证据。
结果进入现有来源快照、候选及复核流程,置信度为 0.5,归为未登记来源,不参与自动批准。
来源端点、字段映射、番号格式或线路变化时,新的查询规则有独立证据键;启停或改名称保持证据键。
删除配置不删除已保存的来源快照或复核产物。
网络与存储
接口使用 HTTPS 公网域名、默认 443 端口,拒绝用户信息、片段、私网解析结果和重定向。
查询使用最多 15 秒的时间预算,响应最多 1 MiB;代理配置、DNS 解析和会话准备共用该预算。
系统 DNS 解析为同步调用,无法在预算到期时强制取消;解析返回时若预算已耗尽,不再发起
HTTP 请求,因此实际返回时间可能超过预算。直连或 Peach 代理都通过 cURL CONNECT_TO 固定已验证的
公共 IP,TLS 的 SNI 和证书验证仍使用接口原域名。Peach 代理沿用已保存的连接设置,不另存凭据。
配置位于本机 secrets/custom-metadata.json,通过文件锁和原子替换保存;不写 ledger。
复用与取证
- 参考 OpenAver
502278a3e09c7520838ffb00b2ff080323a4cdcb的声明式配置、公网目标检查和 番号身份核对。上游支持 YAML、CSS/meta/JSON-LD 及一至两步页面抓取;Peach 主动收窄为单步 JSON。 未复制上游实现。 - 使用项目固定版本
curl_cffi 0.16.3、filelock 4.0.12,以及既有SiteRecord、identifies_code、来源链与复核流程,无新增依赖。cURL 的连接边界见 CONNECT_TO 官方说明。 - 2026-10-13 无写入 POC:正式适配器经 Peach 代理、固定公共 IP、严格 TLS 查询
112312_478,返回番号匹配、标题非空、演员 1 人、置信度0.5。直连 r18.dev 与一本道时 返回curl (35) Recv failure: Connection was reset;未降低 TLS 校验。