Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

docs(readme): 默认展示英文精简介绍与线性 Star 历史

longmeidao960824c13eb7
diff --git a/README.en.md b/README.en.md
deleted file mode 100644
index ca2e28781..000000000
--- a/README.en.md
+++ /dev/null
@@ -1,163 +0,0 @@
-<p align="center">
- <img src="resources/peach-logo.png" alt="Peach" width="96">
-</p>
-
-<h1 align="center">Peach</h1>
-
-<p align="center">A local-first video metadata scraper and media manager for local drives, cloud drives and creator updates.</p>
-
-<p align="center">
- <a href="https://peach.video">Website</a> ·
- <a href="https://peach.video/#download">Download installers</a> ·
- <a href="https://demo.peach.video">Live demo</a> ·
- <a href="https://peach.video/#live">Interface tour</a> ·
- <a href="https://github.com/peach-mitao/peach/issues">Report a problem</a> ·
- <a href="https://github.com/orgs/peach-mitao/projects/7/views/1">Requests board</a> ·
- <a href="https://github.com/orgs/peach-mitao/projects/7/views/3">Roadmap</a> ·
- <a href="#documentation">Documentation</a> ·
- <a href="README.md">中文</a>
-</p>
-
-<p align="center">
- <a href="https://gitgud.io/peach-mitao/peach/-/releases"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownloads.peach.video%2Freleases.json&amp;query=%24%5B0%5D.tag_name&amp;label=release" alt="release"></a>
- <a href="https://gitgud.io/peach-mitao/peach/-/pipelines?ref=master"><img src="https://img.shields.io/badge/CI-GitGud-554488?logo=gitlab&amp;logoColor=white" alt="CI pipelines"></a>
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0--or--later-blue?logo=gnu&amp;logoColor=white" alt="license"></a>
- <a href="docs/TESTING_DESKTOP.md"><img src="https://img.shields.io/badge/Windows-x64-0078D4" alt="Windows x64"></a>
- <a href="docs/OPERATIONS.md#macos-独立测试包"><img src="https://img.shields.io/badge/macOS-DMG-555555?logo=apple&amp;logoColor=white" alt="Build and install the standalone macOS app"></a>
-</p>
-
-> Use Peach to manage media you own or are authorized to use, subject to applicable laws, copyright and source-platform terms, including age and regional restrictions. Peach does not provide video resources or access to paid content.
-
-Public screenshots use movie demo data with documented sources and licenses, without personal collection media; see [asset credits and licenses](https://peach.video/en/credits/). The repository includes a seed of public textual metadata and brand marks, without collection media or user databases. Access to outside sites requires the appropriate accounts and permissions.
-
-## Features
-
-- **Local and cloud together**: browse hard drives and mounted cloud drives, including 115, PikPak and OneDrive, in one library.
-- **Pick from the video wall**: drag through a full-screen cover wall and play in place, with versions and parts of the same title grouped together.
-- **Player subtitles**: automatically discover matching subtitles beside the video, load subtitle files manually, search SubtitleCat for simplified and traditional Chinese subtitles by video code, then adjust fonts, size, colors and backgrounds. Each video keeps its loaded subtitles and last selection, including turning subtitles off, and restores them when played again. No API key is required; results may include machine translations.
-- **Playback options**: rotate the picture in the web player settings. On Windows and macOS, open media with the system default or a detected installed player; Docker and remote devices can use network playback links and M3U playlists. See [External players](docs/EXTERNAL_PLAYERS.md).
-- **Bring your existing collection**: read NFO files and posters, then fill missing titles, performers, studios and covers from multiple sources while keeping your edits.
-- **Preview while seeking**: reuse Jellyfin Trickplay, Emby/Plex BIF exports, WebVTT, HLS and DASH image previews beside your videos to avoid extracting the same frames again. See [formats and naming](docs/VIDEO_PREVIEWS.md).
-- **Reduce repeated scraping**: public textual metadata ships with each version. After scanning, Peach supplements recognized performers and studios with aliases, source IDs and profiles while keeping your edits. See [seed data and updates](docs/SEED.md).
-- **Follow across sites**: combine creator updates from configured sources and group matching posts into one card. See [sources and access requirements](docs/SOURCING.md).
-- **Manage tags**: local and online details share controls for adding, renaming and removing tags. Follow management supports merging tags, hiding tags in batches, and blocking or restoring content by tag. Names are preserved as aliases. See [tag management](docs/TAG_MANAGEMENT.md).
-- **Find your next watch**: subscribe to performers' new releases, discover titles based on your taste and save them to your want list.
-- **Cloud download**: search by video code or paste a magnet link, send it to a library with cloud download support and organize the downloaded video automatically. Channels follow configured libraries and provider capabilities, through CloudDrive2 or a direct PikPak connection. Confirm your rights to access and use the content before submitting it.
-- **Add videos from your browser**: detect or select a video code on a supported metadata page, then send it to Peach for cloud download and library ingestion. The [userscript](https://github.com/peach-mitao/peach-userscript) is maintained independently; see [supported sources, installation and pairing](docs/JAV_BROWSER.md).
-- **Taste preferences**: combine viewing, feedback, your library, browser history, bookmarks and follows to understand your preferences. Read history and bookmarks from supported local browsers in one action, or import HTML bookmarks and Chromium Bookmarks JSON. Stop reading a source or remove it when needed. See [taste data sources](docs/TASTE_SOURCES.md).
-
-Watch history, favorites and settings stay on your computer. Scanning leaves original files untouched; manual organization offers a preview and an undo for the last batch. Release codes are recognized even when the file name carries a title; for other naming schemes, add [recognition rules](docs/OPERATIONS.md#配置页) on the configuration page instead of renaming files.
-
-Scanning, cloud downloads and media processing share junk checks. Attachments with sufficient evidence go to the recoverable trash; uncertain items await review. You can restore an item and mark it as “not junk”. See [junk files](docs/OPERATIONS.md#垃圾文件) for processing order and protections.
-
-Scanning, follow updates and new-release metadata collection save their progress and continue unfinished items after the app restarts. When metadata or cover requests take too long, skip the current work or stop the entire scan and collection task. Completed results are kept, and stopped tasks do not resume automatically. The management page can process only newly added videos, export the complete issue list, or archive notices from finished tasks while keeping their history. See [task recovery](docs/OPERATIONS.md#长时任务断点续跑) for recovery boundaries.
-
-Upgrades automatically process existing metadata and caches while preserving manual edits. Normal use requires no migration scripts. The app and independently installed userscript offer update notices; page refreshes remain your choice. See [automatic upgrade processing](docs/OPERATIONS.md#升级后的自动处理) for scope and recovery.
-
-System diagnostics generate reports and selected scraping records in the background, with progress and cancellation. Network settings show local and phone connection addresses; standalone desktop deployments can change access scope and the local network name.
-
-First-time setup lets you choose the Peach proxy for metadata requests and dependency downloads. Windows, macOS and Docker distributions include an isolated amane runtime; source and wheel installations prepare Peach's locked version automatically when first needed. If preparation fails, pending items remain available for retry after fixing the network or runtime.
-
-Scanning and collection show video and recognizable code counts, with incremental checks for new folders. Traffic estimates use pending work, local caches, deduplicated release codes, and local samples of similar operations. Before starting, you can also review estimated additional disk usage, temporary frame files, and free space on each output drive. Library settings read and save CloudDrive API and data proxies; traffic totals follow each linked folder's connection setting. Proxy protection limits automatic video reads. See [configuration](docs/OPERATIONS.md#配置页) for measurement coverage and estimation limits.
-
-The combined "Send version statistics and error diagnostics (recommended)" option is checked by default. Clear it during installation, first setup or in settings to disable both. Saved opt-out choices are preserved. While enabled, it sends the listed technical fields to Sentry; full logs, diagnostic ZIPs, media details and watch history are excluded. See [remote diagnostics](docs/DIAGNOSTICS.md#可选远程诊断).
-
-Sharing library and taste details is a separate option in the installer and settings, off by default. Review the complete fields and local preview before explicitly consenting to snapshots of works, tags, ratings, viewing summaries and every preference dimension. Each installation can send at most once per UTC week; snapshots without analyzable content wait for data without consuming that opportunity. Account, device and installation identifiers are excluded. Detailed snapshots can still be linked or re-identified, and the receiving service can see the connection IP. See the [diagnostics reference](docs/DIAGNOSTICS.md#馆藏与口味群体研究).
-
-## Screenshots
-
-Try search, filters and profiles in the [live demo](https://demo.peach.video). Its data is for demonstration, and playback controls do not load a video. Screenshots show the movie demo library with illustrative numbers; click for the original PNG. See [asset credits and licenses](https://peach.video/en/credits/) for the sources, attribution and licenses of movie images and profiles.
-
-<table>
- <tr>
- <td width="50%"><a href="https://peach.video/assets/screenshots/home-wide-20261025-2.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/home-wide-20261025-2-1280.webp" alt="Movie demo library filters and video cards" width="600"></a></td>
- <td width="50%"><a href="https://peach.video/assets/screenshots/profile-wide-20261025-2.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/profile-wide-20261025-2-1280.webp" alt="Charlie Chaplin's profile and films in the demo library" width="600"></a></td>
- </tr>
- <tr>
- <td align="center">Library: browse by performer, source and tag</td>
- <td align="center">Person profile: details and films</td>
- </tr>
- <tr>
- <td><a href="https://peach.video/assets/screenshots/follow-wide-20261025-2.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/follow-wide-20261025-2-1280.webp" alt="Creator follows and film updates in the demo library" width="600"></a></td>
- <td><a href="https://peach.video/assets/screenshots/stats-wide-20261025-3.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/stats-wide-20261025-3-1280.webp" alt="Illustrative library and storage statistics in the movie demo" width="600"></a></td>
- </tr>
- <tr>
- <td align="center">Following: creator updates across sites</td>
- <td align="center">Statistics: storage and watch history</td>
- </tr>
- <tr>
- <td colspan="2"><a href="https://peach.video/assets/screenshots/play-wide-20261025-2.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/play-wide-20261025-2-1280.webp" alt="Big Buck Bunny player interface in the movie demo library" width="1200"></a></td>
- </tr>
- <tr>
- <td colspan="2" align="center">Player: film details and playback controls</td>
- </tr>
-</table>
-
-Daily sync discovers new files and completes pending videos; full-library maintenance has a separate menu. Browse series alongside studios and agencies, and filter the catalog by release year. Narrow cards retain release dates on a separate line.
-
-## Download and use
-
-### Windows
-
-1. Download the full installer, `Peach-<version>-windows-x64-setup.exe`, from the [website download section](https://peach.video/#download) and run it. No administrator rights needed. Alternatively, extract the full portable package and run `Peach.exe`.
-2. Choose media directories and access permissions on the setup page that opens in your browser.
-3. Start scanning, then browse and play in your browser.
-
-The full installer includes media tools for offline installation. The smaller lite installer downloads tools as needed during setup.
-
-Windows and macOS packages include the scraping runtime; users do not need to install uv, Python, or Git. Reinstall Peach if the scraping tools are missing or their version does not match.
-
-Test builds are unsigned. If Windows says “Windows protected your PC”, confirm the file came from this project's Releases, then choose “More info → Run anyway”. See the [Windows guide](docs/TESTING_DESKTOP.md) for installation, updates and troubleshooting.
-
-### Build on macOS
-
-Build a self-contained `.app` and DMG locally on macOS, including FFmpeg, ffprobe, untrunc, cloudflared and the face detection and recognition models. Running it requires neither Homebrew, Python, a source checkout, nor another computer. Complete corresponding media tool sources accompany each release. See [the macOS build guide](docs/OPERATIONS.md#macos-独立测试包).
-
-The release workflow generates separate Apple Silicon (`macos-arm64.dmg`) and Intel (`macos-x86_64.dmg`) test packages. Check the actual assets in the [website download section](https://peach.video/#download) for availability. Check your chip in About This Mac, open the matching image, and drag Peach into Applications. Test packages are not notarized.
-
-### Run from source (Windows, macOS)
-
-Requires Git, uv and Python 3.14 or newer. See [running from source](docs/OPERATIONS.md#从源码运行windowsmacos).
-
-### Docker (VPS / NAS)
-
-See [Docker deployment](docs/DOCKER.md) for setup and supported configurations.
-
-For LAN access on fnOS or another NAS, set Compose's `PEACH_BIND` to the NAS LAN IP; the default accepts connections only from the host. Run `peach token` in the container terminal to view the initial login token. Enter the actual container media path; no specific drive letters are required. See [NAS first run](docs/DOCKER.md#飞牛其他-nas-与局域网访问).
-
-## FAQ
-
-- **Can I connect a NAS over SMB?** Enter `smb://server/share/folder` as a media folder, set credentials separately, and test the connection. SMB sources support scanning, playback, organization and deletion according to the account permissions; see [SMB media sources](docs/SMB.md). Compatibility with a particular NAS requires device testing.
-
-- **Will it change my files?** Scanning and filling in details leave originals untouched. Manual organization renames or moves files; emptying the trash deletes files, and resource-sync cleanup removes empty folders. Each requires confirmation.
-- **Which cloud drives work?** Drives mounted as local folders through tools such as CloudDrive2; see [cloud drive mounts](docs/CLOUDDRIVE.md). Cloud download follows the connected provider's reported capabilities, with direct PikPak connections also supported and sign-in tokens stored locally.
-- **How do I watch on my phone?** Allow devices on the same network during setup, connect your phone to that network, open the address shown and set an access password.
-- **Where is my data?** In the local `peach-data` folder. The Windows build defaults to `%LOCALAPPDATA%\Peach\peach-data`; first-run setup lets you pick another drive. Later, **App & maintenance → Storage** shows usage, cleans caches and old backups, and moves the folder elsewhere; see [storage and moving the data directory](docs/OPERATIONS.md#存储空间与迁移数据目录).
-
-## Reporting problems
-
-Check [user feedback](https://github.com/peach-mitao/peach/issues), or [open an issue](https://github.com/peach-mitao/peach/issues/new/choose) with the version, steps, expected result and actual result. Use demo data without sexually explicit imagery in public screenshots, and hide credentials, LAN addresses and full paths; do not upload databases or media. Report security issues privately through the [security policy](SECURITY.md).
-
-## Documentation
-
-[Operations](docs/OPERATIONS.md) · [Sourcing](docs/SOURCING.md) · [External players](docs/EXTERNAL_PLAYERS.md) · [Changelog](CHANGELOG.md)
-
-Contributing: [Development guide](AGENTS.md) · [Testing and dependencies](docs/TESTING.md)
-
-## Related projects
-
-Thanks to [amane](https://github.com/sqzw-x/amane), [Gfriends](https://github.com/gfriends/gfriends), [CloudDrive2](https://www.clouddrive2.com/) and others. See the [reuse inventory](docs/REUSE.md) for full credits and details.
-
-## Star History
-
-<a href="https://www.star-history.com/?repos=peach-mitao%2Fpeach&amp;type=date&amp;logscale=&amp;releases=&amp;legend=top-left">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;theme=dark&amp;logscale&amp;legend=top-left">
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;logscale&amp;legend=top-left">
- <img alt="Peach Star History" src="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;logscale&amp;legend=top-left">
- </picture>
-</a>
-
-## License
-
-[AGPL-3.0-or-later](LICENSE) · Copyright (C) 2026 longmeidao. Third-party components retain their own licenses.
diff --git a/README.md b/README.md
index 5ac80a9ba..c09674188 100644
--- a/README.md
+++ b/README.md
@@ -1,163 +1,84 @@
-<p align="center">
- <img src="resources/peach-logo.png" alt="Peach" width="96">
-</p>
-
-<h1 align="center">Peach</h1>
-
-<p align="center">本地优先的影片刮削与媒体管理工具:整理影片资料,浏览本地硬盘、网盘和创作者更新。</p>
-
-<p align="center">
- <a href="https://peach.video">官网</a> ·
- <a href="https://peach.video/#download">下载安装包</a> ·
- <a href="https://demo.peach.video">在线演示</a> ·
- <a href="https://peach.video/#live">界面导览</a> ·
- <a href="https://github.com/peach-mitao/peach/issues">问题反馈</a> ·
- <a href="https://github.com/orgs/peach-mitao/projects/7/views/1">需求看板</a> ·
- <a href="https://github.com/orgs/peach-mitao/projects/7/views/3">路线图</a> ·
- <a href="#文档">文档</a> ·
- <a href="README.en.md">English</a>
-</p>
+<p align="center"><img src="resources/peach-logo-128.png" alt="Peach" width="88"></p>
-<p align="center">
- <a href="https://gitgud.io/peach-mitao/peach/-/releases"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownloads.peach.video%2Freleases.json&amp;query=%24%5B0%5D.tag_name&amp;label=release" alt="release"></a>
- <a href="https://gitgud.io/peach-mitao/peach/-/pipelines?ref=master"><img src="https://img.shields.io/badge/CI-GitGud-554488?logo=gitlab&amp;logoColor=white" alt="CI 流水线"></a>
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0--or--later-blue?logo=gnu&amp;logoColor=white" alt="license"></a>
- <a href="docs/TESTING_DESKTOP.md"><img src="https://img.shields.io/badge/Windows-x64-0078D4" alt="Windows x64"></a>
- <a href="docs/OPERATIONS.md#macos-独立测试包"><img src="https://img.shields.io/badge/macOS-DMG-555555?logo=apple&amp;logoColor=white" alt="macOS 独立应用构建与安装"></a>
-</p>
+# Peach
-> 仅用于管理自行持有或获授权使用的媒体,并遵守适用法律、版权与来源平台条款,包括来源的年龄和地区限制。Peach 不提供影片资源或付费内容访问权。
+A local-first video metadata scraper and media manager.
-公开截图使用有来源与许可记录的电影演示资料,不含个人馆藏,见[素材来源与许可](https://peach.video/credits/)。仓库包含用于补齐资料的公开文字事实种子与品牌标识,不包含馆藏媒体和用户数据库;连接外部站点需有相应账号和访问权。
+[Website](https://peach.video) · [Download](https://peach.video/#download) · [Live demo](https://demo.peach.video) · [Documentation](#documentation) · [简体中文](README.zh-CN.md)
-## 能做什么
+## Screenshots
-- **本地、网盘一起看**:硬盘与已挂载的 115、PikPak、OneDrive 等网盘汇成一个馆藏。
-- **播放墙挑片**:拖动全屏封面墙,点开原位播放;同一番号的不同版本与分卷集中切换。
-- **播放器字幕**:自动识别视频同目录的配对字幕,也可手动加载字幕,按番号搜索 SubtitleCat 简繁中文字幕并选择加载,调整字体、字号、颜色与背景。每个视频保留加载过的字幕和最后选择,关闭字幕也会记住,再次播放时恢复。在线搜索无需 API Key,来源可能包含机翻。
-- **按习惯播放**:网页播放器支持画面旋转,并按视频在服务端记住旋转、倍速、字幕选择和外观;Windows、macOS 本机可用系统默认播放器或已安装播放器打开,Docker 和远程设备可用网络播放地址与 M3U。见[外部播放器](docs/EXTERNAL_PLAYERS.md)。
-- **接手已有收藏**:直接读取 NFO 和海报,缺少的标题、人物、厂牌与封面可从多个来源补齐,保留手动修改。
-- **进度条看画面**:复用视频旁已有的 Jellyfin Trickplay、Emby/Plex 导出的 BIF、WebVTT、HLS 和 DASH 图片预览,减少重复抽帧。见[格式与命名](docs/VIDEO_PREVIEWS.md)。
-- **减少重复刮削**:随版本附带公开文字资料,扫描后为已识别的人物和厂牌补充别名、来源编号与资料,保留手动修改。见[种子数据边界与更新](docs/SEED.md)。
-- **管理标签**:本地与在线详情共用标签的添加、改名和删除入口;关注管理可合并标签、批量隐藏标签或按标签屏蔽内容并恢复。旧名称留作别名。见[标签管理](docs/TAG_MANAGEMENT.md)。
-- **跨站关注**:按已配置的来源汇总创作者更新,同一作品合成一张卡;来源支持和访问条件见[来源采集](docs/SOURCING.md)。
-- **追新作、找想看的**:按人物订阅新作,按口味发现作品,用「想要」清单留住待找的片子。
-- **云下载**:按番号查找或粘贴磁力,提交到支持云下载的媒体库,落地后自动整理入库。渠道随媒体库与网盘能力生成,支持 CloudDrive2 和 PikPak 直连;提交前须确认具有相应访问与使用权。
-- **从浏览器添加影片**:在支持的资料页识别或选中影片编号,一键交给 Peach 云下载入库。[用户脚本](https://github.com/peach-mitao/peach-userscript)独立维护,来源范围与使用条件见[安装与配对](docs/JAV_BROWSER.md)。
-- **口味**:结合观看、反馈、馆藏、浏览历史、书签与关注关系分析偏好。一次读取本机浏览器的历史和书签,也可导入 HTML 书签或 Chromium Bookmarks JSON;来源可停止读取或删除。见[口味数据来源](docs/TASTE_SOURCES.md)。
+[![Video library with search, filters and posters](https://peach.video/assets/screenshots/home-wide-20261025-2-1280.webp)](https://peach.video/assets/screenshots/home-wide-20261025-2.png)
-观看记录、收藏和设置保存在本机。扫描不动原文件;手动整理先预览,可撤回上一批。文件名带片名也能识别番号,特殊命名可在配置页补写[识别规则](docs/OPERATIONS.md#配置页),不必为 Peach 改名。
+Movie demo data; see [asset credits and licenses](https://peach.video/en/credits/).
-扫描、云下载和媒体处理共用垃圾检查:证据充分的附件自动进回收站,疑似项留待复核;可还原,也可标记「不是垃圾」。处理顺序和保护条件见[垃圾文件](docs/OPERATIONS.md#垃圾文件)。
+<details>
+<summary>More screenshots</summary>
-扫描、关注更新和新作资料采集会保存进度,应用重启后继续处理未完成的项目。外部资料或封面等待较久时,可跳过当前影片;也可停止整趟扫描与采集,保留已取得的结果,停止后不会自动恢复。日常同步只补新增文件与待补全影片,全库维护放在独立菜单。管理页可单独补全已登记影片、导出完整问题清单或归档已结束任务的提示,历史记录仍保留。恢复范围见[断点续跑](docs/OPERATIONS.md#长时任务断点续跑)。
+**People and works**
-升级后自动处理已有资料与缓存,保留人工修改;正常使用无需手动运行迁移脚本。应用和独立用户脚本分别提示更新,页面需要刷新时由你选择。适用范围与异常处理见[升级后的自动处理](docs/OPERATIONS.md#升级后的自动处理)。
+[![Charlie Chaplin's profile and films](https://peach.video/assets/screenshots/profile-wide-20261025-2-1280.webp)](https://peach.video/assets/screenshots/profile-wide-20261025-2.png)
-系统诊断支持后台导出诊断报告和按番号选择的刮削记录,显示生成进度并可取消。网络与访问页显示本机地址和手机连接地址;独立桌面部署可修改访问范围和局域网名称。
+**Creator updates**
-首次设置可选择 Peach 代理,保存后用于资料采集与依赖下载。Windows、macOS 与 Docker 随附 amane 独立运行环境;源码和 wheel 在首次需要时按 Peach 锁定版本自动准备。准备失败会保留待处理项目,修复网络或运行环境后可重试。
+[![Creator follows and new works](https://peach.video/assets/screenshots/follow-wide-20261025-2-1280.webp)](https://peach.video/assets/screenshots/follow-wide-20261025-2.png)
-扫描与采集显示视频与可识别编号数量,首次目录分批预检;流量按待处理资料、缓存、同番号去重和本机同类样本估算,运行中显示已用流量和预计总流量。启动前还可查看预计新增磁盘占用、抽帧临时文件和各盘剩余空间。媒体库设置可读取和保存 CloudDrive 的 API/数据代理,按对应目录的连接方式汇总流量;“代理保护”限制自动读取视频。统计范围与估算限制见[运行与配置](docs/OPERATIONS.md#配置页)。
+**Library statistics**
-「发送版本统计与错误诊断(推荐)」默认勾选,可在安装、首次设置或设置页取消。两类技术事件由同一开关控制,已保存的关闭选择会保留。启用后向 Sentry 发送页面列出的技术字段,不自动上传完整日志、诊断 ZIP、媒体信息或观看记录。见[远程诊断说明](docs/DIAGNOSTICS.md#可选远程诊断)。
+[![Library, storage and viewing statistics](https://peach.video/assets/screenshots/stats-wide-20261025-3-1280.webp)](https://peach.video/assets/screenshots/stats-wide-20261025-3.png)
-馆藏与口味明细上传在安装器和设置页另设独立选项,默认关闭。设置页先展示完整字段与本机预览,经明确同意后,每周最多发送一次包含作品、标签、评分、观看汇总及全部偏好维度的明细;没有可分析内容时等待数据,不占周传输机会。不含账号、设备或安装标识。明细仍有跨次关联与再识别风险,接收服务可见连接 IP。见[馆藏与口味群体研究](docs/DIAGNOSTICS.md#馆藏与口味群体研究)。
+**Player**
-## 截图
+[![Big Buck Bunny player](https://peach.video/assets/screenshots/play-wide-20261025-2-1280.webp)](https://peach.video/assets/screenshots/play-wide-20261025-2.png)
-[在线演示](https://demo.peach.video) 可体验搜索、筛选和资料页;数据仅供演示,播放操作不加载影片。截图使用电影演示库,数字为示例,点击可查看 PNG 原图。作品、图片与人物资料的来源、署名和许可见[素材来源与许可](https://peach.video/credits/)。
+</details>
-<table>
- <tr>
- <td width="50%"><a href="https://peach.video/assets/screenshots/home-wide-20261025-2.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/home-wide-20261025-2-1280.webp" alt="电影演示库:影片筛选与作品卡片" width="600"></a></td>
- <td width="50%"><a href="https://peach.video/assets/screenshots/profile-wide-20261025-2.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/profile-wide-20261025-2-1280.webp" alt="电影演示库:查理·卓别林的资料与作品" width="600"></a></td>
- </tr>
- <tr>
- <td align="center">馆藏:按人物、来源和标签浏览影片</td>
- <td align="center">人物页:资料与作品</td>
- </tr>
- <tr>
- <td><a href="https://peach.video/assets/screenshots/follow-wide-20261025-2.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/follow-wide-20261025-2-1280.webp" alt="电影演示库:创作者关注与作品更新" width="600"></a></td>
- <td><a href="https://peach.video/assets/screenshots/stats-wide-20261025-3.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/stats-wide-20261025-3-1280.webp" alt="电影演示库:示例馆藏与存储统计" width="600"></a></td>
- </tr>
- <tr>
- <td align="center">关注:创作者的跨站更新</td>
- <td align="center">统计:馆藏、存储与观看汇总</td>
- </tr>
- <tr>
- <td colspan="2"><a href="https://peach.video/assets/screenshots/play-wide-20261025-2.png" target="_blank" rel="noopener"><img src="https://peach.video/assets/screenshots/play-wide-20261025-2-1280.webp" alt="电影演示库:Big Buck Bunny 的播放器界面" width="1200"></a></td>
- </tr>
- <tr>
- <td colspan="2" align="center">播放器:影片资料与播放控件示意</td>
- </tr>
-</table>
+## Features
-馆藏可按发行年份多选筛选,并从厂牌、事务所旁进入系列总览。窄卡片保留发行日期,自动换行显示。
+- **Metadata scraping**: recognize video codes, read NFO files and fill titles, performers, studios and covers from multiple sources while keeping your edits.
+- **Local and cloud libraries**: browse local drives, SMB, mounted cloud storage and PikPak libraries together.
+- **Playback and history**: web and external players, subtitles, playback speed, rotation, resume and timeline previews.
+- **Follows and discovery**: track performer and creator updates, discover titles and manage a want list.
+- **Cloud download**: search by video code or submit a magnet link, then organize completed downloads into your library.
+- **Library management**: manage tags, duplicates, versions and parts; metadata and watch history are stored locally.
-## 下载与使用
+## Download and use
-### Windows
+| Method | Get started |
+| --- | --- |
+| Windows | [Installer and portable builds](https://peach.video/#download) |
+| macOS | [Apple Silicon / Intel DMG](https://peach.video/#download) |
+| Docker / NAS | [Deployment guide](docs/DOCKER.md) |
+| Source | [Setup instructions](docs/OPERATIONS.md#从源码运行windowsmacos); requires Git, uv and Python 3.14+ |
-1. 从[官网下载区](https://peach.video/#download)下载完整安装包 `Peach-<版本>-windows-x64-setup.exe`,双击安装,无需管理员权限;也可下载完整免安装包,解压后运行 `Peach.exe`。
-2. 浏览器打开首次设置页后,选择媒体目录和访问范围。
-3. 开始扫描,随后在浏览器里浏览和播放。
+Choose your media folders after installation, then scan to start browsing and playing. Desktop test builds are unsigned, and macOS builds are not notarized. See the [Windows](docs/TESTING_DESKTOP.md) and [macOS](docs/OPERATIONS.md#macos-独立测试包) guides.
-完整安装包携带媒体工具,可离线安装;轻量安装包体积更小,安装时按需下载工具。
+## Documentation
-Windows 与 macOS 安装包均自带采集运行环境,使用者无需另装 uv、Python 或 Git。采集工具缺失或版本不匹配时,请重新安装 Peach。
+[Operations](docs/OPERATIONS.md) · [Sources](docs/SOURCING.md) · [External players](docs/EXTERNAL_PLAYERS.md) · [Diagnostics and data sharing](docs/DIAGNOSTICS.md) · [Changelog](CHANGELOG.md)
-测试版尚未签名。若 Windows 提示「已保护你的电脑」,确认来自本项目的 Release,再点「更多信息 → 仍要运行」。安装、更新和故障排查见 [Windows 使用说明](docs/TESTING_DESKTOP.md)。
+Development: [Contributing](CONTRIBUTING.md) · [Development guide](AGENTS.md) · [Testing](docs/TESTING.md)
-### macOS 本机构建
+## Reporting problems
-macOS 可在本机构建独立 `.app` 与 DMG,内含 FFmpeg、ffprobe、untrunc、cloudflared 和人脸检出与比对模型,安装后不需要 Homebrew、Python、源码或另一台电脑。媒体工具的完整对应源码随同版本制品提供。构建与安装见 [macOS 独立测试包](docs/OPERATIONS.md#macos-独立测试包)。
+[Report a bug or suggest a feature](https://github.com/peach-mitao/peach/issues/new/choose) with your version, steps and error message. Use demo data in public screenshots and redact private information; do not upload videos or databases. Report vulnerabilities privately through the [security policy](SECURITY.md).
-发版流程分别生成 Apple Silicon(`macos-arm64.dmg`)与 Intel(`macos-x86_64.dmg`)测试包;可下载版本以[官网下载区](https://peach.video/#download)的实际资产为准。在「关于本机」确认芯片,打开对应镜像并将 Peach 拖入「应用程序」。测试包未完成 Apple 公证。
+## Related projects
-### 从源码运行(Windows、macOS)
+Thanks to [amane](https://github.com/sqzw-x/amane), [Gfriends](https://github.com/gfriends/gfriends) and [CloudDrive2](https://www.clouddrive2.com/). See the [reuse inventory](docs/REUSE.md) for full credits.
-需要 Git、uv 和 Python 3.14 或更高,步骤见[源码运行](docs/OPERATIONS.md#从源码运行windowsmacos)。
+## Star History
-### Docker(VPS / NAS)
-
-部署步骤与支持范围见 [Docker 部署](docs/DOCKER.md)。
-
-飞牛或其他 NAS 从局域网访问时,需将 Compose 的 `PEACH_BIND` 设为 NAS 的局域网 IP;默认只接受宿主机访问。初始口令在容器终端运行 `peach token` 查看,媒体目录填写容器内实际路径,无需使用指定盘符。见 [NAS 首次运行](docs/DOCKER.md#飞牛其他-nas-与局域网访问)。
-
-## 常见问题
-
-- **支持 NAS 的 SMB 共享吗?** 可在媒体目录中填写 `smb://服务器/共享/目录`,单独设置账号并测试连接。按账号权限读取、播放、整理和删除,详见 [SMB 媒体来源](docs/SMB.md);具体 NAS 的兼容性需实机验证。
-
-- **会改我的文件吗?** 扫描、补资料不碰原文件。手动整理会改名或移动;清空回收站会删除文件,资源同步中的清理会删除空目录,均需确认。
-- **支持哪些网盘?** 通过 CloudDrive2 等工具挂载为本地目录的网盘,详见[网盘挂载](docs/CLOUDDRIVE.md);云下载按当前连接器返回的能力开放,PikPak 也可直连,登录令牌保存在本机。
-- **手机上怎么看?** 首次设置时允许同一局域网的设备访问,手机连同一网络,打开设置页给出的地址,并设置访问密码。
-- **数据存在哪?** 本机的 `peach-data` 文件夹;Windows 版默认位于 `%LOCALAPPDATA%\Peach\peach-data`,首次设置时可改到其他磁盘。之后可在「应用与维护 → 存储空间」查看占用、清理缓存与旧备份,或迁移到其他位置,见[存储空间与迁移数据目录](docs/OPERATIONS.md#存储空间与迁移数据目录)。
-
-## 问题反馈
-
-先查看[用户反馈](https://github.com/peach-mitao/peach/issues),或[提交问题](https://github.com/peach-mitao/peach/issues/new/choose),附上版本、操作步骤、预期与实际结果。公开截图使用不含露骨画面的演示资料,遮掉凭据、局域网地址和完整路径,不要上传数据库或媒体;安全问题按[安全政策](SECURITY.md)私下报告。
-
-## 文档
-
-[运行与配置](docs/OPERATIONS.md) · [来源采集](docs/SOURCING.md) · [外部播放器](docs/EXTERNAL_PLAYERS.md) · [变更日志](CHANGELOG.md)
-
-参与开发:[开发约定](AGENTS.md) · [测试与依赖](docs/TESTING.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://www.star-history.com/?repos=peach-mitao%2Fpeach&amp;type=date&amp;logscale=&amp;releases=&amp;legend=top-left">
+<a href="https://www.star-history.com/?repos=peach-mitao%2Fpeach&amp;type=date&amp;releases=&amp;legend=top-left">
<picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;theme=dark&amp;logscale&amp;legend=top-left">
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;logscale&amp;legend=top-left">
- <img alt="Peach Star 历史" src="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;logscale&amp;legend=top-left">
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;theme=dark&amp;releases=&amp;legend=top-left">
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;releases=&amp;legend=top-left">
+ <img alt="Peach cumulative stars, linear scale" src="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;releases=&amp;legend=top-left">
</picture>
</a>
-## 许可证
+## License
+
+[AGPL-3.0-or-later](LICENSE) · Copyright (C) 2026 longmeidao. Third-party components retain their own licenses.
-[AGPL-3.0-or-later](LICENSE) · Copyright (C) 2026 longmeidao。第三方组件保留各自的许可证。
+Manage only media you own or are authorized to use, subject to laws, copyright and source-platform access, age and regional restrictions. Peach does not provide video resources or access to paid content.
diff --git a/README.zh-CN.md b/README.zh-CN.md
new file mode 100644
index 000000000..093277910
--- /dev/null
+++ b/README.zh-CN.md
@@ -0,0 +1,84 @@
+<p align="center"><img src="resources/peach-logo-128.png" alt="Peach" width="88"></p>
+
+# Peach
+
+本地优先的影片刮削与媒体管理工具。
+
+[官网](https://peach.video) · [下载](https://peach.video/#download) · [在线演示](https://demo.peach.video) · [文档](#文档) · [English](README.md)
+
+## 截图
+
+[![影片馆藏:搜索、筛选与海报墙](https://peach.video/assets/screenshots/home-wide-20261025-2-1280.webp)](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-1280.webp)](https://peach.video/assets/screenshots/profile-wide-20261025-2.png)
+
+**创作者关注**
+
+[![创作者关注与作品更新](https://peach.video/assets/screenshots/follow-wide-20261025-2-1280.webp)](https://peach.video/assets/screenshots/follow-wide-20261025-2.png)
+
+**馆藏统计**
+
+[![馆藏、存储与观看统计](https://peach.video/assets/screenshots/stats-wide-20261025-3-1280.webp)](https://peach.video/assets/screenshots/stats-wide-20261025-3.png)
+
+**播放器**
+
+[![Big Buck Bunny 播放器](https://peach.video/assets/screenshots/play-wide-20261025-2-1280.webp)](https://peach.video/assets/screenshots/play-wide-20261025-2.png)
+
+</details>
+
+## 能做什么
+
+- **影片刮削**:识别影片编号,读取 NFO,多来源补齐标题、演员、厂牌和封面,保留人工修改。
+- **本地与网盘**:统一浏览本地硬盘、SMB、已挂载网盘和 PikPak 媒体库。
+- **播放与记录**:网页与外部播放器、字幕、倍速、旋转、续播和时间轴预览。
+- **关注与发现**:订阅人物与创作者更新,发现作品,管理「想要」清单。
+- **云下载**:按影片编号查找或提交磁力,下载完成后整理入库。
+- **馆藏管理**:管理标签、重复文件、多版本与分卷;资料和观看记录保存在本机。
+
+## 下载与使用
+
+| 方式 | 入口 |
+| --- | --- |
+| Windows | [安装包与免安装包](https://peach.video/#download) |
+| macOS | [Apple Silicon / Intel DMG](https://peach.video/#download) |
+| 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://www.star-history.com/?repos=peach-mitao%2Fpeach&amp;type=date&amp;releases=&amp;legend=top-left">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;theme=dark&amp;releases=&amp;legend=top-left">
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;releases=&amp;legend=top-left">
+ <img alt="Peach 累计 Star 数,线性坐标" src="https://api.star-history.com/svg?repos=peach-mitao/peach&amp;type=date&amp;releases=&amp;legend=top-left">
+ </picture>
+</a>
+
+## 许可证
+
+[AGPL-3.0-or-later](LICENSE) · Copyright (C) 2026 longmeidao。第三方组件保留各自的许可证。
+
+仅管理自行持有或获授权使用的媒体,遵守法律、版权及来源平台的访问、年龄和地区限制。Peach 不提供影片资源或付费内容访问权。
diff --git a/docs/README_MAINTENANCE.md b/docs/README_MAINTENANCE.md
index d1c070e8a..d2d3b1c9f 100644
--- a/docs/README_MAINTENANCE.md
+++ b/docs/README_MAINTENANCE.md
@@ -1,8 +1,11 @@
# README 维护
+默认入口 `README.md` 使用英文,简体中文版为 `README.zh-CN.md`;两种语言同批核对。
+
1. 按下表核对本次涉及的能力、安装方式与限制。
2. 同批核对中英文 README,修改需要调整的内容,保留使用入口和安全说明。
-3. 按 [文档与界面文案](WRITING.md#检查与复核) 检查,再运行 [正式测试入口](TESTING.md#正式入口)。
+3. 用 documd 提供当前稿的可视化预览,取得用户明确确认后才能推送 README;继续修改时确认对应的新稿。
+4. 按 [文档与界面文案](WRITING.md#检查与复核) 检查,再运行 [正式测试入口](TESTING.md#正式入口)。
README 面向初次访问项目的人,依次讲它是什么、界面导览与截图、能做什么、怎么装、常见问题、
问题反馈和文档入口。用使用者的话写:说能做什么、会不会动文件,不写账本、候选、实体这类内部
@@ -24,8 +27,8 @@ README 迭代绑定 Codex 与 Claude 共用的工作树交付流程。每次提
| 判断 | 提交消息末尾的独立字段 |
| --- | --- |
| 已更新两份 README | `README-Impact: updated; 同步了哪些用户说明` |
-| 只需修改中文 README | `README-Impact: updated; 中文修改原因`,另加 `README-Reviewed: README.en.md; 英文无需修改的原因` |
-| 只需修改英文 README | `README-Impact: updated; 英文修改原因`,另加 `README-Reviewed: README.md; 中文无需修改的原因` |
+| 只需修改中文 README | `README-Impact: updated; 中文修改原因`,另加 `README-Reviewed: README.md; 英文无需修改的原因` |
+| 只需修改英文 README | `README-Impact: updated; 英文修改原因`,另加 `README-Reviewed: README.zh-CN.md; 中文无需修改的原因` |
| 不影响 README | `README-Impact: none; 具体原因` |
声明与 `Co-Authored-By` 等其它 trailer 连续写在提交消息末尾的同一块里,彼此之间不留空行。
@@ -114,6 +117,5 @@ SHA-256 对不上是硬错误,不降级放行。
使用条款,Peach 的边界以 AGPL 与 `SECURITY.md` 为准。
- **演示素材**:README 里任何截图或视频都按上面「演示数据集」一节的边界取图,换素材时重新核对
那几条边界。
-- **篇幅取舍(2026-10-17)**:复读已登记的 amane、Stash 与 OpenAver 原文,并核对线上 README。采用 amane 的短功能列表与安装入口,保留 Peach 的演示、全部五张截图、六条特色和必要安全说明;源码安装步骤集中在 [运行与配置](OPERATIONS.md#从源码运行windowsmacos)。路由、字段判据、缓存周期、更新包机制与开发流程由专题文档承载。
-- **截图与 Star 历史(2026-10-17)**:截图沿用 `a5f979d6^` 的双列表格,播放墙独占一行,五张 WebP 均链接 PNG 原图。Star History 依据官方 [`EmbedMarkdownSection.tsx`](https://github.com/star-history/star-history/blob/608d0e39be441665c01cd6ac1fd01ca5ec1eaf39/frontend/components/EmbedMarkdownSection.tsx) 使用 `/svg`,保留深浅主题并链接用户指定的交互页。实测 `/chart` 与 `/svg` 均返回 HTTP 200、SVG 类型及 `Cache-Control: public, s-maxage=86400, max-age=86400`;同版本 [`cache.ts`](https://github.com/star-history/star-history/blob/608d0e39be441665c01cd6ac1fd01ca5ec1eaf39/backend/cache.ts) 将数据与 SVG 缓存各设为 24 小时。交互页 URL 仅改变点击去向,不能保证嵌入图片即时刷新;README 不显示实时性承诺。
-- **交互图与嵌入图(2026-10-17)**:用户截图显示纵轴为 0、10、100;嵌入接口使用 `logscale` 得到相同刻度。官方同版本 [`StarChartViewer.tsx`](https://github.com/star-history/star-history/blob/608d0e39be441665c01cd6ac1fd01ca5ec1eaf39/frontend/components/StarChartViewer.tsx) 在浏览器调用 GitHub,并在页面内存中复用结果;24 小时服务端缓存针对嵌入图片接口,不能据此判断官网交互图的数据新鲜度。官网 `https://peach.video` 位于中英文 README 顶部导航。
+- **篇幅取舍(2026-10-27)**:参考 amane 的一行一功能与安装入口,以及 SakuraMedia 的主图与折叠截图。README 保留六条特色、安装表、文档导航和必要限制;参数、缓存、任务恢复、诊断与升级细节由专题文档承载。当前原文版本见 `docs/reference-sources.json`,不复制外部文案或使用条款。
+- **截图与 Star 历史(2026-10-27)**:五张电影演示库截图保留,首页主图直接展示,其余四张折叠;WebP 均链接 PNG 原图。Star History 使用 `/svg`,按用户要求展示累计 Star 数的线性坐标,图表与交互页均不传 `logscale`;保留深浅主题。接口缓存不代表实时数据,README 不承诺即时刷新。
diff --git a/docs/reference-snapshots/upstream/readme-sakuramedia.md b/docs/reference-snapshots/upstream/readme-sakuramedia.md
index a364e29b1..409243fd1 100644
--- a/docs/reference-snapshots/upstream/readme-sakuramedia.md
+++ b/docs/reference-snapshots/upstream/readme-sakuramedia.md
@@ -1,74 +1,222 @@
<p align="center">
- <img src="./wiki/public/brand/sakuramedia-logo.png" alt="SakuraMedia logo" width="96" />
+ <img src="./wiki/public/brand/sakuramedia-logo.png" alt="SakuraMedia logo" width="88" />
</p>
<h1 align="center">SakuraMedia</h1>
<p align="center">
- 收藏久了,我开始在意:这部影片里,我究竟想留下什么?<br />
- <a href="https://tinypinglite.github.io/sakuramedia/guide/collection-strategy"><strong>为什么做 SakuraMedia:让喜欢的内容留下来 →</strong></a>
+ <strong>把本地和网盘里的影片,变成可搜索、可订阅、可续看的媒体库。</strong>
</p>
-
<p align="center">
- <img src="./wiki/public/images/sakuramedia-home-hero.png" alt="SakuraMedia 海报图" width="1100" />
+ 面向自建媒体库的用户:后端可部署在 NAS、迷你主机、服务器或 VPS 上;影片可以存本地,也可以存 115 网盘。
</p>
<p align="center">
- <a href="https://tinypinglite.github.io/sakuramedia/"><strong>查看 Wiki</strong></a>
+ <a href="https://github.com/tinypinglite/sakuramedia/releases/latest"><strong>下载客户端</strong></a>
·
- <a href="https://tinypinglite.github.io/sakuramedia/guide/quick-start"><strong>快速开始</strong></a>
+ <a href="https://tinypinglite.github.io/sakuramedia/guide/quick-start"><strong>部署后端</strong></a>
·
- <a href="https://tinypinglite.github.io/sakuramedia/guide/plugin-development"><strong>插件开发</strong></a>
+ <a href="https://tinypinglite.github.io/sakuramedia/"><strong>查看 Wiki</strong></a>
·
- <a href="https://github.com/tinypinglite/sakuramediabe"><strong>后端项目</strong></a>
+ <a href="https://tinypinglite.github.io/sakuramedia/videos/sakuramedia-demo.mp4"><strong>看演示</strong></a>
+</p>
+
+<p align="center">
+ <a href="https://github.com/tinypinglite/sakuramedia/releases/latest"><img src="https://img.shields.io/github/v/release/tinypinglite/sakuramedia?style=flat-square" alt="Latest release" /></a>
+ <a href="./LICENSE"><img src="https://img.shields.io/badge/license-PolyForm%20Noncommercial%201.0.0-blue?style=flat-square" alt="License" /></a>
+</p>
+
+<p align="center">
+ <sub>需要一台 24 小时运行的主机 + Docker;客户端不能单独使用。</sub>
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/home-hero.jpg" alt="SakuraMedia 界面预览" width="1100" />
+</p>
+
+<p align="center">
+ 收藏久了,我开始在意:这部影片里,我究竟想留下什么?<br />
+ <a href="https://tinypinglite.github.io/sakuramedia/guide/collection-strategy"><strong>为什么做 SakuraMedia →</strong></a>
</p>
## 核心功能
-- 🔍 **发现与追踪**:按番号搜索影片、按姓名查找女优,通过标签、排行榜和推荐逛内容;订阅女优后持续追踪她的新作。
-- 📥 **订阅与自动入库**:订阅影片后,系统定期寻找合适资源、提交下载,并在完成后自动导入媒体库;暂无资源的影片可以先留在订阅清单里等待。
-- 📦 **本地导入与刮削**:直接导入 NAS 或网盘里已有的影片,自动识别番号、刮削元数据与封面;识别或获取失败的条目支持手动搜索匹配。
-- 🎬 **独立 APP + 缩略图辅助观影**:SakuraMedia 客户端内置缩略图时间轴,把影片画面按时间展开,点击即可跳到对应画面,快速预览场景、定位精彩片段;配合倍速、字幕与续播,也支持调用外部播放器。
-- 🥽 **VR 影片播放**:支持调用外部播放器播放 VR 影片,多分段资源可合并为完整影片连续播放;实验性支持 Pico 等 VR 设备以 2D 形式使用。
-- 🖼️ **以图搜图**:用喜欢的画面或文字描述检索库内相似内容(可选功能)。
-- ❤️ **收藏与整理**:用播放列表、时刻、切片和各自的合集,留下想回看的画面与片段。
-- 🗂️ **媒体库管理**:查看重复文件、多版本和失效媒体,并可在支持的存储之间迁移,保留媒体记录与播放进度。
-- 🧬 **文件指纹**:专属的采样指纹算法,只读取少量文件片段就能快速识别重复媒体,跨媒体库、跨存储都适用。
-- 🔔 **任务与通知**:集中查看下载、导入和后台任务的进度与结果,通过通知接收提醒,并提供扩展机制可接入多种通知渠道。
-- 💾 **可扩展的存储与下载**:目前支持本地存储 + qBittorrent,以及 115 网盘并配置 115 离线下载;存储与下载能力通过插件接入,后续可继续扩展。
-- 🧩 **插件化扩展**:提供多种插件能力机制,排行榜来源、字幕获取和女优资料补全等能力,都可以通过插件按需启用。
-- 💻 **多客户端**:通过flutter开发,提供 Windows、macOS、iOS、Android 客户端;
+从找片、下载到观看和整理,当前版本覆盖以下能力。
-## 社区支持
+### 找片与获取
-- 发现 Bug:[提交 Issue](https://github.com/tinypinglite/sakuramedia/issues)
-- 使用交流或求助:[参与 Discussions](https://github.com/tinypinglite/sakuramedia/discussions)
-- 敏感问题(涉及 APP 截图、影片截图等不宜公开的内容):[加入 Telegram 群](https://t.me/+ysbUBDExCsw5N2Jh)
+- 🔍 **发现与订阅**:按番号搜索、按姓名查找女优;标签、排行榜、推荐;订阅女优持续追踪新作(不会自动下载她的全部作品)。
+- 📥 **自动下载与入库**:订阅影片后定期寻找资源,通过 qBittorrent 或 115 离线下载;完成后自动导入媒体库,暂无资源的影片留在订阅清单。
+- 📦 **导入与信息补全**:导入本地磁盘、NAS 挂载目录或 115 网盘;识别番号,刮削并补全标题、演员、封面等信息;识别失败可手动匹配。
-- **项目当前处理快速迭代阶段, 如遇问题可尝试将前后端以及各个插件升级到最新版本**
+### 观看与留下
+- 🎬 **播放与时刻**:缩略图时间轴定位画面;标记时刻;把一段画面切成独立视频;支持倍速、字幕、续播和外部播放器。
+- 🥽 **VR 播放**:调用外部播放器播放 VR 影片;多分段资源可合并连续播放;实验性支持 Pico 等设备以 2D 形式使用。
+- 🖼️ **以图搜图**:用缩略图、剧情图或文字描述,找其他影片里的相似画面;有可播放来源的结果可直接跳到对应时间(可选,需额外部署嵌入服务;只搜已索引的库内图片)。
+- ❤️ **收藏与整理**:播放列表、时刻合集、切片合集;用合集组织想回看的内容。
+> 时刻依赖来源媒体;切片是独立视频文件。
+### 普通视频(PornBox)
-## 参与贡献
+- 📼 **普通视频导入**:在「媒体导入 → 视频」选择存储中的目录或视频文件,导入时可直接加入合集;不需要番号,也不走 JAV 的订阅与下载流程。
+- 🗂️ **合集组织**:在合集详情查看成员、手动排序,加入或移出成员;点「播放全部」按当前顺序开始。
+- 🔗 **合集连播**:右侧缩略图面板把各集关键帧拼成一条;滚动或点选即可跳到对应视频和画面,播完自动进入下一部。
+- 📌 **连播中标记时刻**:缩略图右键 →「添加标记」;时刻仍绑定具体视频和媒体,不会因为连播丢失。同一菜单也可以保存到本地;启用以图搜图后还能搜相似图片。
+
+> PornBox 与 JAV 的番号、订阅和下载流程相互独立;合集只负责组织已经入库的普通视频。
+
+### 管理与扩展
+
+- 🗂️ **媒体库管理**:查看重复文件、多版本和失效媒体;采样文件指纹只读少量片段,跨库/跨存储识别重复。把本地影片通过 115 秒传迁移到网盘,保留媒体记录与播放进度;未命中会跳过并保留源文件。
+- 🔔 **任务与通知**:任务中心查看下载、导入和后台任务;通知提醒,通知渠道可扩展。
+- 🧩 **插件扩展**:存储、下载、排行榜、字幕、女优资料补全等能力通过插件接入。
+- 💻 **多客户端**:Windows / macOS / Android / iOS;桌面端负责配置和集中管理,移动端用于浏览和观看,具体入口因平台而异。
+
+## 界面
+
+> 截图使用演示数据,封面与缩略图已虚化。完整演示见下方视频。
-此项目不需要捐赠,如果对你有用,可以点个Star,如果你想要帮助改进这个项目,可以通过以下方式参与进来:
+<p align="center">
+ <img src="./wiki/public/images/readme/carousel.gif" alt="界面轮播" width="900" />
+</p>
+<p align="center">
+ <sub>概览 / 发现 / 详情 / 播放器 / 切片 / PornBox</sub>
+</p>
+
+<p align="center">
+ <a href="https://tinypinglite.github.io/sakuramedia/videos/sakuramedia-demo.mp4"><strong>▶ 看 45 秒完整演示</strong></a>
+</p>
+
+<details>
+<summary><strong>更多截图</strong></summary>
-- 帮助撰写和改进Wiki
-- 开发新的插件扩展新功能,可以查看[插件开发文档](https://tinypinglite.github.io/sakuramedia/guide/plugin-development.html)
-- 将自己开发的插件上架插件市场:向 [sakuramedia-plugin-market](https://github.com/tinypinglite/sakuramedia-plugin-market) 提交 Pull Request,附上插件用途与仓库地址(仓库需公开、Release 提供安装包)。
-- Bug修复 / 新功能 PR
+<p align="center">
+ <img src="./wiki/public/images/readme/desktop-overview.png" alt="概览" width="1100" />
+</p>
+<p align="center">
+ <sub>概览:媒体资产、观看趋势、存储分布</sub>
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/desktop-discover.png" alt="发现页" width="49%" />
+ <img src="./wiki/public/images/readme/desktop-detail.png" alt="影片详情" width="49%" />
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/desktop-player.png" alt="播放器与缩略图时间轴" width="1100" />
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/thumbnail-menu.png" alt="从缩略图搜相似画面" width="1100" />
+</p>
+<p align="center">
+ <sub>从缩略图右键 → 相似图片</sub>
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/thumbnail-timeline.gif" alt="缩略图时间轴演示" width="400" />
+ <img src="./wiki/public/images/readme/clip-selection.png" alt="圈选切片" width="400" />
+</p>
+<p align="center">
+ <sub>缩略图时间轴 / 圈选切片</sub>
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/clips-page.png" alt="切片页" width="1100" />
+</p>
+<p align="center">
+ <sub>切片页:浏览、播放、加入合集</sub>
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/pornbox-collection.png" alt="PornBox 合集详情" width="1100" />
+</p>
+<p align="center">
+ <sub>PornBox 合集:成员、手动顺序、播放全部</sub>
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/pornbox-timeline.png" alt="合集连播缩略图与添加标记" width="420" />
+</p>
+<p align="center">
+ <sub>合集连播:缩略图面板按合集拼接;右键 → 添加标记</sub>
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/desktop-image-search.png" alt="以图搜图" width="1100" />
+</p>
+
+<p align="center">
+ <img src="./wiki/public/images/readme/mobile-home.png" alt="移动端" width="260" />
+</p>
+
+</details>
+
+## 怎么存、怎么下
+
+NAS 不是必须的:后端可以跑在任何能长期运行 Docker 的机器上,影片存在哪里由存储插件决定。
+
+| 组合 | 存储 | 下载 | 适合 |
+| --- | --- | --- | --- |
+| 💾 本地 + qBittorrent(后端镜像预装) | 本地磁盘 / NAS 挂载目录 | qBittorrent | 有本地空间,希望影片留在自己手里 |
+| ☁️ 115 网盘 + 离线下载 | 115 网盘 | 115 离线下载 | 不想占本地空间,适合迷你主机、服务器或 VPS |
+| ☁️ 光鸭云盘 + 云添加 | 光鸭云盘 | 光鸭云添加 | 不想占本地空间,适合迷你主机、服务器或 VPS |
+
+> 存储和下载都通过插件接入。后端镜像已预装「本地存储与 qBittorrent」;115 网盘和光鸭云盘是可选插件,需要自行在「系统设置 → 插件」中安装。
+
+## 下载与安装
+
+客户端从 [GitHub Releases](https://github.com/tinypinglite/sakuramedia/releases/latest) 下载。Windows 和 macOS 安装包当前未签名,系统可能提示来源不明;请确认下载来源后按系统提示允许运行。
+
+| 平台 | 安装包 | 说明 |
+| --- | --- | --- |
+| Windows | `sakuramedia-windows-*-setup-unsigned.exe` | 未签名;SmartScreen 提示时选择「更多信息 → 仍要运行」 |
+| macOS | `sakuramedia-macos-*-unsigned.dmg` | 未签名;首次打开需右键 → 打开,或在「隐私与安全性」中允许 |
+| Android | `sakuramedia-android-*-release-signed.apk` | 直接安装;系统可能提示未知来源 |
+| iOS | `sakuramedia-ios-*-sidestore-ready.ipa` | 需要 iOS 15.0+,通过 SideStore 或自签工具安装;没有侧载经验建议先用桌面端 |
+
+> **版本配套**:客户端、后端和插件需要配套升级。下载客户端后,请查看对应 Release 说明中的最低后端版本;跨版本混用可能出现接口错误。后端项目:[tinypinglite/sakuramediabe](https://github.com/tinypinglite/sakuramediabe)。
+
+## 快速开始
+
+1. **部署后端**:按 [快速开始](https://tinypinglite.github.io/sakuramedia/guide/quick-start) 用 Docker Compose 启动后端,默认端口 `38000`。后端建议 4 核 CPU、2GB 以上内存,运行数据放在 SSD;影片存 115 时不需要大容量本地盘。
+2. **下载并登录客户端**:首次登录填写后端地址,例如 `http://你的IP:38000`;默认账号 `account / account`,登录后请立即修改密码。
+3. **创建媒体库并导入影片**:后端镜像已预装「本地存储与 qBittorrent」,创建媒体库后即可导入宿主机上已有的影片;需要自动下载时,再按 [自动下载与索引器](https://tinypinglite.github.io/sakuramedia/guide/auto-download) 配置 qBittorrent 和索引器(Jackett / Prowlarr)。
+
+完整步骤、路径映射、自动下载和插件选择见 [快速开始](https://tinypinglite.github.io/sakuramedia/guide/quick-start)、[容器路径与硬链接](https://tinypinglite.github.io/sakuramedia/guide/container-paths)、[自动下载与索引器](https://tinypinglite.github.io/sakuramedia/guide/auto-download) 与 [推荐插件](https://tinypinglite.github.io/sakuramedia/guide/plugins)。
+
+## 适合谁
+
+**适合**:有 NAS、迷你主机、服务器或 VPS 等可长期运行的环境,希望把影片发现、下载、导入和观看放在一个地方的人。
+
+**不适合**:没有可长期运行的环境、希望装个 App 就能直接看,或不愿意做任何后端/插件配置的人。SakuraMedia 不提供影片资源,也不内置资源站点。
+
+## 社区与支持
+
+- 发现 Bug 或有功能建议:[提交 Issue](https://github.com/tinypinglite/sakuramedia/issues)。请附上客户端、后端和插件版本、复现步骤与相关日志;请勿上传不宜公开的影片截图、封面或个人信息。
+- 使用交流或求助:[参与 Discussions](https://github.com/tinypinglite/sakuramedia/discussions)。
+- 遇到连接或导入问题,先在「概览 → 组件诊断」检查媒体库、索引器、JavDB 和嵌入服务的连通性。
+- 也可以把 `wiki/` 目录的 Markdown 交给 AI,说明你的问题和已尝试的步骤,通常能更快定位。
+- 项目处于快速迭代阶段;升级前请查看 Release 说明,前后端与插件尽量一起升级。
+
+## 参与贡献
+- 点一个 Star,让更多人看到这个项目。
+- 帮助改进 [Wiki](https://tinypinglite.github.io/sakuramedia/) 和文档。
+- 开发插件:查看 [插件开发文档](https://tinypinglite.github.io/sakuramedia/guide/plugin-development);上架插件市场请向 [sakuramedia-plugin-market](https://github.com/tinypinglite/sakuramedia-plugin-market) 提交 PR。
+- 提交 Bug 修复或新功能 PR。客户端使用 Flutter 开发,当前基线为 3.47.2;`flutter pub get` 后可用 `./scripts/test.sh -j 4` 运行测试。
+本项目不需要捐赠;Star、文档、插件和 PR 都是帮助。
-<h2 align="center">风险与声明</h2>
+## 风险与声明
-* 本项目仅用于技术交流
-* 不提供任何影片资源以及资源下载链接等.
-* 用户使用本工具产生的一切后果由使用者自行承担,和作者无关.
-* 用户在使用本软件前,请用户了解并遵守当地法律法规,如果本软件使用过程中存在违反当地法律法规的行为,请勿使用该软件.
-* 禁止将本软件用于商业用途
-* 若用户不同意上述条款任意一条,请勿使用本软件
-- License: [GNU GPL v3](./LICENSE)
+- 本项目仅用于技术交流,不提供任何影片资源或下载链接。
+- 用户使用本工具产生的一切后果由使用者自行承担,与作者无关。
+- 请在使用前了解并遵守当地法律法规;如使用行为违反当地法律,请勿使用。
+- 禁止将本软件用于商业用途。
+- 若不同意上述任意一条,请勿使用。
+- License: [PolyForm Noncommercial 1.0.0](./LICENSE)
<h2 align="center">Star History</h2>
diff --git a/docs/reference-sources.json b/docs/reference-sources.json
index d79ca83db..91b7d2f3e 100644
--- a/docs/reference-sources.json
+++ b/docs/reference-sources.json
@@ -525,7 +525,7 @@
"role": "短定位、下载与文档入口、精简功能层级;Peach 仅借鉴信息结构。",
"consumers": [
"README.md",
- "README.en.md"
+ "README.zh-CN.md"
]
},
{
@@ -539,7 +539,7 @@
"role": "小尺寸具象 Logo 配短介绍;Peach 使用自己的桃形 Logo,不复制上游品牌素材。",
"consumers": [
"README.md",
- "README.en.md"
+ "README.zh-CN.md"
]
},
{
@@ -553,7 +553,7 @@
"role": "集中导航与图片替代文本;Peach 统一三枚 flat 徽章,不复制长功能清单。",
"consumers": [
"README.md",
- "README.en.md"
+ "README.zh-CN.md"
]
},
{
@@ -644,7 +644,7 @@
"role": "同类本地馆藏管理器的信息组织:人物页三个直达入口、本地作品与作品总数并列、页头的数据质量计数。源码未公开(README 自己写着这一条),结论来自 README 与它挂的 5 张演示图,加上论坛帖里 8 张真实截图的测读;截图给不出可哈希的上游字节,登记的是 README 本体。Peach 不复制它的界面,只取这三处的组织方式。README 另取它的页头链接行、粗体引导的主要功能短列表和「问题反馈要附什么、遮盖什么」的写法。",
"consumers": [
"README.md",
- "README.en.md"
+ "README.zh-CN.md"
]
},
{
@@ -663,7 +663,7 @@
"role": "同类本地影片管理器的 README 信息结构:页头几条粗体承诺、规格速览表、截图表与常见问题。Peach 只借结构,不复制文案、截图、功能承诺与免责声明条款。",
"consumers": [
"README.md",
- "README.en.md"
+ "README.zh-CN.md"
]
},
{
@@ -672,17 +672,17 @@
"name": "amane 说明",
"url": "https://raw.githubusercontent.com/sqzw-x/amane/main/README.md",
"snapshot": "docs/reference-snapshots/upstream/readme-amane.md",
- "checked_on": "2026-10-13",
+ "checked_on": "2026-10-27",
"sha256": "eeb3a4313b593d38847abab0135df7b19b60dbe983daed684ede01813d589036",
"git": {
"repository": "https://github.com/sqzw-x/amane.git",
"ref": "refs/heads/main",
- "revision": "cc42cee6ecf290cf05af1caa347d2dc2d5aeffcd"
+ "revision": "01c6695df643b615adf660ab57fe0f93d229ba51"
},
"role": "同类项目的极简 README:一行一个功能、安装只给入口、开发说明压到最后。Peach 只借篇幅控制,不复制文案。",
"consumers": [
"README.md",
- "README.en.md"
+ "README.zh-CN.md"
]
},
{
@@ -701,7 +701,7 @@
"role": "自托管成人馆藏应用的 README:一句定位加大截图、演示视频入口、首次运行的未签名提示与 FFmpeg 说明。Peach 只借这几处的位置,不复制文案与截图。",
"consumers": [
"README.md",
- "README.en.md"
+ "README.zh-CN.md"
]
},
{
@@ -720,7 +720,7 @@
"role": "同类元数据插件的 README:功能一行一条、详细说明全部链到文档。Peach 只借「README 不展开细节」的做法。",
"consumers": [
"README.md",
- "README.en.md"
+ "README.zh-CN.md"
]
},
{
@@ -739,7 +739,7 @@
"role": "同类刮削器的 README:上游项目谱系与致谢写法。Peach 只借致谢的位置,不复制附加使用条款。",
"consumers": [
"README.md",
- "README.en.md"
+ "README.zh-CN.md"
]
},
{
@@ -790,15 +790,18 @@
"name": "SakuraMedia 客户端说明",
"url": "https://raw.githubusercontent.com/tinypinglite/sakuramedia/main/README.md",
"snapshot": "docs/reference-snapshots/upstream/readme-sakuramedia.md",
- "checked_on": "2026-10-13",
- "sha256": "09ddc717b3ba9e62abc0846a0cb265d02ad3bdb32b451c516e44a30b537f38fc",
+ "checked_on": "2026-10-27",
+ "sha256": "6fd3716a2487187f946bc4ed9bc2d7f04133542f32698c00334bcb162a209114",
"git": {
"repository": "https://github.com/tinypinglite/sakuramedia.git",
"ref": "refs/heads/main",
- "revision": "8cfc99b7963404694ae563ef0d1f3af58254b195"
+ "revision": "17b5fe414c273437ef5586480f097c9f862d5174"
},
- "role": "SakuraMedia 的 Flutter 客户端只作行为证据:诊断提示的「原因、修法、跳转」三元组(待办第 26 条)、先看画面再选片(第 49 条)与多端原生客户端(第 70 条)。",
- "consumers": []
+ "role": "README 的主图、折叠截图与安装导航;诊断提示、播放交互和多端客户端仅作产品行为证据,不复制源码、文案或功能承诺。",
+ "consumers": [
+ "README.md",
+ "README.zh-CN.md"
+ ]
},
{
"id": "readme-neoavdc",
diff --git a/scripts/check_copy_final_state.py b/scripts/check_copy_final_state.py
index 06d45aba5..ed7e22750 100644
--- a/scripts/check_copy_final_state.py
+++ b/scripts/check_copy_final_state.py
@@ -122,7 +122,7 @@ def scan_html(path: str, source: str) -> list[Finding]:
def targets(root: Path) -> list[Path]:
- picked = [root / name for name in ("AGENTS.md", "README.md", "README.en.md")]
+ picked = [root / name for name in ("AGENTS.md", "README.md", "README.zh-CN.md")]
picked.extend(sorted((root / "docs").glob("*.md")))
picked.extend(sorted((root / ".claude/skills").glob("*/SKILL.md")))
picked.extend(sorted((root / "web").glob("*.html")))
diff --git a/scripts/check_readme_impact.py b/scripts/check_readme_impact.py
index 6eda5c476..7676f720c 100644
--- a/scripts/check_readme_impact.py
+++ b/scripts/check_readme_impact.py
@@ -5,7 +5,7 @@ from __future__ import annotations
import subprocess
from pathlib import Path
-READMES = {"README.md", "README.en.md"}
+READMES = {"README.md", "README.zh-CN.md"}
PREFIXES = ("src/peach/", "web/", "frontend/", "migrations/", "resources/")
FILES = {
"pyproject.toml", "package.json", "package-lock.json",
diff --git a/scripts/test_runner.py b/scripts/test_runner.py
index fa839a9f1..a476ed3a7 100644
--- a/scripts/test_runner.py
+++ b/scripts/test_runner.py
@@ -267,7 +267,7 @@ AUTO_SCOPE_FILES: dict[str, tuple[str, ...]] = {
"src/peach/web_entry.py": ("catalog", "tooling", "web"),
# 这几份文档有测试在读它们的正文:改文档也要跑到那条测试。
"README.md": ("checks", "tooling"),
- "README.en.md": ("checks", "tooling"),
+ "README.zh-CN.md": ("checks", "tooling"),
# 差异表是 token 判据的另一半:偏离上游的每一条都要在那张表里写明原因,所以
# `test_frontend_build.py` 读它——改表就得跑到 web。
"frontend/src/react/boardui/ORIGIN.md": ("checks", "web"),
diff --git a/tests/test_agent_worktree.py b/tests/test_agent_worktree.py
index 5633c2fa1..e2f88385a 100644
--- a/tests/test_agent_worktree.py
+++ b/tests/test_agent_worktree.py
@@ -208,13 +208,13 @@ class CommitMessageGuardTests(_WorktreeCase):
self.assertIn("README-Impact", result.stderr)
def test_counterpart_review_trailer_requires_a_file_reason_and_contiguous_block(self):
- for declaration in ("README-Reviewed: README.en.md; 已核对\n\n",
- "README-Reviewed: README.en.md;\n",
+ for declaration in ("README-Reviewed: README.zh-CN.md; 已核对\n\n",
+ "README-Reviewed: README.zh-CN.md;\n",
"README-Reviewed: unknown.md; 已核对\n"):
result = self.attempt("test: 核对声明\n\n" + declaration + AUTHOR)
self.assertNotEqual(result.returncode, 0)
self.assertIn("README-Reviewed", result.stderr)
- result = self.attempt("test: 核对声明\n\nREADME-Reviewed: README.en.md; 英文正确\n" + AUTHOR)
+ result = self.attempt("test: 核对声明\n\nREADME-Reviewed: README.zh-CN.md; 中文正确\n" + AUTHOR)
self.assertEqual(result.returncode, 0, result.stderr)
def test_valid_trailers_and_amend_preserve_the_message(self):
@@ -606,8 +606,8 @@ class ReadmeImpactTests(unittest.TestCase):
git(self.repo, "init", "-b", "master")
git(self.repo, "config", "user.name", "Test")
git(self.repo, "config", "user.email", "[email protected]")
- self.save("README.md", "中文")
- self.save("README.en.md", "English")
+ self.save("README.md", "English")
+ self.save("README.zh-CN.md", "中文")
git(self.repo, "commit", "-m", "base")
self.base = git(self.repo, "rev-parse", "HEAD").strip()
git(self.repo, "checkout", "-b", "worker")
@@ -637,23 +637,23 @@ class ReadmeImpactTests(unittest.TestCase):
def test_single_language_typo_accepts_explicit_counterpart_review(self):
self.save("README.md", "修正错字")
self.assertEqual(self.commit("README-Impact: updated; 中文错字\n"
- "README-Reviewed: README.en.md; 英文表述正确,无需修改"), [])
+ "README-Reviewed: README.zh-CN.md; 中文表述正确,无需修改"), [])
def test_counterpart_review_requires_correct_file_and_reason(self):
self.save("README.md", "修正错字")
- for trailer in ("README-Reviewed: README.md; 已核对", "README-Reviewed: README.en.md;",
- "README-Reviewed: README.en.md; 已核对\nREADME-Reviewed: README.en.md; 重复"):
+ for trailer in ("README-Reviewed: README.md; 已核对", "README-Reviewed: README.zh-CN.md;",
+ "README-Reviewed: README.zh-CN.md; 已核对\nREADME-Reviewed: README.zh-CN.md; 重复"):
self.assertTrue(self.commit("README-Impact: updated; 中文错字\n" + trailer))
git(self.repo, "reset", "--soft", "HEAD^")
def test_bilingual_update_accepts_review(self):
self.save("README.md", "新内容")
- self.save("README.en.md", "New content")
+ self.save("README.zh-CN.md", "New content")
self.assertEqual(self.commit("README-Impact: updated; 功能说明"), [])
def test_none_cannot_describe_document_changes(self):
self.save("README.md", "新内容")
- self.save("README.en.md", "New content")
+ self.save("README.zh-CN.md", "New content")
self.assertTrue(self.commit("README-Impact: none; 内部改动"))
def test_test_only_change_needs_no_declaration(self):
@@ -664,7 +664,7 @@ class ReadmeImpactTests(unittest.TestCase):
self.save("frontend/package.json", "{}")
self.commit("README-Impact: updated; 工具要求")
self.save("README.md", "新内容")
- self.save("README.en.md", "New content")
+ self.save("README.zh-CN.md", "New content")
self.assertTrue(check(self.repo, self.base))
def test_missing_reason_and_duplicate_trailers_are_rejected(self):
diff --git a/tests/test_scripts.py b/tests/test_scripts.py
index 477ca000f..a3ad23dde 100644
--- a/tests/test_scripts.py
+++ b/tests/test_scripts.py
@@ -1918,8 +1918,11 @@ class OperationalScriptTests(unittest.TestCase):
self.assertIn("fromJSON(needs.plan.outputs.matrix)", workflow)
from scripts.ci_plan import plan
self.assertEqual({row["python"] for row in plan("workflow_dispatch", [])["matrix"]["include"]}, {floor})
- self.assertIn(f"Python {floor} 或更高", (ROOT / "README.md").read_text(encoding="utf-8"))
- self.assertIn(f"Python {floor} or newer", (ROOT / "README.en.md").read_text(encoding="utf-8"))
+ for readme, suffix in (("README.md", r"(?:\+| or newer)"),
+ ("README.zh-CN.md", r"(?:\+| 或更高)")):
+ with self.subTest(readme=readme):
+ self.assertRegex((ROOT / readme).read_text(encoding="utf-8"),
+ rf"\bPython {re.escape(floor)}{suffix}")
def test_functional_test_scopes_are_explicit(self):
runner = load_script("test_runner")
diff --git a/tests/test_source_assertion_ratchet.py b/tests/test_source_assertion_ratchet.py
index 9aeeac210..2f594e427 100644
--- a/tests/test_source_assertion_ratchet.py
+++ b/tests/test_source_assertion_ratchet.py
@@ -44,7 +44,7 @@ BASELINE: dict[str, int] = {
"test_job_status.py": 1,
"test_metadata_library.py": 5,
"test_repo_hygiene.py": 1,
- "test_scripts.py": 13,
+ "test_scripts.py": 12,
"test_social_avatar_harvest.py": 2,
"test_studio_icon_variants.py": 2,
"test_studio_site_harvest.py": 1,
diff --git a/tests/test_test_evidence.py b/tests/test_test_evidence.py
index f6b7aa3b4..94d3d8e86 100644
--- a/tests/test_test_evidence.py
+++ b/tests/test_test_evidence.py
@@ -967,8 +967,8 @@ class VerificationTests(unittest.TestCase):
item = coordinator.create(self.repo, "codex", "verification", self.root / "worktrees")
worker = Path(item["path"])
(worker / "README.md").write_text("测试内容\n", encoding="utf-8")
- (worker / "README.en.md").write_text("Test content\n", encoding="utf-8")
- evidence.git(worker, "add", "README.md", "README.en.md")
+ (worker / "README.zh-CN.md").write_text("Test content\n", encoding="utf-8")
+ evidence.git(worker, "add", "README.md", "README.zh-CN.md")
evidence.git(worker, "commit", "-m", "docs: test", "-m",
"README-Impact: updated; 测试文档\n"
"Co-Authored-By: Codex (GPT-5.5) <[email protected]>")