Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

2.6 KB
Raw Blame

封面取景与边车契约

封面获取流程见 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 与前端卡片取景用例为准;通过坐标算术不能代替浏览器实际像素证据。