核心摘要
Peach是一款单用户、本地优先的个人媒体系统，可将本地硬盘与已挂载的网盘内容汇入同一个馆藏，并提供播放墙、播放器字幕、资料补全、跨站关注与云下载等功能。
- 项目名称：Peach（蜜桃）
- 当前版本：0.46.1
- 项目定位：单用户、本地优先的个人媒体系统
- 核心功能：本地与网盘统一馆藏、播放墙挑片、播放器字幕、NFO与海报读取、跨站创作者关注、口味分析、云下载入库
- 适用人群：拥有个人影片收藏并希望集中管理的个人收藏者
- 资费模式：开源，许可证为AGPL-3.0-or-later
- 使用范围：项目标注为18+，仅供成年人管理自己的成人内容馆藏；仓库不含媒体或站点数据，连接外部站点需有相应账号和访问权
核心功能与价值
本地与网盘统一馆藏
统一馆藏：将本地硬盘与已挂载的115、PikPak、OneDrive等网盘汇入同一馆藏，减少分别查找文件的麻烦。
播放墙挑片
播放墙：通过全屏封面墙拖动挑选影片，点开后原位播放，同一番号的不同版本与分卷可集中切换。
播放器字幕
字幕加载：支持加载本地字幕，并可按番号搜索SubtitleCat简繁中文字幕，同时调整字体、字号、颜色与背景。在线搜索无需API Key。
已有收藏接管
资料补全：直接读取NFO和海报，缺少的标题、女优、厂牌与封面可从多个来源补齐，并保留手动修改。
跨站关注
跨站更新：同一创作者在FANBOX、Patreon、Kemono等站点的更新汇集在一起，同一作品合成一张卡片。
新作追踪与云下载
云下载：按番号查找资源或粘贴磁力，提交至115或PikPak，落地后自动整理入库；也可按女优订阅新作，并通过「想要」清单记录待找的作品。
核心优势与竞品对比
| 核心优势 | 说明 |
|---|---|
| 本地优先 | 观看记录、收藏和设置保存在本机 |
| 不改动原文件 | 扫描不改动原文件，手动整理先预览，可撤回上一批操作 |
| 断点续跑 | 扫描、关注更新和新作资料采集会保存进度，应用重启后继续处理未完成的项目 |
| 隐私可控 | 远程诊断默认勾选且可取消；馆藏与口味明细上传默认关闭，需明确同意后才会启用 |
| 开源许可 | 采用AGPL-3.0-or-later许可证，源码公开 |
适用场景与目标受众
- 已有硬盘或网盘收藏的个人收藏者：可以在同一界面中浏览、搜索和播放分散在不同位置的内容。
- 关注多个创作者平台的收藏者：可以将FANBOX、Patreon、Kemono等站点的更新合并查看，同一作品合成一张卡片。
- 希望在NAS或VPS上部署并用手机观看的使用者：可以在首次设置时允许同一局域网设备访问，手机连接同一网络后打开设置页给出的地址；Docker部署的步骤与支持范围可参考项目的Docker部署文档。
部署与搭建指南
环境依赖与准备：Windows版需在Windows系统上运行，安装时无需管理员权限。完整安装包携带媒体工具，可离线安装；轻量安装包体积更小，安装时按需下载工具。从源码运行需要Git、uv以及Python 3.14或更高版本。
从项目的Releases页面下载Peach-<版本>-windows-x64-setup.exe安装包。
双击安装包完成安装，安装过程无需管理员权限。
在浏览器中打开首次设置页，选择媒体文件夹并确定访问范围；如需手机访问，可允许同一局域网设备访问并设置访问密码。
在首次设置页开始扫描，扫描完成后即可在浏览器中浏览和播放。扫描不会改动原文件。
从源码运行的步骤请参考项目的源码运行文档，Docker部署的步骤请参考Docker部署文档。
真实体验与反馈
- 扫描不改动原文件，手动整理前可先预览，并可撤回上一批操作，有助于降低误操作风险。
- 扫描、关注更新和新作资料采集会保存进度，应用重启后可继续处理未完成的项目，减少重复等待。
局限：测试版尚未签名，Windows系统可能弹出受保护提示，需确认安装包来自本项目的Release后，再点击「更多信息」并选择「仍要运行」。
常见问题解答
扫描和补资料不会改动原文件。手动整理会改名或移动文件，操作前可先预览，并可撤回上一批；清空回收站会删除文件，资源同步中的清理会删除空目录，两者均需确认。
通过CloudDrive2等工具挂载为本地目录的网盘均可纳入馆藏；云下载功能支持115和PikPak，登录令牌保存在本机。
可以。首次设置时允许同一局域网设备访问，手机连接同一网络后打开设置页给出的地址，并设置访问密码即可。
数据保存在本机的peach-data文件夹中；Windows版默认位于%LOCALAPPDATA%Peachpeach-data。
远程诊断默认勾选，启用后仅向Sentry发送页面列出的技术字段，不会自动上传完整日志、诊断ZIP、媒体信息或观看记录，可在安装、首次设置或设置页取消。馆藏与口味明细上传默认关闭，需明确同意后才会进行。
项目采用AGPL-3.0-or-later许可证发布，第三方组件保留各自的许可证。
