From eabe55b432e02ea3033e8c8da375730f52e5ffc0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=A7=9A=E7=AB=A0=E6=B5=A9?= Date: Sat, 10 Oct 2026 10:22:06 +0800 Subject: [PATCH] =?UTF-8?q?fix(release):=20wiki=20=E6=A0=A1=E9=AA=8C?= =?UTF-8?q?=E4=B8=8E=E5=86=99=E5=85=A5=E7=9A=84=E5=BD=92=E5=B1=9E=E5=8F=A3?= =?UTF-8?q?=E5=BE=84=E4=B8=8D=E4=B8=80=E8=87=B4=E5=AF=BC=E8=87=B4=E8=B7=A8?= =?UTF-8?q?=E7=8E=AF=E5=A2=83=E5=8F=91=E5=B8=83=E5=BF=85=E7=84=B6=E5=A4=B1?= =?UTF-8?q?=E8=B4=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 端到端验收实测(2026-10-10):文件型文档(docx)跨环境发布时,写入侧按设计保留了 目标库外来源 wiki 页(日志 in_scope=0 foreign=8 untouched=1 degraded=true), 但校验侧 VerifyWiki 仍要求"生产页 slug 集合与包内快照完全相等",必然误判,项级 报 release_verification_failed,批次随后被判失败单项失败。 - verifier.go: 归属判定与写入侧 replaceWiki 共用 packageWikiOwners; 校验改为"快照内页必须都存在 + 多出来的页只有在不属于本包时才放行", 保留原有牙齿:本包拥有却缺失/残留的页仍判失败;撤权仍禁止任何页引用被撤权文档 - wiki_channel_test.go: 用例改为 外来源多余页放行 / 本包拥有残留页拒绝 / 缺页拒绝 - 实测:同一批次重排后完成(done=1/1 item=verified 生产可用),回滚 rolled_back 这也是 wiki 归属门禁上线后第一次真实跨环境发布 --- internal/releaseadapter/v071/verifier.go | 42 ++++++++++++++++--- .../releaseadapter/v071/wiki_channel_test.go | 20 ++++++++- 2 files changed, 55 insertions(+), 7 deletions(-) diff --git a/internal/releaseadapter/v071/verifier.go b/internal/releaseadapter/v071/verifier.go index be5122d..a6188b1 100644 --- a/internal/releaseadapter/v071/verifier.go +++ b/internal/releaseadapter/v071/verifier.go @@ -140,8 +140,12 @@ func boundedProbeText(value string) string { } // VerifyWiki 校验生产端 wiki 与本次快照一致: -// - 页面 slug 集合必须与快照完全相同(多一个少一个都算失败,这样“撤权后 -// 生产还留着已撤权文档的页面”会被抓住); +// - 快照里的页面 slug 必须都存在于生产端(少一个算失败); +// - 生产端多出来的页面,只有"不属于本包"时才放行:跨来源共库时写入侧 +// (replaceWiki)会按设计保留外来源页面(degraded 模式,日志 foreign=N), +// 校验侧若按"集合完全相等"验就会误判——2026-10-10 跨环境发布实测: +// in_scope=0 / foreign=8 的文件型发布被 release_verification_failed 拦死。 +// 仍然会被拦下的是"本包拥有却多出来或少了"的页面; // - 撤权(delete)时生产 wiki 任何页面都不得再引用被撤权的文档。 // // 老包 / 未启用 wiki 的库不携带 wiki 快照,直接跳过(生产 wiki 保持原样)。 @@ -152,6 +156,15 @@ func (verifier *WeKnoraVerifier) VerifyWiki(ctx context.Context, item releasewor if !hasWikiSnapshot(bundle.Postgres) { return nil } + // 本包拥有的知识(与写入侧 replaceWiki 用同一套判定):目标库页面若引用了 + // 这些知识,就是本包页面;否则属于其他来源,写入侧会保留它们。 + owners, ownersErr := packageWikiOwners(bundle.Postgres) + if ownersErr != nil { + owners = map[string]bool{} + if validSearchIdentifier(item.KnowledgeID) { + owners[item.KnowledgeID] = true + } + } expected := map[string]bool{} for _, raw := range bundle.Postgres.Table("wiki_pages").Rows { var row struct { @@ -165,6 +178,7 @@ func (verifier *WeKnoraVerifier) VerifyWiki(ctx context.Context, item releasewor const pageSize = 20 const maxPageBudget = 1000 seen := map[string]bool{} + owned := map[string]bool{} scanned := 0 for page := 1; ; page++ { pages, total, err := verifier.client.ListWikiPages(ctx, item.TargetBase(), page, pageSize) @@ -176,6 +190,9 @@ func (verifier *WeKnoraVerifier) VerifyWiki(ctx context.Context, item releasewor continue } seen[wikiPage.Slug] = true + if pageOwnedByPackage(wikiPage, owners) { + owned[wikiPage.Slug] = true + } if item.Action != "delete" { continue } @@ -193,15 +210,30 @@ func (verifier *WeKnoraVerifier) VerifyWiki(ctx context.Context, item releasewor return errors.New("production WeKnora wiki verification exceeded its page budget") } } - if len(seen) != len(expected) { - return errors.New("production WeKnora wiki page set mismatch") - } for slug := range expected { if !seen[slug] { return errors.New("production WeKnora wiki page set mismatch") } } + // 生产端多出来的页面:外来源页面是写入侧明确保留的,不算失败; + // 本包自己的页面多出来(例如撤权后仍残留)仍然判失败。 + for slug := range seen { + if expected[slug] || !owned[slug] { + continue + } + return errors.New("production WeKnora wiki page set mismatch") + } return nil } +// pageOwnedByPackage 判断目标库某页面是否属于本包:页面任一 source_ref 指向本包知识。 +func pageOwnedByPackage(page weknora.WikiPageSummary, owners map[string]bool) bool { + for _, reference := range page.SourceRefs { + if owner := referenceOwner(reference); owner != "" && owners[owner] { + return true + } + } + return false +} + var _ ProductionVerifier = (*WeKnoraVerifier)(nil) diff --git a/internal/releaseadapter/v071/wiki_channel_test.go b/internal/releaseadapter/v071/wiki_channel_test.go index 2aeec5e..c40a4cf 100644 --- a/internal/releaseadapter/v071/wiki_channel_test.go +++ b/internal/releaseadapter/v071/wiki_channel_test.go @@ -112,10 +112,26 @@ func TestWeKnoraVerifierChecksWikiPageSet(t *testing.T) { t.Fatal(err) } - client.wikiPages = append(client.wikiPages, weknora.WikiPageSummary{Slug: "entity/stale"}) + // 跨来源共库:目标库多出来的"外来源"页面(不引用本包知识)由写入侧按设计保留, + // 校验侧必须放行,否则 2026-10-10 那次跨环境发布会被误判(in_scope=0 / foreign=8)。 + client.wikiPages = append(client.wikiPages, weknora.WikiPageSummary{Slug: "entity/foreign", SourceRefs: []string{"knowledge-other|b.md"}}) client.wikiTotal = 3 + if err := verifier.VerifyWiki(context.Background(), item, bundle); err != nil { + t.Fatalf("foreign-owned production wiki page rejected: %v", err) + } + + // 本包拥有(引用本包知识)却不在快照里的页面,仍然必须判失败。 + client.wikiPages = append(client.wikiPages, weknora.WikiPageSummary{Slug: "entity/stale", SourceRefs: []string{"knowledge-safe|a.md"}}) + client.wikiTotal = 4 if err := verifier.VerifyWiki(context.Background(), item, bundle); err == nil { - t.Fatal("stale production wiki page accepted") + t.Fatal("package-owned stale production wiki page accepted") + } + + // 无 source_refs 的页面无法判定归属,按"外来源"放行(写入侧同样不碰它)。 + client.wikiPages = []weknora.WikiPageSummary{{Slug: "entity/alpha"}, {Slug: "index"}, {Slug: "entity/unrelated"}} + client.wikiTotal = 3 + if err := verifier.VerifyWiki(context.Background(), item, bundle); err != nil { + t.Fatalf("unowned production wiki page rejected: %v", err) } client.wikiPages = []weknora.WikiPageSummary{{Slug: "entity/alpha"}}