diff --git a/AGENTS.md b/AGENTS.md index 6c48132..d719fdf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -70,3 +70,4 @@ python3 ~/.hermes/scripts/gitea_api.py GET "/api/v1/repos/Weknora/knowledge-gove | --- | ------ | ---- | | 14 | 包一层装饰器就丢掉可选接口 ⇒ 写集合台账被静默跳过 | `docs/agents/traps.md` | | 15 | Stat/Delete/Copy 与 Open/Put 吃不同的定位符形状 | `docs/agents/traps.md` | +| 16 | "资源不在预备份范围"≠"属于别的知识库",复用只认可审计证据 | `docs/agents/traps.md` | diff --git a/docs/agents/traps.md b/docs/agents/traps.md index 97ef271..69d1e81 100644 --- a/docs/agents/traps.md +++ b/docs/agents/traps.md @@ -383,3 +383,30 @@ scheme)。`validObjectKey` 认这种形状并把它拆成裸 key,`ValidObjec **反例**:`if _, _, err := store.Stat(...); err == nil { t.Log("...") }` —— 读不到也 算通过,等于把断言关掉了。 + +## trap-16:"资源不在预备份范围"不等于"属于别的知识库" + +**症状**:同步 A 成功 → 手工恢复 B(resources 表不删行、对象也不删)→ 再同步同一个 A, +预检在写第一笔之前整次拒绝: + +``` +资源 ID 冲突: 存在于目标租户但不在预备份范围内(属于其它知识库),拒绝覆盖 +``` + +**根因**:`resources` 是多知识库共享表,只有 `tenant_id`;预检把"同租户 + 不在预备份 +范围"当成"别人的行"。但恢复 B 的预备份是按**当时**的绑定/正文引用取范围的,A 写进去、 +恢复后变成无绑定的资源不在它里面 —— 这些行恰恰是本目标自己上一次成功同步的结果。 +**"目标里没人引用"不是归属证据**,历史孤儿、其它知识库暂未绑定的资源同样 +满足它;按它放行就是允许覆盖别人的行。 + +**判据**:真实现场(同步 A → 恢复 B → 再同步 A)必须能完成,且复用资源的 PG `xmin` +不变、`universeDump` 里历史孤儿/其它知识库/外租户行逐字节不变;把同一行的内容改一个 +字段后必须继续拒绝;没有持久来源时必须继续拒绝。 + +**修法**:只走"可审计复用"这一条放行路径(`internal/releaseadapter/v071/library_reuse.go`): +持久来源(这个目标成功同步过且登记生效版本的快照,或它自己的预备份)+ 整行内容 +(除易变时间戳)一致 + 对象字节与归档摘要一致,三者同时成立才允许复用;复用行在写集合 +里是 `existing+reused`,写入阶段跳过(不重写行、不重传对象),恢复也不清理它。 +证据单独落盘在 `reuse/.json`,摘要在写集合行里 —— 不冒充历史台账。 + +**反例**:为了"让同步能过"把"不在预备份范围"直接放行,或者恢复时按"没被引用就删"清理。