Skip to content

armgit / peach

Public Imported from GitHub
0

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

docs(adr): 复核页撤回自动写入的 ADR 改号为 0141

longmeidaof47d92bbc197
diff --git a/docs/ROUTES.md b/docs/ROUTES.md
index 29f682b42..a6c82f3f1 100644
--- a/docs/ROUTES.md
+++ b/docs/ROUTES.md
@@ -116,7 +116,7 @@
用户脚本通过专用令牌调用 `POST /api/jav-browser/errors`,仅接收白名单错误字段并写入本机日志;批次、体积、限频与诊断包范围见 [浏览器添加 JAV](JAV_BROWSER.md)。状态接口 `GET /api/jav-browser` 同时投影真实下载与整理进度,`GET /api/jav-browser/active` 以同一结构列出进行中与最近结束的任务,均不授予配置、账号或账本写入权限。`POST /api/jav-browser/postprocess` 只能重试该番号已失败的整理,走任务中心同一入口。`POST /api/jav-browser/dismiss` 只记下脚本确认过哪些已结束的任务,不改任务与账本。
-`GET /api/review/auto-landings` 逐条列出 ADR-0139 两条规则仍在的自动写入:作品、封面地址、写入的字段与值、写入前的值或补上的标签、规则与时间;带 `items=<决定键>`(换行分隔)时只读返回这几条要改回的值、要删的标签、写入后被改过或已删除而不动的作品,以及计划摘要 `token`。`POST /api/review/auto-landings/revert` 接收 `items` 与 `token`,在写锁里重算计划,对不上返回 400 要求重新预览;对上后先备份账本再撤回,回执带备份文件名与未改动的作品。列表里没有的决定键一律拒绝,其余自动落库来源仍由 `scripts/revert_auto_landing.py` 撤回;只读端拒绝撤回(ADR-0140)。
+`GET /api/review/auto-landings` 逐条列出 ADR-0139 两条规则仍在的自动写入:作品、封面地址、写入的字段与值、写入前的值或补上的标签、规则与时间;带 `items=<决定键>`(换行分隔)时只读返回这几条要改回的值、要删的标签、写入后被改过或已删除而不动的作品,以及计划摘要 `token`。`POST /api/review/auto-landings/revert` 接收 `items` 与 `token`,在写锁里重算计划,对不上返回 400 要求重新预览;对上后先备份账本再撤回,回执带备份文件名与未改动的作品。列表里没有的决定键一律拒绝,其余自动落库来源仍由 `scripts/revert_auto_landing.py` 撤回;只读端拒绝撤回(ADR-0141)。
`GET /api/client-updates` 要求应用鉴权,返回运行版本与构建标记、发行版检查结果、安装状态、用户脚本版本和自动补修状态,不触发外部检查。`GET /api/jav-browser/updates` 使用用户脚本专用令牌,无需番号,返回运行与发行版、脚本版本快照,不暴露补修明细。`POST /api/configuration/upgrade-repairs/retry` 限本机同源请求,重试失败项;`GET /api/configuration/upgrade-repairs/review` 限本机管理权限,下载 JSON 复核记录,无记录时返回 404。
diff --git a/docs/adr/0139-verification-differences-settle-by-rule.md b/docs/adr/0139-verification-differences-settle-by-rule.md
index 0618ae79b..b5b2f7cac 100644
--- a/docs/adr/0139-verification-differences-settle-by-rule.md
+++ b/docs/adr/0139-verification-differences-settle-by-rule.md
@@ -3,7 +3,7 @@
- 状态:已采纳
- 日期:2026-11-04
- 关系:修订 [ADR-0108](0108-nfo-verification-and-reviewed-overwrites.md)「覆盖已有值必须复核」;ADR-0025 否决的归一化比对与来源优先级取舍只在本 ADR 划定的范围内放开;沿用 [ADR-0033](0033-online-sources-only-fill-empty-fields.md) 的社区来源只补空、[ADR-0038](0038-field-priority-chain-settles-dissent.md) 的字段优先级链与 [ADR-0052](0052-entity-results-land-when-evidence-is-sufficient.md) 的可撤回自动落库
-- 补充:[ADR-0140](0140-review-page-reverts-settlement-writes.md) 让复核页逐条列出这两条规则的写入、勾选后预览并撤回,覆盖改为一次结算一个批次号
+- 补充:[ADR-0141](0141-review-page-reverts-settlement-writes.md) 让复核页逐条列出这两条规则的写入、勾选后预览并撤回,覆盖改为一次结算一个批次号
## 背景
diff --git a/docs/adr/0140-review-page-reverts-settlement-writes.md b/docs/adr/0141-review-page-reverts-settlement-writes.md
similarity index 98%
rename from docs/adr/0140-review-page-reverts-settlement-writes.md
rename to docs/adr/0141-review-page-reverts-settlement-writes.md
index bc50b5ed7..503779ba2 100644
--- a/docs/adr/0140-review-page-reverts-settlement-writes.md
+++ b/docs/adr/0141-review-page-reverts-settlement-writes.md
@@ -1,4 +1,4 @@
-# ADR-0140:复核页逐条列出并撤回核查结算的自动写入
+# ADR-0141:复核页逐条列出并撤回核查结算的自动写入
- 状态:已采纳
- 日期:2026-11-04
diff --git a/frontend/src/react/review/auto-landings-card.tsx b/frontend/src/react/review/auto-landings-card.tsx
index fe96ac6a0..1a3ea4d89 100644
--- a/frontend/src/react/review/auto-landings-card.tsx
+++ b/frontend/src/react/review/auto-landings-card.tsx
@@ -1,4 +1,4 @@
-/* 复核页元数据分类下的「自动写入的资料」(ADR-0140)。
+/* 复核页元数据分类下的「自动写入的资料」(ADR-0141)。
*
* 资料处理按确定判据自动写下的标题、发行日期与标签,一行一条:先看是哪部作品、写了什么、
* 原来是什么,规则与时间排在后面。勾选后先读一次撤回预览,弹层里逐条列出会改回的值、会删的
diff --git a/frontend/src/react/review/auto-landings.ts b/frontend/src/react/review/auto-landings.ts
index 84b6047ad..dd6a9e97a 100644
--- a/frontend/src/react/review/auto-landings.ts
+++ b/frontend/src/react/review/auto-landings.ts
@@ -1,4 +1,4 @@
-/* 复核页「自动写入的资料」的数据契约(ADR-0140)。
+/* 复核页「自动写入的资料」的数据契约(ADR-0141)。
*
* 一个读端点、一个写端点。列表一行是一条自动写入:哪部作品的哪一格写成了什么。带 `items`
* 读到的是这几条的撤回预览与 token;撤回把同一个 token 交回去,服务端在写锁里重算,对不上就拒绝。 */
diff --git a/scripts/revert_auto_landing.py b/scripts/revert_auto_landing.py
index a91c00fa5..daaf65498 100644
--- a/scripts/revert_auto_landing.py
+++ b/scripts/revert_auto_landing.py
@@ -1,7 +1,7 @@
"""把自动落库写下的一批结果整批撤回(ADR-0052)。
认哪些写入、怎么撤、哪些不动,全在 `peach.auto_landing_revert`;复核页的「自动写入的资料」
-走同一份实现(ADR-0140)。这里只管命令行参数、打印计划和备份。
+走同一份实现(ADR-0141)。这里只管命令行参数、打印计划和备份。
revert_auto_landing.py --source auto:follow-creator
revert_auto_landing.py --source auto:performer-alias
diff --git a/scripts/test_runner.py b/scripts/test_runner.py
index 89b075ad3..520307566 100644
--- a/scripts/test_runner.py
+++ b/scripts/test_runner.py
@@ -260,7 +260,7 @@ AUTO_SCOPE_FILES: dict[str, tuple[str, ...]] = {
# 失效标记由资料页、网页链接体检、维护脚本与种子导出共用。
"src/peach/link_status.py": ("catalog", "metadata", "tooling", "web"),
"scripts/revert_auto_landing.py": ("catalog", "metadata", "tooling"),
- # 撤回的实现与复核页入口(ADR-0140):脚本用例散在 catalog、metadata、tooling,网页用例在
+ # 撤回的实现与复核页入口(ADR-0141):脚本用例散在 catalog、metadata、tooling,网页用例在
# `test_metadata_verification.py`,路由登记在 `test_rm_web.py`。
"src/peach/auto_landing_revert.py": ("catalog", "metadata", "tooling"),
"src/peach/web_auto_landings.py": ("catalog", "metadata", "web"),
diff --git a/src/peach/auto_landing_revert.py b/src/peach/auto_landing_revert.py
index 2bb7466da..ccb72a87f 100644
--- a/src/peach/auto_landing_revert.py
+++ b/src/peach/auto_landing_revert.py
@@ -34,7 +34,7 @@ id 或路径已被别的行占用时那一批拒绝撤回。登记时自动接
核查差异按确定判据结算的两条(ADR-0139)按规则名撤:`adr-0139-official-replaces-verified`
按 note 的 `previous` 把旧值与旧归属还原,之后被别人改过的资产不动;`adr-0139-verified-tags-union`
删掉那一行补进的标签。两条都删掉决定,`batch` 给 note 里记的批次号。先改判据再撤。
-复核页的「自动写入的资料」逐条列出这两条规则的写入(ADR-0140),撤回走这里同一个 `plan` 与 `apply`。
+复核页的「自动写入的资料」逐条列出这两条规则的写入(ADR-0141),撤回走这里同一个 `plan` 与 `apply`。
西方发行方的无番号作品封面(`ASSET-ID-<id>.jpg`)在 `.scraping.json` 边车里记 `source` 与 `batch`
(`auto:western-artwork@<时间>`)。撤回删掉封面与同组边车,作品回到没有封面的样子。
@@ -249,7 +249,7 @@ def plan(connection, source: str, batch: str = "", *, logo_root: Path, cover_roo
files: bool = True, item_keys: set[str] | None = None) -> dict:
"""这个来源(与批次)要撤的全部条目,只读。`apply` 与 `remove_files` 都按它做。
- 复核页只放行两条核查结算规则(ADR-0140),它们不写盘上文件:`files=False` 不扫标识与
+ 复核页只放行两条核查结算规则(ADR-0141),它们不写盘上文件:`files=False` 不扫标识与
封面目录,`item_keys` 只收窄核查结算那一类,撤的是人逐条勾选的那几行决定。
"""
return {
diff --git a/src/peach/metadata_auto_apply.py b/src/peach/metadata_auto_apply.py
index 425510c13..9e0c1d4f0 100644
--- a/src/peach/metadata_auto_apply.py
+++ b/src/peach/metadata_auto_apply.py
@@ -2083,7 +2083,7 @@ def planned_verified_revert(connection, source: str, batch: str = "",
覆盖那条按 note 的 `previous` 还原每条资产的旧值与旧归属;之后被别人改过的资产
(值或归属已不是这次写下的)不动,计划里记 `changed`。并集那条删掉这次补进的标签。
两条都删掉决定,行回到核查前的样子,下一轮按那时的判据重判。
- `item_keys` 给了就只认这几行决定:复核页逐条勾选撤回(ADR-0140)。
+ `item_keys` 给了就只认这几行决定:复核页逐条勾选撤回(ADR-0141)。
"""
if source not in (VERIFIED_REPLACE_RULE, VERIFIED_UNION_RULE):
return []
diff --git a/src/peach/web_auto_landings.py b/src/peach/web_auto_landings.py
index eaf55d0aa..ddaa8e8bb 100644
--- a/src/peach/web_auto_landings.py
+++ b/src/peach/web_auto_landings.py
@@ -1,4 +1,4 @@
-"""复核页的「自动写入的资料」:逐条列出核查结算自动写下的资料,勾选后预览、撤回(ADR-0140)。
+"""复核页的「自动写入的资料」:逐条列出核查结算自动写下的资料,勾选后预览、撤回(ADR-0141)。
一行是一条决定:哪部作品的哪一格写成了什么、原来是什么,或补上了哪些标签。规则与时间是
次要的列,勾选可以是一条、几条或某次结算的全部。
diff --git a/tests/test_metadata_verification.py b/tests/test_metadata_verification.py
index e88506810..0abbc87f0 100644
--- a/tests/test_metadata_verification.py
+++ b/tests/test_metadata_verification.py
@@ -315,7 +315,7 @@ class VerificationSettlementTests(unittest.TestCase):
rm_auto.revert_verified(connection, plan)
self.assertEqual(self.value(asset_id, "release_date"), ("2024-09-11", USER_MANUAL))
- # ---- 复核页撤回(ADR-0140) ----
+ # ---- 复核页撤回(ADR-0141) ----
def auto_landings(self, **args):
return rm_web.dispatch_api_get(self.contract, "/api/review/auto-landings", args)