peach-mitao / peach

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
1. 从 Releases 下载完整安装包 `Peach- -windows-x64-setup.exe`，双击安装，无需管理员权限；也可下载完整免安装包，解压后运行 `Peach.exe`。
2. 浏览器打开首次设置页后，选择媒体目录和访问范围。
3. 开始扫描，随后在浏览器里浏览和播放。
完整安装包携带媒体工具，可离线安装；轻量安装包体积更小，安装时按需下载工具。
测试版尚未签名。若 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`。
## 问题反馈
先查看用户反馈，或提交问题，附上版本、操作步骤、预期与实际结果。截图请遮掉凭据、局域网地址和完整路径，不要上传数据库或媒体；安全问题按安全政策私下报告。
## 文档
运行与配置 · 来源采集 · 外部播放器 · 变更日志
参与开发：开发约定 · 测试与依赖
## 相关项目
感谢 amane、Gfriends、CloudDrive2 等项目，完整致谢与复用说明见复用清单。
## Star 历史
## 许可证
AGPL-3.0-or-later · Copyright (C) 2026 longmeidao。第三方组件保留各自的许可证。