Skip to content

JavSP-fork v0.4.6

Choose a tag to compare

View all tags
@luckwalter luckwalter released this 26 Oct 09:01
· 4 commits to master since this release
v0.4.6
4036101

JavSP-fork v0.4.6 发布说明

派生自 Yuukiy/JavSP 的带 WEBUI 刮削器。本版本为功能增强版：
「结果审阅」页新增各渠道封面缩略图，让不同来源的封面能并排比对，
不用等整理落盘后才发现选错了图；并配套一套可管理的本地缓存。
无破坏性变更，Docker 与 Windows 桌面版均可平滑升级。

本次要点

审阅页渠道封面缩略图

原审阅页只列出各渠道的标题与贡献字段，无法判断"哪个源给的封面更好看" —— 往往要等到整理落盘后才发现选错了图。

现在每个有贡献的渠道前面会显示一张该站自己的封面小图，并排比对哪个源更清晰、构图更好。

  • 懒加载：页面滚动到哪才拉哪，不拖慢审阅页打开速度
  • 本地缓存：原图缩到 120px 宽存为 jpg —— 实测 35KB 原图 → 4.3KB 缩略图，同一张图只下载一次
  • 零新增依赖：缩放用的是项目本就有的 Pillow
  • 取不到也不影响：某个源取图失败只显示占位块，刮削与审阅流程照常

缓存管理（设置 → 软件更新 页底部新增「封面缓存」区）

能力 说明
缓存统计 已缓存张数 / 占用空间 / 最早缓存时间 / 目录路径
立即清除 一键清空全部缩略图缓存
自动清理 开关 + 保留天数（默认 7 天，启动时清理超期文件）
缓存目录 可显式指定，留空则自动判定

缓存位置

形态 默认目录
容器（Docker / NAS） /data/.javsp_cache/thumbs
Windows 桌面版 exe 同级 cache/thumbs

容器侧刻意用点开头的隐藏目录 —— /data 是媒体库挂载点，隐藏目录可确保 Jellyfin / Emby / Kodi 默认跳过，不会把缓存混进媒体库索引；该目录随共享持久化，容器重建后缓存仍在。

⚠️ 清理只删缩略图缓存目录内的文件，绝不会删除已整理到媒体库的封面。

新增配置项

写入 config.yml（新增 cache 组）：

cache:
  thumbs_dir: ''      # 留空 = 自动判定
  auto_clean: true
  retention_days: 7

顺带修复

站点数据透传原先只给前端 has_cover 布尔标记，各站封面 URL 根本没传出去 —— 现补上 cover 字段（仅在该站确实有封面时给出）。

安装 / 升级

Docker（推荐，NAS / 服务器）

docker load -i javsp-fork-0.4.6-image.tar.gz
docker restart javsp

容器内版本以 /api/health 返回的 version 为准；界面右下角显示版本号。

Windows 桌面版

  1. 下载 JavSP-0.4.6-windows.zip，解压到任意目录（便携，exe 同级即数据目录）。
  2. 升级已有安装：启动旧版 → 设置页「软件更新」→「立即升级」会自动完成下载、替换并保留 config.yml / .sessions.json / JavSP.log；或直接把新 zip 内容覆盖到旧目录（保留旧 config.yml）。
  3. 首次使用请把自己的 config.yml 放到 exe 同级。

v0.4.5 及更早版本请直接下载本版 zip 手动覆盖一次 —— 那些版本自带的升级助手有缺陷，
从它们点「立即升级」会失败。v0.4.5 起一键升级才真正可用。

校验

下载后可用发布资产 javsp-fork-0.4.6.sha256 核对（含 windows.zip 与 image.tar.gz 两个值）：

sha256sum -c javsp-fork-0.4.6.sha256

回归验证

  • 6 个指定回归用例文件 + 新增缩略图用例共 57/57 通过。
  • 端到端走真实 HTTP 链路：640×960 原图 → 120×180 JPEG（430 字节）、缓存命中不重复下载、
    非法协议返回 404、DELETE 清空后计数归零，全部通过。
  • 真实外网拉取验证：35KB 原图 → 120px 宽 / 4.3KB 缩略图。
  • Windows 桌面版 exe 实跑：/api/health 返回 version=0.4.6、status=ok；
    /api/cache/thumbs 返回 auto_clean=true、retention_days=7、目录落在 exe 同级 cache/thumbs。
  • NAS 部署后 /api/health 返回 version=0.4.6、container=true；前端资产名与构建一致；
    挂载卷 config.yml 未被改动。

附注

  • 本版本 Docker 端仅同步源码（含本次功能），无容器运行时行为变化。
  • 历史 CHANGELOG 中保留的早期部署位置描述（如本机安装目录、网盘共享名）属已发布记录，本次未做破坏性清洗。
  • 完整变更见仓库 CHANGELOG_FORK.md 的 v0.4.6 段。
Assets 2
Loading