Peach: Local-first video metadata scraper and media manager.
fix(config): 按应用服务协议生成 CloudDrive2 通知配置
longmeidaofa4b1626f1bb
diff --git a/docs/CLOUDDRIVE.md b/docs/CLOUDDRIVE.mdindex 450c643a9..b74e9f0f3 100644--- a/docs/CLOUDDRIVE.md+++ b/docs/CLOUDDRIVE.md@@ -113,7 +113,7 @@ Peach 不实时监视网盘目录,因为每列一次目录都是一次网络注意事项:-- 配置里的地址是 Peach 所在电脑的局域网地址。Peach 只接受本机和私有网络发来的通知,来自公网的请求一律忽略。+- 配置里的地址是 Peach 所在电脑的局域网地址,协议和端口与应用服务一致:独立版局域网模式使用 HTTP,启用 TLS 的服务使用 HTTPS。Peach 只接受本机和私有网络发来的通知,来自公网的请求一律忽略。- Windows 版 CloudDrive2 的编辑框会把换行存坏,列表里显示「无效」。解决办法:把这段配置存成一个 `.toml` 文件,放进 `%LOCALAPPDATA%\CloudDrive.WinUI\webhooks\`,然后重启 CloudDrive2。Webhooks 页的「刷新」不会重新读取这个文件夹。- CloudDrive2 发通知时也走它自己的代理设置,代理要让局域网地址直连。diff --git a/docs/REUSE.md b/docs/REUSE.mdindex 24f5ee301..291e8af4a 100644--- a/docs/REUSE.md+++ b/docs/REUSE.md@@ -619,6 +619,8 @@ A 盘垃圾隔离使用短名称 `peach-purge-<32 位 UUID>.peach-quarantine`,| 本地 NFO 导入 | Kodi/Jellyfin NFO 协议(2026-09-06 核对 [Kodi](https://kodi.wiki/view/NFO_files/Movies)、[Jellyfin](https://jellyfin.org/docs/general/server/metadata/nfo/)),标准库 ElementTree,图片走项目固定版 Pillow;实现在 `library_nfo.py` | 只适配影片、单集与音乐视频(整剧、专辑、播放记录与远端图片引用不套用),拒绝 DTD、超大输入与越目录图片引用。同名边车优先,`movie.nfo` 与通用海报只用于单影片目录;正片和图片同属一组连号(`(1).mp4` 配 `(1).jpg`…)时同名图是图集的一张。已知内容词投影为中文标签,画质、促销、发行属性与演员编成丢弃,未收录的自定义标签保留;远端补厂牌、导演、发行商、时长与图片出处,人物主名精确一致时补 DMM id、假名、罗马字与首次头像,不替换演员真值。网络复用 R18 JSON 入口、SourceTransport、头像缓存与封面解析器。候选按资产 ID 与路径定位,批准时复核目标,时长证据不覆盖探测时长(ADR-0029) || JAV 高清封面 | Javinizer-Go `dd56998328d078c9baf68ff4fde2e6fcaa2a691a`(MIT)的 DMM modern `awsimgsrc.dmm.com/dig/...` 映射与尺寸门槛;Prestige 公开 API 的查询模型参考 MDCX `58e3f930f2e864fceb8a53ceef818716e2a6413d`(GPL-3.0,只作协议证据) | 候选、Range 量尺寸、面积最大者胜出与仅更大才原子升级见 `peach-jav-cover-workflow`。批量流程不请求社区来源,历史快照里的社区站只借厂牌;既有库采集在官方落空时经 `peach.community_catalog` 查 AVBase(取商品号认得出这个番号的店铺条目,名寄せ的标题可能来自合集)、JavBus 与 JavDB,两个图源先按 dHash 求一致,取景不同时用 OpenCV ORB(相似变换内点 ≥60 算同一张)。JavDB 只参与复核,不作为安装候选;其他单一图源留空 `verified_by`,遇验证页不绕过(ADR-0107)。MDC-NG 只证明 Amazon 日本渠道存在,只留 POC 候选。不写 ledger |+CloudDrive2 配置生成复用现有 TOML 模板、mDNS 公布地址和应用服务设置。HTTP 与 HTTPS 按各自默认端口生成 origin,非默认端口完整保留;配置读取、保存与更换密钥共用生成函数。该差异属于 Peach 部署配置,无需引入协议库或新增依赖;模板沿用现有 CloudDrive2 结构。回归用临时服务验证 HTTP 通知接收、密钥和来源校验,真实 ledger 与生产监听设置不参与验证。+依赖的第一个消费者及其隔离测试必须在同一改动落地,否则不引入依赖。表里没有单列的 Python 依赖及首个消费者:`numpy`(vision 组,`face_detect.decode` 直接 import)、`socksio`(PikPak 的 SOCKS 代理)、`opencc==1.4.2`(naming 组,`harvest_javdb_cn_names` 繁转简与字形表复核)、`psutil`(开发依赖,`agent_worktree.py processes`)。前端每个包的用途见 [前端岛层](FRONTEND.md#依赖清单),引入时机按 ADR-0031「前端基础库」。diff --git a/frontend/src/react/settings/push-discovery-settings.tsx b/frontend/src/react/settings/push-discovery-settings.tsxindex ecc665b1c..db41fb406 100644--- a/frontend/src/react/settings/push-discovery-settings.tsx+++ b/frontend/src/react/settings/push-discovery-settings.tsx@@ -96,7 +96,7 @@ export function PushDiscoveryForm({ initial, receipt }: {? '贴进 CloudDrive2「设置 → Webhooks」,需要会员;更换密钥后要重贴。': live.origin? '还没有共享密钥,保存配置后生成。'- : '要先有 CloudDrive2 能访问的 HTTPS 地址才能生成。'}>+ : '要先有 CloudDrive2 能访问的局域网地址才能生成。'}></SettingsRow>) : null}</Rows>diff --git a/frontend/test/react/push-discovery.test.tsx b/frontend/test/react/push-discovery.test.tsxindex 13744b7b5..409657309 100644--- a/frontend/test/react/push-discovery.test.tsx+++ b/frontend/test/react/push-discovery.test.tsx@@ -20,19 +20,21 @@ const clipboard = () => {return writeText;};-it('配置块给的是服务端拼好的那一段,复制键把它整个写进剪贴板', async () => {+it.each(['https://192.0.2.10', 'http://192.0.2.10:38473'])(+ '%s 的配置块展示并复制服务端生成的完整配置', async (origin) => {// 地址和密钥不再单独列成读数:抄两处就会抄漏一处,而 CloudDrive2 要的本来就是整段。const writeText = clipboard();const receipt = vi.fn();- const host = await mount(<PushDiscoveryForm initial={state()} receipt={receipt} />);+ const toml = TOML.replace('https://192.0.2.10', origin);+ const host = await mount(<PushDiscoveryForm initial={state({ origin, config_toml: toml })} receipt={receipt} />);// 卡片自己就是 `secondary`,代码块用同一档等于没有块——底色要比它亮一级才看得出来。expect(host.querySelector('[data-code-block]')?.className).toContain('bg-background-tertiary-default');- expect(host.querySelector('pre')?.textContent).toBe(TOML);+ expect(host.querySelector('pre')?.textContent).toBe(toml);expect(host.textContent).not.toContain('共享密钥');expect(host.textContent).not.toContain('通知地址');await click(buttonNamed('复制配置', host));await settle();- expect(writeText).toHaveBeenCalledWith(TOML);+ expect(writeText).toHaveBeenCalledWith(toml);expect(receipt).toHaveBeenCalledWith('已复制 CloudDrive2 配置');});@@ -51,12 +53,12 @@ it('配置块默认收起,横向滚动用全站的覆盖式滑块', async () =expect(pre.parentElement?.querySelector('.ovtrack')).not.toBeNull();});-it('这台机器没有对外的 HTTPS 地址时说出原因,不发一段填了也不通的配置', async () => {+it('这台机器没有局域网地址时说明生成条件', async () => {const host = await mount(<PushDiscoveryForm initial={state({ origin: '', config_toml: '' })} receipt={vi.fn()} />);expect(host.querySelector('pre')).toBeNull();expect(buttonNamed('复制配置', host)).toBeNull();- expect(host.textContent).toContain('要先有 CloudDrive2 能访问的 HTTPS 地址');+ expect(host.textContent).toContain('要先有 CloudDrive2 能访问的局域网地址');});it('配置块跟着已保存的开关走,拨一下不算数', async () => {diff --git a/src/peach/push_discovery.py b/src/peach/push_discovery.pyindex 1b888a11f..d46192ac0 100644--- a/src/peach/push_discovery.py+++ b/src/peach/push_discovery.py@@ -201,8 +201,8 @@ body = '{"data": []}'def clouddrive_config(origin: str, secret: str) -> str:"""整段抄进 CloudDrive2 的配置文本。两样缺一样就给空串,页面据此说还不能抄。- 地址只能是 HTTPS。80 口上那条服务对 `POST` 回的是 426 而不是重定向——跨 origin- 的 307 会让 CloudDrive2 把密钥和正文原样再发一遍到另一个地址上。+ 地址由配置接口按应用服务的协议与端口生成。源码部署的 HTTPS 应用入口与 HTTP+ 跳转入口分开,后者对 `POST` 回 426;独立版的 HTTP 应用入口直接接收通知。正文只留 Peach 要读的那四个字段,默认模板里的设备名、事件时间那些一概不要:`parse_notification` 本来就忽略它们,少发一样东西就少一处能对不上的地方。diff --git a/src/peach/routes_configuration.py b/src/peach/routes_configuration.pyindex f67dd3db9..02c55d9dc 100644--- a/src/peach/routes_configuration.py+++ b/src/peach/routes_configuration.py@@ -235,8 +235,8 @@ def push_discovery_payload(request: Request, payload: dict[str, Any] | None = No地址不取这次请求的 origin:配置页多半是从回环地址打开的,而 TLS 那条服务只绑在局域网地址上,把 `127.0.0.1` 抄过去 CloudDrive2 连不上。取这台机器对外公布的那个- 地址,也就是 mDNS 登记的同一个。没开 TLS 或者不知道自己的地址时给空串,页面据此- 说这段现在给不出来,而不是发一段填了也不通的配置出去。+ 地址,也就是 mDNS 登记的同一个。协议与端口取实际应用服务的设置;独立版的局域网+ 服务使用 HTTP,启用 TLS 的服务使用 HTTPS。不知道自己的地址时给空串。"""if payload is None:payload = request.app.state.push_discovery.snapshot(reveal=True)@@ -245,8 +245,9 @@ def push_discovery_payload(request: Request, payload: dict[str, Any] | None = Noaddress = str(getattr(mdns, "address", "") or settings.mdns_address or "").strip()port = int(settings.mdns_port or 0)origin = ""- if settings.tls_enabled and address:- origin = f"https://{address}" if port in (0, 443) else f"https://{address}:{port}"+ if address:+ scheme, default_port = ("https", 443) if settings.tls_enabled else ("http", 80)+ origin = f"{scheme}://{address}" if port in (0, default_port) else f"{scheme}://{address}:{port}"payload["origin"] = originpayload["config_toml"] = push_discovery.clouddrive_config(origin, payload.get("secret", ""))return payloaddiff --git a/tests/test_push_discovery.py b/tests/test_push_discovery.pyindex bf84a834e..5ef3a86c2 100644--- a/tests/test_push_discovery.py+++ b/tests/test_push_discovery.py@@ -16,6 +16,7 @@ import threadingimport timeimport tomllibimport unittest+from dataclasses import replacefrom pathlib import Path, PureWindowsPathfrom types import SimpleNamespacefrom unittest import mock@@ -164,11 +165,21 @@ class ConfigPagePayloadTests(unittest.TestCase):payload = self._payload(self._request(port=8443))self.assertEqual(payload["origin"], "https://192.0.2.10:8443")- def test_without_tls_or_an_address_the_block_is_withheld_rather_than_guessed(self):- """HTTP 的地址发出去就是白发:80 口那条服务对写请求回 426,不替它转发。"""- for request in (self._request(tls=False), self._request(declared="", port=443)):- with self.subTest(request=request):- payload = self._payload(request)+ def test_http_service_uses_its_published_address_and_listening_port(self):+ for port, origin in ((38473, "http://198.51.100.7:38473"),+ (80, "http://198.51.100.7"),+ (443, "http://198.51.100.7:443")):+ with self.subTest(port=port):+ payload = self._payload(self._request(tls=False, published="198.51.100.7", port=port))+ self.assertEqual(payload["origin"], origin)+ config = tomllib.loads(payload["config_toml"])+ self.assertEqual(config["global_params"]["base_url"], origin)+ self.assertEqual(config["file_system_watcher"]["headers"][push.SECRET_HEADER], "tok")++ def test_without_an_address_the_block_is_withheld(self):+ for tls in (True, False):+ with self.subTest(tls=tls):+ payload = self._payload(self._request(tls=tls, declared=""))self.assertEqual(payload["origin"], "")self.assertEqual(payload["config_toml"], "")@@ -581,6 +592,36 @@ class WebhookRouteTests(_ServiceCase):_wait_for(lambda: path in self.rows())self.assertEqual(self.rows().get(path), ("video", 5))+ def test_http_configuration_saves_rotates_and_delivers_a_notification(self):+ from fastapi.testclient import TestClient+ origin = "http://127.0.0.1:38473"+ self.app.state.settings = replace(+ self.app.state.settings, mdns_address="127.0.0.1", mdns_port=38473, tls_enabled=False)+ client = TestClient(self.app, base_url=origin, client=("127.0.0.1", 9000))+ saved = client.post("/api/configuration/push-discovery", json={+ "enabled": True, "watch_local": False, "cloud": True,+ "prefixes": [{"prefix": "/115", "root": self.declared["115"][0]}]})+ self.assertEqual(saved.status_code, 200, saved.text)+ self.assertEqual(saved.json()["origin"], origin)+ rotated = client.post("/api/configuration/push-discovery/secret")+ self.assertEqual(rotated.status_code, 200, rotated.text)+ payload = rotated.json()+ config = tomllib.loads(payload["config_toml"])+ self.assertEqual(config["global_params"]["base_url"], origin)+ self.assertNotEqual(payload["secret"], saved.json()["secret"])+ self.assertEqual(self.post(secret=saved.json()["secret"]).status_code, 404)+ watcher = config["file_system_watcher"]+ body = watcher["body"]+ for placeholder, value in (("{action}", "create"), ("{is_dir}", "false"),+ ("{source_file}", "/115/a.mp4"), ("{destination_file}", "")):+ body = body.replace(placeholder, value)+ response = client.post(watcher["url"].replace("{base_url}", origin),+ headers=watcher["headers"], json=json.loads(body))+ self.assertEqual(response.status_code, 204)+ path = self.ledger("115", "a.mp4")+ _wait_for(lambda: path in self.rows())+ self.assertEqual(self.rows().get(path), ("video", 5))+def test_a_wrong_or_missing_secret_is_refused_without_admitting_the_endpoint(self):for supplied in (None, "", self.secret + "x"):with self.subTest(supplied=supplied):diff --git a/web/dist/peach-app.js b/web/dist/peach-app.jsindex 6208cf3ff..3c6aad50b 100644--- a/web/dist/peach-app.js+++ b/web/dist/peach-app.js@@ -75144,7 +75144,7 @@ function jIe({ initial: e, receipt: t }) {}),u.enabled && u.cloud ? /* @__PURE__ */ (0, C.jsx)(hA, {label: "Webhook 配置",- description: u.config_toml ? "贴进 CloudDrive2「设置 → Webhooks」,需要会员;更换密钥后要重贴。" : u.origin ? "还没有共享密钥,保存配置后生成。" : "要先有 CloudDrive2 能访问的 HTTPS 地址才能生成。"+ description: u.config_toml ? "贴进 CloudDrive2「设置 → Webhooks」,需要会员;更换密钥后要重贴。" : u.origin ? "还没有共享密钥,保存配置后生成。" : "要先有 CloudDrive2 能访问的局域网地址才能生成。"}) : null] }),u.enabled && u.cloud && u.config_toml ? /* @__PURE__ */ (0, C.jsx)(bA, {