Version: 0.9.23.dev.260416

后端：
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 模块
前端：无
仓库：无

backend/model/memory_manage.go

@@ -0,0 +1,105 @@
+package model
+
+import "time"
+
+// MemoryGetItemRequest 描述“查看我的某条记忆”所需的最小参数。
+type MemoryGetItemRequest struct {
+	UserID   int
+	MemoryID int64
+}
+
+// MemoryCreateItemRequest 描述“手动新增一条记忆”的输入。
+type MemoryCreateItemRequest struct {
+	UserID           int        `json:"-"`
+	ConversationID   string     `json:"conversation_id,omitempty"`
+	AssistantID      string     `json:"assistant_id,omitempty"`
+	RunID            string     `json:"run_id,omitempty"`
+	MemoryType       string     `json:"memory_type"`
+	Title            string     `json:"title"`
+	Content          string     `json:"content"`
+	Confidence       *float64   `json:"confidence,omitempty"`
+	Importance       *float64   `json:"importance,omitempty"`
+	SensitivityLevel *int       `json:"sensitivity_level,omitempty"`
+	IsExplicit       *bool      `json:"is_explicit,omitempty"`
+	TTLAt            *time.Time `json:"ttl_at,omitempty"`
+	Reason           string     `json:"reason,omitempty"`
+	OperatorType     string     `json:"-"`
+}
+
+// MemoryUpdateItemRequest 描述“手动修改一条记忆”的 Patch 输入。
+//
+// 说明：
+// 1. 使用指针区分“未传字段”和“显式传零值”；
+// 2. ClearTTL 用于表达“显式清空 ttl_at”；
+// 3. 当前仍只允许修改内容侧字段，不开放跨用户、跨归属字段改写。
+type MemoryUpdateItemRequest struct {
+	UserID           int        `json:"-"`
+	MemoryID         int64      `json:"-"`
+	MemoryType       *string    `json:"memory_type,omitempty"`
+	Title            *string    `json:"title,omitempty"`
+	Content          *string    `json:"content,omitempty"`
+	Confidence       *float64   `json:"confidence,omitempty"`
+	Importance       *float64   `json:"importance,omitempty"`
+	SensitivityLevel *int       `json:"sensitivity_level,omitempty"`
+	IsExplicit       *bool      `json:"is_explicit,omitempty"`
+	TTLAt            *time.Time `json:"ttl_at,omitempty"`
+	ClearTTL         bool       `json:"clear_ttl,omitempty"`
+	Reason           string     `json:"reason,omitempty"`
+	OperatorType     string     `json:"-"`
+}
+
+// MemoryDeleteItemRequest 描述“删除我的一条记忆”的输入。
+type MemoryDeleteItemRequest struct {
+	UserID       int
+	MemoryID     int64
+	Reason       string
+	OperatorType string
+}
+
+// MemoryRestoreItemRequest 描述“恢复我的一条记忆”的输入。
+type MemoryRestoreItemRequest struct {
+	UserID       int
+	MemoryID     int64
+	Reason       string
+	OperatorType string
+}
+
+// MemoryDedupCleanupRequest 描述离线去重治理任务的执行参数。
+type MemoryDedupCleanupRequest struct {
+	UserID       int
+	Limit        int
+	DryRun       bool
+	Reason       string
+	OperatorType string
+}
+
+// MemoryDedupCleanupResult 描述一次离线去重治理的汇总结果。
+type MemoryDedupCleanupResult struct {
+	ScannedGroupCount int     `json:"scanned_group_count"`
+	DedupedGroupCount int     `json:"deduped_group_count"`
+	KeptCount         int     `json:"kept_count"`
+	ArchivedCount     int     `json:"archived_count"`
+	ArchivedIDs       []int64 `json:"archived_ids,omitempty"`
+	DryRun            bool    `json:"dry_run"`
+}
+
+// MemoryItemView 是前端可见的记忆条目视图。
+type MemoryItemView struct {
+	ID               int64      `json:"id"`
+	UserID           int        `json:"user_id"`
+	ConversationID   string     `json:"conversation_id,omitempty"`
+	AssistantID      string     `json:"assistant_id,omitempty"`
+	RunID            string     `json:"run_id,omitempty"`
+	MemoryType       string     `json:"memory_type"`
+	Title            string     `json:"title"`
+	Content          string     `json:"content"`
+	ContentHash      string     `json:"content_hash,omitempty"`
+	Confidence       float64    `json:"confidence"`
+	Importance       float64    `json:"importance"`
+	SensitivityLevel int        `json:"sensitivity_level"`
+	IsExplicit       bool       `json:"is_explicit"`
+	Status           string     `json:"status"`
+	TTLAt            *time.Time `json:"ttl_at,omitempty"`
+	CreatedAt        *time.Time `json:"created_at,omitempty"`
+	UpdatedAt        *time.Time `json:"updated_at,omitempty"`
+}