fad3aed30a
后端： 1. Memory 管理面 API 落地（“我的记忆”增删改查 + 恢复） - 补齐 List/Get/Create/Update/Delete/Restore 的 handler、请求模型与返回视图 - 注册 `/api/v1/memory/items*` 路由并接入 MemoryHandler - 新增 memory item not found / invalid memory type / invalid memory content 三类管理面错误码 2. Memory Module / Service / Repo 扩展为“可管理 + 可治理”门面 - 新增 NewModuleWithObserve / ObserveDeps，导出 GetItem / CreateItem / UpdateItem / DeleteItem / RestoreItem / RunDedupCleanup / MemoryObserver / MemoryMetrics - 新增手动新增、修改、恢复能力；删除链路切到 SoftDeleteByID；所有管理动作统一事务内写 audit，并桥接向量同步与管理面观测 - 补齐 CreateItemFields / UpdateItemFields、单条 Create、管理侧字段更新、软删/恢复，以及 dedup 扫描/归档所需 repo 能力 - 审计操作补齐 archive / restore 3. Memory 读侧与注入侧观测补齐 - HybridRetrieve 返回 telemetry，统一记录 pinned hit / semantic hit / dedup drop / degraded / RAG fallback，并上报读取命中、去重丢弃、RAG 降级指标 - AgentService 持有 memory observer / metrics；injectMemoryContext 对读取失败、空注入、成功注入补齐结构化日志与注入计数 4. Worker / 决策 / 向量同步链路治理增强 - 召回结果显式携带 fallbackMode；hash 精确命中、rag→mysql 降级、最终动作统一写入决策观测 - 接入 vectorSyncer / observer / metrics；为 job 重试、任务成功/失败、决策分布与 fallback 补齐打点；向量 upsert/delete 统一改走公共 Syncer，并收敛 parseMemoryID 解析逻辑 5. 启动层接入 Memory 观测依赖 - 启动时创建 LoggerObserver + MetricsRegistry，并通过 NewModuleWithObserve 注入 memory 模块 前端：无 仓库：无
442 lines
12 KiB
Go
442 lines
12 KiB
Go
package service
|
||
|
||
import (
|
||
"context"
|
||
"fmt"
|
||
"sort"
|
||
"strconv"
|
||
"strings"
|
||
"time"
|
||
|
||
infrarag "github.com/LoveLosita/smartflow/backend/infra/rag"
|
||
memorymodel "github.com/LoveLosita/smartflow/backend/memory/model"
|
||
memoryobserve "github.com/LoveLosita/smartflow/backend/memory/observe"
|
||
memoryrepo "github.com/LoveLosita/smartflow/backend/memory/repo"
|
||
memoryutils "github.com/LoveLosita/smartflow/backend/memory/utils"
|
||
"github.com/LoveLosita/smartflow/backend/model"
|
||
)
|
||
|
||
const (
|
||
defaultRetrieveLimit = 5
|
||
maxRetrieveLimit = 20
|
||
)
|
||
|
||
// ReadService 负责 memory 模块内部的读取、门控与轻量重排。
|
||
//
|
||
// 职责边界：
|
||
// 1. 负责把 memory_items 读出来并做用户设置过滤；
|
||
// 2. 负责最小可用的排序与截断，为后续 prompt 注入提供稳定入口；
|
||
// 3. 不直接依赖 newAgent，不负责真正把记忆拼进 prompt。
|
||
type ReadService struct {
|
||
itemRepo *memoryrepo.ItemRepo
|
||
settingsRepo *memoryrepo.SettingsRepo
|
||
ragRuntime infrarag.Runtime
|
||
cfg memorymodel.Config
|
||
observer memoryobserve.Observer
|
||
metrics memoryobserve.MetricsRecorder
|
||
}
|
||
|
||
type retrieveTelemetry struct {
|
||
ReadMode string
|
||
QueryLen int
|
||
LegacyHitCount int
|
||
PinnedHitCount int
|
||
SemanticHitCount int
|
||
DedupDropCount int
|
||
FinalCount int
|
||
Degraded bool
|
||
RAGFallbackUsed bool
|
||
}
|
||
|
||
type semanticRetrieveTelemetry struct {
|
||
HitCount int
|
||
Degraded bool
|
||
RAGFallbackUsed bool
|
||
}
|
||
|
||
func NewReadService(
|
||
itemRepo *memoryrepo.ItemRepo,
|
||
settingsRepo *memoryrepo.SettingsRepo,
|
||
ragRuntime infrarag.Runtime,
|
||
cfg memorymodel.Config,
|
||
observer memoryobserve.Observer,
|
||
metrics memoryobserve.MetricsRecorder,
|
||
) *ReadService {
|
||
if observer == nil {
|
||
observer = memoryobserve.NewNopObserver()
|
||
}
|
||
if metrics == nil {
|
||
metrics = memoryobserve.NewNopMetrics()
|
||
}
|
||
return &ReadService{
|
||
itemRepo: itemRepo,
|
||
settingsRepo: settingsRepo,
|
||
ragRuntime: ragRuntime,
|
||
cfg: cfg,
|
||
observer: observer,
|
||
metrics: metrics,
|
||
}
|
||
}
|
||
|
||
// Retrieve 读取可供后续注入使用的候选记忆。
|
||
func (s *ReadService) Retrieve(ctx context.Context, req memorymodel.RetrieveRequest) ([]memorymodel.ItemDTO, error) {
|
||
if s == nil || s.itemRepo == nil || s.settingsRepo == nil {
|
||
return nil, nil
|
||
}
|
||
if req.UserID <= 0 {
|
||
return nil, nil
|
||
}
|
||
|
||
now := req.Now
|
||
if now.IsZero() {
|
||
now = time.Now()
|
||
}
|
||
telemetry := retrieveTelemetry{
|
||
ReadMode: s.cfg.EffectiveReadMode(),
|
||
QueryLen: len(strings.TrimSpace(req.Query)),
|
||
}
|
||
|
||
setting, err := s.settingsRepo.GetByUserID(ctx, req.UserID)
|
||
if err != nil {
|
||
s.recordRetrieve(ctx, req, telemetry, err)
|
||
return nil, err
|
||
}
|
||
effectiveSetting := memoryutils.EffectiveUserSetting(setting, req.UserID)
|
||
if !effectiveSetting.MemoryEnabled {
|
||
return nil, nil
|
||
}
|
||
|
||
limit := normalizeLimit(req.Limit, defaultRetrieveLimit, maxRetrieveLimit)
|
||
if s.cfg.EffectiveReadMode() == memorymodel.MemoryReadModeHybrid {
|
||
items, hybridTelemetry, hybridErr := s.HybridRetrieve(ctx, req, effectiveSetting, limit, now)
|
||
hybridTelemetry.ReadMode = memorymodel.MemoryReadModeHybrid
|
||
hybridTelemetry.QueryLen = telemetry.QueryLen
|
||
s.recordRetrieve(ctx, req, hybridTelemetry, hybridErr)
|
||
return items, hybridErr
|
||
}
|
||
if s.cfg.RAGEnabled && s.ragRuntime != nil && strings.TrimSpace(req.Query) != "" {
|
||
items, ragErr := s.retrieveByRAG(ctx, req, effectiveSetting, limit, now)
|
||
if ragErr == nil && len(items) > 0 {
|
||
telemetry.SemanticHitCount = len(items)
|
||
telemetry.FinalCount = len(items)
|
||
s.recordRetrieve(ctx, req, telemetry, nil)
|
||
return items, nil
|
||
}
|
||
telemetry.Degraded = true
|
||
telemetry.RAGFallbackUsed = true
|
||
}
|
||
|
||
items, legacyErr := s.retrieveByLegacy(ctx, req, limit, now, effectiveSetting)
|
||
telemetry.LegacyHitCount = len(items)
|
||
telemetry.FinalCount = len(items)
|
||
s.recordRetrieve(ctx, req, telemetry, legacyErr)
|
||
return items, legacyErr
|
||
}
|
||
|
||
func (s *ReadService) retrieveByLegacy(
|
||
ctx context.Context,
|
||
req memorymodel.RetrieveRequest,
|
||
limit int,
|
||
now time.Time,
|
||
effectiveSetting model.MemoryUserSetting,
|
||
) ([]memorymodel.ItemDTO, error) {
|
||
if !effectiveSetting.MemoryEnabled {
|
||
return nil, nil
|
||
}
|
||
query := buildReadScopedItemQuery(
|
||
req,
|
||
now,
|
||
[]string{model.MemoryItemStatusActive},
|
||
normalizeLimit(limit*3, limit*3, maxRetrieveLimit*3),
|
||
)
|
||
|
||
items, err := s.itemRepo.FindByQuery(ctx, query)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
items = memoryutils.FilterItemsBySetting(items, effectiveSetting)
|
||
if len(items) == 0 {
|
||
return nil, nil
|
||
}
|
||
|
||
sort.SliceStable(items, func(i, j int) bool {
|
||
left := scoreRetrievedItem(items[i], now)
|
||
right := scoreRetrievedItem(items[j], now)
|
||
if left == right {
|
||
return items[i].ID > items[j].ID
|
||
}
|
||
return left > right
|
||
})
|
||
|
||
if len(items) > limit {
|
||
items = items[:limit]
|
||
}
|
||
_ = s.itemRepo.TouchLastAccessAt(ctx, collectMemoryIDs(items), now)
|
||
return toItemDTOs(items), nil
|
||
}
|
||
|
||
func (s *ReadService) retrieveByRAG(
|
||
ctx context.Context,
|
||
req memorymodel.RetrieveRequest,
|
||
effectiveSetting model.MemoryUserSetting,
|
||
limit int,
|
||
now time.Time,
|
||
) ([]memorymodel.ItemDTO, error) {
|
||
if !effectiveSetting.MemoryEnabled {
|
||
return nil, nil
|
||
}
|
||
|
||
result, err := s.ragRuntime.RetrieveMemory(ctx, buildReadScopedRAGRequest(req, limit, s.cfg.Threshold))
|
||
if err != nil || result == nil || len(result.Items) == 0 {
|
||
return nil, err
|
||
}
|
||
|
||
items := make([]memorymodel.ItemDTO, 0, len(result.Items))
|
||
ids := make([]int64, 0, len(result.Items))
|
||
for _, hit := range result.Items {
|
||
dto, memoryID := buildMemoryDTOFromRetrieveHit(hit)
|
||
if !effectiveSetting.ImplicitMemoryEnabled && !dto.IsExplicit {
|
||
continue
|
||
}
|
||
if !effectiveSetting.SensitiveMemoryEnabled && dto.SensitivityLevel > 0 {
|
||
continue
|
||
}
|
||
if dto.ID <= 0 && memoryID > 0 {
|
||
dto.ID = memoryID
|
||
}
|
||
items = append(items, dto)
|
||
if dto.ID > 0 {
|
||
ids = append(ids, dto.ID)
|
||
}
|
||
}
|
||
if len(items) > limit {
|
||
items = items[:limit]
|
||
}
|
||
_ = s.itemRepo.TouchLastAccessAt(ctx, ids, now)
|
||
return items, nil
|
||
}
|
||
|
||
func normalizeRetrieveMemoryTypes(raw []string) []string {
|
||
normalized := normalizeMemoryTypes(raw)
|
||
if len(normalized) > 0 {
|
||
return normalized
|
||
}
|
||
return []string{
|
||
memorymodel.MemoryTypeConstraint,
|
||
memorymodel.MemoryTypePreference,
|
||
memorymodel.MemoryTypeTodoHint,
|
||
memorymodel.MemoryTypeFact,
|
||
}
|
||
}
|
||
|
||
func (s *ReadService) recordRetrieve(
|
||
ctx context.Context,
|
||
req memorymodel.RetrieveRequest,
|
||
telemetry retrieveTelemetry,
|
||
err error,
|
||
) {
|
||
if s == nil {
|
||
return
|
||
}
|
||
|
||
level := memoryobserve.LevelInfo
|
||
if err != nil {
|
||
level = memoryobserve.LevelWarn
|
||
}
|
||
s.observer.Observe(ctx, memoryobserve.Event{
|
||
Level: level,
|
||
Component: memoryobserve.ComponentRead,
|
||
Operation: memoryobserve.OperationRetrieve,
|
||
Fields: map[string]any{
|
||
"user_id": req.UserID,
|
||
"read_mode": telemetry.ReadMode,
|
||
"query_len": telemetry.QueryLen,
|
||
"legacy_hit_count": telemetry.LegacyHitCount,
|
||
"pinned_hit_count": telemetry.PinnedHitCount,
|
||
"semantic_hit_count": telemetry.SemanticHitCount,
|
||
"dedup_drop_count": telemetry.DedupDropCount,
|
||
"final_count": telemetry.FinalCount,
|
||
"degraded": telemetry.Degraded,
|
||
"rag_fallback_used": telemetry.RAGFallbackUsed,
|
||
"success": err == nil,
|
||
"error": err,
|
||
"error_code": memoryobserve.ClassifyError(err),
|
||
},
|
||
})
|
||
|
||
if telemetry.FinalCount > 0 {
|
||
s.metrics.AddCounter(memoryobserve.MetricRetrieveHitTotal, int64(telemetry.FinalCount), map[string]string{
|
||
"read_mode": strings.TrimSpace(telemetry.ReadMode),
|
||
})
|
||
}
|
||
if telemetry.DedupDropCount > 0 {
|
||
s.metrics.AddCounter(memoryobserve.MetricRetrieveDedupDropTotal, int64(telemetry.DedupDropCount), map[string]string{
|
||
"read_mode": strings.TrimSpace(telemetry.ReadMode),
|
||
})
|
||
}
|
||
if telemetry.RAGFallbackUsed {
|
||
s.metrics.AddCounter(memoryobserve.MetricRAGFallbackTotal, 1, map[string]string{
|
||
"read_mode": strings.TrimSpace(telemetry.ReadMode),
|
||
})
|
||
}
|
||
}
|
||
|
||
// scoreRetrievedItem 计算 legacy 读链路的确定性排序分数。
|
||
//
|
||
// 说明：
|
||
// 1. 这里只保留 importance / confidence / recency / explicit / type 这些稳定特征；
|
||
// 2. conversation_id 已不再参与读侧打分，因为同对话信息本就已经在上下文窗口内；
|
||
// 3. 若后续需要引入语义分或 reranker，应在 DTO 层补齐对应字段后再统一并入。
|
||
func scoreRetrievedItem(item model.MemoryItem, now time.Time) float64 {
|
||
score := 0.35*clamp01(item.Importance) + 0.3*clamp01(item.Confidence) + 0.2*recencyScore(item, now)
|
||
if item.IsExplicit {
|
||
score += 0.1
|
||
}
|
||
switch item.MemoryType {
|
||
case memorymodel.MemoryTypeConstraint:
|
||
score += 0.12
|
||
case memorymodel.MemoryTypePreference:
|
||
score += 0.08
|
||
case memorymodel.MemoryTypeTodoHint:
|
||
score += 0.05
|
||
}
|
||
return score
|
||
}
|
||
|
||
func recencyScore(item model.MemoryItem, now time.Time) float64 {
|
||
base := item.UpdatedAt
|
||
if base == nil {
|
||
base = item.CreatedAt
|
||
}
|
||
if base == nil || now.Before(*base) {
|
||
return 0.5
|
||
}
|
||
age := now.Sub(*base)
|
||
switch {
|
||
case age <= 24*time.Hour:
|
||
return 1
|
||
case age <= 7*24*time.Hour:
|
||
return 0.85
|
||
case age <= 30*24*time.Hour:
|
||
return 0.65
|
||
case age <= 90*24*time.Hour:
|
||
return 0.45
|
||
default:
|
||
return 0.25
|
||
}
|
||
}
|
||
|
||
func clamp01(v float64) float64 {
|
||
if v < 0 {
|
||
return 0
|
||
}
|
||
if v > 1 {
|
||
return 1
|
||
}
|
||
return v
|
||
}
|
||
|
||
func collectMemoryIDs(items []model.MemoryItem) []int64 {
|
||
if len(items) == 0 {
|
||
return nil
|
||
}
|
||
ids := make([]int64, 0, len(items))
|
||
for _, item := range items {
|
||
if item.ID <= 0 {
|
||
continue
|
||
}
|
||
ids = append(ids, item.ID)
|
||
}
|
||
return ids
|
||
}
|
||
|
||
func buildMemoryDTOFromRetrieveHit(hit infrarag.RetrieveHit) (memorymodel.ItemDTO, int64) {
|
||
memoryID := parseMemoryIDFromDocumentID(hit.DocumentID)
|
||
metadata := hit.Metadata
|
||
content := strings.TrimSpace(hit.Text)
|
||
memoryType := readString(metadata["memory_type"])
|
||
dto := memorymodel.ItemDTO{
|
||
ID: memoryID,
|
||
UserID: int(readFloatLike(metadata["user_id"])),
|
||
ConversationID: readString(metadata["conversation_id"]),
|
||
AssistantID: readString(metadata["assistant_id"]),
|
||
RunID: readString(metadata["run_id"]),
|
||
MemoryType: memoryType,
|
||
Title: readString(metadata["title"]),
|
||
Content: content,
|
||
ContentHash: fallbackContentHash(memoryType, content, readString(metadata["content_hash"])),
|
||
Confidence: readFloatLike(metadata["confidence"]),
|
||
Importance: readFloatLike(metadata["importance"]),
|
||
SensitivityLevel: int(readFloatLike(metadata["sensitivity_level"])),
|
||
IsExplicit: readBoolLike(metadata["is_explicit"]),
|
||
Status: readString(metadata["status"]),
|
||
TTLAt: readTimeLike(metadata["ttl_at"]),
|
||
}
|
||
return dto, memoryID
|
||
}
|
||
|
||
func parseMemoryIDFromDocumentID(documentID string) int64 {
|
||
documentID = strings.TrimSpace(documentID)
|
||
if !strings.HasPrefix(documentID, "memory:") {
|
||
return 0
|
||
}
|
||
raw := strings.TrimPrefix(documentID, "memory:")
|
||
if strings.HasPrefix(raw, "uid:") {
|
||
return 0
|
||
}
|
||
parsed, err := strconv.ParseInt(raw, 10, 64)
|
||
if err != nil {
|
||
return 0
|
||
}
|
||
return parsed
|
||
}
|
||
|
||
func readString(v any) string {
|
||
if v == nil {
|
||
return ""
|
||
}
|
||
return strings.TrimSpace(fmt.Sprintf("%v", v))
|
||
}
|
||
|
||
func readFloatLike(v any) float64 {
|
||
switch value := v.(type) {
|
||
case float64:
|
||
return value
|
||
case float32:
|
||
return float64(value)
|
||
case int:
|
||
return float64(value)
|
||
case int64:
|
||
return float64(value)
|
||
case string:
|
||
parsed, err := strconv.ParseFloat(strings.TrimSpace(value), 64)
|
||
if err == nil {
|
||
return parsed
|
||
}
|
||
}
|
||
return 0
|
||
}
|
||
|
||
func readBoolLike(v any) bool {
|
||
switch value := v.(type) {
|
||
case bool:
|
||
return value
|
||
case string:
|
||
return strings.EqualFold(strings.TrimSpace(value), "true")
|
||
default:
|
||
return false
|
||
}
|
||
}
|
||
|
||
func readTimeLike(v any) *time.Time {
|
||
text := readString(v)
|
||
if text == "" {
|
||
return nil
|
||
}
|
||
parsed, err := time.Parse(time.RFC3339, text)
|
||
if err != nil {
|
||
return nil
|
||
}
|
||
return &parsed
|
||
}
|