Peach: Local-first video metadata scraper and media manager.
浏览器添加 JAV
在支持站点的影片详情页点击「加入 Peach 馆藏」,Peach 按番号搜索磁力,自动选择现有质量排序中可确认属于该番号的正片资源,提交到默认网盘。文件落地后由现有云下载流程登记、补资料并整理。
准备
- 运行 Peach 的账本写入端。
- 添加云盘媒体库并配置云下载账号、目标目录与挂载路径。CloudDrive2 渠道复用挂载或推送发现的路径关联,并按目录返回的云下载能力筛选;PikPak 也支持直连。光鸭等网盘只有在当前连接器确认支持云下载时才进入列表。配置见资源搜索与 CloudDrive2。
- 浏览器安装支持 GM API 的用户脚本管理器;以 Tampermonkey 官方安装与浏览器说明为准。
CloudDrive2 分别返回提交云下载和管理离线任务的能力。支持管理的网盘通过任务列表跟踪进度;仅支持提交的网盘等待目标目录中的文件落地,取消操作在网盘中完成。Peach 隐藏不可用的远端取消按钮。媒体库与云端路径的关联也用于下载完成后的入库。
脚本由 peach-mitao/peach-userscript 独立维护,覆盖在线播放、数据库与资料、发行销售平台、片商官网、无码发行站和资源索引。各站的域名与识别方式见完整站点清单。镜像域名单独登记,不根据相似名称自动认作同一站。面向使用者的安装、配对和站点说明集中在 Sleazy 发布页文案,Peach 配置页只保留安装与配对操作。
自动识别使用作品详情页的主标题与明确番号字段;DMM、MGS 的详情地址与页面「メーカー品番」「品番」由 Peach 按来源联合校验。DMM 商品目录前缀与 MGS 发行前缀分别解释,商品番号的尾字母保留。字段缺失时可选中完整番号;字段冲突时停止自动添加并提示核对。标记为「选中番号」的站点需要先选中一个完整番号,再从脚本菜单选择「选中番号加入 Peach」,最后点击浮出的添加按钮。
安装与配对
- 在运行 Peach 的电脑上打开「Peach 配置 → 下载渠道 → 浏览器添加 JAV」。
- 点击「安装 Peach 用户脚本」,由脚本管理器安装当前 Peach 随附的制品。公开安装入口见 Sleazy 发布页。
- 选择默认下载渠道,点击「启用并生成令牌」,再点击「复制配对信息」。令牌只在本次生成后显示;离开页面后需要用「更新渠道与令牌」重新生成。
- 打开已登记站点,点击右下角「配置 Peach」或设置按钮,在「Peach 地址」中粘贴配对信息,自动填好地址与令牌,再保存设置。也可从脚本菜单「配置 Peach 地址与令牌」打开设置面板,分别填写地址和令牌。目标浏览器必须信任 Peach 的 HTTPS 证书;HTTP 只允许回环地址。
- 允许脚本管理器连接自己的 Peach 地址。远程设备填写该设备能访问的 Peach HTTPS 地址。
专用令牌仅允许查询作品添加状态、发起 JAV 添加和写入受限的脚本错误记录,网盘账号仍由 Peach 管理。点击「关闭浏览器添加」会撤销令牌并停止队列里尚未开始提交的添加;正在提交或已经提交的云下载从任务中心查看和取消。
脚本从 GM 存储读取已保存配置,设置面板中令牌留空可保留,更换地址时须重新填写令牌。服务端只保存令牌哈希,不能读回明文。配对信息包含地址与专用令牌,应按令牌保管;导入仅填充表单,点击「保存设置」后生效。配置校验与选中番号的提示显示在页面内,浅色与暗色随系统切换。
Peach 配置页通过同源桥接页检测脚本版本和是否已为当前地址保存配对。未收到响应时显示「未检测到」,保留安装与重新检测入口;脚本禁用、脚本管理器未授予访问权限或旧版不支持桥接都会出现该状态。桥接不返回令牌;「已配对」只表示脚本已保存当前地址,令牌权限与服务连接由来源页面的状态查询确认。
添加与查看进度
- 打开影片详情页,点击「加入 Peach 馆藏」。
- 脚本用整体进度显示排队、搜索、下载、入库与整理五个阶段,完成阶段打勾、当前阶段高亮,并显示提交网盘、文件可访问等具体状态。网盘百分比仅属于下载阶段,其他阶段按真实状态推进。馆藏已有的影片显示「馆藏已有该番号影片」,按钮显示「已有该影片」。同一番号的进行中任务会复用。
- 云下载提交后,在 Peach 任务中心查看下载与入库后整理进度。
搜索期间可以关闭源站页面,队列由 Peach 保存;Peach 重启后继续尚未完成的搜索。提交后脚本自动刷新状态,最长一小时。失败时区分原因:磁力问题(网盘拒绝、链接无效、没有下载源、内容不符)可点击「换一个磁力」,Peach 跳过已失败的磁力,查完所有来源后取下一个,不在第一条高清结果处提前结束;网盘问题(配置或登录、额度、网络、文件未落地)需要先在 Peach 检查网盘,再点击「重试加入 Peach 馆藏」,重试仍使用原来的磁力。没有可换的磁力时显示未找到资源。网络超时只提供状态查询,确认服务器结果后再决定是否重试。
浮卡标题栏可折叠详情,也可收起为右下角的 Peach 标志小球。点击小球展开并查询现有任务,不会再次添加。设置面板打开时隐藏浮卡,关闭后恢复;开关过渡遵循系统的减少动效偏好。
「本页番号」识别后先查询每个番号的 Peach 状态,再开放加入操作。馆藏已有、已入库和进行中任务不计入「全部加入」,未加入与可重试项仍可选择;进行中任务继续刷新。查询失败显示「未取得」,可用「重新识别」重新查询。返回后不再继续查询后续番号,已提交任务继续由 Peach 处理。
添加请求只校验本机配置并保存队列;云盘能力探测与提交由后台执行,状态查询不等待远端提交。脚本单次请求上限为 60 秒,超时不表示下载失败,也不会自动重复添加。状态接口的可选 download 字段仅投影任务状态、标签、当前阶段 phase、下载进度、整理状态及更新时间;下载进度来自后台最近一次网盘对账,整体阶段来自任务里程碑。连接异常保留最近一次确认的阶段;未请求的整理显示跳过。
GET /api/jav-browser/active 无需番号,一次返回所有进行中的任务:浏览器队列里排队或搜索中的番号,以及带番号、仍在云下载或入库后整理未结束的下载任务,不论从哪里添加。最近 10 分钟内结束的任务带着终态保留在列表里,便于看到完成或失败。由浏览器添加的任务结束后一直保留,直到在脚本里标为已读,窗口全关时结束的也能在下次打开时看到;从任务中心、想要清单等别处提交的只保留 10 分钟。结束的项多带 ended_key(任务编号@结束时间)与 dismissed;确认过的项在 10 分钟内仍列出,只标 dismissed。每项与状态接口同一结构,最多 200 项。没有生成下载任务的搜索失败不在列表里。
POST /api/jav-browser/dismiss 确认已结束的任务:{"keys": [...]} 逐条确认 ended_key,{"all": true} 确认此刻之前结束的全部,返回新的任务列表。重试整理等让任务再次结束时,结束时间变了,会重新列出。确认记录存在本机状态目录的 jav-browser-ended.json;首次启用时从 10 分钟前起算,之前早已结束的任务不会补列。
POST /api/jav-browser/postprocess 接收 {"code": "..."},重试这个番号入库后失败的整理,与任务中心的「重试整理」同一入口,返回状态接口同一结构;没有失败的整理时返回 400。
资源搜索与入库后处理遇到可恢复的网络超时、暂时服务错误、挂载离线或文件占用时,由 Peach 后台自动重试,最多 3 次,间隔为 1、5、30 分钟;来源要求的 Retry-After 更长时按来源等待。计划和次数持久保存,关闭网页或重启服务不丢失。已经入库的影片只重跑幂等后处理,不重新提交云下载。凭据、配额、身份、文件冲突、路径超长、完整性与程序错误不自动重试。
等待期间状态响应带 retry_at(ISO-8601 UTC)、retry_attempt 和 retry_limit,任务仍属于进行中;用户脚本显示「待自动重试」,进度页说明时间与次数。重试耗尽带 retry_exhausted: true,保留失败与手动入口。手动重试会开启一轮新的有限后处理重试。
女优页的「订阅新作」走 GET /api/jav-browser/performer?source_url=…&names=… 与 POST /api/jav-browser/performer(正文 {"source_url": "…", "names": [...], "enabled": true}),两者都回 {name, entity_id, following, avatar?}。支持 JavDB 演员页 /actors/<id>、DMM 女优片单 ?actress=<编号> 与旧版 article=actress/id=<编号>、MISSAV 女优页 /actresses/<名字>;names 是页面上的女优名,JavDB 标题栏的几种写法与 MISSAV 的「现名(旧名)」都会拆开。认人先看页面编号的持有者,再按名字认正名或唯一别名;编号没人持有时新建她并绑上编号,DMM 页没给名字时向 DMM 问。只有名字的页面,库里有编号的直接订,否则到 JavDB 搜,名字对得上又确认是同一个人才登记,同名不止一位、搜不到或 JavDB 冷却时返回 400 与原因。取舍见 ADR-0143。
脚本通过专用令牌向 POST /api/jav-browser/errors 写入请求超时、连接失败、HTTP 拒绝和无效响应记录。记录只含发生时间、事件标识、脚本版本、站点标识、番号、操作类型、耗时和 HTTP 状态,不含令牌、账号、完整来源地址、页面正文或原始异常。每批最多 10 条、16 KiB,服务端每分钟最多接收 20 条并按事件标识去重;仅写本机 errors-*.log,随导出诊断包提供。脚本管理器暂存最多 20 条、保留 7 天,后续请求成功时按一分钟限频向原 Peach 地址补报;记录失败不重试添加,也不递归生成错误。
配置来源与显示条件
| 内容 | 来源与显示条件 |
|---|---|
| 网盘账号与专属字段 | 已声明的媒体来源;未添加 PikPak 时隐藏其登录和目录字段,未添加 115 时隐藏其目录与检查提示 |
| CloudDrive2 配置、代理与挂载帮助 | 存在云盘媒体库时显示;仅有本地媒体库时隐藏 |
| 下载渠道、名称和图标 | 媒体库名称、来源注册表与目录云下载能力;移除媒体库后退出可选列表 |
| 默认渠道 | 有效的已选渠道,否则给出可用候选;没有候选时保持空选择。已启用渠道失效时提示重新配置 |
| 脚本版本、兼容要求与安装入口 | 随附发布清单;安装入口指向当前 Peach 的同版制品 |
| Peach 地址与令牌 | 配置页当前地址与用户生成的配对信息;脚本读取 GM 存储 |
| 站点、镜像与安装匹配 | 同一份 jav-sites.json 构建清单 |
| 番号与后处理来源 | 复用编目规则;后处理使用媒体来源,不把具体下载渠道标识作为来源 |
云下载能力查询只读,结果缓存 30 秒;媒体路径、名称、下载设置或凭据变化时失效。渠道被移除不清除已有账号、配对信息或下载任务。请求超时、轮询上限、协议版本与字段长度属于通信和校验约束。
DMM / FANZA 的 /av/content/?id=… 与旧版数字、DVD 详情路径,以及 MGS 的 /product/product_detail/…/ 自动把商品号交给 Peach 识别。例如 DMM 的 1dandy00899 对应 DANDY-899,h_086iqqq00026 对应 IQQQ-026;MGS 的 104DANDY-851C 保留发行前缀和尾字母。明确商品番号与文件名的字幕标记使用各自的上下文,日期式番号的分隔符也属于身份。脚本支持 KIRARI 的 MKBD-S/MKD-S 和二至四位序号的日期式番号。识别和状态查询均不创建下载任务。
常见问题
| 现象 | 处理 |
|---|---|
| 没有按钮 | 核对域名、脚本启用和脚本管理器的站点访问权限;打开作品详情页,或选中番号后使用脚本菜单 |
| 已安装但配置页未检测到 | 在 Chrome 的 Tampermonkey 扩展详情中开启「允许用户脚本」或开发者模式,允许访问当前 Peach 站点,确认脚本已启用并更新后刷新页面、重新检测;见 Tampermonkey 权限说明 |
| 番号存在冲突 | 核对地址、标题和详情字段;脚本不会提交多个身份不一致的页面 |
| 无法连接 Peach | 核对 Peach 地址、证书信任、服务在线状态和脚本管理器连接权限 |
| 令牌无效或无权限 | 在本机下载渠道更新令牌,并重新配置脚本;reader 不能接收添加 |
| 下载渠道未配置 | 保存网盘账号与目标目录后启用 |
| 未找到资源 | 在 Peach 云下载弹层手动查找或选择其他版本,之后可再次主动添加 |
| 云下载或入库失败 | 在 Peach 任务中心查看具体原因,按现有云下载流程重试 |
来源地址保存页面协议、主机、路径及清单允许的作品标识参数,例如 JavLibrary 的 v、FANZA 的 id。其他查询参数、片段、Cookie 和网站播放器地址不提交给 Peach。直接播放外来在线来源属于后续功能,见公开路线图。
核验范围
临时账本与模拟网盘完成服务端回归;完整安装脚本通过模拟 GM 桥连接真实临时后端,覆盖 DMM 与 MGS 商品号、厂家番号和尾字母的桌面及 390×844 联合验收。模拟 GM API 的 Chromium 页面另覆盖特殊番号、SPA 切页、身份冲突、HTTP 错误和请求重试。真实 Tampermonkey 扩展安装、MissAV/Jable 当前页面和真实网盘下载的联合验收未取得。
制品同步
脚本设置、浮动卡和脚本管理器菜单均提供「检查更新」。匹配页面即使没有识别出番号或尚未配对,也可独立检查;可见页面每天自动检查一次可信脚本发布元数据。公开检查不携带 Peach 专用令牌、不执行返回内容,失败可稍后手动重试。
发现脚本版本可更新时提供安装入口。脚本更新后,已打开页面保留当前操作并提示刷新;首次从缺少版本监听的旧脚本更新时,需要先刷新一次页面。Peach 下载渠道分别展示最低兼容版本和当前发布版本,兼容的旧脚本也会显示可更新提示。
脚本与站点规则的唯一维护源在独立仓库。Peach 的 web/integrations/ 保存同一次发布的完整安装脚本、站点快照与 jav-userscript-release.json 来源记录;安装端点直接返回该脚本,服务端使用本地快照独立校验来源地址。运行时不下载远程规则或代码。
更新时在用户脚本仓库构建、验证并提交,通过其 scripts/export-peach.mjs 导出到 Peach 隔离工作树,再按本项目测试和集成入口交付。来源记录包含上游提交、版本与 SHA256;同步方法见独立仓库说明。