feat(release): wiki 通道按归属判定替换,共享知识库不再被整库清空
WeKnora 的 wiki 图谱与页面同表(wiki_pages),旧的库级 DELETE + 灌包在共享真实 知识库上会把其他文档的页面与 agent 手写页一起抹掉(2026-10-08 生产演练现场)。 - 新增 internal/releaseadapter/v071/wiki_scope.go:按 source_refs 判定归属 (全部引用属于本包 = InScope;引用包外知识 = 外来页;无引用 = index/log/ agent 页永不触碰),目标库存在外来页时降级为只替换包内页集,外来页上仅摘掉 本包知识引用,包内库级页不写;包内会写入的页与外来页同 slug 时 fail-closed 拒绝发布且不落任何改动。 - Replace 与 ReplaceWiki(撤权/回滚)共用同一套判定,不再整库清空。 - 作用域以一行日志落盘:release wiki replace scope in_scope=… degraded=… - 测试:单测 7 条(纯函数判定)+ 真库集成 3 条(共享库保护 / slug 冲突拒绝 / 镜像库整库替换不变),集成用例只用带随机后缀的临时知识库并自清理。 - 文档:P6 新增「wiki 通道的归属门禁」,P8 补验收点与镜像前提。
This commit is contained in:
@@ -256,6 +256,26 @@ tenant_id + knowledge_base_id + knowledge_id
|
||||
- Chunk seq_id 冲突时整个事务失败,不静默改 ID。
|
||||
- 不调用 WeKnora 解析和 Embedding。
|
||||
|
||||
### wiki 通道的归属门禁(2026-10-08 起)
|
||||
|
||||
WeKnora 的 wiki 图谱与页面同表(`wiki_pages`,节点/边靠 slug + `in_links`/`out_links` 表达),
|
||||
所以"库级快照整库替换"在**共享真实知识库**上会把其他文档的页面和 agent 手写页一起抹掉。
|
||||
导入端现在先判定归属,再决定写入范围:
|
||||
|
||||
- 归属来自页面 `source_refs`(形如 `<knowledge_id>|<doc_title>`;`chunk_refs` 只有 chunk UUID,
|
||||
不带知识 id)。一页引用的知识**全部属于本包**才算 `InScope`;引用包外知识的是外来页;完全没有
|
||||
引用的页(`index`/`log`、agent 手写页)永不触碰。
|
||||
- **目标库没有外来页** → 镜像库对原件的前提成立,保持整库替换语义(行为与旧实现一致,仍不删
|
||||
"无引用且不在包内"的页)。
|
||||
- **目标库存在外来页** → 自动降级为"只替换包内页集":按 slug 删除重建包内页、只删包内 folder id、
|
||||
外来页上仅摘掉本包知识的引用(正文不动)、包内库级页(`index`/`log`)不写以免毁掉目标库自己的聚合。
|
||||
作用域以一行日志落盘:`release wiki replace scope in_scope=… foreign=… foreign_ref_stripped=…
|
||||
untouched=… skipped_library=… degraded=…`。
|
||||
- **包内会写入的页与外来页同 slug** → 拒绝发布(fail-closed),事务不落任何改动,错误信息点名该 slug。
|
||||
- 撤权(`delete`)与回滚走同一套判定(`ReplaceWiki`),不再整库清空。
|
||||
- 已知取舍:降级路径上共享页的正文仍由目标库的库级合成结果决定,无法在不重算(不额外烧 token)的
|
||||
前提下与本包一致;这类页只做引用级差集,并在作用域日志里计入 `foreign_ref_stripped`。
|
||||
|
||||
## Elasticsearch 通道
|
||||
|
||||
源导出:
|
||||
|
||||
@@ -59,4 +59,11 @@ target.KnowledgeBaseID == mapping.TargetKnowledgeBaseID (目标
|
||||
1. `go test ./...`、`go vet`、前端 `tsc` + `vitest` 全绿;迁移 44 up/down 往返可用。
|
||||
2. 单元/集成:映射生效后 `knowledges/chunks/wiki_pages` 的 KB 列、ES 文档字段均为目标库;摘要随改写重算;未绑定退回同 ID。
|
||||
3. 界面:系统设置可选目标库(列真实库名),保存时对目标 WeKnora 真校验(无效 ID 拒绝);发布管理显示本次目标库。
|
||||
4. 真实跨环境:1 份文档发布到目标库 → 三通道读回一致 → 官方 API 检索命中 → 撤权后零命中 → 回滚恢复。
|
||||
4. 真实跨环境:1 份文档发布到目标库 → 三通道读回一致 → 官方 API 检索命中 → 撤权后零命中 → 回滚恢复。
|
||||
5. **wiki 归属门禁(2026-10-08 起)**:目标库存在引用包外知识的页时,发布自动降级为"只替换包内页集",
|
||||
外来页 / agent 手写页 / 目标库自己的 `index`-`log` 一行不动;包内会写入的页与外来页同 slug 时拒绝发布
|
||||
且事务不留任何改动。真库集成用例:`TestWikiReplaceOnSharedKnowledgeBaseKeepsForeignPages`、
|
||||
`TestWikiReplaceRefusesWhenPackageSlugBelongsToForeignPage`、`TestWikiReplaceOnFaithfulMirrorReplacesWholeLibrary`
|
||||
(`TEST_WEKNORA_V071_TARGET_DATABASE_URL` 指向 v0.7.1 库时运行,只使用带随机后缀的临时知识库并自清理)。
|
||||
6. 跨库对发布的前置条件:**测试库与生产库承载同一批文档**(镜像)时 wiki 才能保持"测试=生产";
|
||||
只做单文档发布时,共享页正文不保证两边一致(见 P6「wiki 通道的归属门禁」)。
|
||||
Reference in New Issue
Block a user