Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

Peach

Peach

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

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

release CI 状态 license Windows x64 macOS 独立应用构建与安装 18+ 成人内容

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 历史

Peach Star 历史

许可证

AGPL-3.0-or-later · Copyright (C) 2026 longmeidao。第三方组件保留各自的许可证。

关于 About

Peach 蜜桃:单用户、本地优先的个人媒体系统 · Single-user, local-first personal media system
javlocal-firstmedia-librarymedia-managerpythonreactself-hostedvideo-player

语言 Languages

Python63.8%
TypeScript30.3%
CSS3.5%
JavaScript1.5%
HTML0.4%
Inno Setup0.2%
PowerShell0.2%
Shell0.1%
Dockerfile0.0%
Batchfile0.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
5000
Total Commits
峰值: 957次/周
Less
More

核心贡献者 Contributors