Skip to content

armgit / peach

Public Imported from GitHub
0

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

docs(adr): ADR-0137 补上挪过的文件、人批准的标签与后台结算

longmeidaoe41791ed201a
diff --git a/docs/adr/0137-verification-differences-settle-by-rule.md b/docs/adr/0137-verification-differences-settle-by-rule.md
index 0c543e8f5..40d251c24 100644
--- a/docs/adr/0137-verification-differences-settle-by-rule.md
+++ b/docs/adr/0137-verification-differences-settle-by-rule.md
@@ -41,16 +41,18 @@ ADR-0108 记的是用户 10-17 的要求:「补漏无需复核,覆盖已有
**三、可撤回的写入只有两种。**
-- **标签并集。** 证据候选里认得出、账本没有的标签按链上先后补上,一个不删。复用 ADR-0082 的并集写法,标签行归属是批次号 `auto:metadata-tags@<时间>`。决定记 `rule: adr-0137-verified-tags-union`、`added_tags`、各次 `batches` 与当时全部候选身份。之后又收录了生词时,下一轮照样补。
+- **标签并集。** 证据候选里认得出、账本没有的标签按链上先后补上,一个不删。复用 ADR-0082 的并集写法,标签行归属是批次号 `auto:metadata-tags@<时间>`。决定记 `rule: adr-0137-verified-tags-union`、`added_tags`、各次 `batches` 与当时全部候选身份。之后又收录了生词时,下一轮照样补。人批准过、已过期的标签决定按 ADR-0082 只增不删,原决定只追加 `added_tags` 与候选身份。
- **官方一致的标题与日期覆盖。** 链首那一档有异议的来源取值一致、现值不归人、没有更靠前的来源写过、番号身份核得上(`_auto_apply_targets`),按链首那一家覆盖,归属 `auto:<来源>`。决定记 `rule: adr-0137-official-replaces-verified`、批次号,以及每条资产覆盖前的取值与归属(`previous`)。
-`scripts/revert_auto_landing.py --source <规则名> [--batch …]` 按决定撤回:并集删掉那一行补进的标签,覆盖把旧值与旧归属原样写回,之后被别人改过的资产不动。两种都删掉决定,下一轮按那时的判据重判,所以先改判据再撤。
+`scripts/revert_auto_landing.py --source <规则名> [--batch …]` 按决定撤回:并集删掉那一行补进的标签,覆盖把旧值与旧归属原样写回,之后被别人改过的资产不动。两种都删掉决定,下一轮按那时的判据重判,所以先改判据再撤。并集补的标签与 ADR-0082 同一个批次前缀,`--source auto:metadata-tags` 也能删掉它们,但决定里的规则名还在,下一轮会照样补回来。
+
+按文件出的候选行(`asset:<编号>:<字段>`)此前按「编号+路径」认文件。扫描按番号改指挪过的文件时编号不变(ADR-0131),处理任务重出同一行又沿用旧路径,2026-11-04 真实账本里 697 行因此谁批准都写不进去。落库闸(`_landing_scope`,人工批准与自动落库共用)改为:路径对不上、编号还在且番号相同,仍是这条资产;编号已不在库或成了别的番号,这一行保留现值、不入队。
**四、交人的只剩这些。** 本地 NFO 与链首来源说法不一(不论哪边是现值,核对 NFO 正是 ADR-0108 要做的事);出演者有官方或链首来源异议;链首来源之间说法不一;厂牌、系列的官方异议;番号身份核不上;日期式番号的官方日期不是番号那天。
厂牌与系列在账本里是实体,换值连带改作品关联,撤回还不了原样;快照里这一类多是 maker 与 label 混写、系列命名不一、实体缺别名,确实要人判,不进覆盖。
-**五、存量由升级补修结算一次。** `upgrade_rules.VERIFICATION_SETTLEMENT` 记规则版本,`UpgradeRepairs.prepare` 在本地确定性补修之后,对候选件里带核查标记的行跑一遍自动落库,先备份账本,结果记进 `ledger_upgrade_repair` 的 `verification-settlement-<版本>`。判据再变时版本加一。不推进 `CATALOG`:那会重跑全部收集项,又以核查模式带回一批新差异。
+**五、存量由升级补修结算一次。** `upgrade_rules.VERIFICATION_SETTLEMENT` 记规则版本。服务起来后,升级补修的后台调度对候选件里带核查标记的行跑一遍自动落库,先备份账本,结果记进 `ledger_upgrade_repair` 的 `verification-settlement-<版本>`;判据再变时版本加一。几千行要跑一两分钟,不放在启动前的 `prepare` 里:那一步挡着 `/healthz`,重启脚本默认只等 60 秒。不推进 `CATALOG`:那会重跑全部收集项,又以核查模式带回一批新差异。
## 理由
@@ -68,8 +70,8 @@ ADR-0108 记的是用户 10-17 的要求:「补漏无需复核,覆盖已有
## 后果
-- 对 2026-11-04 快照重放:2775 条里保留现值 1446、标签并集 967、官方覆盖 100、交人 78;另有 184 条不是核查差异(候选变了的过期决定、等收录的生词、资产已不在的旧行),不归本 ADR。
-- 在真实账本的拷贝上跑升级补修结算:标签并集 688 行、官方覆盖 93 行,撤回计划逐条认得回。
+- 对 2026-11-04 快照重放:2775 条里保留现值 1449、标签并集 967、官方覆盖 100、交人 75;另有 184 条不是核查差异(候选变了的过期决定、等收录的生词、补空落不下的描述性称呼),不归本 ADR。
+- 在真实账本的拷贝上跑存量结算:标签并集 829 行、官方覆盖 100 行,撤回计划逐条认得回;复核页元数据队列从 2784 条降到 255 条,其中核查差异 75 条。并集判出而没写的 137 行,是同一条候选早先已落过、之后少掉的标签(多半是手删),不重补。
- 复核页的元数据队列每次多做一轮核查判断;资产按番号一次查齐,取数耗时与此前同一量级。
- 处理任务摘要多出 `kept`(核查差异保留现值的行数)。
- 核查行里来源还不认的生词不再单独摆上复核页;词在补空的行上照常等人收录,收录后下一轮并集照样补。