Peach: Local-first video metadata scraper and media manager.
封面取景与边车契约
封面获取流程见 JAV 封面技能。本文件用于取景或边车任务;来源与算法实证见 来源采集,正式判据、阈值和版本在 peach.jav_poster_crop 与 peach.face_detect。
生产者与消费者
| 产物 | 生成入口 | 消费与保护 |
|---|---|---|
| 人脸坐标 | scripts/detect_cover_faces.py |
保留归一化 cx、cy 和图像尺寸;裁切轴由容器比例决定,无脸时居中 |
| 正封边车 | scripts/poster_crop_boxes.py、peach.jav_poster_crop |
保存原图坐标和算法版本,原图保持完整;手工框不被自动重算覆盖 |
| 页面取景 | frontend/src/card-art/framing.ts、frontend/src/jav-artwork.ts |
复用边车和共享版式,不在页面抄写检测算法 |
默认仅重算缺失、版本过期或尺寸不符的产物,--redo 表示明确全算。算法改变时同步版本、生产者与消费者,并验证旧边车的接收与重算;运行中服务需要切换时使用项目入口。
折痕判据
Sobel 列梯度寻找的是能切出合理正封形状的折痕,不按全宽固定百分比选最强边。窗口、突出度和形状阈值均读取源码常量。
- 厚书脊存在竞争峰时按正封形状选择,不按谁更强;代表回归为 ABP-968。
- 梯度斜坡的峰与终点分别处理;切点不满高时核对右侧满高接缝,避免把书脊文字边当折痕。ABW-147 覆盖文字边情形,TKM-005 对应已知黑边代价。
- 无满高缝时结合孤立尖峰、左右纹理方向和局部基线,避免切掉正封内容;IPZ-602、PPT-018 与 ABP-627 覆盖对应输入。
- 只有两侧接缝与纹理共同证明居中正封时裁中间;数字发行拼图、明确整幅图像与不满足判据的输入沿用当前版式判断。
- 宽封套结合来源、版次与图片比例,不仅凭接近 16:9 的外形判断。厂牌、比例窗口与例外以当前实现为准。
页面投影与验收
框表达正封本身,页面容器负责最终比例和摆放,不在后端先裁成页面形状。传统正封完整居中,比例留白使用当前共享派生背景;整幅大封竖版按主脸填满、横版完整显示,不使用模糊补边。手工框与明确整幅布局保留。
验证算法与前端投影时,同时检查人脸轴、图像尺寸、版本、正封边界和实际容器裁切。行为回归以 tests/test_jav_poster_crop.py 与前端卡片取景用例为准;通过坐标算术不能代替浏览器实际像素证据。