Peach: Local-first video metadata scraper and media manager.
上游依赖与参考来源复核
各节分别记录复核日期(Asia/Taipei)。本文件是人工复核笔记,不登记为可覆盖的上游快照;原文字节、哈希与 revision 见 来源登记。
amane 桥
稳定版 v0.25.0 暂不采用
2026-11-04 复核官方 v0.25.0,提交 f6c1cc9f54bca0fa5381a26d4b2e259df7f58a0a。相对现固定提交的差集含 51 个提交。桥消费的站点类中,airav 比对番号前先剥除 caribbeancom、1pondo 等来源名前缀;avsox 与 faleno、dahlia 共用的 wp_works 改用容忍 null 字段的 ResponseModel;makers(official)、prestige、mgstage、fc2club、freejavbt 没有提交。amane.net 新增出站通道与浏览器后端,桥不使用。运行依赖仍强制安装 numpy、onnxruntime(macOS 以外)、tokenizers 与 macOS CoreML,watchdog 限制为 <7,zhconv 改为随包字典。
继续固定 v0.22.1;语义检索依赖改为可选,或桥接站点出现必须的修复后再升级。本次在约束内把 pydantic-ai-slim、pydantic-graph 更新到 2.65.0,anthropic 到 2.4.0,openai 到 3.43.0,桥不调用它们的模型服务;watchdog 与上游一致保持 6.0.0。清空 PATH 后离线自检载入全部 20 个站点类通过。
稳定版 v0.24.1 暂不采用
2026-11-02 复核官方 v0.24.1,提交 7d037a44b17a147df1db20989ab96047f0935933。相对现固定提交的差集含 31 个提交。桥消费的站点类中只有 avsox 改动,响应模型改为容忍 null 字段;amane.net 新增 BrowserSkill 浏览器后端,桥不使用。0.24 新增 numpy、onnxruntime、tokenizers 与 macOS CoreML 的语义检索运行依赖,会显著增大随包 amane 环境,上游同时把 watchdog 限制为 <7。继续固定 v0.22.1;桥接站点出现必须的修复,或语义检索依赖改为可选后再升级。本次在约束内更新传递依赖,watchdog 与上游一致保持 6.0.0;python-dateutil 升至 4.0.0 只经 croniter 进入调度器,桥消费的站点与网络模块不引用。清空 PATH 后离线自检载入全部站点类通过。
稳定版 v0.23.0 暂不采用
2026-10-30 复核官方 v0.23.0,提交 4230de458c3197e1e17b6c5b42cc385fc6961d15。相对现固定提交的差集含 16 个提交、142 个文件,爬虫只改了 theporndb;桥消费的 makers、prestige、faleno、dahlia、mgstage、fc2club、freejavbt、airav、avsox 站点类和 amane.net 都没有变化,其余是 CLI、服务端与图片代理。继续固定 v0.22.1;桥接站点或网络接口出现修复时再升级。本次更新其约束允许的传递依赖,并核对独立环境的离线类加载。
稳定版 v0.22.1 的桥接范围
2026-10-26 静态复核官方 v0.22.1,固定提交 fd9294fbe5b4aa88ce1df84d534f6816ad9460d5。相对固定基线的差集含 55 个提交。按桥直接消费的模型、站点、检索身份与网络接口判断采用范围;上游 main 的未发布提交不作为稳定发行依赖。
SearchQuery、FetchOptions、MediaMetadata与爬虫构造接口继续适用。AIRAV、FreeJavBT 的 FC2 写法,以及 MGStage 的数字前缀检索、简介、剧照和海报由桥消费;Peach 的独立 DMM、JavBus、JavDB、FC2 来源保持各自归属。- 上游新增
login_required。桥保留这个原因,Peach 映射为auth_required,使用既有认证等待与冷却契约;凭据缺失不写入确定无结果记忆。 - MGStage 的封面与海报分别投影;缺少字段不清空已有人工资料。素人条目的站点代名不产生规范人物身份。
WebClient.download的分块参数归属调整不影响桥使用的 HTML/JSON 查询接口;Peach 继续限制整个查询子进程的总时限,不引入上游下载、数据库、聚合或任务中心。
验收覆盖桥的离线类加载、失败分类、精确检索与候选投影,联网查询和报告者原场景分别记录;源码复核不表示全站或所有作品的可用性已验证。GPL-3.0、独立运行环境、子进程与对应源码分发边界沿用 ADR-0043、ADR-0124。
v0.20.0 复核记录(2026-10-13)
采用 amane 0.20.0,固定 revision cc42cee6ecf290cf05af1caa347d2dc2d5aeffcd,GPL-3.0。Python 下限仍为 3.14,桥以独立 venv 和子进程消费;不引入其数据库、整理、任务中心或界面。
源码差异共 29 个提交。适用于 Peach 的变化是 FreeJavBT、AIRAV 精确检索,AIRAV 详情解析及网络层指纹轮换。演员、kin8、giga、字幕、整理与超分的变化不扩展 Peach 来源链;每站唯一归属、身份核对、候选与结算仍由 Peach 管理。
实测:所有 20 个桥声明的爬虫类可导入,SearchQuery、FetchOptions、MediaMetadata 与 17 档失败原因兼容。真实解析器配合合成页面确认 AIRAV、FreeJavBT 精确命中 ABW-032,查 ABW-03 时不取相近条目;AIRAV 的标题、演员、厂牌、发行日、标签、剧情与封面可解析,片长为空,不采用固定试看时长。
只读在线查询 ABW-032:Prestige 2.48 秒、AIRAV 2.54 秒取得同一番号,FreeJavBT 5.32 秒明确未命中。Prestige 返回片长 190 分钟,AIRAV 不给片长;Prestige 配信日与发行日的分离仍按 Peach 既有规则处理。上游测试数据仓库请求为 HTTP 404,真实 fixture 未取得,合成页面不能作为该站所有作品均可抓取的证据。
max_retries=1 限普通失败重试;403/406 另可轮换三次 TLS 指纹,单个地址最多五次请求。Peach 保持整次查询 60 秒子进程总时限,超时终止并报可重试失败,不按尝试次数推导完成时长;桥不启用浏览器或 solver。公开请求的 TLS 行为沿用上游,未用于证明 Peach 生产 HTTPS 验收。
桥锁文件同时覆盖 PR #40、#42 的传递依赖要求:Mako 1.4.3、pydantic-ai-slim / pydantic-graph 2.55.0。没有新增直接依赖;传递更新包括 anthropic、openai、genai-prices,桥不调用它们的模型服务。
amane 0.21.0 采用范围
2026-10-17 复核稳定版 v0.21.0,
提交 a2d45880e83df7047d461452965919692701e8c9;桥清单仍固定 0.20.0,未执行运行依赖升级。
从固定提交到该版本的源码差异覆盖 DMM 图片路径、CID、数字前缀与 MGStage 搜索;
版本检查与实际接入必须分开判断。
| 能力 | 上游修复与 Peach 消费者 | 判断 |
|---|---|---|
| 高清图片 | amane 生成 legacy 高清候选;Peach jav_cover_fetch 同时测 modern、legacy 与原始图的真实像素面积,保留最大官方图 |
保留 Peach 选图策略;上游补充的 mono/movie 分类目录与剧照路径可单独补回归 |
| DMM CID | amane 区分通贩与配信 CID,剥离门店前缀;Peach 正式 DMM 来源独立使用 GraphQL 与 makerContentId 核对 |
升级桥不会替换 Peach DMM;不直接套用全局去数字规则 |
| MGStage 搜索 | amane 生成搜索变体,精确命中优先,只有一个候选时才允许单边数字前缀差异;Peach 正式来源通过桥调用 MGStage | 桥升级的有效收益,须在独立升级中验证字段与错误契约 |
| 聚合与产品功能 | Peach 经桥使用 4 个社区站、5 个官方来源入口,不调用 amane 聚合、任务中心或前端 | 沿用固定上游版本加 Peach 领域策略,无需维护完整 fork |
pnpm 管理 amane 的前端依赖,Justfile 编排 uv、前端、测试与打包;它们不是桥运行依赖。 Peach 继续使用现有 npm 清单与项目命令入口。pnpm 的多工作树安装收益需实测,just 暂无独立消费者。
Dependabot PR
PR #41、#43、#44、#45、#46、#47、#48 在隔离工作树按项目接管入口处理,保持一 PR 一提交。PR #43 的锁冲突保留主线 pyahocorasick 并采用 Pydantic 2.14.0,uv lock --check 通过。npm vendor、主界面与独立页面包按清单重建。
Motion 14.0.0 的大版本删除内部兼容 API。Peach 只通过 motion 公共入口使用,没有直接引用 framer-motion、motion-dom、motion-utils 或被移除的 timeline 内部 API;版本由其内部精确依赖保持一致,类型检查、组件与浏览器回归由项目完整测试入口核验。
轮播箭头几何用例在图片就绪后等待渲染阶段,再读位置;ResizeObserver 的异步测量不能由图片 complete 代替。位置、尺寸、黑边中心和桌面/手机断言保持完整。
依赖与参考来源判断(2026-11-05)
0.55.0 发版前审阅覆盖 weekly、monthly、quarterly。依赖按约束内最新稳定版更新:Python 侧 filelock 4.2.8(含 GitLab CI 三处 --with),锁内 soupsieve 4.0.1、typing-inspection 0.4.5 跟随;amane 桥锁内 pydantic-ai-slim、pydantic-graph 2.66.0,openai 3.45.0,SQLAlchemy 2.1.8,离线自检载入全部 20 个站点类;前端 Video.js 10.3.0(等待自动播放显示为正在起播、可配置倍速档位、嵌入适配器补缓冲条,Peach 不用嵌入适配器),Lucide 1.68.0(所用图形字节不变),Motion 14.9.1。amane 继续固定 v0.22.1,理由同上文 v0.25.0。
Dependabot #400(Docker 镜像内 uv 0.13.7)与 #401(watchdog 7.0.0)按接管入口各一提交。watchdog 7 的不兼容项不影响推送发现:本地通道不用模式匹配,只收 created、modified、moved、closed,新增的 attrib 事件被忽略。Windows 本地目录实测:7.0.0 送达事件比 6.0.0 晚约 1 秒,观察器停止前尚未送达的事件会丢;推送发现只缩短发现时间,定期全量扫描兜底,停止只发生在退出与改设置时,这个延迟可以接受。
| 来源 | 实测变化 | Peach 判断 |
|---|---|---|
| Javinizer-Go README | actress 子命令新增 list、search 与 credit add |
同类产品信息,接受原文 |
| Atlas README | 原 v3 分支已删,改跟默认分支 main;版本号由 v4.x 重排为 v1.x,能力描述不变;jav-utils.ts 移到 backend/src/services/ |
更新登记的分支与文件路径后接受原文 |
| JAVM README | 仓库 ddmoyu/javm 整个返回 404(删除或转为私有) |
保留 2026-11-04 的最后快照,档位改为 manual,只在点名时检查 |
OpenAver 从 118f19330c49414a6b9dfa94581e3f731e4f8e5f 前移到 67c410ca4465d4d107f940d9f0a9ece8395f0ad8,32 个提交;相关推荐的变化只在 core/ai_services/ 的向量索引与设置页,Peach 没有向量路,本批不改代码。PixivUtil2 停在上次复核的 46bb910cd60c213c9199d939859670a044450239。FANBOX、OpenAver 两份人工笔记照旧不执行 accept。
参考来源判断(2026-11-04)
0.54.0 发版前审阅覆盖 weekly、monthly、quarterly,17 个来源报告漂移,另有 amane 运行依赖前移(见上文 v0.25.0)。15 份原文按完整 SHA-256 与 Git revision 接受;FANBOX、OpenAver 两份人工笔记不执行 accept。仅 revision 前移、内容相同的来源不重新登记。
| 来源 | 实测变化 | Peach 判断 |
|---|---|---|
| Fluid tabs | 由带轨道的分段控件改为横向页签导航:改用索引 API,移除 surface 上下文,增加 activeLabel;选中面仍为 spring.moderate,悬停面仍为 spring.fast |
接受原文。Peach 只采用独立选中面与弹簧参数,两者未变;segmented.tsx 不跟随改成页签导航 |
| BoardUI input | 增加 errorMessage(React Aria FieldError)、trailingAddon,样式类抽成 inputFieldClassName、hintTextClassName;类名与状态配色不变 |
接受原文,Peach 消费的输入框配色与状态未变 |
| evilcharts registry | 新增 ECharts、Recharts 两套日历热力图组件与示例 | 接受原文;Peach 现有图表不使用热力图,留作候选 |
| amane 内容路由 | JavDB 无码条目与演员档案要求登录;jav321 改为 POST 检索并核对品番;AIRAV 收进 FC2 链尾并剥除来源名前缀;MGStage 竖版海报由封面地址推导;giga 同时只允许一个请求 | 接受原文。Peach 自有 JavDB 来源已识别登录页并上报 auth_required;桥仍固定 v0.22.1,不随文档切换路由 |
| amane README | 改为元数据服务定位,列出 25 个站点、Docker 与 Android | 同类产品信息,接受原文 |
| SakuraMediaBE README | 改为英文,新增 PolyForm Noncommercial 1.0.0 许可声明 | 接受原文。Peach 只引用行为证据,不复制其源码 |
| SakuraMedia README | 改为英文 | 同类产品信息,接受原文 |
| Javdex README | 许可证由 MIT 改为 GPL-3.0-or-later;新增 NAS 常驻、libmpv 播放与本地字幕生成说明 | 无直接消费者,接受原文 |
| JAVM README | 桌面宿主由 Tauri 改为 Neutralinojs,界面改为 React + Mantine,补充安装与迁移说明 | 同类产品信息,接受原文 |
| OpenAver README | 新增 AI 可写的自定义 YAML 来源与 NAS 片库连接,测试数改写为 3,300+ | 同类产品信息,接受原文 |
| Javinizer-Go README | --force 刷新保留人工选择,新增 JAVINIZER_HOME 与目标冲突文档 |
同类产品信息,接受原文 |
| JavBoss、AMMDS DOC、Immich、javranking-extension README | 下载版本号、文档目录、语言链接与仓库地址更新 | 接受原文,无运行影响 |
PixivUtil2 自上次复核的 22b5fdc9fc83a976d8f4f6f6acbb4d2d3d542f21 前移到 46bb910cd60c213c9199d939859670a044450239,五个提交为依赖更新与动态 GIF 头像,PixivBrowserFactory.py 没有变化;FANBOX 传输边界不变。
OpenAver 从 502278a3e09c7520838ffb00b2ff080323a4cdcb 前移到 118f19330c49414a6b9dfa94581e3f731e4f8e5f。相关推荐源码有变化:3230465ce1 在开关开启且有向量时,用 RRF 融合规则前 100 与向量前 30 后再做 MMR;0347ac95e0、20f148dafe 让 IDF 与倒排索引计入用户标签,并跳过非字符串标签。Peach 的 related.py 按账本中作品的标签实体计算 IDF,不区分来源标签与用户标签,也没有向量路;向量融合是否值得引入留作后续单独评估,本批不改代码。
参考来源判断
运行项目 check_reference_updates.py check --diff,覆盖 weekly、monthly、quarterly;manual 不在本轮范围。47 个来源中 28 个未变化,19 个报告漂移,另有 amane 运行依赖前移。14 份原文按完整 SHA-256 与 Git revision 接受;5 份人工笔记保留。
| 来源 | 实测变化 | Peach 判断 |
|---|---|---|
| Fluid springs、tabs | 名称与 import 从 Framer Motion 改为 Motion;弹簧参数未变 | 接受原文,Peach 已用 motion |
| Vercel report-design | 增加 Vercel 官方 Logo 下载说明 | 上游品牌专属,不采用其 Logo |
| Vercel web-interface-guidelines | 增加细指针设备页面 overscroll 建议与混合输入限制 | 保留现有滚动行为,本轮不扩展为界面改动 |
| Bruno README | 增加 Hindi 翻译链接 | 接受原文,无运行影响 |
| amane 路由与 README | kin8 欧美归类、giga 会话与 Referer、欧美日期号年份形态及称呼 | 锁定证据,Peach 仅使用已接入来源 |
| OpenAver README | 女优排行 Top 25 | 原文接受,不改 Peach 排行数量 |
| SakuraMediaBE README | 新增番号解析开源项目致谢 | 仅参考出处,不新增依赖 |
| SakuraMedia README | VR 外部播放与插件市场说明 | 同类产品信息,不导入其播放协议 |
| JavBoss README | v2.1.2 下载与设置路径说明 | 同类产品信息,不改变 Peach 部署 |
| MDCz README | 平台、安装包、便携数据与自动更新说明 | 保留 Peach 既有分发和运行边界 |
| Cuelume README | press/release、unlock、卸载绑定与关闭声音语义 | 候选参考,无直接消费者,不安装 |
| Atlas README | 女优资料来源改用 JavBus,注明 minnano-av 反爬 | Peach 有自己的传输与来源冷却,不以 README 声明推断本机站点故障 |
PixivUtil2 从 fc0f9adf44e590dde9242b3755b53528f159720a 前移到 22b5fdc9fc83a976d8f4f6f6acbb4d2d3d542f21,三个提交处理 FFmpeg 8+ 动图转换、x-userid 登录身份和独立错误日志。PixivBrowserFactory.py 只增登录 ID 赋值,Peach 采用的公开 FANBOX 传输边界不变;保留既有取证 revision,不复制登录逻辑。
OpenAver 从 8cc17e50453d9f69a81f5fee1a072df80f7aab73 前移到 502278a3e09c7520838ffb00b2ff080323a4cdcb,共 318 个提交;相关推荐源码未变化。DMM 采用代理 session、连通探测与失败分类,GraphQL 查询取法不变;Peach 参考声明式来源和公网目标守卫,使用受限 JSON 适配器。桌面路径继续由 platform 处理,相关推荐保留固定算法证据。
fiu758-studio-logo-discovery、rule34-follow-tags-and-collections 的漂移是人工笔记与动态 HTML 的比较;f95-masked-gofile-media 返回的脚本哈希与笔记记录相同,协议未变化。这三份和 FANBOX、OpenAver 的人工笔记均不执行 accept,避免被网页或脚本字节覆盖。
采用的应用行为
| 能力 | Peach 实现与边界 |
|---|---|
| 实体收藏与命名筛选 | 资料页、标签页和目录入口;复用 profile.settings_json,收藏跟随规范身份与合并事务,筛选可保存、打开和删除 |
| 来源诊断 | 正式 amane 来源逐站选择直连或公共代理;连接结果区分代理、超时、限流、验证页与服务错误,显示耗时和冷却;诊断把连接与解析分开 |
| 比较图按需请求 | 复核卡点击后加载,30 秒超时可重试;换来源重置请求状态 |
| 声明式来源 | 单步 JSON 配置,公网地址固定连接、严格 TLS、响应番号核对、低置信度候选;不复制 OpenAver 的 HTML/YAML 规则 |
| 外部播放器与 VR | 限时网络链接与 M3U,设备可使用 VLC/IINA 协议;实际投影与解码由播放器负责 |
| 分卷与整理 | 复用同一版本分卷连播、模板预览、目标冲突跳过和整批回滚,不引入第二个规划器 |
Python 最低与默认版本为 3.14;CI 保留 Windows/macOS 系统与独立 wheel 消费,前端类型、lint、
组件验证在 web-bundle 集中执行,本机正式入口完整验证。amane 仍使用独立锁与子进程,
只消费爬虫和网络层;其任务中心、数据库、整理、超分和 AI 服务没有接入 Peach。
本任务未执行真实数据整理、合并或删除。静态、组件、桌面及手机浏览器和生产运行的验收结果 以项目验证记录及 运行与配置 为准。