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 模块 前端：无 仓库：无
110 lines
2.4 KiB
Go
110 lines
2.4 KiB
Go
package observe
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"log"
|
|
"sort"
|
|
"strings"
|
|
)
|
|
|
|
// Level 表示 memory 结构化观测事件等级。
|
|
type Level string
|
|
|
|
const (
|
|
LevelInfo Level = "info"
|
|
LevelWarn Level = "warn"
|
|
LevelError Level = "error"
|
|
)
|
|
|
|
// Event 描述一次 memory 模块内部结构化观测事件。
|
|
//
|
|
// 职责边界：
|
|
// 1. 只承载稳定字段，不绑定具体日志平台；
|
|
// 2. 组件与操作名尽量保持低基数，避免后续指标聚合失控；
|
|
// 3. 字段内容应偏“排障与治理”，不承载大段原始文本。
|
|
type Event struct {
|
|
Level Level
|
|
Component string
|
|
Operation string
|
|
Fields map[string]any
|
|
}
|
|
|
|
// Observer 是 memory 模块的最小观测接口。
|
|
type Observer interface {
|
|
Observe(ctx context.Context, event Event)
|
|
}
|
|
|
|
// ObserverFunc 允许用函数快速适配 Observer。
|
|
type ObserverFunc func(ctx context.Context, event Event)
|
|
|
|
func (f ObserverFunc) Observe(ctx context.Context, event Event) {
|
|
if f == nil {
|
|
return
|
|
}
|
|
f(ctx, event)
|
|
}
|
|
|
|
// NewNopObserver 返回空实现，保证观测能力不会反向阻塞主链路。
|
|
func NewNopObserver() Observer {
|
|
return ObserverFunc(func(context.Context, Event) {})
|
|
}
|
|
|
|
// NewLoggerObserver 返回标准日志实现，当前阶段默认打到后端进程日志。
|
|
func NewLoggerObserver(logger *log.Logger) Observer {
|
|
if logger == nil {
|
|
logger = log.Default()
|
|
}
|
|
return &loggerObserver{logger: logger}
|
|
}
|
|
|
|
type loggerObserver struct {
|
|
logger *log.Logger
|
|
}
|
|
|
|
func (o *loggerObserver) Observe(ctx context.Context, event Event) {
|
|
if o == nil || o.logger == nil {
|
|
return
|
|
}
|
|
|
|
level := strings.TrimSpace(string(event.Level))
|
|
if level == "" {
|
|
level = string(LevelInfo)
|
|
}
|
|
component := strings.TrimSpace(event.Component)
|
|
if component == "" {
|
|
component = "unknown"
|
|
}
|
|
operation := strings.TrimSpace(event.Operation)
|
|
if operation == "" {
|
|
operation = "unknown"
|
|
}
|
|
|
|
fields := FieldsFromContext(ctx)
|
|
for key, value := range event.Fields {
|
|
key = strings.TrimSpace(key)
|
|
if key == "" || !shouldKeepField(value) {
|
|
continue
|
|
}
|
|
fields[key] = value
|
|
}
|
|
|
|
parts := []string{
|
|
"memory",
|
|
fmt.Sprintf("level=%s", level),
|
|
fmt.Sprintf("component=%s", component),
|
|
fmt.Sprintf("operation=%s", operation),
|
|
}
|
|
|
|
keys := make([]string, 0, len(fields))
|
|
for key := range fields {
|
|
keys = append(keys, key)
|
|
}
|
|
sort.Strings(keys)
|
|
for _, key := range keys {
|
|
parts = append(parts, fmt.Sprintf("%s=%v", key, fields[key]))
|
|
}
|
|
|
|
o.logger.Print(strings.Join(parts, " "))
|
|
}
|