Version: 0.9.21.dev.260416

后端:
1. Memory 写入链路新增"召回→比对→汇总"去重决策层
- 新增决策流程:Runner 根据decision.enabled 配置走决策路径(语义召回候选 → Hash 精确命中 → LLM 逐对比对 → 汇总决策 → 执行 ADD/UPDATE/DELETE/NONE),默认关闭,旧路径完全保留
- 新增 LLMDecisionOrchestrator:单对关系判断编排器,输出 duplicate/update/conflict/unrelated 四种关系
- 新增 decision_flow / apply_actions:决策流程主循环与动作落地(新增、更新内容、软删除、跳过)
- 新增 aggregate_decision / decision_validate:汇总规则(按优先级判定动作)与 LLM 输出校验
- 新增 decision model:CandidateSnapshot / ComparisonResult / FinalDecision 等决策层核心类型
- ItemRepo 新增 FindActiveByHash / UpdateContentByID / SoftDeleteByID 三个决策层专用方法
- RAG Runtime / Pipeline / Service 新增 DeleteMemory 向量删除能力,MilvusStore 补充 duplicate collection 错误识别
- Runner 新增 syncVectorDeletes 处理决策层 DELETE 动作的向量清理
- config 新增 decision(enabled/candidateTopK/candidateMinScore/fallbackMode)和 write.mode 配置项,config_loader 增加默认值兜底
- 删除 HANDOFF-RAG复用后续实施计划.md 和旧 log.txt,新增 Log.txt 记录决策流程调试日志
- normalize_facts 导出 HashContent 供决策层复用,audit 新增 update 操作常量

前端:无 仓库:无
This commit is contained in:
Losita
2026-04-16 12:11:58 +08:00
parent 8bde981592
commit 634a9fb926
21 changed files with 1271 additions and 1032 deletions

View File

@@ -23,4 +23,15 @@ type Config struct {
JobMaxRetry int
WorkerPollEvery time.Duration
WorkerClaimBatch int
// 决策层配置。
// 说明:
// 1. DecisionEnabled 控制是否启用"召回→比对→汇总"决策流程;
// 2. 默认关闭,旧路径完全保留,回滚无风险;
// 3. DecisionFallbackMode 仅在决策流程整体报错时生效,不影响单条 LLM 比对失败(单条失败视为 unrelated
DecisionEnabled bool
DecisionCandidateTopK int // Milvus 语义召回候选数上限
DecisionCandidateMinScore float64 // Milvus 语义召回最低相似度
DecisionFallbackMode string // "legacy_add"(退回旧路径直接新增)/ "drop"(丢弃)
WriteMode string // "legacy"(旧路径)/ "decision"(决策流程),仅 DecisionEnabled=true 时生效
}

View File

@@ -0,0 +1,71 @@
package model
// RelationType 常量描述一条新 fact 与一条旧记忆之间的关系。
//
// 四种关系:
// 1. duplicate — 完全重复,新 fact 没有新信息,旧记忆无需变动;
// 2. update — 新 fact 是对旧记忆的修正、补充或更精确表述,需要合并更新;
// 3. conflict — 新 fact 与旧记忆矛盾,旧记忆已过时,应删旧增新;
// 4. unrelated — 两者说的是不同的事情,互不影响。
const (
RelationDuplicate = "duplicate"
RelationUpdate = "update"
RelationConflict = "conflict"
RelationUnrelated = "unrelated"
)
// CandidateSnapshot 是喂给 LLM 的旧记忆候选快照。
//
// 职责边界:
// 1. 只承载 LLM 做关系判断所需的最小信息;
// 2. MemoryID 是真实 memory_idLLM 不可见,仅供汇总决策时使用;
// 3. Score 是向量召回的相似度分数,用于多条 update 时选最优候选。
type CandidateSnapshot struct {
MemoryID int64
Title string
Content string
MemoryType string
Score float64 // Milvus 相似度分数0 表示来自 Hash 查询)
}
// ComparisonResult 是单次"新 fact vs 一条旧记忆"的 LLM 输出。
//
// 职责边界:
// 1. 只描述 LLM 对一对比较的结果,不包含最终决策动作;
// 2. UpdatedContent/UpdatedTitle 仅在 relation=update 时有意义;
// 3. Reason 写审计日志用,便于后续复盘 LLM 判断依据。
type ComparisonResult struct {
MemoryID int64 // 被比较的旧记忆 ID
Relation string // duplicate / update / conflict / unrelated
UpdatedContent string // 仅 relation=update 时有意义:合并后的新内容
UpdatedTitle string // 仅 relation=update 时有意义:合并后的新标题
Reason string // 判断理由(写审计日志用)
}
// FinalDecision 是汇总后的最终动作。
//
// 说明:
// 1. 由确定性代码产出,不是 LLM 产出;
// 2. Action 取值复用 status.go 中已定义的 DecisionActionAdd/Update/Delete/None 常量;
// 3. TargetID 在 UPDATE/DELETE 时指向旧记忆 IDADD/NONE 时为 0。
type FinalDecision struct {
Action string // ADD / UPDATE / DELETE / NONE
TargetID int64 // UPDATE/DELETE 时指向旧记忆 ID
Title string // UPDATE 时的新标题
Content string // UPDATE 时的新内容
Reason string // 汇总理由
}
// UpdateContentFields 是 UPDATE 动作需要更新的字段集合。
//
// 说明:
// 1. 只包含 UPDATE 动作实际需要修改的字段,避免全量覆盖;
// 2. NormalizedContent/ContentHash 由调用方重新计算,保证一致性。
type UpdateContentFields struct {
Title string
Content string
NormalizedContent string
ContentHash string
Confidence float64
Importance float64
}