Skip to content

armgit / peach

Public Imported from GitHub
0

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

12.4 KB
Raw Blame

Windows 测试版

Windows 版提供完整安装包、轻量安装包和免安装包,均无需另装 Python、Git、Node 或 OpenSSL。macOS 的 DMG 构建、安装和测试包限制见 macOS 独立测试包。

文件 用途
Peach-<版本>-windows-x64-setup.exe 完整安装包,包含全部工具,可离线安装
Peach-<版本>-windows-x64-lite-setup.exe 轻量安装包,校验并复用已有工具,缺失或版本不符时自动下载
Peach-<版本>-windows-x64.zip 完整免安装包,解压后运行 Peach.exe

安装包默认装在 %LOCALAPPDATA%\Programs\Peach,可选择目录,无需管理员权限;两种安装包都提供开始菜单与系统设置里的卸载项。免安装包解压到哪里就在哪里。

三种包的数据都在 %LOCALAPPDATA%\Peach\peach-data,换用另一种时设置和数据库照常沿用。

轻量安装包先在临时目录备齐并校验工具,再停止旧程序并安装;下载失败可重试,现有安装会保留。安装包旁边已有对应的 tools-*.zip 时,可校验后直接使用。

安装目录须为当前用户可写的独立文件夹,上级目录也须可写,以便自动更新。可选择空文件夹或已有的 Peach 安装目录;程序目录不能与数据目录重叠,也不能经过目录链接。升级默认沿用已有安装目录。需要换位置时,先卸载并保留数据,再安装到新目录。

开始使用

  1. 从 GitHub Releases 下载其中一种,以及 SHA256SUMS.txt。
  2. 核对哈希:在 PowerShell 里运行 Get-FileHash .\<下载的文件名>,结果应与 SHA256SUMS.txt 里对应的那一行相同(不区分大小写)。
  3. 安装包:双击,选择安装目录,按提示完成安装,最后一步勾选「运行 Peach」。免安装包:右键压缩包,选「全部解压」,保留整个 Peach 文件夹,不要只拿出 Peach.exe,然后双击 Peach.exe。
  4. 浏览器会打开首次设置页。
  5. 添加媒体目录(可以用「选择文件夹」挑选),选择谁可以访问、要不要设访问密码、是否立即扫描,然后提交。
  6. 设置完成后自动进入馆藏,右下角会显示一份安装教程,照着做或逐项跳过都可以。

测试包没有代码签名,Windows 可能提示「未识别的应用」。先确认文件来自本项目的 Release 页面、哈希与 SHA256SUMS.txt 一致,再决定是否运行。

从其他设备打开

  • 选「只有这台电脑」:只能在本机打开 http://127.0.0.1:<端口>。
  • 选「同一局域网的设备」:同一网络里的手机、平板或电脑打开 http://<设置的名字>.local:<端口>。

测试包在局域网里用的是 HTTP,传输不加密。局域网里有其他人时,请设置访问密码。

Windows 第一次询问防火墙权限时,只勾选「专用网络」。

其他设备打不开时,按顺序检查:

  1. 两台设备连的是同一个网络。
  2. 路由器没有开启「客户端隔离」(有时叫 AP 隔离)。
  3. Windows 防火墙允许 Peach 使用专用网络。

修改配置

从管理菜单「配置」、设置弹层「这台电脑」里的「打开配置页」,或托盘菜单「配置 Peach」进入配置页。可以在这里增减媒体目录、修改端口、设置访问密码,并请求重新扫描。

  • 保存配置会重启本机服务,正在播放的视频会中断。
  • 每次保存前,上一份配置会备份为数据目录里的 config.previous.toml。
  • 修改端口时页面会检查冲突。端口被占用时,先退出占用它的程序再试。

数据保存在 %LOCALAPPDATA%\Peach\peach-data,和程序文件夹分开。

播放与 FFmpeg

完整安装包和完整免安装 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、dav1d、nv-codec-headers、AMF 头文件与 libvpl 的固定源码和构建脚本。发行构建会校验工具及对应源码,任何一项缺失或哈希不符都停止打包。

源码运行可在配置页「运行信息」点「安装」,把发布的 FFmpeg、untrunc 工具包装进数据目录的 tools\ffmpeg、tools\untrunc;也可将 FFmpeg、ffprobe 加入 PATH,或自行放在数据目录的 tools\ffmpeg\bin。显式指定的 PEACH_FFMPEG、PEACH_FFPROBE 优先;独立包随后使用随包工具,再查数据目录和 PATH。

已在系统安装媒体工具时,可运行 import_windows_media_tools.cmd,它调用同目录 PowerShell 脚本检测 WinGet、Scoop、Chocolatey、PATH 和下载目录,将工具及同目录 DLL 放入 Peach 的数据目录,替换文件时保留备份。没有检测到已解压工具时,可识别下载目录中的 Gyan ffmpeg-9.0.2-essentials_build.zip,校验固定 SHA-256 后解压接入。脚本不修改系统 PATH 或馆藏账本;完成后刷新配置页。

从外网临时访问

配置页「网络与访问」里的「Cloudflare 公网入口」可以生成一个临时公网链接,默认关闭。

  1. 先在同一分组的「访问密码」里设置密码。没有密码时无法启动公网入口。
  2. 点「启动公网入口」。
  3. 页面显示一个随机地址 https://<id>.trycloudflare.com,用它访问。https://try.cloudflare.com/ 只是介绍页,不是你的入口。

使用须知:

  • 这只用于临时预览。地址是随机的,停止公网入口或退出 Peach 后就失效,下次启动会换一个。
  • 不要把随机地址存进书签、文档或公开配置。
  • 测试包已附带经过 SHA-256 校验的 cloudflared.exe,不用另装。
  • 连接失败时,检查防火墙或代理是否允许 cloudflared 出站访问 TCP/UDP 7844 端口。页面上出现了随机地址,不代表连接已经成功。

采集来源

Windows 完整安装包、免安装包、轻量安装包与应用更新包均随附锁文件固定版本的 amane 独立 console 桥,使用者无需安装 Python、uv 或 Git。运行目录位于程序资源中的 _internal\tools\amane-runtime;桥属于应用必需资源,不随可选媒体工具拆分。macOS 独立应用在 Contents/Frameworks/tools/amane-runtime 携带对应架构的桥,数据资源通过应用内链接映射到 Contents/Resources。

桌面构建调用 scripts/build_amane_runtime.py,按桥的 uv.lock 安装独立构建环境,再复用主锁固定的 PyInstaller 生成运行目录。构建会执行 --self-check,离线载入运行时与全部 Peach 开放站点类;站点连接检查仍需实际网络。目录中的 manifest.json 记录版本、完整 revision 和可执行文件相对路径。GPL-3.0 许可证、来源说明、amane 完整对应源码,以及 zhconv 和 certifi 的固定源码随运行目录一起分发。

  1. 扫描完成后,打开「数据管理」页,在「扫描与采集」卡片上点「来源和凭证」。
  2. 每个来源可以选连接方式:「Peach 代理」或「直接连接」。高清来源通常需要代理;「Peach 代理」用的是配置页「网络与访问 → Peach 代理」里的设置(系统代理、直连或自定义地址,系统代理不支持 PAC)。
  3. 点「检查连接」。DMM 会分别检查页面和高清图片服务器,图片检查会显示实际像素尺寸。
  4. 在「高清封面」里填一个馆藏里已有的番号,点「抓取封面」。只有新图能完整解码、而且像素比现有封面大时才替换;失败时保留已有的图。同一个番号 24 小时内抓成功过,会直接用本机已有的文件。
  5. 需要 Cookie 的来源(例如 FC2)选「粘贴 Cookie」或「导入文件」其中一种,文件支持 Netscape 格式的 .txt。Cookie 只保存在这台电脑上,不同电脑之间不共享。

「已保存」只表示 Cookie 存下来了,不代表登录仍然有效。撤销后,这个来源需要登录的采集要重新提供 Cookie。浏览器里的 Cookie 不能直接导入,只能粘贴或导入文件。更多来源的说明见 来源采集。

更新

在配置页「应用与维护 → 检查更新」里操作:

  1. 点「检查更新」。有新版本时出现「下载并安装」。
  2. 点「下载并安装」,等待下载、校验、解压和准备安装完成。
  3. 点「重启安装」。

已有馆藏却出现首次设置页时,点「使用已有数据目录」,填入保存馆藏的 peach-data 目录。成功连接后会记住位置,沿用原配置、账本和访问密码。尚未进入馆藏的部署可先运行新版安装包,再接回已有目录。

也可以打开「自动检查新版本」和「自动下载更新」,下载完成后仍要在这里确认重启。

也可以手动更新,数据目录不用动,新版启动后会沿用已有配置:

  • 安装包:直接运行新版安装包。它会先让正在运行的 Peach 退出,装完后在需要时更新本地数据库,更新前的数据库备份在数据目录的 database 文件夹里,文件名以 ledger.pre-migrate- 开头。
  • 免安装包:先从托盘退出 Peach,再把新版完整解压到一个新文件夹。不要只替换 Peach.exe:旁边的 _internal 文件夹也是程序的一部分。

卸载

在配置页「维护 → 卸载 Peach」里操作。卸载会先退出 Peach,再移除程序文件夹、开机自启和桌面图标;用安装包装的,开始菜单项和系统设置里的卸载项也一并移除。

用安装包装的也可以在系统设置「应用 → 已安装的应用」里卸载 Peach。这条路只移除程序、开始菜单项、开机自启和桌面图标,数据全部保留;要连数据一起删,用配置页里的「完全卸载」。

  • 默认保留数据:设置、本地数据库、观看记录和缓存都留着,以后重新安装可以接着用。
  • 勾选「完全卸载」会同时删除设置、本地数据库、观看记录、凭据和缓存。
  • 原始媒体文件在任何情况下都不会被删除。自己手工复制的 config.toml.bak 和其他 Peach 不认识的文件也会保留。
  • 数据目录放在别处、用了目录链接,或者和媒体目录有重叠时,「完全卸载」不可用,需要对照页面上列出的目录手动清理。
  • 文件被占用导致删除失败时,弹窗会给出日志位置,日志是临时目录里的 peach-uninstall.log,里面写着失败的路径和原因。

反馈问题

启动失败时保留完整弹窗,并找到弹窗给出的 peach-support-*.zip。能够运行时,从托盘「导出诊断报告」或系统诊断页「下载诊断报告」取得报告;程序尚未配置也可以导出。发送前打开报告,确认其中没有需要保留的私人信息。

请写上版本、操作系统、操作步骤、预期结果和实际结果。与采集有关的问题,再加上来源、连接方式、番号、页面状态和图片像素。版本、数据目录和日志目录都在配置页「运行信息」里。

发送之前:

  • 检查日志,去掉个人路径和来源网址。
  • 不要发送 secrets 目录、数据库、Cookie 或带签名的图片网址。