mirror of
https://gitee.com/mateos/mateclaw.git
synced 2026-09-13 03:13:41 +08:00
fa5d406118
## 背景 Agent 通过 `wiki_create_page` 工具写入知识库的报告、分析结果等页面，虽然能在"Wiki 页面"列表中看到，但： - **识别不到**：不出现在"原始材料"面板 - **不可操作**："查看引用"按钮消失（`sourceRawIds` 为空） - **不可处理**：无 raw 可 reprocess、无 chunks 导致语义检索查不到 - **不可下载**：无 raw 行，下载端点无数据 ## 根因 `wiki_create_page` 只调用 `WikiPageService.createPage()` 写了一张 `mate_wiki_page` 表（`sourceRawIds=null`），跳过了 UI 上传文本路径的全部"消化副产物"——raw material 创建、chunks 切片、embeddings 生成、citations 构建、lineage 血缘、`WikiPageCreatedEvent` 事件发布。 ## 解决方案 让 `wiki_create_page` 在落 page 之后，同步创建 raw material 并补齐全部消化副产物，但**不重跑 LLM 页面生成**（agent 已提供最终内容）。`WikiTool.wiki_create_page` 的同步返回（`ok / pageId / slug`）不受影响。 ### 改动（4 个文件，+190 / -1） | 文件 | 改动 | |---|---| | `WikiRawMaterialService.java` | 新增 `addAgentAuthored(kbId, title, content)`：创建 `sourceType="text"` 的 raw 行，状态置 `processing`（不发布 `WikiProcessingEvent`，避免触发 LLM 重消化），按 content hash 去重 | | `WikiProcessingService.java` | 新增 `linkAgentPageToRaw(pageId, kbId, rawId, rawTitle, pageType)`：编排 ①`mergeSourceLineage`（血缘）②`deriveKnowledgeLayer` ③`persistChunks`（切片）④`embedMissingChunks` + `embedPage` ⑤`buildCitationsAsync` ⑥发布 `WikiPageCreatedEvent` ⑦raw 置 `completed` + `lastProcessedHash`。每步独立 try/catch，单点失败不阻塞其它 | | `WikiTool.java` | `wiki_create_page` 在 `createPage` 后调用 `addAgentAuthored` + `linkAgentPageToRaw`。`processingService` 为可选注入（`@Autowired(required = false)`），测试上下文中为 null 时退化为旧行为 | | `WikiPageService.java` | `deleteExclusiveBySourceRawId` 新增跳过 `lastUpdatedBy = "ai"` 的页面：agent 直接创作的页面不应在 reprocess 时被自动清理 | ### 修复后效果 | 能力 | 修复前 | 修复后 | |---|---|---| | Wiki 页面列表可见 | ✅ | ✅ | | 原始材料面板可见（可识别） | ❌ | ✅ | | 下载按钮 | ❌ | ✅ | | 查看引用按钮（可操作） | ❌ 隐藏 | ✅ | | CitationDrawer 有内容 | ❌ 空 | ✅ | | 可 reprocess（可处理） | ❌ | ✅ | | 语义检索可命中 | ❌ | ✅ chunks+embeddings | | pipeline 触发器评估 | ❌ | ✅ | | 页面内容 = agent 原文 | ✅ | ✅（不重跑 LLM） | | UI "AI 生成"标记 | ✅ | ✅（`lastUpdatedBy = "ai"`） | ## 验证 全量 wiki 模块测试通过：`Tests run: 474, Failures: 0, Errors: 0, Skipped: 0` ## 风险 - `processingService` 为可选注入，测试/轻量上下文下退化为旧行为，**向后兼容无破坏** - 新增两处数据库写入（raw + chunks），每次 `wiki_create_page` 增加 1 条 raw + N 条 chunk 行 - reprocess 行为：reprocess 时 `lastUpdatedBy = "ai"` 的页面被保留不清理，LLM 管线会从 raw content 重新消化生成额外概念页 |
||
|---|---|---|
| .. | ||
| src | ||
| Dockerfile | ||
| pom.xml | ||
| settings.xml | ||