为什么:撤销文档后 Wiki 变化此前只有"快照保存"证据;页面级差异能给出增/改/撤, 但必须写明它不等于实体、概念、边与引用的语义重算。 - overview 差异新增 wiki 字段:读两份快照的 wiki_pages 行数组比较,缺部件时 unknown。 - 发布管理"本次变更"显示 Wiki 新增/更新/撤销页数与页面级声明。 - 真实归档验证:对内 vs 对外 = 新增 31 / 撤销 1,反向镜像一致。
This commit is contained in:
@@ -54,6 +54,85 @@ type libraryDiffView struct {
|
||||
// 避免把某次历史差异当成"当前拟发布"。
|
||||
BaseSnapshot string `json:"base_snapshot,omitempty"`
|
||||
TargetSnapshot string `json:"target_snapshot,omitempty"`
|
||||
// Wiki 是**页面级**差异:只能证明页面被增/改/撤,不能证明共享正文、实体、
|
||||
// 概念或边被重新计算——后者需要 WeKnora 内部语义,本平台不做也不声称。
|
||||
Wiki *libraryWikiDiffView `json:"wiki,omitempty"`
|
||||
}
|
||||
|
||||
type libraryWikiDiffView struct {
|
||||
State string `json:"state"` // computed | unknown
|
||||
Reason string `json:"reason,omitempty"`
|
||||
Added int `json:"added"`
|
||||
Updated int `json:"updated"`
|
||||
Removed int `json:"removed"`
|
||||
// Sample 只列前若干页,避免把整库 Wiki 列表塞进接口。
|
||||
Sample []string `json:"sample"`
|
||||
Note string `json:"note"`
|
||||
}
|
||||
|
||||
// wikiDiffOf 比较两份快照的 wiki_pages 行数组(页面级)。
|
||||
// 它不能替代"删除文档后共享正文/实体/边/引用如何变化"的语义证据。
|
||||
func wikiDiffOf(archive *librarysnapshot.Archive, baseID, targetID string) *libraryWikiDiffView {
|
||||
unknown := func(reason string) *libraryWikiDiffView {
|
||||
return &libraryWikiDiffView{State: "unknown", Reason: reason, Sample: []string{},
|
||||
Note: "页面级比对缺失时不能声称 Wiki 已同步"}
|
||||
}
|
||||
rows := func(id string) ([]map[string]any, string) {
|
||||
manifest, err := archive.Load(id)
|
||||
if err != nil {
|
||||
return nil, "快照不可读"
|
||||
}
|
||||
for _, part := range manifest.Parts {
|
||||
if part.Kind != "wiki" || part.Name != "wiki_pages" {
|
||||
continue
|
||||
}
|
||||
reader, err := archive.OpenPart(part)
|
||||
if err != nil {
|
||||
return nil, "Wiki 正文不可读"
|
||||
}
|
||||
defer reader.Close()
|
||||
parsed, err := librarydiff.ReadDocuments(reader)
|
||||
if err != nil {
|
||||
return nil, "Wiki 行格式不符"
|
||||
}
|
||||
return parsed, ""
|
||||
}
|
||||
return nil, "快照里没有 wiki_pages 部件"
|
||||
}
|
||||
base, reason := rows(baseID)
|
||||
if reason != "" {
|
||||
return unknown("生产版本:" + reason)
|
||||
}
|
||||
target, reason := rows(targetID)
|
||||
if reason != "" {
|
||||
return unknown("测试版本:" + reason)
|
||||
}
|
||||
result, err := librarydiff.Compare(base, target)
|
||||
if err != nil {
|
||||
return unknown("Wiki 页面比对失败:" + err.Error())
|
||||
}
|
||||
view := &libraryWikiDiffView{State: "computed", Added: len(result.Added), Updated: len(result.Updated),
|
||||
Removed: len(result.Removed), Sample: []string{},
|
||||
Note: "页面级差异:只说明页面被增/改/撤,不代表实体、概念、边或引用已重算"}
|
||||
for _, item := range result.Added {
|
||||
if len(view.Sample) >= 20 {
|
||||
break
|
||||
}
|
||||
view.Sample = append(view.Sample, "新增 "+item.Title)
|
||||
}
|
||||
for _, item := range result.Updated {
|
||||
if len(view.Sample) >= 20 {
|
||||
break
|
||||
}
|
||||
view.Sample = append(view.Sample, "更新 "+item.Title)
|
||||
}
|
||||
for _, item := range result.Removed {
|
||||
if len(view.Sample) >= 20 {
|
||||
break
|
||||
}
|
||||
view.Sample = append(view.Sample, "撤销 "+item.Title)
|
||||
}
|
||||
return view
|
||||
}
|
||||
|
||||
// computeLibraryDiff 用归档里的 knowledges 行数组比较两个快照:
|
||||
@@ -115,6 +194,7 @@ func computeLibraryDiff(root, baseID, targetID string) (libraryDiffView, bool) {
|
||||
}
|
||||
view := libraryDiffView{State: "computed", Added: []any{}, Updated: []any{}, Removed: []any{},
|
||||
BaseSnapshot: baseID, TargetSnapshot: targetID}
|
||||
view.Wiki = wikiDiffOf(archive, baseID, targetID)
|
||||
for _, item := range result.Added {
|
||||
view.Added = append(view.Added, item)
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user