README.zh-CN.md
Rama master · réplica de lectura del repositorio original.
<p align="center"><img src="resources/peach-logo-128.png" alt="Peach" width="88"></p>
# Peach
本地优先的影片刮削与媒体管理工具。
[官网](https://peach.video) · [下载](#下载与使用) · [在线演示](https://demo.peach.video) · [文档](#文档) · [English](README.md)
[](https://github.com/peach-mitao/peach/releases)
[](https://github.com/peach-mitao/peach/actions/workflows/test.yml)
[](LICENSE)
[](docs/TESTING_DESKTOP.md)
[](docs/OPERATIONS.md#macos-独立测试包)
[](#许可证)
## 截图
[](https://peach.video/assets/screenshots/home-wide-20261025-2.png)
电影演示资料，来源与许可见[素材说明](https://peach.video/credits/)。
<details>
<summary>更多截图</summary>
**人物与作品**
[](https://peach.video/assets/screenshots/profile-wide-20261025-2.png)
**创作者关注**
[](https://peach.video/assets/screenshots/follow-wide-20261025-2.png)
**馆藏统计**
[](https://peach.video/assets/screenshots/stats-wide-20261025-3.png)
**播放器**
[](https://peach.video/assets/screenshots/play-wide-20261025-2.png)
</details>
## 能做什么
- **影片刮削**：识别影片编号，读取 NFO，多来源补齐标题、演员、厂牌和封面，保留人工修改。
- **本地与网盘**：统一浏览本地硬盘、SMB、已挂载网盘和 PikPak 媒体库。
- **播放与记录**：网页与外部播放器、字幕、倍速、旋转、续播和时间轴预览。
- **关注与发现**：订阅人物与创作者更新，发现作品，管理「想要」清单。
- **云下载**：按影片编号查找或提交磁力，下载完成后整理入库。
- **馆藏管理**：管理标签、重复文件、多版本与分卷；按女优批量永久删除影片，保留人物档案和照片。资料和观看记录保存在本机。
- **任务中心**：暂停、继续或取消本机后台任务，查看可取得的各任务 CPU、GPU 与下载活动。
## 下载与使用
| 方式 | 入口 |
| --- | --- |
| Windows x64 | [安装版](https://github.com/peach-mitao/peach/releases/download/v0.57.0/Peach-0.57.0-windows-x64-setup.exe) · [免安装版](https://github.com/peach-mitao/peach/releases/download/v0.57.0/Peach-0.57.0-windows-x64.zip) |
| macOS | [Apple Silicon / ARM64](https://github.com/peach-mitao/peach/releases/download/v0.57.0/Peach-0.57.0-macos-arm64.dmg) · [Intel / x86_64](https://github.com/peach-mitao/peach/releases/download/v0.57.0/Peach-0.57.0-macos-x86_64.dmg) |
| Docker / NAS | [部署说明](docs/DOCKER.md) |
| 源码运行 | [安装步骤](docs/OPERATIONS.md#从源码运行windowsmacos)，需要 Git、uv 和 Python 3.14+ |
安装后选择媒体目录，扫描后即可浏览与播放。桌面测试包未签名，macOS 尚未完成公证；详见 [Windows](docs/TESTING_DESKTOP.md) 与 [macOS](docs/OPERATIONS.md#macos-独立测试包) 说明。
## 文档
[运行与配置](docs/OPERATIONS.md) · [来源支持](docs/SOURCING.md) · [外部播放器](docs/EXTERNAL_PLAYERS.md) · [诊断与数据分享](docs/DIAGNOSTICS.md) · [更新日志](CHANGELOG.md)
参与开发：[贡献说明](CONTRIBUTING.md) · [开发约定](AGENTS.md) · [测试](docs/TESTING.md)
## 问题反馈
[提交问题或建议](https://github.com/peach-mitao/peach/issues/new/choose)，附版本、复现步骤与报错。公开截图使用演示资料，遮盖隐私；不要上传影片或数据库。安全问题按[安全政策](SECURITY.md)私下报告。
## 相关项目
感谢 [amane](https://github.com/sqzw-x/amane)、[Gfriends](https://github.com/gfriends/gfriends) 与 [CloudDrive2](https://www.clouddrive2.com/)；完整致谢见[复用清单](docs/REUSE.md)。
## Star 历史
<a href="https://github.com/peach-mitao/peach/tree/star-history">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/peach-mitao/peach/star-history/star-history-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/peach-mitao/peach/star-history/star-history-light.svg">
<img alt="Peach 累计 Star 数，线性坐标" src="https://raw.githubusercontent.com/peach-mitao/peach/star-history/star-history-light.svg">
</picture>
</a>
## 许可证
[AGPL-3.0-or-later](LICENSE) · Copyright (C) 2026 The Peach contributors。第三方组件保留各自的许可证。Peach 名称与图标的使用见[名称与标识政策](docs/TRADEMARKS.md)。
仅管理自行持有或获授权使用的媒体，遵守法律、版权及来源平台的访问、年龄和地区限制。Peach 不提供影片资源或付费内容访问权。