Add documentation for EverOS memory API and OpenViking admin workflows

docs/everos流程.txt

@@ -0,0 +1,77 @@
+输入user_id和session_id插入memories
+curl -X POST "http://localhost:1995/api/v1/memories" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "user_id": "user_001",
+    "session_id": "default",
+    "messages": [
+      {
+        "message_id": "msg_007",
+        "timestamp": 1778724000000,
+        "role": "user",
+        "content": "我喜欢喝拿铁，不喜欢美式。"
+      }
+    ]
+  }'
+
+{"data":{"request_id":"4535506c-26b6-4741-be62-3723db7a552c","message_count":1,"status":"accumulated","message":"Messages accepted"}
+
+
+status=accumulated 表示先缓存了，等待边界检测；status=extracted 才表示已经触发记忆提取。
+如果想强制触发总结/提取：调用 flush
+
+
+curl -X POST "http://localhost:1995/api/v1/memories/flush"   -H "Content-Type: application/json"   -d '{
+    "user_id": "user_001",
+    "session_id": "default"
+  }'
+
+{"data":{"request_id":"cc3e24be-9127-41aa-aefe-2ee80eacd054","status":"extracted","message":"Flush completed"}}
+
+
+curl -X POST "http://localhost:1995/api/v1/memories/search" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "query": "Tom 喜欢喝什么咖啡？",
+    "method": "hybrid",
+    "memory_types": ["episodic_memory", "profile"],
+    "filters": {
+      "user_id": "user_001"
+    },
+    "top_k": 10,
+    "include_original_data": true
+  }'
+
+{"data":{"episodes":[],"profiles":[{"id":"6a058e72e0fcbba549ae94d8","user_id":"user_001","group_id":"gen_solo_669f08bf6134","profile_data":{"item_type":"explicit_info","embed_text":"饮食偏好: 喜欢喝拿铁，不喜欢美式咖啡"},"scenario":"solo","memcell_count":1,"score":0.7263925671577454}],"raw_messages":[],"agent_memory":null,"query":{"text":"Tom 喜欢喝什么咖啡？","method":"hybrid","filters_applied":{"user_id":"user_001"}},"original_data":{"episodes":{},"profiles":{}}}}
+
+
+按用户/群组/时间拉取记忆：
+curl -X POST "http://localhost:1995/api/v1/memories/get" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "memory_type": "episodic_memory",
+    "filters": {
+      "user_id": "user_001"
+    },
+    "page": 1,
+    "page_size": 20,
+    "rank_by": "timestamp",
+    "rank_order": "desc"
+  }'
+
+{"data":{"episodes":[{"id":"6a058e5de0fcbba549ae94d6","user_id":"user_001","group_id":"gen_solo_669f08bf6134","session_id":"default","timestamp":"2026-05-14T02:00:00Z","participants":["user_001"],"sender_ids":["user_001"],"summary":"2026年5月14日（星期四）凌晨02:00 UTC，汤姆明确表达了自己的咖啡偏好。他陈述喜爱饮用拿铁咖啡，同时明确表示不偏好美式咖啡。","subject":"汤姆于2026年5月14日凌晨表达咖啡口味偏好","episode":"2026年5月14日（星期四）凌晨02:00 UTC，汤姆明确表达了自己的咖啡偏好。他陈述喜爱饮用拿铁咖啡，同时明确表示不偏好美式咖啡。","type":"Conversation","parent_type":"memcell","parent_id":"6a058e46e0fcbba549ae94d3"}],"profiles":[],"agent_cases":[],"agent_skills":[],"total_count":1,"count":1}}
+
+
+查 profile 画像：
+(OpenViking) tom@tom:~$ curl -X POST "http://localhost:1995/api/v1/memories/get" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "memory_type": "profile",
+    "filters": {
+      "user_id": "user_001"
+    },
+    "page": 1,
+    "page_size": 20
+  }'
+
+{"data":{"episodes":[],"profiles":[{"id":"6a058e71e0fcbba549ae94d7","user_id":"user_001","group_id":"gen_solo_669f08bf6134","profile_data":{"id":null,"memory_type":"profile","user_id":"user_001","user_name":null,"timestamp":"2026-05-14T08:57:00.574433+00:00","group_id":"gen_solo_669f08bf6134","explicit_info":[{"category":"饮食偏好","description":"喜欢喝拿铁，不喜欢美式咖啡","evidence":"2026年5月14日用户明确表示“我喜欢喝拿铁，不喜欢美式。”","sources":["6a058e46e0fcbba549ae94d3"]}],"implicit_traits":[],"last_updated":"2026-05-14T08:57:21.222404+00:00","processed_episode_ids":["6a058e46e0fcbba549ae94d3"]},"scenario":"solo","memcell_count":1}],"agent_cases":[],"agent_skills":[],"total_count":1,"count":1}}