Skip to content

armgit / peach

Public Imported from GitHub
0

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

feat(desktop): 人脸模型随安装包分发

longmeidao91d6f1e706ea
diff --git a/Dockerfile b/Dockerfile
index 21e3be127..69abe4f5c 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -22,9 +22,22 @@ RUN apt-get update && apt-get install -y --no-install-recommends ffmpeg openssl
&& rm -rf /var/lib/apt/lists/* \
&& groupadd --gid 1000 peach && useradd --uid 1000 --gid 1000 --create-home peach \
&& mkdir /data && chown peach:peach /data
+# 人脸模型与许可证随镜像分发,地址与哈希同 scripts/fetch_face_models.py,运行时经 PEACH_FACE_MODELS 读取。
+ADD --chmod=a+rX --checksum=sha256:8f2383e4dd3cfbb4553ea8718107fc0423210dc964f9f4280604804ed2552fa4 \
+ https://media.githubusercontent.com/media/opencv/opencv_zoo/48b10fa505aeb51fbd127fc60a5c660040e823b7/models/face_detection_yunet/face_detection_yunet_2023mar.onnx \
+ /app/tools/face-models/face_detection_yunet_2023mar.onnx
+ADD --chmod=a+rX --checksum=sha256:0ba9fbfa01b5270c96627c4ef784da859931e02f04419c829e83484087c34e79 \
+ https://media.githubusercontent.com/media/opencv/opencv_zoo/48b10fa505aeb51fbd127fc60a5c660040e823b7/models/face_recognition_sface/face_recognition_sface_2021dec.onnx \
+ /app/tools/face-models/face_recognition_sface_2021dec.onnx
+ADD --chmod=a+rX --checksum=sha256:c83b8120c50ccbd4c4f96edf53141bdd566ebb8f8e9227e415326aa1b1aba958 \
+ https://raw.githubusercontent.com/opencv/opencv_zoo/48b10fa505aeb51fbd127fc60a5c660040e823b7/models/face_detection_yunet/LICENSE \
+ /app/tools/face-models/LICENSE-yunet.txt
+ADD --chmod=a+rX --checksum=sha256:cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30 \
+ https://raw.githubusercontent.com/opencv/opencv_zoo/48b10fa505aeb51fbd127fc60a5c660040e823b7/models/face_recognition_sface/LICENSE \
+ /app/tools/face-models/LICENSE-sface.txt
COPY --from=build /app/.venv /app/.venv
ENV PATH="/app/.venv/bin:$PATH" PEACH_DATA_ROOT=/data PYTHONUNBUFFERED=1 \
- PYTHONIOENCODING=utf-8 PYTHONUTF8=1
+ PYTHONIOENCODING=utf-8 PYTHONUTF8=1 PEACH_FACE_MODELS=/app/tools/face-models
WORKDIR /data
USER peach
EXPOSE 8900
diff --git a/README.en.md b/README.en.md
index c41ce5883..727a44692 100644
--- a/README.en.md
+++ b/README.en.md
@@ -99,7 +99,7 @@ Test builds are unsigned. If Windows says “Windows protected your PC”, confi
### Build on macOS
-Build a self-contained `.app` and DMG locally on macOS, including FFmpeg, ffprobe, untrunc and cloudflared. Running it requires neither Homebrew, Python, a source checkout, nor another computer. Complete corresponding media tool sources accompany each release. See [the macOS build guide](docs/OPERATIONS.md#macos-独立测试包).
+Build a self-contained `.app` and DMG locally on macOS, including FFmpeg, ffprobe, untrunc, cloudflared and the face detection and recognition models. Running it requires neither Homebrew, Python, a source checkout, nor another computer. Complete corresponding media tool sources accompany each release. See [the macOS build guide](docs/OPERATIONS.md#macos-独立测试包).
The release workflow generates separate Apple Silicon (`macos-arm64.dmg`) and Intel (`macos-x86_64.dmg`) test packages. Check the actual assets in the [website download section](https://peach.video/#download) for availability. Check your chip in About This Mac, open the matching image, and drag Peach into Applications. Test packages are not notarized.
diff --git a/README.md b/README.md
index 938c3d45b..2d1aa25a7 100644
--- a/README.md
+++ b/README.md
@@ -99,7 +99,7 @@ https://github.com/user-attachments/assets/a5610874-e611-41bb-be22-7d99f0d64b62
### macOS 本机构建
-macOS 可在本机构建独立 `.app` 与 DMG,内含 FFmpeg、ffprobe、untrunc 和 cloudflared,安装后不需要 Homebrew、Python、源码或另一台电脑。媒体工具的完整对应源码随同版本制品提供。构建与安装见 [macOS 独立测试包](docs/OPERATIONS.md#macos-独立测试包)。
+macOS 可在本机构建独立 `.app` 与 DMG,内含 FFmpeg、ffprobe、untrunc、cloudflared 和人脸检出与比对模型,安装后不需要 Homebrew、Python、源码或另一台电脑。媒体工具的完整对应源码随同版本制品提供。构建与安装见 [macOS 独立测试包](docs/OPERATIONS.md#macos-独立测试包)。
发版流程分别生成 Apple Silicon(`macos-arm64.dmg`)与 Intel(`macos-x86_64.dmg`)测试包;可下载版本以[官网下载区](https://peach.video/#download)的实际资产为准。在「关于本机」确认芯片,打开对应镜像并将 Peach 拖入「应用程序」。测试包未完成 Apple 公证。
diff --git a/docs/DOCKER.md b/docs/DOCKER.md
index 94f0006f4..dd4b29764 100644
--- a/docs/DOCKER.md
+++ b/docs/DOCKER.md
@@ -68,6 +68,8 @@ local = '/media'
Linux 首次重编码时会探测实际可用的硬件编码器,整片 MP4 与 HLS 分片共享探测结果。AMD / Intel 使用 VAAPI;存在 NVIDIA 设备时探测 NVENC。探测失败的后端在当前服务进程内不再尝试,重启服务后重新探测。封装复制不需要硬件探测。
+镜像自带头像取景与比对用的人脸模型(YuNet 为 MIT,SFace 为 Apache-2.0,许可证在同一目录),位于 `/app/tools/face-models`,由 `PEACH_FACE_MODELS` 指向,容器不联网也能用。构建镜像时按固定地址下载并校验 SHA-256。
+
镜像包含 Debian FFmpeg、Mesa VAAPI 驱动与 `vainfo`。AMD 宿主机需加载 `amdgpu` 和对应固件,并提供 `/dev/dri/renderD*`。Intel 需在自定义镜像内安装适配设备的 VAAPI 驱动;Mesa 驱动不代表已覆盖全部 Intel GPU。将下面的条目合入 Compose 的 `services.peach`,设备路径按宿主机调整:
```yaml
diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md
index ffdb70a18..fbc272007 100644
--- a/docs/OPERATIONS.md
+++ b/docs/OPERATIONS.md
@@ -45,7 +45,7 @@ export PATH="$PWD/build/macos-media-toolchain/env/bin:$PATH"
产物在 `dist/macos.noindex/<架构>/`,构建副本避开 Spotlight 索引;日常使用只保留 Applications 里的应用,测试结束卸载已挂载的安装镜像。Apple Silicon 使用 `arm64`,Intel 使用 `x86_64`;分别用对应架构的 Python 与依赖构建。`--target-arch` 显式指定目标,解释器架构不匹配会停止,两个包不混合原生扩展,也不直接合并成 universal2。Intel 构建可在 Intel Mac 或 Rosetta 下的 x86_64 Python 环境完成;Rosetta 验收不能代替 Intel 真机和较旧 macOS 的验收。
-随包工具与许可证位于 `Contents/Resources/tools/ffmpeg/bin`、`Contents/Resources/tools/untrunc`,cloudflared 位于 `Contents/MacOS`。工具先独立签名,再签整个应用,资源目录允许同时保存工具清单和说明。它们不依赖 Homebrew;FFmpeg、x264、dav1d 和修复用 FFmpeg 库静态链接,动态依赖仅允许 macOS 系统库。`scripts/smoke_macos_media.py` 在系统 PATH 下使用合成 H.264/AAC 与 AV1 样片验证工具查找、探测、抽帧、转码、缺 `moov` 修复和完整解码。该修复验收覆盖同编码参照样片,不代表任意损坏媒体都能恢复。
+随包工具与许可证位于 `Contents/Resources/tools/ffmpeg/bin`、`Contents/Resources/tools/untrunc`,人脸检出与比对模型位于 `Contents/Resources/tools/face-models`,cloudflared 位于 `Contents/MacOS`。构建时 `scripts/fetch_face_models.py` 按固定提交下载两个模型与许可证并逐个校验 SHA-256,缓存在 `build/face-models`。工具先独立签名,再签整个应用,资源目录允许同时保存工具清单和说明。它们不依赖 Homebrew;FFmpeg、x264、dav1d 和修复用 FFmpeg 库静态链接,动态依赖仅允许 macOS 系统库。`scripts/smoke_macos_media.py` 在系统 PATH 下使用合成 H.264/AAC 与 AV1 样片验证工具查找、探测、抽帧、转码、缺 `moov` 修复和完整解码。该修复验收覆盖同编码参照样片,不代表任意损坏媒体都能恢复。
每种架构同时生成 `ffmpeg-macos-<架构>-corresponding-source.zip` 与 `untrunc-macos-<架构>-corresponding-source.zip`,必须与 DMG 同版本发布;归档包含完整上游源码、固定哈希、许可证、构建脚本、配置和环境记录。构建拒绝缺失、哈希不符、架构不符或依赖开发机动态库的工具。cloudflared 固定官方 2026.9.0,归档 SHA-256 采用 GitHub Release 资产 API 的 `digest`,来源登记在 `scripts/cloudflared-macos.json`;发布正文的旧校验值不作为这两个 macOS 归档的锁。
@@ -417,6 +417,8 @@ Peach 按下面的顺序找 FFmpeg 和 ffprobe:
untrunc 按相同顺序查找,对应目录为 `tools/untrunc`。独立程序优先使用随包验证的版本;环境变量仍可显式指定工具路径。
+人脸检出(YuNet)与比对(SFace)模型随 Windows 完整安装包、完整免安装 ZIP、macOS 应用和 Docker 镜像分发,离线即可用。Peach 先读 `PEACH_FACE_MODELS` 指向的目录(Docker 镜像设为 `/app/tools/face-models`),再读独立程序的 `tools/face-models`,两处都按 SHA-256 校验;不在或校验不符时改用数据目录 `tools/yunet`、`tools/sface` 里的那份,再没有才联网下载。随包那份不会复制到数据目录。轻量安装包和应用更新包不带模型,由安装器或更新器按需下载 `tools-face-models.zip`。
+
播放时:
- 浏览器不支持的 AVI、MKV 等格式,Peach 会转成兼容的 MP4 缓存起来再播放,**不会改动原始文件**。第一次播放前会先探测文件,最长 20 秒。
diff --git a/docs/REUSE.md b/docs/REUSE.md
index f73ab1295..242b2ed12 100644
--- a/docs/REUSE.md
+++ b/docs/REUSE.md
@@ -403,7 +403,7 @@ OneJAV、Free JAV Torrent 只给种子链接。这类条目经索引器同源的
- `job_recovery` 保存馆藏处理范围、阶段、指定影片、时间轴密度、单部封面、关注、订阅和想要资料的请求;服务启动或安装结束后只领取未完成记录。暂停任务复用任务中心的同一行,已完成、失败和主动停止的任务不循环重试。馆藏预览在产物登记后保存影片检查点,元数据检查点跟随候选 CSV 成功落盘;未取得结果的项目不记完成。时间轴复用已有索引判定。恢复领取和新任务起跑共用安装闸门,数据仍留在本机 state 目录,不引入 ledger 迁移。
- 自动更新设置用 APScheduler(见「必须复用」表的定时轮询)、共享 HTTPX 发行查询、filelock 与原子 JSON 写入,安装走 `standalone_update`。按 [interval trigger](https://apscheduler.readthedocs.io/en/3.x/modules/triggers/interval.html) 每分钟查是否到期,本机持久时间与文件锁协调多个服务;关闭、6/24/168 小时间隔与源码下载限制归 Peach。默认关闭,下载只准备安装,重启仍需确认;设置存 state 目录的 `automatic-updates.json`。
-- 版本与资产信息用 [GitHub Releases REST API](https://docs.github.com/en/rest/releases/assets)(测试通道含预发布),查询与流式下载用项目 HTTPX,ZIP 解压用标准库,互斥用 FileLock。只有已上传完整独立包的发布才进更新,优先选择 `*-update.zip`,历史完整 ZIP 保留原名供旧客户端更新。`package_windows_release.py` 从同一构建目录生成完整包、应用更新包与 FFmpeg、untrunc、cloudflared 工具包;更新包内清单固定工具文件哈希、工具包大小与 SHA-256,运行时只复用校验相符的文件,按需下载不符的工具。工具包路径限于对应工具目录,补齐后再次校验并沿用同卷暂存与目录回滚。复用已有 HTTPX、hashlib、zipfile、copy2,无新增依赖;不引入 Velopack 的包格式或二进制差分机制。隔离回归用实际生成的 ZIP 验证工具复用、独立补下载与失败保留现有安装,不使用真实 ledger。
+- 版本与资产信息用 [GitHub Releases REST API](https://docs.github.com/en/rest/releases/assets)(测试通道含预发布),查询与流式下载用项目 HTTPX,ZIP 解压用标准库,互斥用 FileLock。只有已上传完整独立包的发布才进更新,优先选择 `*-update.zip`,历史完整 ZIP 保留原名供旧客户端更新。`package_windows_release.py` 从同一构建目录生成完整包、应用更新包与 FFmpeg、untrunc、cloudflared、人脸模型(`face-models`)工具包;更新包内清单固定工具文件哈希、工具包大小与 SHA-256,运行时只复用校验相符的文件,按需下载不符的工具。清单可以多出本版不认得的工具,读取时只留本版认得的那些,认得的一个都不能少;新增工具包由该工具自己的运行时兜底补齐,不让旧版更新器拒收整个更新包。工具包路径限于对应工具目录,补齐后再次校验并沿用同卷暂存与目录回滚。复用已有 HTTPX、hashlib、zipfile、copy2,无新增依赖;不引入 Velopack 的包格式或二进制差分机制。隔离回归用实际生成的 ZIP 验证工具复用、独立补下载与失败保留现有安装,不使用真实 ledger。
- 安装策略与进度归 Peach:下载校验后在程序同卷暂存,用户确认重启,复制出来的包内助手等原托盘退出再切换完整目录;失败保留或恢复旧目录。配置、数据库与媒体不进更新包。
- 轻量安装包复用应用更新包的工具清单、`standalone_update.prepare_tools` 与既有 HTTPX、hashlib、zipfile。Inno Setup 6.7.3 用 [external 文件](https://jrsoftware.org/ishelp/topic_filessection.htm)安装临时目录中已验证的工具,用[滚动进度页](https://jrsoftware.org/ishelp/topic_isxfunc_createoutputmarqueeprogresspage.htm)显示准备状态;官方 API 已于 2026-10-17 核对。工具先在预检目录准备,成功后才暂停任务并覆盖安装;安装包旁的工具 ZIP 同样按清单校验,不读取馆藏配置或增加依赖。不引入另一套下载器或更新框架,校验及解压路径与在线更新共用。
- 不用 [Velopack](https://docs.velopack.io/packaging/operating-systems/windows)(要求其安装目录与包格式)与 [WinSparkle](https://winsparkle.org/)(要求 appcast 与原生更新界面):产物是 PyInstaller ZIP、进度在 Web 显示,沿用托盘进程与目录替换协议。
@@ -714,8 +714,8 @@ A 盘垃圾隔离使用短名称 `peach-purge-<32 位 UUID>.peach-quarantine`,
| Windows 托盘恢复 | Windows 自带 `OpenProcess`、`GetProcessTimes`、[`WaitForSingleObject`](https://learn.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-waitforsingleobject)、`GetExitCodeProcess`;Python 3.12+ 标准库 `ctypes` / `subprocess`,无新增依赖或分发体积 | `tray_lifecycle` 保留明确退出意图、创建时间校验、3 次 / 5 分钟预算与重启交接。pystray 0.19.5 的 `_message_handlers` 接收 `WM_STOP` / `WM_ENDSESSION`,已核对安装包源码;Windows 临时进程实验证明强制退出能恢复,明确退出不会恢复。原生 API 随受支持的 Windows 维护;pystray 使用项目固定版本。不采用 Task Scheduler `RestartOnFailure`:它只管理任务启动的实例,桌面快捷方式与现有重启脚本不归其管理;不新增 psutil 运行时依赖,进程句柄已覆盖等待与退出码。已知边界是监视器随整棵进程树被终止时不能恢复。 |
| macOS 菜单栏 | `pyobjc-framework-Cocoa==12.2.2`(MIT)提供 AppKit / PyObjCTools / objc | 附件应用策略、18 pt template 图、服务归属与菜单动作 |
| macOS 拖放安装镜像 | [dmgbuild 1.6.7](https://github.com/dmgbuild/dmgbuild)(MIT,Python ≥3.10,macOS)直接写 Finder 元数据;仅安装于 `build` extra。纯 Python wheel 约 35 KB,依赖 `ds-store`、`mac-alias`;固定传递版本见 `uv.lock` | 已读取固定版的文件复制、背景多分辨率合成与图标布局实现;背景渲染复用 resvg-py 0.5.0,无运行时新增依赖。Peach 提供 640×420 拖放布局、双分辨率背景和应用内许可证;[APFS 设置](https://dmgbuild.readthedocs.io/en/latest/settings.html#filesystem)保留签名资源的 Unicode 文件名。单元验证配置与图片尺寸,macOS 原生回归与发布验收实际挂载镜像,检查严格签名、资源字节及软链。磁盘镜像创建依赖 macOS 的 hdiutil;无需 Finder 自动化权限,挂载或文件系统失败会终止构建 |
-| 人脸取景 | `opencv-python-headless==5.0.0.93`(Apache-2.0)的 `cv2.FaceDetectorYN` + opencv_zoo 定版模型 `face_detection_yunet_2023mar.onnx`(sha256 `8f2383e4…52fa4`,232 KB,放 `peach-data/tools/yunet/`,不进 Git);MetaTube SDK `6a5e6128c725187aeaf921d48ed7d9cd9f30671b` 的主脸聚类只作算法参考 | 头像/封面离线脚本共用 `peach.face_detect`(主脸、归一化焦点与 sidecar)。`detect` 按长边 320/640/1280 各检一次、分数取中位数;`main_face` 先筛掉分数落后最好那张 0.1 以上的框,再取最大。不用 Haar 级联(OpenCV 5 wheel 里没有、检出率低)与 Pigo v1.4.6(有无脸误报)。[实测](SOURCING.md#人脸与水印实测) |
-| 人脸比对 | 同一 OpenCV 的 `cv2.FaceRecognizerSF` + opencv_zoo 定版模型 `face_recognition_sface_2021dec.onnx`(sha256 `0ba9fbfa…34e79`,与 LFS 指针的 oid 一致,37 MB,放 `peach-data/tools/sface/`,不进 Git) | `peach.face_match` 提特征、算余弦,阈值用 SFace 官方的 0.363;补头像后继拿图库候选与单人封面截到的脸比(ADR-0056),小脸先放大再检(ADR-0070)。检脸用 `peach.face_detect`,取模型走同一条 `fetch_model`。不引 `face_recognition`/dlib(要编译、体积大)与 InsightFace(模型限非商用、需 onnxruntime)。[实测](SOURCING.md#人脸与水印实测) |
+| 人脸取景 | `opencv-python-headless==5.0.0.93`(Apache-2.0)的 `cv2.FaceDetectorYN` + opencv_zoo 定版模型 `face_detection_yunet_2023mar.onnx`(MIT,opencv_zoo 提交 `48b10fa5`,sha256 `8f2383e4…52fa4`,232 KB,随安装包放 `tools/face-models/`,没带时放 `peach-data/tools/yunet/`,不进 Git);MetaTube SDK `6a5e6128c725187aeaf921d48ed7d9cd9f30671b` 的主脸聚类只作算法参考 | 头像/封面离线脚本共用 `peach.face_detect`(主脸、归一化焦点与 sidecar)。`detect` 按长边 320/640/1280 各检一次、分数取中位数;`main_face` 先筛掉分数落后最好那张 0.1 以上的框,再取最大。不用 Haar 级联(OpenCV 5 wheel 里没有、检出率低)与 Pigo v1.4.6(有无脸误报)。[实测](SOURCING.md#人脸与水印实测) |
+| 人脸比对 | 同一 OpenCV 的 `cv2.FaceRecognizerSF` + opencv_zoo 定版模型 `face_recognition_sface_2021dec.onnx`(Apache-2.0,同一提交,sha256 `0ba9fbfa…34e79`,与 LFS 指针的 oid 一致,37 MB,随安装包放 `tools/face-models/`,没带时放 `peach-data/tools/sface/`,不进 Git) | `peach.face_match` 提特征、算余弦,阈值用 SFace 官方的 0.363;补头像后继拿图库候选与单人封面截到的脸比(ADR-0056),小脸先放大再检(ADR-0070)。检脸用 `peach.face_detect`,取模型先认随包那份(`bundled_model`,校验 SHA-256,进程内按文件大小与修改时间缓存结论),再走同一条 `fetch_model`;随包文件由 `scripts/fetch_face_models.py` 取齐并附两个目录的 LICENSE,Docker 镜像用 `ADD --checksum` 取同一组文件。不引 `face_recognition`/dlib(要编译、体积大)与 InsightFace(模型限非商用、需 onnxruntime)。[实测](SOURCING.md#人脸与水印实测) |
| 头像水印检出 | 同一 OpenCV 的 `cv2.dnn.TextDetectionModel_DB` + opencv_zoo 定版模型 `text_detection_en_ppocrv3_2023may.onnx`(sha256 `03f550c6…66587`,2.4 MB,放 `peach-data/tools/ppocr/`,不进 Git) | `peach.avatar_watermark` 检出,`scripts/scrub_avatar_watermarks.py` 复核与移除。不用 MSER 自写启发式(抓不到半透明水印)。`MIN_SCORE` 0.9、框宽占图宽 ≥ 4%、框整体落在距边 15% 带内;半透明水印给不出框,所以检出只是候选,人看标注图确认、漏的自己补框。移除优先裁边、不 inpaint。[实测](SOURCING.md#人脸与水印实测) |
| 正封取景 | 同一 OpenCV 的 `cv2.Sobel` 求列向梯度;NeoAVDC `c7a430c64013c97a0213cd8a57e2ff5696793a86`(MIT)与 sakuramediabe `9c6a31915c9a364c9d6717798575daf9445916bd`(GPL-3.0,只作算法边界参考)的封套几何实测值 | `peach.jav_poster_crop` 给出正封取景框(折痕列到右下角、满高),`scripts/poster_crop_boxes.py` 批量写边车,产物是坐标不是图片。折痕判据见 `peach-jav-cover-workflow`,外部参照、实测与手工框规则见 [取证](SOURCING.md#正封取景实测) |
| 115 文件清单 | `p115client==0.0.9.6.5.1`(MIT) | 只在显式 SHA-1 对账脚本中安装,Peach 负责 ledger 事务、备份与写入门槛 |
@@ -859,7 +859,7 @@ Python 源文件纳入 `src/peach/library_sharing.py` 与 `src/peach/library_pro
任务中心复用 `CodeBlock` 展示可复制的 JSON 技术详情。`task_results.result_counts` 将链接检查、资源扫描、追更、订阅、来源查找及浏览记录分析的明细折算为领域数量,供后台结算与读取投影共用;读取投影只补同一轮已结束的恢复检查点,不写 ledger。想要资料任务按作品保存未完整取得的结果,续跑时逐项更新数量。页面保留失败、访问失败、未能清理等结果,有问题的完成任务显示“发现问题”并独立展示;摘要里的能力缺失标记(`face_match_unavailable`,人脸模型取不到时退回旧判据的那一轮)同样算问题。原始任务执行状态仍由任务服务维护。未新增依赖。
-人脸模型(YuNet、SFace)是全进程共用的一次性能力。`face_detect.fetch_model` 每次联网取模型的结果经 `face_detect.observer` 报给 `face_models.Reporter`,它只按转变写 `face-models` 任务记录:从能用到取不到一条失败,取回来一条成功,同一次失败反复撞上只留一条。任务卡只记历史;活动中心页顶「需要处理」读 `face_models.status(contract.task_runs)`:只查最新一条记录和两个模型文件在不在,不联网,返回 `state`(`ready`/`missing`/`failed`/`downloading`)、失败时刻与原因、对应任务卡的 `run_id` 和 `retry_url`。那一行的「立即重试」调 `POST /api/face-models`,走普通 `BackgroundJob`;取到后 `face_detect.downloads` 加一,常驻的 `avatar_face.FaceProbe` 据此提前结束重试窗口。未新增依赖。
+人脸模型(YuNet、SFace)是全进程共用的一次性能力。`face_detect.fetch_model` 每次联网取模型的结果经 `face_detect.observer` 报给 `face_models.Reporter`,它只按转变写 `face-models` 任务记录:从能用到取不到一条失败,取回来一条成功,同一次失败反复撞上只留一条。任务卡只记历史;活动中心页顶「需要处理」读 `face_models.status(contract.task_runs)`:只查最新一条记录和两个模型在不在(随包那份校验通过,或数据目录里有文件),不联网,返回 `state`(`ready`/`missing`/`failed`/`downloading`)、失败时刻与原因、对应任务卡的 `run_id` 和 `retry_url`。那一行的「立即重试」调 `POST /api/face-models`,走普通 `BackgroundJob`;取到后 `face_detect.downloads` 加一,常驻的 `avatar_face.FaceProbe` 据此提前结束重试窗口。未新增依赖。
普通 Toast 与扫描任务卡共用 Agent Progress 外框,16px 半径由通知栈内的既有 token 解析,细边框与接触阴影分别复用 `border-button-default`、`elevation-xs`,不改变内容排版。浏览器回归核对桌面、手机和明暗主题下的外框一致性,并以同一任务、同一内容回放外框基线生成对比图。
diff --git a/docs/TESTING_DESKTOP.md b/docs/TESTING_DESKTOP.md
index 07611be71..f45b9e8f5 100644
--- a/docs/TESTING_DESKTOP.md
+++ b/docs/TESTING_DESKTOP.md
@@ -56,6 +56,8 @@ Windows 第一次询问防火墙权限时,只勾选「专用网络」。
完整安装包和完整免安装 ZIP 均包含 FFmpeg 与 ffprobe,位于程序目录的 `tools\ffmpeg\bin`;轻量安装包会在安装时备齐工具。转码、媒体信息探测与缩略图无需额外配置。`*-update.zip` 由 Peach 更新器校验和安装,不提供手动导入入口;首次安装使用任一安装包或完整免安装包。`tools-*.zip` 由更新器或轻量安装包按需处理。
+完整安装包和完整免安装 ZIP 还包含头像取景与比对用的人脸模型,位于 `tools\face-models`,连同两个模型的许可证(YuNet 为 MIT,SFace 为 Apache-2.0);没有网络也能用。这份模型被删除、被安全软件隔离或校验不符时,Peach 会改为联网下载到数据目录,失败时在活动中心「需要处理」里提示并可立即重试。
+
缺索引 MP4 修复使用随包的 `tools\untrunc\untrunc.exe`,需要同编码参数的完整片作为参照。该工具与其兼容的 FFmpeg 库独立构建,按 GPL-2.0-or-later 分发;完整对应源码制品为同一 Release 中的 `untrunc-corresponding-source.zip`。显式 `PEACH_UNTRUNC` 优先于随包工具,其后查数据目录与 PATH。
工具以独立进程调用,按 GPL-3.0-or-later 分发;工具目录包含许可证、构建配置、来源清单和 SHA-256。完整对应源码制品 `ffmpeg-corresponding-source.zip` 与应用放在同一个 Release,包含 FFmpeg、x264、nv-codec-headers 的固定源码和构建脚本。发行构建会校验工具及对应源码,任何一项缺失或哈希不符都停止打包。
diff --git a/scripts/build_macos_standalone.py b/scripts/build_macos_standalone.py
index a43f410e3..528ce0049 100644
--- a/scripts/build_macos_standalone.py
+++ b/scripts/build_macos_standalone.py
@@ -82,6 +82,7 @@ def build(destination: Path, *, dmg: bool = True, target_arch: str | None = None
from media_tool_bundle import validate
from build_macos_media import audit_binary
from fetch_cloudflared_macos import validate as validate_cloudflared
+ from fetch_face_models import install as install_face_models
media_root = ROOT / "build/media-macos" / architecture
sources = []
@@ -92,10 +93,14 @@ def build(destination: Path, *, dmg: bool = True, target_arch: str | None = None
audit_binary(media_root / tool / tool / name, architecture)
cloudflared = media_root / "cloudflared"
validate_cloudflared(cloudflared, architecture)
+ work = ROOT / "build" / "macos-standalone" / architecture
+ # 人脸模型在 PyInstaller 之前取齐并校验,网络不通时尽早失败。
+ face_models = work / "face-models"
+ shutil.rmtree(face_models, ignore_errors=True)
+ install_face_models(face_models)
build_frontend_bundles()
destination = destination.resolve()
- work = ROOT / "build" / "macos-standalone" / architecture
work.mkdir(parents=True, exist_ok=True)
commit = subprocess.run(["git", "-C", str(ROOT), "rev-parse", "HEAD"],
capture_output=True, text=True, encoding="utf-8", check=True).stdout.strip()
@@ -118,6 +123,7 @@ def build(destination: Path, *, dmg: bool = True, target_arch: str | None = None
tools.mkdir(exist_ok=True)
for tool in ("ffmpeg", "untrunc"):
shutil.copytree(media_root / tool / tool, tools / tool)
+ shutil.copytree(face_models, tools / "face-models")
shutil.copyfile(cloudflared / "cloudflared", app / "Contents/MacOS/cloudflared")
(app / "Contents/MacOS/cloudflared").chmod(0o755)
for name in ("LICENSE-cloudflared.txt", "NOTICE-cloudflared.md"):
diff --git a/scripts/build_windows.ps1 b/scripts/build_windows.ps1
index 7a08200a7..691836dd2 100644
--- a/scripts/build_windows.ps1
+++ b/scripts/build_windows.ps1
@@ -109,6 +109,13 @@ if ($Standalone) {
if ($LASTEXITCODE -ne 0) {
throw 'Standalone build requires verified untrunc and corresponding source. Run scripts/build_untrunc_windows.sh first or pass -UntruncPath.'
}
+ # 人脸模型在 PyInstaller 之前取齐并校验,网络不通时尽早失败;缓存在 build\face-models。
+ $FaceModelsStage = Join-Path $BuildPath 'face-models'
+ if (Test-Path -LiteralPath $FaceModelsStage) { Remove-Item -LiteralPath $FaceModelsStage -Recurse -Force }
+ & $Python -X utf8 (Join-Path $PSScriptRoot 'fetch_face_models.py') --destination $FaceModelsStage
+ if ($LASTEXITCODE -ne 0) {
+ throw 'Standalone build requires verified face models. Check access to media.githubusercontent.com or fill build\face-models.'
+ }
$CloudflaredCandidates = @()
if ($CloudflaredPath) { $CloudflaredCandidates += $CloudflaredPath }
if ($env:PEACH_CLOUDFLARED_BUILD) { $CloudflaredCandidates += $env:PEACH_CLOUDFLARED_BUILD }
@@ -167,6 +174,12 @@ if ($Standalone) {
if (Test-Path -LiteralPath $PackagedUntrunc) { Remove-Item -LiteralPath $PackagedUntrunc -Recurse -Force }
& $Python -X utf8 (Join-Path $PSScriptRoot 'media_tool_bundle.py') --tool untrunc --source $UntruncPath --destination $PackagedUntrunc
if ($LASTEXITCODE -ne 0) { throw 'untrunc packaging failed.' }
+ $PackagedFaceModels = [IO.Path]::GetFullPath((Join-Path $OutputPath 'tools\face-models'))
+ if (-not $PackagedFaceModels.StartsWith($OutputPath.TrimEnd('\') + '\', [StringComparison]::OrdinalIgnoreCase)) {
+ throw 'Face model packaging destination must stay inside the application output directory.'
+ }
+ if (Test-Path -LiteralPath $PackagedFaceModels) { Remove-Item -LiteralPath $PackagedFaceModels -Recurse -Force }
+ Copy-Item -LiteralPath $FaceModelsStage -Destination $PackagedFaceModels -Recurse
}
# 工作目录只服务这一次构建:`--clean` 已让下一次不复用它,留着只是几十 MB 的中间产物。
diff --git a/scripts/fetch_face_models.py b/scripts/fetch_face_models.py
new file mode 100644
index 000000000..4f3be156d
--- /dev/null
+++ b/scripts/fetch_face_models.py
@@ -0,0 +1,95 @@
+"""取 YuNet 与 SFace 两个人脸模型及其许可证,逐个校验 SHA-256 后放进发行包的模型目录。
+
+Windows 构建放进程序目录的 `tools/face-models`,macOS 放 `Peach.app/Contents/Resources/tools/face-models`,
+运行时由 `peach.face_detect.bundled_model` 认这一份;Docker 镜像在 Dockerfile 里按同一组地址与哈希取。
+下载先落到缓存目录,缓存里哈希对得上的文件不再联网。
+"""
+from __future__ import annotations
+
+import argparse
+import hashlib
+import json
+from pathlib import Path
+import shutil
+import sys
+
+ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT / "src"))
+from peach import face_detect, face_match
+from peach.peach_proxy import read_url
+from peach.user_agent import USER_AGENT
+
+CACHE = ROOT / "build" / "face-models"
+SOURCE = "https://github.com/opencv/opencv_zoo"
+LICENSE_BASE = f"https://raw.githubusercontent.com/opencv/opencv_zoo/{face_detect.ZOO_COMMIT}/models/"
+#: (随包文件名, 地址, SHA-256)。许可证按 opencv_zoo 各模型目录的 LICENSE 与 README 核实:
+#: `face_detection_yunet` 为 MIT(Copyright (c) 2020 Shiqi Yu),`face_recognition_sface` 为
+#: Apache-2.0;两个目录都没有 NOTICE 文件。
+FILES = (
+ (face_detect.MODEL_PATH.name, face_detect.MODEL_URL, face_detect.MODEL_SHA256),
+ (face_match.MODEL_PATH.name, face_match.MODEL_URL, face_match.MODEL_SHA256),
+ ("LICENSE-yunet.txt", LICENSE_BASE + "face_detection_yunet/LICENSE",
+ "c83b8120c50ccbd4c4f96edf53141bdd566ebb8f8e9227e415326aa1b1aba958"),
+ ("LICENSE-sface.txt", LICENSE_BASE + "face_recognition_sface/LICENSE",
+ "cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30"),
+)
+#: 模型文件名 → (许可证, 许可文件)。
+LICENSES = {
+ face_detect.MODEL_PATH.name: ("MIT", "LICENSE-yunet.txt"),
+ face_match.MODEL_PATH.name: ("Apache-2.0", "LICENSE-sface.txt"),
+}
+
+
+def digest(path: Path) -> str:
+ with path.open("rb") as stream:
+ return hashlib.file_digest(stream, "sha256").hexdigest()
+
+
+def download(url: str) -> bytes:
+ return read_url(url, headers={"User-Agent": USER_AGENT}, timeout=300)
+
+
+def manifest() -> str:
+ """模型目录里的 `manifest.json`:来源提交、地址、哈希与许可证。内容固定,工具包哈希可复现。"""
+ models = [{"file": name, "url": url, "sha256": sha256,
+ "license": LICENSES[name][0], "license_file": LICENSES[name][1]}
+ for name, url, sha256 in FILES if name in LICENSES]
+ return json.dumps({"source": SOURCE, "commit": face_detect.ZOO_COMMIT, "models": models},
+ ensure_ascii=False, indent=2, sort_keys=True) + "\n"
+
+
+def install(destination: Path, *, cache: Path = CACHE, fetch=download) -> list[Path]:
+ """把四个文件与清单写进 `destination`;任何一个哈希对不上都不落盘并报错。"""
+ cache.mkdir(parents=True, exist_ok=True)
+ destination.mkdir(parents=True, exist_ok=True)
+ written = []
+ for name, url, sha256 in FILES:
+ cached = cache / name
+ if not (cached.is_file() and digest(cached) == sha256):
+ payload = fetch(url)
+ actual = hashlib.sha256(payload).hexdigest()
+ if actual != sha256:
+ raise ValueError(f"{name} 的 SHA-256 不符:期望 {sha256},实际 {actual}")
+ temporary = cached.with_name(cached.name + ".part")
+ temporary.write_bytes(payload)
+ temporary.replace(cached)
+ shutil.copyfile(cached, destination / name)
+ written.append(destination / name)
+ (destination / "manifest.json").write_bytes(manifest().encode("utf-8"))
+ written.append(destination / "manifest.json")
+ return written
+
+
+def main() -> int:
+ parser = argparse.ArgumentParser(description=__doc__)
+ parser.add_argument("--destination", type=Path, required=True)
+ parser.add_argument("--cache", type=Path, default=CACHE)
+ args = parser.parse_args()
+ written = install(args.destination.resolve(), cache=args.cache.resolve())
+ print(json.dumps({"destination": str(args.destination.resolve()), "files": [path.name for path in written]},
+ ensure_ascii=False))
+ return 0
+
+
+if __name__ == "__main__":
+ raise SystemExit(main())
diff --git a/scripts/package_windows_release.py b/scripts/package_windows_release.py
index f7f77e08d..3b78567f2 100644
--- a/scripts/package_windows_release.py
+++ b/scripts/package_windows_release.py
@@ -43,7 +43,8 @@ def download_notes(version: str, *, lite_installer: bool = False,
f"| [完整免安装包(ZIP)]({base}.zip) | 包含全部工具,解压后运行 `Peach.exe` |\n"
f"| [应用更新包(update.zip)]({base}-update.zip) | 不含工具,由 Peach 更新器安装,不能单独用于首次安装 |\n"
f"| 工具包(tools-*.zip):[FFmpeg]({base}-tools-ffmpeg.zip) / "
- f"[untrunc]({base}-tools-untrunc.zip) / [cloudflared]({base}-tools-cloudflared.zip) "
+ f"[untrunc]({base}-tools-untrunc.zip) / [cloudflared]({base}-tools-cloudflared.zip) / "
+ f"[人脸模型]({base}-tools-face-models.zip) "
"| 更新器按需下载,普通使用无需手动选择 |\n"
"| `*-corresponding-source.zip` | 第三方工具源码,普通使用无需下载 |\n\n"
"已有 Peach:在「配置 → 应用与维护」检查更新,下载完成后确认重启安装。"
diff --git a/scripts/test_runner.py b/scripts/test_runner.py
index 187d1e415..6bb0c888b 100644
--- a/scripts/test_runner.py
+++ b/scripts/test_runner.py
@@ -122,7 +122,7 @@ SCOPES: dict[str, tuple[str, ...]] = {
"test_copy_final_state.py", "test_demo_dataset.py",
"test_cloudflared_packaging.py", "test_tunnel.py", "test_process_job.py",
"test_ffmpeg_build.py", "test_ffmpeg_bundle.py", "test_untrunc_build.py", "test_macos_media.py",
- "test_media_tool_import.py", "test_seed_corrections.py"),
+ "test_media_tool_import.py", "test_seed_corrections.py", "test_face_models_bundle.py"),
# 前端 island 层(ADR-0022)。产物与源码的断言不需要 Node;vitest 那部分在没有
# npm 时自己跳过,所以这个域在任何机器上都能跑,`full` 也就自动包含它。
# `test_web_perf.py` 两个域都登记:压缩与 ETag 是 API 交付(catalog),
@@ -150,7 +150,8 @@ SCOPES: dict[str, tuple[str, ...]] = {
"packaging": ("test_dependency_policy.py", "test_buildinfo.py", "test_onboarding.py", "test_macos_standalone.py",
"test_cli.py", "test_server.py", "test_versioning.py", "test_frontend_build.py",
"test_cloudflared_packaging.py", "test_desktop_installer.py",
- "test_ffmpeg_build.py", "test_ffmpeg_bundle.py", "test_untrunc_build.py", "test_macos_media.py"),
+ "test_ffmpeg_build.py", "test_ffmpeg_bundle.py", "test_untrunc_build.py", "test_macos_media.py",
+ "test_face_models_bundle.py"),
}
SCOPE_TEST_IDS: dict[str, tuple[str, ...]] = {
@@ -173,6 +174,7 @@ AUTO_SCOPE_FILES: dict[str, tuple[str, ...]] = {
"scripts/setup_macos_media_tools.py": ("tooling", "packaging"),
"scripts/smoke_macos_media.py": ("tooling", "packaging"),
"scripts/fetch_cloudflared_macos.py": ("tooling", "packaging"),
+ "scripts/fetch_face_models.py": ("tooling", "packaging"),
"scripts/cloudflared-macos.json": ("tooling", "packaging"),
"scripts/fetch_ffmpeg_sources.py": ("tooling", "packaging"),
"scripts/ffmpeg-sources.json": ("tooling", "packaging"),
diff --git a/src/peach/face_detect.py b/src/peach/face_detect.py
index c87d70bc4..f9448aacb 100644
--- a/src/peach/face_detect.py
+++ b/src/peach/face_detect.py
@@ -17,12 +17,16 @@ r"""人脸检出:OpenCV 的 YuNet,取代已经跑不起来的 Haar 级联。
丢掉假阳性(`278GYAN-017` 检到画面最左的剧照拼贴,`KAVR-428` 一张图检出 7 个框)。
YuNet 给的是框 + 5 个关键点 + 置信度,可以按分数卡,不必靠位置猜。
-模型不进 Git:它是二进制资产,和 ffmpeg 一样放 `peach-data/tools/`。首次运行按
-固定 URL 取一次并校验 sha256——版本要能复现,不能「取到什么算什么」。
+模型不进 Git:它是二进制资产,和 ffmpeg 一样随安装包分发(`bundled_model`),取用前
+校验 sha256——版本要能复现,不能「取到什么算什么」。随包那份不在或对不上时,退回
+`peach-data/tools/` 里联网取过的那份,再退回按固定 URL 联网取一次。
"""
from __future__ import annotations
import hashlib
+import logging
+import os
+import sys
import httpx
from .peach_proxy import read_url
from dataclasses import dataclass, replace
@@ -30,15 +34,23 @@ from pathlib import Path
from .config import TOOLS_DIR
-#: opencv_zoo 的 YuNet 定版模型。走 media. 域名是因为仓库用 Git LFS,
-#: raw. 域名只会回一个 131 字节的指针文件。
-MODEL_URL = (
- "https://media.githubusercontent.com/media/opencv/opencv_zoo/main/"
- "models/face_detection_yunet/face_detection_yunet_2023mar.onnx"
-)
+LOGGER = logging.getLogger(__name__)
+
+#: opencv_zoo 的定版提交。模型与许可证都按这个提交取,内容不随 main 分支变化。
+ZOO_COMMIT = "48b10fa505aeb51fbd127fc60a5c660040e823b7"
+#: 走 media. 域名是因为仓库用 Git LFS,raw. 域名只会回一个 131 字节的指针文件。
+ZOO_MEDIA = f"https://media.githubusercontent.com/media/opencv/opencv_zoo/{ZOO_COMMIT}/models/"
+
+#: opencv_zoo 的 YuNet 定版模型。
+MODEL_URL = ZOO_MEDIA + "face_detection_yunet/face_detection_yunet_2023mar.onnx"
MODEL_SHA256 = "8f2383e4dd3cfbb4553ea8718107fc0423210dc964f9f4280604804ed2552fa4"
MODEL_PATH = TOOLS_DIR / "yunet" / "face_detection_yunet_2023mar.onnx"
+#: 随包模型目录的环境变量。Docker 镜像经它指到镜像里那份;桌面包不设,读程序目录。
+BUNDLE_ENV = "PEACH_FACE_MODELS"
+#: 桌面包里随包模型所在的工具目录名,与 `update_packages.TOOL_PATHS` 的 `face-models` 同名。
+BUNDLE_TOOL = "face-models"
+
#: 低于这个分数的检出不算数。YuNet 会给出置信度,不必再靠「落在左半边就是假阳性」
#: 这类位置规则去猜——那条规则只在长封套上成立,换个版式就不成立。
DEFAULT_SCORE = 0.6
@@ -154,13 +166,62 @@ def ensure_model(path: Path | None = None, *, allow_download: bool = True) -> Pa
"""返回可用的模型路径;本地没有且允许联网时取一次。
校验 sha256 而不是只看文件在不在:半个下载同样留下一个文件,而它会让
- `FaceDetectorYN_create` 抛一个和网络毫无关系的错。
+ `FaceDetectorYN_create` 抛一个和网络毫无关系的错。没指定 `path` 时先认随包那份。
"""
+ if path is None and (bundled := bundled_model(MODEL_PATH.name, MODEL_SHA256)) is not None:
+ return bundled
target = Path(path) if path is not None else MODEL_PATH
return fetch_model(target, MODEL_URL, MODEL_SHA256,
allow_download=allow_download, label="人脸模型")
+def bundled_dir() -> Path | None:
+ """随包模型所在的目录:环境变量优先,其次是冻结桌面包的程序目录;源码运行没有。"""
+ configured = os.environ.get(BUNDLE_ENV)
+ if configured:
+ return Path(configured).expanduser()
+ if getattr(sys, "frozen", False):
+ from .ffmpeg import bundled_tools_root
+ return bundled_tools_root() / BUNDLE_TOOL
+ return None
+
+
+#: 已核对过的随包模型:路径 → ((期望哈希, 大小, 修改时间), 是否对得上)。活动中心按轮询读
+#: `face_models.status`,37 MB 的 SFace 每次都算一遍哈希太贵;文件没变就沿用这个进程里第一次
+#: 核对的结论,对不上的那份也只警告一次。重装后大小或修改时间变了,结论随之作废。
+_verified: dict[Path, tuple[tuple[str, int, int], bool]] = {}
+
+
+def bundled_model(name: str, sha256: str) -> Path | None:
+ """随包那份模型:在且哈希对得上就返回它,否则返回 None。
+
+ 对不上不删:程序目录常常只读,而且那份文件归安装包管,不归这里。也不往数据根复制,
+ 不碰 `downloads` 与 `observer`——这不是联网取到的。
+ """
+ root = bundled_dir()
+ if root is None:
+ return None
+ path = root / name
+ try:
+ stat = path.stat()
+ except OSError:
+ return None
+ key = (sha256, stat.st_size, stat.st_mtime_ns)
+ cached = _verified.get(path)
+ if cached is not None and cached[0] == key:
+ return path if cached[1] else None
+ try:
+ actual = _digest(path)
+ except OSError:
+ return None
+ _verified[path] = (key, actual == sha256)
+ if actual != sha256:
+ LOGGER.warning("随包的人脸模型校验不符,退回数据目录或联网取:%s(期望 %s,实际 %s)",
+ path, sha256, actual)
+ return None
+ return path
+
+
#: 每联网取到一份模型加一。进程里活得久的探针按它判断「失败之后有没有人把模型取回来了」,
#: 不必等满自己的重试窗口(`avatar_face.FaceProbe`)。
downloads = 0
diff --git a/src/peach/face_match.py b/src/peach/face_match.py
index a7f2bc2fe..ba0d46a32 100644
--- a/src/peach/face_match.py
+++ b/src/peach/face_match.py
@@ -8,8 +8,9 @@ opencv_zoo,走同一个 `cv2` 包:`cv2.FaceRecognizerSF` 先按 YuNet 给的
用它的地方只有一处:补头像后继在图库同名多张时,拿每张候选上的脸和她单人作品封面上
截到的脸比,挑出是她本人的那几张(ADR-0056)。
-模型不进 Git:37 MB 的 ONNX,与 YuNet 一样放 `peach-data/tools/`,首次用到时按固定
-地址取一次、校验 sha256(`face_detect.fetch_model`)。取不到时 `FaceMatcher` 记下原因、
+模型不进 Git:37 MB 的 ONNX,与 YuNet 一样随安装包分发,随包那份不在或对不上时退回
+`peach-data/tools/`,再退回按固定地址联网取一次,都校验 sha256(`face_detect.bundled_model`、
+`face_detect.fetch_model`)。取不到时 `FaceMatcher` 记下原因、
一张都不比,调用方退回不看脸的旧判据——一次下载失败不能变成「装了一张别人的脸」。
"""
from __future__ import annotations
@@ -20,12 +21,8 @@ from . import face_detect
from .config import TOOLS_DIR
from .face_detect import FaceDetector, main_face
-#: opencv_zoo 的 SFace 定版模型。走 media. 域名的原因和 YuNet 一样:仓库用 Git LFS,
-#: raw. 域名只回一个指针文件——那个指针里的 oid 就是下面这个哈希。
-MODEL_URL = (
- "https://media.githubusercontent.com/media/opencv/opencv_zoo/main/"
- "models/face_recognition_sface/face_recognition_sface_2021dec.onnx"
-)
+#: opencv_zoo 的 SFace 定版模型,与 YuNet 同一个定版提交。LFS 指针里的 oid 就是下面这个哈希。
+MODEL_URL = face_detect.ZOO_MEDIA + "face_recognition_sface/face_recognition_sface_2021dec.onnx"
MODEL_SHA256 = "0ba9fbfa01b5270c96627c4ef784da859931e02f04419c829e83484087c34e79"
MODEL_PATH = TOOLS_DIR / "sface" / "face_recognition_sface_2021dec.onnx"
#: 记进头像边车的模型名,回溯时要答得出「这个分是哪一版模型给的」。
@@ -43,6 +40,8 @@ FACE_CROP_SIDE = 480
def ensure_model(path: Path | None = None, *, allow_download: bool = True) -> Path:
+ if path is None and (bundled := face_detect.bundled_model(MODEL_PATH.name, MODEL_SHA256)) is not None:
+ return bundled
target = Path(path) if path is not None else MODEL_PATH
return face_detect.fetch_model(target, MODEL_URL, MODEL_SHA256,
allow_download=allow_download, label="人脸比对模型")
diff --git a/src/peach/face_models.py b/src/peach/face_models.py
index 7d7e807f0..02e8d28e4 100644
--- a/src/peach/face_models.py
+++ b/src/peach/face_models.py
@@ -3,8 +3,8 @@
任务卡只记历史:取不到时留一条失败记录和原因。此刻是否可用由 `status` 回答,活动中心页顶
「需要处理」那一行读它,「立即重试」调 `RETRY_URL`。
-YuNet 与 SFace 两个模型是全进程共用的一次性能力:第一次用到时联网取一次,之后一直用本地
-那份。取不到不让任何一轮任务停下(`avatar_face.FaceProbe`、`face_match.FaceMatcher` 都退回
+YuNet 与 SFace 两个模型是全进程共用的一次性能力:完整安装包、macOS 应用与 Docker 镜像随包
+带着;没带或那份对不上时,第一次用到时联网取一次,之后一直用本地那份。取不到不让任何一轮任务停下(`avatar_face.FaceProbe`、`face_match.FaceMatcher` 都退回
不看脸的旧判据),代价是这件事在界面上没有位置——补头像的后继照样显示跑完了。
这里补的就是那个位置。回报点只有一个:`face_detect.fetch_model` 每次联网取模型的结果经
@@ -74,13 +74,14 @@ RETRY_URL = "/api/face-models"
def status(runs) -> dict:
- """人脸模型此刻的状态,给活动中心页顶「需要处理」那一行读。不联网、不算哈希,读一次就是一条查询。
+ """人脸模型此刻的状态,给活动中心页顶「需要处理」那一行读。不联网,读一次就是一条查询。
判据和任务卡同一个来源:最新那条 `face-models` 记录。`state` 取四个值:
- `downloading`:立即重试那一轮在跑。
- `failed`:最新一条是失败,`failed_at`/`error`/`run_id` 指向那张卡。
- - `ready`:两个模型文件都在本机。哈希留到用的时候由 `fetch_model` 核对。
+ - `ready`:两个模型都在本机,随包那份或数据目录里那份。随包那份按 `bundled_model`
+ 核对哈希,进程里只算一次;数据目录那份的哈希留到用的时候由 `fetch_model` 核对。
- `missing`:还没取过,下次用到时自动去取;这不是问题,不必提示。
详细原因只在任务卡上写,这里的 `error` 供「需要处理」判断与排查,不另起一套说法。
@@ -89,7 +90,8 @@ def status(runs) -> dict:
latest = runs.query(task_key=TASK_KEY, limit=1)
last = latest[0] if latest else None
- present = face_detect.MODEL_PATH.is_file() and face_match.MODEL_PATH.is_file()
+ present = all(face_detect.bundled_model(module.MODEL_PATH.name, module.MODEL_SHA256) is not None
+ or module.MODEL_PATH.is_file() for module in (face_detect, face_match))
if last is not None and last.active:
state = "downloading"
elif last is not None and last.status == "failed":
diff --git a/src/peach/update_packages.py b/src/peach/update_packages.py
index a7ae2c5fe..06c06f9f9 100644
--- a/src/peach/update_packages.py
+++ b/src/peach/update_packages.py
@@ -11,6 +11,8 @@ TOOL_PATHS = {
"ffmpeg": ("tools/ffmpeg", {"bin/ffmpeg.exe", "bin/ffprobe.exe", "manifest.json", "LICENSE.txt", "NOTICE.md", "buildconf.txt"}),
"untrunc": ("tools/untrunc", {"untrunc.exe", "manifest.json", "LICENSE.txt", "NOTICE.md", "buildconf.txt"}),
"cloudflared": ("", {"cloudflared.exe", "cloudflared-manifest.json"}),
+ "face-models": ("tools/face-models", {"face_detection_yunet_2023mar.onnx", "face_recognition_sface_2021dec.onnx",
+ "LICENSE-yunet.txt", "LICENSE-sface.txt", "manifest.json"}),
}
@@ -40,11 +42,17 @@ def matches(root: Path, files: dict[str, str]) -> bool:
def read_manifest(stage: Path, version: str) -> dict:
+ """读更新包的工具清单,只留本版认得的工具。
+
+ 清单可以多出本版不认得的工具:那是更新版本新增的工具包,这一版不下载,装好后由那个
+ 工具自己的运行时兜底补齐。认得的工具一个都不能少。
+ """
manifest = json.loads((stage / MANIFEST).read_text(encoding="utf-8"))
if (not isinstance(manifest, dict) or manifest.get("format") != 1 or manifest.get("version") != version
or not isinstance(manifest.get("tools"), dict)
- or set(manifest.get("tools", {})) != set(TOOL_PATHS)):
+ or not set(TOOL_PATHS) <= set(manifest.get("tools", {}))):
raise ValueError("更新包工具清单无效")
+ manifest["tools"] = {tool: manifest["tools"][tool] for tool in TOOL_PATHS}
all_names: set[str] = set()
for tool, bundle in manifest["tools"].items():
if not isinstance(bundle, dict):
diff --git a/tests/test_face_detect.py b/tests/test_face_detect.py
index 09154b245..78b8d8257 100644
--- a/tests/test_face_detect.py
+++ b/tests/test_face_detect.py
@@ -49,11 +49,83 @@ class EnsureModelTests(unittest.TestCase):
self.assertFalse(target.exists())
def test_the_pinned_digest_is_a_real_sha256(self):
- # 定版是这条复用记录的全部意义:URL 指向 main 分支,内容可能变。
+ # 定版是这条复用记录的全部意义:地址钉在 opencv_zoo 的一个提交上,哈希再核一遍内容。
self.assertEqual(len(MODEL_SHA256), 64)
self.assertTrue(all(ch in "0123456789abcdef" for ch in MODEL_SHA256))
self.assertIn("media.githubusercontent.com", face_detect.MODEL_URL,
"opencv_zoo 用 Git LFS,raw 域名只会回一个指针文件")
+ self.assertIn(face_detect.ZOO_COMMIT, face_detect.MODEL_URL)
+
+
+class BundledModelTests(unittest.TestCase):
+ """随包那份先认:在且哈希对得上就不联网、不往数据根写;对不上就退回原来的取法。"""
+
+ def setUp(self):
+ temporary = tempfile.TemporaryDirectory()
+ self.addCleanup(temporary.cleanup)
+ self.root = Path(temporary.name).resolve()
+ self.bundle = self.root / "program" / "tools" / "face-models"
+ self.bundle.mkdir(parents=True)
+ self.data = self.root / "data" / "yunet" / MODEL_PATH_NAME
+ self.payload = b"bundled-yunet"
+ for patcher in (
+ patch.dict(face_detect.os.environ, {face_detect.BUNDLE_ENV: str(self.bundle)}),
+ patch.object(face_detect, "MODEL_PATH", self.data),
+ patch.object(face_detect, "MODEL_SHA256", hashlib.sha256(self.payload).hexdigest()),
+ patch.object(face_detect, "_verified", {}),
+ patch.object(face_detect, "read_url", side_effect=AssertionError("随包有模型时不该联网"))):
+ patcher.start()
+ self.addCleanup(patcher.stop)
+
+ def test_a_matching_bundled_model_is_used_offline_without_touching_the_data_root(self):
+ (self.bundle / MODEL_PATH_NAME).write_bytes(self.payload)
+ seen = []
+ before = face_detect.downloads
+ with patch.object(face_detect, "observer", lambda *args: seen.append(args)):
+ self.assertEqual(ensure_model(), self.bundle / MODEL_PATH_NAME)
+ self.assertFalse(self.data.exists(), "随包那份不往数据根复制")
+ self.assertEqual((seen, face_detect.downloads), ([], before), "随包命中不是联网取到的")
+
+ def test_a_mismatched_bundled_model_is_kept_and_the_data_root_copy_is_used(self):
+ (self.bundle / MODEL_PATH_NAME).write_bytes(b"tampered")
+ self.data.parent.mkdir(parents=True)
+ self.data.write_bytes(self.payload)
+ with self.assertLogs("peach.face_detect", "WARNING"):
+ self.assertEqual(ensure_model(), self.data)
+ self.assertEqual((self.bundle / MODEL_PATH_NAME).read_bytes(), b"tampered", "程序目录那份归安装包管,不删")
+
+ def test_without_any_copy_the_download_fallback_still_runs(self):
+ with patch.object(face_detect, "read_url", return_value=self.payload) as read:
+ self.assertEqual(ensure_model(), self.data)
+ read.assert_called_once()
+
+ def test_a_verified_bundled_model_is_hashed_once_per_process(self):
+ (self.bundle / MODEL_PATH_NAME).write_bytes(self.payload)
+ with patch.object(face_detect, "_digest", wraps=face_detect._digest) as digest:
+ for _ in range(3):
+ face_detect.bundled_model(MODEL_PATH_NAME, face_detect.MODEL_SHA256)
+ self.assertEqual(digest.call_count, 1)
+
+ def test_a_mismatched_bundled_model_is_hashed_and_reported_once_per_process(self):
+ """活动中心轮询状态时,一份坏掉的随包模型不能每次都重算 37 MB、刷一条警告。"""
+ (self.bundle / MODEL_PATH_NAME).write_bytes(b"tampered")
+ with patch.object(face_detect, "_digest", wraps=face_detect._digest) as digest, \
+ self.assertLogs("peach.face_detect", "WARNING") as logs:
+ for _ in range(3):
+ self.assertIsNone(face_detect.bundled_model(MODEL_PATH_NAME, face_detect.MODEL_SHA256))
+ self.assertEqual((digest.call_count, len(logs.records)), (1, 1))
+
+ def test_the_frozen_desktop_package_reads_its_program_directory(self):
+ program = self.root / "Peach"
+ with patch.dict(face_detect.os.environ, {face_detect.BUNDLE_ENV: ""}), \
+ patch.object(face_detect.sys, "frozen", True, create=True), \
+ patch.object(face_detect.sys, "executable", str(program / "Peach.exe")):
+ self.assertEqual(face_detect.bundled_dir(), program.resolve() / "tools" / "face-models")
+ with patch.dict(face_detect.os.environ, {face_detect.BUNDLE_ENV: ""}):
+ self.assertIsNone(face_detect.bundled_dir(), "源码运行没有随包目录")
+
+
+MODEL_PATH_NAME = face_detect.MODEL_PATH.name
class DetectorContractTests(unittest.TestCase):
diff --git a/tests/test_face_models.py b/tests/test_face_models.py
index a534a23e7..623e0d226 100644
--- a/tests/test_face_models.py
+++ b/tests/test_face_models.py
@@ -197,6 +197,18 @@ class StatusTests(ModelFilesCase):
self.assertEqual((current["state"], current["available"], current["error"]),
("ready", True, ""))
+ def test_models_shipped_with_the_package_are_ready_without_any_download(self):
+ bundle = self.root / "program" / "tools" / "face-models"
+ bundle.mkdir(parents=True)
+ for module in (face_detect, face_match):
+ (bundle / module.MODEL_PATH.name).write_bytes(self.payload)
+ with mock.patch.dict(face_detect.os.environ, {face_detect.BUNDLE_ENV: str(bundle)}), \
+ mock.patch.object(face_detect, "_verified", {}):
+ self.assertEqual(self.status()["state"], "ready")
+ self.retry(side_effect=AssertionError("随包有模型时立即重试也不联网"))
+ self.assertEqual([run.status for run in self.rows()], ["succeeded"])
+ self.assertFalse((self.root / "tools").exists(), "随包那份不往数据根复制")
+
class LabelTests(unittest.TestCase):
def test_every_task_written_by_the_service_has_a_chinese_name(self):
diff --git a/tests/test_face_models_bundle.py b/tests/test_face_models_bundle.py
new file mode 100644
index 000000000..f4a6cf61a
--- /dev/null
+++ b/tests/test_face_models_bundle.py
@@ -0,0 +1,137 @@
+"""人脸模型随安装包分发:取模型的脚本、Docker 镜像的同一组文件,以及完整包到运行时的整条路。
+
+真模型不进测试、不出网:四个文件换成小字节,哈希按它们重算。
+"""
+import hashlib
+import json
+from pathlib import Path
+import re
+import tempfile
+import unittest
+from unittest.mock import patch
+import zipfile
+
+from peach import face_detect, face_match, face_models, update_packages
+from scripts import fetch_face_models
+from scripts.package_windows_release import package as package_release
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def sha(payload: bytes) -> str:
+ return hashlib.sha256(payload).hexdigest()
+
+
+class FixtureCase(unittest.TestCase):
+ """四个文件换成小字节;`FILES` 与两个运行时模块的哈希一起换,脚本与运行时仍是同一组判据。"""
+
+ def setUp(self):
+ temporary = tempfile.TemporaryDirectory()
+ self.addCleanup(temporary.cleanup)
+ self.root = Path(temporary.name).resolve()
+ self.payloads = {name: f"fixture {name}".encode() for name, _, _ in fetch_face_models.FILES}
+ self.urls = {url: name for name, url, _ in fetch_face_models.FILES}
+ files = tuple((name, url, sha(self.payloads[name])) for name, url, _ in fetch_face_models.FILES)
+ for patcher in (
+ patch.object(fetch_face_models, "FILES", files),
+ patch.object(face_detect, "MODEL_SHA256", sha(self.payloads[face_detect.MODEL_PATH.name])),
+ patch.object(face_match, "MODEL_SHA256", sha(self.payloads[face_match.MODEL_PATH.name])),
+ patch.object(face_detect, "_verified", {})):
+ patcher.start()
+ self.addCleanup(patcher.stop)
+ self.fetched = []
+
+ def fetch(self, url: str) -> bytes:
+ self.fetched.append(url)
+ return self.payloads[self.urls[url]]
+
+
+class FetchScriptTests(FixtureCase):
+ def test_the_bundle_holds_every_file_the_tool_package_requires(self):
+ destination = self.root / "tools" / "face-models"
+ fetch_face_models.install(destination, cache=self.root / "cache", fetch=self.fetch)
+ _, required = update_packages.TOOL_PATHS["face-models"]
+ self.assertEqual({path.name for path in destination.iterdir()}, required)
+ manifest = json.loads((destination / "manifest.json").read_text(encoding="utf-8"))
+ self.assertEqual(manifest["commit"], face_detect.ZOO_COMMIT)
+ self.assertEqual({model["file"]: (model["license"], model["license_file"]) for model in manifest["models"]},
+ {face_detect.MODEL_PATH.name: ("MIT", "LICENSE-yunet.txt"),
+ face_match.MODEL_PATH.name: ("Apache-2.0", "LICENSE-sface.txt")})
+
+ def test_a_verified_cache_is_reused_without_network(self):
+ cache = self.root / "cache"
+ fetch_face_models.install(self.root / "first", cache=cache, fetch=self.fetch)
+ self.assertEqual(len(self.fetched), 4)
+ fetch_face_models.install(self.root / "second", cache=cache, fetch=self.fetch)
+ self.assertEqual(len(self.fetched), 4, "缓存里哈希对得上的文件不再联网")
+ self.assertEqual((self.root / "first" / "manifest.json").read_bytes(),
+ (self.root / "second" / "manifest.json").read_bytes(), "清单内容固定,工具包哈希可复现")
+
+ def test_a_download_whose_digest_differs_is_refused_and_not_cached(self):
+ cache = self.root / "cache"
+ with self.assertRaisesRegex(ValueError, "SHA-256 不符"):
+ fetch_face_models.install(self.root / "out", cache=cache, fetch=lambda url: b"tampered")
+ self.assertEqual(list(cache.iterdir()), [])
+
+ def test_the_pinned_files_point_at_one_opencv_zoo_commit(self):
+ for name, url, digest in fetch_face_models.FILES:
+ with self.subTest(name=name):
+ self.assertEqual(url.split("/opencv_zoo/", 1)[1].split("/", 1)[0], face_detect.ZOO_COMMIT)
+ self.assertTrue(re.fullmatch(r"[0-9a-f]{64}", digest))
+
+
+class DockerImageTests(unittest.TestCase):
+ def test_the_image_adds_the_same_files_with_the_same_digests(self):
+ dockerfile = (ROOT / "Dockerfile").read_text(encoding="utf-8")
+ added = {Path(target).name: (url, digest) for digest, url, target in re.findall(
+ r"ADD --chmod=a\+rX --checksum=sha256:([0-9a-f]{64}) \\\n\s+(\S+) \\\n\s+(/app/tools/face-models/\S+)",
+ dockerfile)}
+ self.assertEqual(added, {name: (url, digest) for name, url, digest in fetch_face_models.FILES})
+ self.assertEqual(re.findall(r"PEACH_FACE_MODELS=(\S+)", dockerfile), ["/app/tools/face-models"])
+
+
+class FullPackageTests(FixtureCase):
+ """完整包里带两个模型、哈希对得上;解开后运行时直接用它,不联网、不往数据根写。"""
+
+ def test_the_full_package_ships_both_models_and_the_runtime_uses_them_offline(self):
+ source = self.root / "dist" / "Peach"
+ (source / "_internal").mkdir(parents=True)
+ (source / "Peach.exe").write_bytes(b"application")
+ (source / "_internal/standalone.txt").touch()
+ for tool, (prefix, required) in update_packages.TOOL_PATHS.items():
+ if tool == "face-models":
+ continue
+ for name in required:
+ path = source / prefix / name
+ path.parent.mkdir(parents=True, exist_ok=True)
+ path.write_bytes(name.encode())
+ fetch_face_models.install(source / "tools" / "face-models", cache=self.root / "cache", fetch=self.fetch)
+ output = self.root / "release"
+ manifest = package_release(source, output, "1.0.0")
+
+ prefix = "Peach/tools/face-models/"
+ with zipfile.ZipFile(output / "Peach-1.0.0-windows-x64.zip") as full:
+ shipped = {name.removeprefix(prefix): sha(full.read(name))
+ for name in full.namelist() if name.startswith(prefix)}
+ full.extractall(self.root / "installed")
+ for module in (face_detect, face_match):
+ self.assertEqual(shipped[module.MODEL_PATH.name], module.MODEL_SHA256)
+ self.assertEqual({"tools/face-models/" + name for name in shipped},
+ set(manifest["tools"]["face-models"]["files"]))
+ with zipfile.ZipFile(output / "Peach-1.0.0-windows-x64-update.zip") as thin:
+ self.assertFalse([name for name in thin.namelist() if name.startswith(prefix)], "应用更新包不带模型")
+
+ data = self.root / "data"
+ bundle = self.root / "installed" / "Peach" / "tools" / "face-models"
+ with patch.dict(face_detect.os.environ, {face_detect.BUNDLE_ENV: str(bundle)}), \
+ patch.object(face_detect, "MODEL_PATH", data / "yunet" / face_detect.MODEL_PATH.name), \
+ patch.object(face_match, "MODEL_PATH", data / "sface" / face_match.MODEL_PATH.name), \
+ patch.object(face_detect, "read_url", side_effect=AssertionError("程序目录有模型时不该联网")):
+ self.assertEqual(face_detect.ensure_model(), bundle / face_detect.MODEL_PATH.name)
+ self.assertEqual(face_match.ensure_model(), bundle / face_match.MODEL_PATH.name)
+ self.assertEqual(face_models.download_all(), {"ok": True, "outcome": "人脸模型已就绪"})
+ self.assertFalse(data.exists(), "随包那份不往数据根复制")
+
+
+if __name__ == "__main__":
+ unittest.main()
diff --git a/tests/test_release_updates.py b/tests/test_release_updates.py
index 0f67240f3..f7edf71aa 100644
--- a/tests/test_release_updates.py
+++ b/tests/test_release_updates.py
@@ -74,6 +74,8 @@ class ReleaseUpdateTests(unittest.TestCase):
self.assertEqual(self.check([row])["package_kind"], "full")
row["assets"] += [{"name": f"Peach-1.0.0-windows-x64-tools-{tool}.zip", "state": "uploaded"}
for tool in ("ffmpeg", "untrunc", "cloudflared")]
+ self.assertEqual(self.check([row])["package_kind"], "full", "缺人脸模型工具包时不能只下应用更新包")
+ row["assets"].append({"name": "Peach-1.0.0-windows-x64-tools-face-models.zip", "state": "uploaded"})
result = self.check([row])
self.assertEqual(result["package_kind"], "update")
self.assertTrue(result["asset_url"].endswith("-update.zip"))
diff --git a/tests/test_scripts.py b/tests/test_scripts.py
index b904a3805..719bf5aa0 100644
--- a/tests/test_scripts.py
+++ b/tests/test_scripts.py
@@ -4989,7 +4989,7 @@ class ReleaseDownloadNotesTests(unittest.TestCase):
def test_default_download_notes_use_the_github_version_directory(self):
from scripts.package_windows_release import download_notes
links = re.findall(r'https://[^\s)]+', download_notes('1.0.0', lite_installer=True))
- self.assertEqual(len(links), 7)
+ self.assertEqual(len(links), 8)
self.assertTrue(all(url.startswith('https://github.com/peach-mitao/peach/releases/download/v1.0.0/')
for url in links))
@@ -5005,7 +5005,7 @@ class ReleaseDownloadNotesTests(unittest.TestCase):
self.assertIn('### 新增\n\n- **更新**:支持公开下载。', result)
self.assertEqual(result.count('## 下载选择'), 1)
self.assertEqual(links[0], 'https://gitgud.io/peach-mitao/peach/-/blob/v1.0.0/docs/OPERATIONS.md')
- self.assertEqual(len(links[1:]), 9)
+ self.assertEqual(len(links[1:]), 10)
self.assertTrue(all(url.startswith('https://downloads.peach.video/v1.0.0/') for url in links[1:]))
self.assertIn('https://downloads.peach.video/v1.0.0/Peach-1.0.0-macos-arm64.dmg', links)
self.assertIn('https://downloads.peach.video/v1.0.0/Peach-1.0.0-macos-x86_64.dmg', links)
diff --git a/tests/test_standalone_update.py b/tests/test_standalone_update.py
index b73921f3c..72ca31562 100644
--- a/tests/test_standalone_update.py
+++ b/tests/test_standalone_update.py
@@ -203,12 +203,14 @@ class StandaloneUpdateTests(unittest.TestCase):
source, output, manifest, target, archive, release = self.release_fixture()
rebuilt = self.root / "rebuilt"
report = verify_split(output, "1.0.0", rebuilt)
- self.assertEqual(report["tools"], 3)
+ self.assertEqual(report["tools"], 4)
self.assertEqual((rebuilt / "Peach/Peach.exe").read_bytes(), (source / "Peach.exe").read_bytes())
with zipfile.ZipFile(archive) as thin, zipfile.ZipFile(output / "Peach-1.0.0-windows-x64.zip") as full:
self.assertNotIn("Peach/tools/ffmpeg/bin/ffmpeg.exe", thin.namelist())
self.assertNotIn("Peach/cloudflared.exe", thin.namelist())
+ self.assertFalse([name for name in thin.namelist() if name.startswith("Peach/tools/face-models/")])
self.assertIn("Peach/tools/ffmpeg/bin/ffmpeg.exe", full.namelist())
+ self.assertIn("Peach/tools/face-models/face_recognition_sface_2021dec.onnx", full.namelist())
self.assertNotIn("Peach/" + update_packages.MANIFEST, full.namelist())
state, requests = self.prepare_fixture(target, output, release)
self.assertEqual(state["state"], "ready", state)
@@ -309,7 +311,7 @@ class StandaloneUpdateTests(unittest.TestCase):
def test_lite_installer_prepares_from_r2_with_no_github_or_adjacent_archives(self):
result, requests, manifest, stage, error = self.prepare_online_lite()
self.assertEqual(result, 0, error.read_text(encoding='utf-8') if error.exists() else '')
- self.assertEqual(len(requests), 3)
+ self.assertEqual(len(requests), len(update_packages.TOOL_PATHS))
self.assertTrue(all(url.startswith('https://downloads.peach.video/v1.0.0/') for url in requests))
for bundle in manifest['tools'].values():
self.assertTrue(update_packages.matches(stage, bundle['files']))
@@ -317,7 +319,7 @@ class StandaloneUpdateTests(unittest.TestCase):
def test_lite_installer_uses_same_version_github_when_r2_is_unavailable(self):
result, requests, manifest, stage, _ = self.prepare_online_lite('unavailable')
self.assertEqual(result, 0)
- self.assertEqual(len(requests), 6)
+ self.assertEqual(len(requests), 2 * len(update_packages.TOOL_PATHS))
self.assertTrue(all(url.startswith('https://github.com/peach-mitao/peach/releases/download/v1.0.0/')
for url in requests[1::2]))
for bundle in manifest['tools'].values():
@@ -326,7 +328,7 @@ class StandaloneUpdateTests(unittest.TestCase):
def test_lite_installer_accepts_only_the_embedded_manifest_digest_across_sources(self):
result, requests, manifest, stage, _ = self.prepare_online_lite('mismatch')
self.assertEqual(result, 0)
- self.assertEqual(len(requests), 6)
+ self.assertEqual(len(requests), 2 * len(update_packages.TOOL_PATHS))
for bundle in manifest['tools'].values():
self.assertTrue(update_packages.matches(stage, bundle['files']))
@@ -388,6 +390,15 @@ class StandaloneUpdateTests(unittest.TestCase):
with self.assertRaises(ValueError):
update_packages.read_manifest(source, "1.0.0")
+ def test_a_tool_this_version_does_not_know_is_left_out_not_refused(self):
+ """更新版本新增的工具包这一版不认得:照常更新,只是不下载它。"""
+ source, output, manifest, target, archive, release = self.release_fixture()
+ future = json.loads(json.dumps(manifest))
+ future["tools"]["future-tool"] = {"files": {"tools/future/x.bin": "a" * 64}, "asset": {}}
+ (source / update_packages.MANIFEST).write_text(json.dumps(future), encoding="utf-8")
+ self.assertEqual(set(update_packages.read_manifest(source, "1.0.0")["tools"]),
+ set(update_packages.TOOL_PATHS))
+
def test_tool_archive_cannot_replace_application_files(self):
archive = self.archive(["Peach/tools/ffmpeg/bin/ffmpeg.exe", "Peach/Peach.exe"])
with self.assertRaisesRegex(ValueError, "清单外"):