CMS 记忆管理

// Request
GET /admin/users?q=john&page=1&limit=20

// Response
{
  users: Array<{
    entity_id: string,
    entity_type: 'user' | 'group',
    memory_count: number,          // 记忆总数
    profile_updated_at: string,    // 画像最后更新时间
    has_profile: boolean,
  }>,
  total: number,
  page: number,
  limit: number,
}

// Response
{
  entity_id: string,
  entity_type: 'user' | 'group',
  style: string | null,
  workflow: string | null,
  instructions: string | null,
  context: string | null,
  stats: object,
  updated_at: string,
}

// Request
{
  style?: string,
  workflow?: string,
  instructions?: string,
  context?: string,
}

// Response
{ success: true, updated_at: string }

// Request
GET /admin/users/:entity_id/memories?page=1&limit=20&type=preference&sort=created_at&order=desc

// Query Params
{
  page?: number,           // 默认 1
  limit?: number,          // 默认 20，最大 100
  type?: string,           // 可选过滤：preference | workflow | instruction | episodic
  sort?: string,           // 排序字段：created_at | importance | decay_weight | access_count
  order?: 'asc' | 'desc',  // 默认 desc
}

// Response
{
  memories: Array<{
    id: string,
    content: string,
    type: 'preference' | 'workflow' | 'instruction' | 'episodic',
    source: 'behavior' | 'conversation' | 'explicit',
    importance: number,
    access_count: number,
    decay_weight: number,
    metadata: {
      thread_id?: string,
      tool_name?: string,
      model?: string,
      prompt?: string,
      satisfaction?: string,
    },
    created_at: string,
    last_accessed_at: string | null,
    consolidated_at: string | null,
  }>,
  total: number,
  page: number,
  limit: number,
}

// Response
{
  id: string,
  entity_id: string,
  entity_type: 'user' | 'group',
  content: string,
  embedding_preview: number[],     // 前 8 维，用于调试展示
  embedding_norm: number,          // 向量范数
  type: string,
  source: string,
  importance: number,
  access_count: number,
  decay_weight: number,
  metadata: object,
  created_at: string,
  last_accessed_at: string | null,
  consolidated_at: string | null,
}

// Request
{
  content: string,                 // 记忆内容（自然语言）
  type: 'preference' | 'workflow' | 'instruction' | 'episodic',
  importance?: number,             // 0-1，默认 0.8
  metadata?: {
    note?: string,                 // 运营备注（标记为人工添加）
  },
}

// Response
{ id: string, deduplicated: boolean }

// Request
{
  content?: string,                // 修改后内容（触发重新 embedding）
  type?: string,                   // 修改分类
  importance?: number,             // 修改重要性
}

// Response
{ success: true }

// Response
{ success: true }

// Request
{ ids: string[] }

// Response
{ deleted: number }

// Request Header
X-Confirm-Dangerous: "RESET_ALL_MEMORIES"

// Response
{
  memories_deleted: number,
  profile_reset: true,
}

kira-cms/src/
  components/
    NavLinks.tsx              # 新增 "User Memory" 导航链接
    views/
      MemoryAdmin.tsx         # Server Component：页面入口
      MemoryAdminPanel.tsx    # Client Component：主面板
      MemoryUserSearch.tsx    # Client Component：用户搜索
      MemoryProfileCard.tsx   # Client Component：画像卡片（可编辑）
      MemoryTable.tsx         # Client Component：记忆列表表格
      MemoryDetailModal.tsx   # Client Component：记忆详情/编辑弹窗

┌────────────────────────────────────────────────────────────┐
│  User Memory Management                                    │
├────────────────────────────────────────────────────────────┤
│  🔍 搜索用户: [userId / email / nickname        ] [Search] │
├────────────────────────────────────────────────────────────┤
│                                                            │
│  ┌─ User Profile (Compact Memory) ──────────────────────┐  │
│  │ Style:        偏好复古暖色调，vintage 使用率 80%...    │  │
│  │ Workflow:     典型流程：滤镜→微调→裁剪→导出...        │  │
│  │ Instructions: 导出时保持原始分辨率...                  │  │
│  │ Context:      常拍人像                                │  │
│  │ Stats:        sessions: 142 | edits/session: 3.2      │  │
│  │                                     [Edit Profile]    │  │
│  └───────────────────────────────────────────────────────┘  │
│                                                            │
│  ┌─ Vector Memories ─────────────────────────────────────┐  │
│  │ Filter: [All Types ▼]  Sort: [Created ▼]  [+ Add]    │  │
│  │ ┌─────────────────────────────────────────────────────│  │
│  │ │ ☐ │ Type       │ Content          │ Imp. │ Decay │  │  │
│  │ ├───┼────────────┼──────────────────┼──────┼───────│  │  │
│  │ │ ☐ │ preference │ 喜欢暖色调滤镜... │ 0.9  │ 0.82  │  │  │
│  │ │ ☐ │ workflow   │ 先裁剪再调色...   │ 0.7  │ 0.65  │  │  │
│  │ │ ☐ │ instruction│ 所有图加水印...   │ 1.0  │ 0.91  │  │  │
│  │ │ ☐ │ episodic   │ 2月15日日落照...  │ 0.6  │ 0.33  │  │  │
│  │ └─────────────────────────────────────────────────────│  │
│  │ [Delete Selected]           Page 1/5  [< Prev] [Next >]│  │
│  │                                                       │  │
│  │ ⚠️ [Clear All Memories] (需二次确认)                   │  │
│  └───────────────────────────────────────────────────────┘  │
└────────────────────────────────────────────────────────────┘

CREATE TABLE memory.admin_audit_log (
  id            UUID DEFAULT gen_random_uuid() PRIMARY KEY,
  operator_id   TEXT NOT NULL,         -- CMS 管理员 ID
  action        TEXT NOT NULL,         -- create_memory | update_memory | delete_memory | batch_delete | reset_all | update_profile
  target_entity TEXT NOT NULL,         -- 目标用户/群 entity_id
  detail        JSONB DEFAULT '{}',   -- 操作详情（如删除的 memory_id 列表、修改前后内容）
  created_at    TIMESTAMPTZ DEFAULT NOW()
);

CREATE INDEX idx_admin_audit_entity ON memory.admin_audit_log (target_entity, created_at DESC);
CREATE INDEX idx_admin_audit_operator ON memory.admin_audit_log (operator_id, created_at DESC);