fix(release): wiki 校验与写入的归属口径不一致导致跨环境发布必然失败

端到端验收实测(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 归属门禁上线后第一次真实跨环境发布
This commit is contained in:
姚章浩
2026-10-10 10:22:06 +08:00
parent d29e04e647
commit eabe55b432
2 changed files with 55 additions and 7 deletions
+37 -5
View File
@@ -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)
@@ -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"}}