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 模块 前端：无 仓库：无
78 lines
2.1 KiB
Go
78 lines
2.1 KiB
Go
package utils
|
||
|
||
import (
|
||
"encoding/json"
|
||
"strings"
|
||
|
||
"github.com/LoveLosita/smartflow/backend/model"
|
||
)
|
||
|
||
const (
|
||
// AuditOperationCreate 表示系统新建一条记忆。
|
||
AuditOperationCreate = "create"
|
||
// AuditOperationUpdate 表示决策层更新已有记忆的内容。
|
||
AuditOperationUpdate = "update"
|
||
// AuditOperationArchive 表示治理层把重复记忆归档。
|
||
AuditOperationArchive = "archive"
|
||
// AuditOperationDelete 表示对已有记忆做软删除。
|
||
AuditOperationDelete = "delete"
|
||
// AuditOperationRestore 表示把已删除/归档记忆恢复为 active。
|
||
AuditOperationRestore = "restore"
|
||
)
|
||
|
||
// BuildItemAuditLog 构造记忆变更审计日志。
|
||
//
|
||
// 职责边界：
|
||
// 1. 负责把 before/after 快照统一序列化为审计日志结构；
|
||
// 2. 不负责决定“是否应该写审计”，该决策由上层 service/worker 控制；
|
||
// 3. 不负责落库，调用方仍需显式调用 AuditRepo。
|
||
func BuildItemAuditLog(
|
||
memoryID int64,
|
||
userID int,
|
||
operation string,
|
||
operatorType string,
|
||
reason string,
|
||
before *model.MemoryItem,
|
||
after *model.MemoryItem,
|
||
) model.MemoryAuditLog {
|
||
return model.MemoryAuditLog{
|
||
MemoryID: memoryID,
|
||
UserID: userID,
|
||
Operation: strings.TrimSpace(operation),
|
||
OperatorType: NormalizeOperatorType(operatorType),
|
||
Reason: strings.TrimSpace(reason),
|
||
BeforeJSON: marshalMemoryItemSnapshot(before),
|
||
AfterJSON: marshalMemoryItemSnapshot(after),
|
||
}
|
||
}
|
||
|
||
// NormalizeOperatorType 统一规整审计操作者类型。
|
||
//
|
||
// 规则说明：
|
||
// 1. 目前只接受 user/system 两类固定值；
|
||
// 2. 空值或未知值统一回退为 user，避免把脏值直接写进审计表；
|
||
// 3. 若后续扩展 admin/tool 等类型，再在这里集中放开即可。
|
||
func NormalizeOperatorType(raw string) string {
|
||
switch strings.ToLower(strings.TrimSpace(raw)) {
|
||
case "system":
|
||
return "system"
|
||
default:
|
||
return "user"
|
||
}
|
||
}
|
||
|
||
func marshalMemoryItemSnapshot(item *model.MemoryItem) *string {
|
||
if item == nil {
|
||
return nil
|
||
}
|
||
|
||
raw, err := json.Marshal(item)
|
||
if err != nil {
|
||
empty := "{}"
|
||
return &empty
|
||
}
|
||
|
||
value := string(raw)
|
||
return &value
|
||
}
|