peach README

The project's README from github.com/peach-mitao/peach. As one markdown file: README.md.

Peach

给自己用的私人影片馆藏：本地硬盘、网盘和关注的创作者，放在一个地方看。

官网 · 下载安装包 · 在线演示 · 介绍视频 · 问题反馈 · 需求看板 · 路线图 · 文档 · English

https://github.com/user-attachments/assets/a5610874-e611-41bb-be22-7d99f0d64b62

18+ 仅供成年人管理自己的成人内容馆藏。仓库不含媒体或站点数据；连接外部站点需有相应账号和访问权。

能做什么

本地、网盘一起看：硬盘与已挂载的 115、PikPak、OneDrive 等网盘汇成一个馆藏。
播放墙挑片：拖动全屏封面墙，点开原位播放；同一番号的不同版本与分卷集中切换。
播放器字幕：加载本地字幕，按番号搜索 SubtitleCat 简繁中文字幕并选择加载，调整字体、字号、颜色与背景。在线搜索无需 API Key，来源可能包含机翻。
接手已有收藏：直接读取 NFO 和海报，缺少的标题、女优、厂牌与封面可从多个来源补齐，保留手动修改。
跨站关注：同一创作者在 FANBOX、Patreon、Kemono 等站点的更新汇到一起，同一作品合成一张卡。
追新作、找想看的：按女优订阅新作，按口味发现作品，用「想要」清单留住待找的片子。
云下载：按番号查找资源或粘贴磁力，提交到 115 或 PikPak，落地后自动整理入库。
浏览器添加 JAV：在 JavDB、MissAV、Jable 等站点识别或选中番号，一键交给 Peach 云下载入库。用户脚本独立维护，见安装与配对。
口味：结合观看、反馈、馆藏、浏览历史、书签与关注关系分析偏好。一次读取本机浏览器的历史和书签，也可导入 HTML 书签或 Chromium Bookmarks JSON；来源可停止读取或删除。见口味数据来源。

观看记录、收藏和设置保存在本机。扫描不动原文件；手动整理先预览，可撤回上一批。

扫描、关注更新和新作资料采集会保存进度，应用重启后继续处理未完成的项目。恢复范围见断点续跑。

「发送版本统计与错误诊断（推荐）」默认勾选，可在安装、首次设置或设置页取消。两类技术事件由同一开关控制，已保存的关闭选择会保留。启用后向 Sentry 发送页面列出的技术字段，不自动上传完整日志、诊断 ZIP、媒体信息或观看记录。见远程诊断说明。

馆藏与口味明细上传在安装器和设置页另设独立选项，默认关闭。设置页先展示完整字段与本机预览，经明确同意后，每周上传作品、标签、评分、观看汇总及全部偏好维度的明细；不含账号、设备或安装标识。明细仍有跨次关联与再识别风险，接收服务可见连接 IP。见馆藏与口味群体研究。

截图

在线演示可直接体验搜索、筛选和资料页，操作不会保存。点击截图查看原图。


馆藏：按人物、来源和标签找片	女优页：资料、别名和全部作品

关注：创作者的跨站更新	统计：片子存在哪、看了多少

播放墙：拖动挑片，原位播放

下载与使用

Windows

从 Releases 下载完整安装包 Peach-<版本>-windows-x64-setup.exe，双击安装，无需管理员权限；也可下载完整免安装包，解压后运行 Peach.exe。
浏览器打开首次设置页后，选择媒体目录和访问范围。
开始扫描，随后在浏览器里浏览和播放。

完整安装包携带媒体工具，可离线安装；轻量安装包体积更小，安装时按需下载工具。

测试版尚未签名。若 Windows 提示「已保护你的电脑」，确认来自本项目的 Release，再点「更多信息 → 仍要运行」。安装、更新和故障排查见 Windows 使用说明。

macOS 本机构建

macOS 可在本机构建独立 .app 与 DMG，运行不需要 Python、源码或另一台电脑。构建与安装见 macOS 独立测试包。

发版流程分别生成 Apple Silicon（macos-arm64.dmg）与 Intel（macos-x86_64.dmg）测试包；可下载版本以 Releases 的实际资产为准。在「关于本机」确认芯片，打开对应镜像并将 Peach 拖入「应用程序」。测试包未完成 Apple 公证，媒体工具需另行准备。

从源码运行（Windows、macOS）

需要 Git、uv 和 Python 3.14 或更高，步骤见源码运行。

Docker（VPS / NAS）

部署步骤与支持范围见 Docker 部署。

常见问题

会改我的文件吗？ 扫描、补资料不碰原文件。手动整理会改名或移动；清空回收站会删除文件，资源同步中的清理会删除空目录，均需确认。
支持哪些网盘？ 通过 CloudDrive2 等工具挂载为本地目录的网盘，详见网盘挂载；云下载支持 115 和 PikPak，登录令牌保存在本机。
手机上怎么看？ 首次设置时允许同一局域网的设备访问，手机连同一网络，打开设置页给出的地址，并设置访问密码。
数据存在哪？ 本机的 peach-data 文件夹；Windows 版默认位于 %LOCALAPPDATA%\Peach\peach-data。