Skip to content

armgit / peach

Public Imported from GitHub
0

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

14.4 KB
Raw Blame

JAV 发现

发现用于找可能喜欢的作品。三个主分区为「馆藏」「发现」「想要」;发现内有「库外发现」和「馆藏探索」两种范围。

卡片的版本标签保留在标题中;推荐档位、其他来源和内容标签在左对齐的一栏中展示。JAV 馆藏元信息包含人物、发行日期与文件大小。4K 根据实际媒体尺寸显示,无码与字幕标签使用已记录的版本属性,不依据封面推断。来源记录保留完整出演资料,明确登记的男优不参与展示、口味与推荐。来源头像与详情使用同一查询缓存。

发现筛选栏等待查询时,标签和读数使用占位;范围、版式与排序控件即时显示。首屏与页面内加载态复用同一组标签占位,标签的高度和横向排列与实际控件一致。

发现卡与首页共用头像、标题、署名和日期排版,署名、日期与馆藏文件大小带对应图标。筛选栏的刷新图标更新作品资料;读取期间同一位置提供停止操作,进度在筛选栏下方显示。图片导航固定在媒体区两侧,悬停面与关闭键一致。

已有推荐先显示并后台更新。浏览证据只读取推荐需要的访问,按日去重,同一地址和标题共用身份解析;独立缓存只保存实体、姓名和计数,随浏览历史、实体身份、别名、关注链接、标签决定及解析规则失效。观看和标记直接参与本地偏好计算,任务心跳不使推荐偏好缓存失效。

人物头像、姓名正文和提示统一使用本地规范名及唯一别名映射,未知姓名保留来源写法,同一人物的别名只显示一次;原始来源记录保持原文。厂牌有本地实体时打开资料页,无本地实体时只显示名称。发现卡以覆盖方式打开详情,关闭后保留范围、搜索、标签、排序、卡片结果和滚动位置。影院模式保留详情框体尺寸,在媒体区内展开,隐藏媒体下方的缩略图与分页点,退出恢复普通布局和同一播放器。

视频媒体处于选中状态时,左右方向键按播放设置快退、快进;图片处于选中状态时按方向键翻页。此规则适用于只有封面、带样本图片及带视频预览的作品。

已取得的公开静态头像地址保存在来源资料边车,读取头像直接复用图片下载与解码,不要求再次取得完整作品详情;带查询参数或签名的地址不保存。缺少静态地址时,头像请求复用已取得的作品身份读取并核验详情。卡片只为进入视口的人物读取来源头像。已打开的作品详情使用六小时查询缓存,陈旧详情先显示已有资料,再后台更新。

想要清单优先显示已有查询缓存,并在需要时后台更新;待找提供「全部」「有磁链」「没磁链」分段筛选,筛选使用已保存的资源状态,不触发来源查询。

范围 候选 打开方式
库外发现 已知、未入库、未忽略的作品,无发行日期阈值 /jav/movie/:code 作品详情
馆藏探索 未看或只看过一次且进度不足一半的 JAV,排除看过标记、不合口味及已移除作品 /item/:id 视频详情

已有数据

观看次数、观看时长、评分、喜欢及高潮记录提供强证据;馆藏数量提供较弱的积累证据,浏览记录和启用的关注关系分别计权。已标记不合口味、已移除作品不提供正向证据。出演者、创作者、内容标签、厂牌、系列、五年发行区间和时长区间分别构建偏好强度。身份按规范名或唯一别名匹配;来源标签复用 genre 归一规则。每个候选按自身特征与偏好强度计算,其他偏好不稀释其匹配分。资料未取得的维度不获得正向分。

推荐复用 related.rank_related 的 MMR 选集,用候选间的标签 IDF 和身份相似度减少重复;偏好相关度由 taste_preferences 提供。发行区间和时长只按已有馆藏、观看分布作为小权重证据,不限制新旧作品。没有口味信号时不制造推荐理由。

库外候选来自本机已知的 feed_discovery,并非全发行目录。发现页为固定的至多 100 部作品后台读取资料,标签随进度更新,无需打开各部详情。来源资料保存在独立缓存中,服务重启后可继续读取;新作每天按需补齐一次,发行超过一个日历月后取得的成功快照固定保存,最多 2,048 条,失败冷却 15 分钟。库内匹配使用账本中已有的规范实体与观看进度。每轮最多为 4,000 个匹配优先的候选做排序,返回至多 100 部;容量限制不是发行时间限制。同番号只显示一张卡。

排序支持口味、发行日期、来源评分、时长和番号,均可切换升降序。推荐档位显示在内容标签前:75 分起为「强烈推荐」,50 分起为「推荐」,25 分起为「值得看看」,其余为「探索」;未知读数显示「资料未取得」。口味分固定为偏好相关度乘以 100,不是喜欢概率,也不按列表缩放。悬停或键盘聚焦可查看推荐分、MMR 选择分、来源评分及各维度证据。口味排序对选集按同一推荐分升降序显示;其他字段排序缺失值排在末尾。

后台任务串行请求、间隔 0.5 秒;每轮最多 202 次 HTTP 请求、16 MiB 响应及 900 秒。页面显示进度,支持停止和重新读取。完成后只在同一固定集合过期时补齐,不自动启动下一批;停止或失败需要显式恢复。来源返回 403 或 429 时停止并冷却。编目边车只保留编目字段,不保存签名播放地址、资源链接或观看行为,不写入 ledger。

外部读取的缓存范围

外部内容 策略
作品公开资料、评论分页、磁链区与评论资源、想要资源查询 发行期每 24 小时按需更新;发行超过一个日历月后补齐一次并固定保存;日期未知或未来日期每天更新
图片、关注视频、作品预览流 复用媒体持久缓存;下载内容与资料 JSON 分开保存,播放地址失效不替换已有内容
Prestige 官方预告 按官方 SKU 与作品身份读取公开 MP4;成功结果发行满月固定保存,暂未提供的预告每天再查,来源失败保持可重试状态
标签映射、人物规范身份、想要状态、观看行为 每次从本地状态投影,来源固定快照不冻结本地决定
关注列表、新作订阅、任务状态、授权与连接诊断 保持各自更新机制;不按作品发行日永久冻结
手动重新查询、明确发起的刮削 使用既有强制读取入口,仍遵守来源限速及失败冷却

评论与资源在服务端保存来源快照,在浏览器保存完整成功的分页与查询结果。重开详情、浏览器或服务重启可复用;checked_at 表示实际取得来源的时间,读取缓存不续期。评论区可手动刷新。刷新失败保留成功内容及时间,缺页、部分来源失败和格式错误不建立固定缓存。服务端 JSON 按键原子写入,同键跨请求和跨进程合并;签名材料只保留短期内存。尚未缓存的媒体若使用带查询参数的临时地址,地址每天按需补齐,已有媒体字节继续复用。

已取得的作品 ID 可从编目缓存复用,详情直接读取并核对完整资料,不重复按番号搜索。图片下载与资料缓存分开,同键请求合并,CDN 图片不占资料 API 的请求间隔;来源限流、失败冷却与身份核对仍执行。

新作详情显示女优、性别未知的出演者、厂牌和系列。标签按本地词表与人工决定映射、去重并排除非内容分类,已确认的来源简体与繁体写法共用规范名,未收录词保留来源原文。评论和资源在详情栏内展开;资源标题单行省略,完整名称可悬停查看,大小缺失显示「大小未知」。操作按主动作、次要动作、来源外链排列。

资料与候选扩展方案

维度或能力 当前条件 取得和使用方案
标签、题材、场景、外观 库内有规范标签;库外后台资料提供来源标签 按本机归一规则投影,保留原词和分类;资料未取得时保留状态
系列、厂牌 库内实体及部分库外资料可用 后台资料或详情缓存补足候选属性,参与 MMR
历史作品目录 当前候选只覆盖已知作品 按口味人物、厂牌、系列和标签调用公开目录的有界分页,逐页去重、排除已入库及忽略项;请求尊重来源间隔,不以“新作”接口代替全目录
年代、时长、质量与热度 年代、时长分布参与低权重偏好;部分作品有来源评分 来源评分仅作质量参考;跨来源热度未取得,不把它当作个人偏好
相似作品与探索比例 已有标签 IDF 与 MMR 保留明确匹配的主体,给少量相邻题材探索位;取得“不感兴趣”反馈后才做可撤回的负向调整
近期偏好 口味接口支持时间窗口,发现当前使用全部时间 合并近期与长期证据,按事件时间衰减;单次浏览不足以改写偏好

行为原始记录留在本机;向公开目录查询只发送必要的人物、厂牌、系列、标签或番号。真实候选落库、后台采集和负向偏好学习需要另行定义来源、撤回口径与数据写入范围。

来源提示

作品详情与馆藏视频共用标题折叠、人物和厂牌身份格、规格图标与标签筛选样式。人物按来源或规范资料的明确性别分为女优及性别未确认的出演者;男优仅保留来源记录,不凭姓名或头像推断性别。来源与评论评分按小数比例填充五颗星,来源评分同时显示原始分数;评论日期显示年月日。来源标签遵循本机归一规则和已登记分类。人物优先显示本地头像与取景,缺少本地图时可显示该作品来源名单对应的头像。

封面与预览图复用关注详情的左右切换和圆点。缩略图条常驻主图下方,横向滚动并支持点击、键盘切换;只有进入可见范围的小图才读取。来源提供可信视频预览时,可切换至视频;播放器复用视频详情的播放、进度、音量、设置和全屏控件,等待用户播放,切回图片或关闭详情时停止。视频的缩略图与媒体 indicator 都在播放器下方。未提供视频入口的作品只显示图片。「作品来源」使用按钮打开新标签页。已建档厂牌打开规范资料页,未建档厂牌进入馆藏厂牌筛选;来源大小写差异和日英组合写法复用既有解析规则,投影到唯一已有身份。评论和资源通过带对象图标与箭头的标题展开、收起;详情画框按视口预留高度,右侧内容在框内滚动。想要和下载操作服从账本的实际只读状态。

评论读取期间仅评论区显示 skeleton,微光定位并裁切在占位条内,已显示的标题、身份和操作保持挂载。桌面与手机均覆盖正常动画的等待及展开状态。

来源返回多少评论就展示多少。公开 Web UI 的匿名评论分页已取得首两页不同记录,完整评论范围仍未取得;HTML 来源的部分评论限制不代表所有来源均需 VIP。资源提示说明本次取得范围并提供来源页,不推断用户账号权限。

新作详情和发现列表的每个来源标签都经过人工决定、内容词表与非内容过滤。已登记的中文来源词同时接受简体和繁体写法,规范标签去重,未收录的词保留来源原文。当前缓存的只读核验覆盖 116 部作品、93 种来源词:78 种映射、7 种排除、8 种未收录,逐词结果存于 <私有验证记录>。

馆藏 JAV 详情也使用同一媒体轮播,默认打开正片,封面和已登记的官方样张按需读取。查看图片时暂停正片,返回正片保留播放位置;已登记样张的缩略图使用现有小图缓存。作品没有登记样张时异步读取来源详情的预览图片,复用公共详情及持久图片缓存;等待和重试只占图片区域,正片实例保持挂载。来源图片仅供浏览,不写入账本。

馆藏与库外作品共用按视口预留的详情画框。等待资料、切换横竖图和视频时保持画框高度;右侧正文与底部推荐各自在可用空间内滚动。缩略图条支持鼠标滚轮横向滚动。

公开图片使用三个下载槽位,同一图片请求共享结果,缓存命中不等待其他图片下载;图片 CDN 不使用资料 API 的请求间隔。资料 API 与图片 CDN 各自保留来源冷却,彼此的故障不阻塞另一种读取。资料 API 保留 0.5 秒间隔,图片保留来源主机校验、单次字节上限和 6 小时缓存。

资源协议用文字「磁链」「ED2K」「网页链接」。标题和元数据占据资源区宽度,窄资源区的操作键在下方换行,宽资源区并列显示。字节容量复用馆藏 fmtSize 口径显示,有明确单位的容量按来源展示;纯数字且单位未取得时显示「大小未标注」,悬停可查看来源原值。复制和下载使用原始链接。

云下载的直接添加优先取得可用高清候选;「想要」的待找清单在同一请求预算内继续汇集 manko.fun、JavDB 和 sukebei,按画质与版本排序并去重。JavDB 一环与新作页共用匿名资源接口,读磁链区与前 4 页评论;资源区与评论中的磁链、ED2K 和网页链接按原协议保留,取得范围提示随来源返回。待找缓存与快速添加候选分开,已取得的多个资源保留展开入口。

新作页的匿名资源接口合并磁链区与前 8 页评论的链接,资源按协议身份去重并保留评论锚点。磁链区体积由来源的 MiB 数换算成 MB 或 GB 显示。评论取数失败时保留磁链区结果,并在资源区提示未取得的范围;重新查询同时刷新磁链和评论。资源缓存使用包含评论的独立身份。

待找资源在浏览器和服务端本机缓存。发行未满三个月保存 7 天,更早作品保存 1 年,最多保留 128 部;服务重启后有效期从原查询时间继续计算。已取得的结果优先读取,不等待其他作品的查询锁;过期或点击「重新查询」才访问来源。主动查询失败时保留上次成功资源;来源失败或受限且没有结果的状态只短暂缓存,不写入持久结果。缓存位于私有来源目录,不写入账本。