Skip to content

armgit / peach

Public Imported from GitHub
0

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

fix(config): 媒体目录校验保留 NAS 映射盘盘符

longmeidao726efb62f46d
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4b8da5df6..fb2973c3e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -30,6 +30,7 @@ Removed / Fixed / Security。
- **桌面**:Windows 安装包与免安装包使用完整的锁定依赖构建;安装包支持选择程序目录。
- **桌面**:Windows 桌面处于共享 Job 时可独立启动托盘,终端或智能体退出后保持运行。
- **配置**:首次设置可接回已有数据目录;升级沿用配置、账本和访问密码,并记住数据目录。
+- **配置**:媒体目录校验保留 NAS 映射盘的盘符路径。
### 新增
diff --git a/docs/REUSE.md b/docs/REUSE.md
index 9bf5a4b25..bc26ad606 100644
--- a/docs/REUSE.md
+++ b/docs/REUSE.md
@@ -252,6 +252,7 @@ JAV 默认封面(官方封面/预览图)与视频默认大小(大图/
- 候选 `ANDonekey/javapi` revision `9a2a245a659a4008ee75bc148b0af9c7126e7a71` 未归档、最后推送为 2026-05-11,使用 Go 和部署服务,GitHub 未标明许可证,不能作为 Python 依赖或复制其源码。仅以部署公开前端与匿名实测确定协议事实;原始取证脚本及脱敏概要保留在工作树 `build/javdb-public-api/`。`phoenixthrush/javdb-python`(MIT、Python ≥3.11、无运行依赖)解析的是 `javdatabase.com` HTML,站点与协议不匹配;现有 `sources.javdb` 同样只适用于 HTML。Peach 保留番号核对、权限失败、字段投影和缓存策略。
- 编码边界依据 [MDN 视频编码说明](https://developer.mozilla.org/en-US/docs/Web/Media/Guides/Formats/Video_codecs) 与 [ffprobe 文档](https://ffmpeg.org/ffprobe.html),用当前 FFmpeg;Peach 只持有兼容格式判定与缓存策略。
- CloudDrive 引导用现有 `settings_file`、`platform.root_online`、`scan_location` 与 React 配置页,来源为 `local`、`115`、`pikpak`。挂载由用户安装的 CloudDrive 负责([官方帮助](https://www.clouddrive2.com/help.html):Windows 用盘符、macOS 用目录挂载点),Peach 不捆绑其二进制,挂载引导不依赖管理 API,路径处理用 `pathlib`、`os.scandir`、`tomllib`;表单、来源归属与扫描选择归 Peach。云下载经官方 proto 子集(`downloads_clouddrive.proto`,version 1.1.0)走 gRPC,令牌存 CredentialStore,不用非官方 SDK(ADR-0089)。
+- 媒体目录校验沿用 `media.normalized_path` 的平台策略:Windows 用标准库 `os.path.abspath` 保留盘符,macOS 用 `Path.resolve` 解析文件系统链接。实现只依赖项目 Python 标准库(PSF 许可),不新增依赖;校验器独立于账本路径翻译与媒体仓储。映射盘转 UNC 的边界由注入文件系统解析结果的回归覆盖,首次设置的本地来源也验证配置保留盘符。直接输入 UNC 仍按盘符路径契约拒绝;真实 NAS 挂载需在目标机器验收。
- JAV 入库资源查询复用 `sources.javdb` 的身份核对、`SourceTransport` 的 Cookie 与冷却、`HostLimitedTransport` 的 3 秒间隔、`beautifulsoup4==4.15.0` 和 `downloads.parse_magnet`。JavPack 的 `JavDB.magnet.user.js` 0.0.2(GPL-3.0,仓库 revision `b546e1881147e15796c697e8e086db9d3ac0c5be`)只作页面字段参考;它依赖浏览器用户脚本 API,不能直接作为 Python 服务端依赖。Peach 负责评论链接、协议分流、去重、60 秒缓存和最多三页评论的预算,不新增依赖。2026-10-02 单作品只读实测取得 4 条磁链和含 ed2k 的评论页;评论入口从 `.review-tab[data-url]` 读取,受限评论保留来源限制提示。磁链可交现有云下载服务,ed2k 与其他网页链接提供复制。
- 磁力优先链复用同一套 `SourceTransport`、`HostLimitedTransport`、`downloads.parse_magnet` 与 Torznab 后备,不引入新的抓取运行时。manko.fun 的页面请求实际落到 `healertanker.com/swx`,响应 `data` 是 basE91 包装的 JSON;实现只移植该公开响应形态与编号精确匹配,不复用会话脚本。Sukebei 直接读搜索表格;JavBus、16mag、OneJAV、Free JAV Torrent 由现有自配 Prowlarr/Jackett 索引器续接。Akiba Online 与 Reddit 只作线索,不自动取磁力。候选按分辨率、做种、推广附件数量与正片体积排序;总文件数不再是一票否决,manko.fun 候选绕过水印门槛,其他来源只能标为待到盘检查。
- 云下载后处理复用 `task_run` 后继串行、`process_library(retry_ids=...)`、垃圾复核的 `AUTO_TRASH_SCORE`、`organize.build_plan(asset_ids=...)`、SQLite backup 与整理批次日志。没有另造第二套刮削、垃圾词库或移动器。
diff --git a/src/peach/onboarding.py b/src/peach/onboarding.py
index 41115bf1b..0615d2c03 100644
--- a/src/peach/onboarding.py
+++ b/src/peach/onboarding.py
@@ -114,7 +114,8 @@ def media_dir_validator(*, windows: bool) -> Callable[[str], Path]:
path = Path(text).expanduser()
if not path.is_dir():
raise ValueError(f"目录不存在,或者不是目录:{path}。先建好再填。")
- resolved = path.resolve()
+ # Windows 媒体目录保留盘符;挂载盘的最终路径可能是 UNC。
+ resolved = Path(os.path.abspath(path)) if windows else path.resolve()
if windows and not is_windows_path(str(resolved)):
raise ValueError(f"{resolved} 不是盘符路径;网络位置先映射成盘符再来")
return resolved
diff --git a/tests/test_configuration_sources.py b/tests/test_configuration_sources.py
index 95f628233..64976480c 100644
--- a/tests/test_configuration_sources.py
+++ b/tests/test_configuration_sources.py
@@ -1,5 +1,6 @@
"""CloudDrive 表单、来源映射与离线状态的隔离回归。"""
from dataclasses import replace
+import ntpath
from pathlib import Path
import tempfile
import unittest
@@ -9,6 +10,25 @@ from peach import media_configuration as media_config, onboarding, settings_file
class MediaConfigurationTests(unittest.TestCase):
+ def test_setup_local_source_accepts_a_mapped_nas_drive(self):
+ from peach.routes_pages import _read_answers
+
+ with tempfile.TemporaryDirectory() as directory:
+ base = Path(directory).resolve()
+ config = settings_file.load_config(environ={"PEACH_DATA_ROOT": str(base)})
+ mapped = r"Z:\CloudDrive2\115open\云下载"
+ submitted = {"data_root": str(base), "media_dir": [mapped],
+ "media_location": ["local"], "host": "1"}
+ windows_abspath = ntpath.abspath
+ with patch.object(Path, "is_dir", return_value=True), \
+ patch.object(Path, "resolve", return_value=Path(r"\\NAS\媒体库")), \
+ patch("peach.onboarding.os.path.abspath", side_effect=windows_abspath):
+ answers, errors = _read_answers(config, submitted, windows=True)
+ self.assertEqual(errors, {})
+ prepared = onboarding.configure(config, answers, windows=True)
+ self.assertEqual(prepared.locations, {"local": (mapped,)})
+ self.assertEqual(prepared.mounts, {})
+
def test_runtime_facts_name_the_operating_system_and_settings_file(self):
from peach import web_entry
with tempfile.TemporaryDirectory() as directory:
diff --git a/tests/test_onboarding.py b/tests/test_onboarding.py
index 0393f6e47..ee7a86bff 100644
--- a/tests/test_onboarding.py
+++ b/tests/test_onboarding.py
@@ -8,6 +8,7 @@ from __future__ import annotations
import importlib.util
import io
+import ntpath
import os
import sqlite3
import tempfile
@@ -72,6 +73,31 @@ class QuestionTests(_Case):
class ValidatorTests(_Case):
+ def test_windows_mapped_directory_keeps_its_drive_path(self):
+ mapped = r"Z:\CloudDrive2\115open\云下载"
+ redirected = Path(r"\\NAS\CloudDrive2\115open\云下载")
+ windows_abspath = ntpath.abspath
+ with mock.patch.object(Path, "is_dir", return_value=True), \
+ mock.patch.object(Path, "resolve", return_value=redirected), \
+ mock.patch("peach.onboarding.os.path.abspath", side_effect=windows_abspath):
+ validate = onboarding.media_dir_validator(windows=True)
+ for raw in (mapped, mapped + r"\子目录\.."):
+ with self.subTest(raw=raw):
+ self.assertEqual(validate(raw), Path(mapped))
+
+ def test_windows_unc_directory_requires_a_drive_mapping(self):
+ shared = r"\\NAS\媒体库"
+ windows_abspath = ntpath.abspath
+ with mock.patch.object(Path, "is_dir", return_value=True), \
+ mock.patch.object(Path, "resolve", return_value=Path(shared)), \
+ mock.patch("peach.onboarding.os.path.abspath", side_effect=windows_abspath):
+ with self.assertRaisesRegex(ValueError, "不是盘符路径"):
+ onboarding.media_dir_validator(windows=True)(shared)
+
+ def test_posix_media_directory_uses_its_filesystem_target(self):
+ with mock.patch.object(Path, "resolve", return_value=self.media):
+ self.assertEqual(onboarding.media_dir_validator(windows=False)(str(self.home)), self.media)
+
def test_media_dir_must_already_exist_and_is_never_created(self):
validate = onboarding.media_dir_validator(windows=False)
missing = self.root / "nope"